Spring Boot Demo

简介 #

spring boot demo 是一个用来深入学习并实战 Spring Boot 的项目，是目前全网、最新最全的实战教程，总共包含 66 个集成demo，已经完成 55 个。

涵盖模板引擎、ORM框架、分布式技术、授权认证等企业级实战方案，具体包括的模块参见下方表格

如果大家还有想要集成的demo，也可在 issue (opens new window) 里提需求。我会额外添加在 TODO 列表里。✊

分支介绍 #

master 分支：基于 Spring Boot 版本 2.4.4，每个 Module 的 parent 依赖根目录下的 pom.xml，主要用于管理每个 Module 的通用依赖版本(SpringBoot版本)，方便大家学习。
v-1.5.x 分支：基于 Spring Boot 版本 1.5.8.RELEASE，每个 Module 均依赖 spring-boot-demo-parent，有挺多同学们反映这种方式对新手不是很友好，运行起来有些难度，因此此分支已经停止开发维护，所有内容均在 master 分支全部更新，此分支暂未完成的，也会直接在 master 分支上加，在此分支学习的同学们，仍然可以在此分支学习，但是建议后期切换到master分支，会更加容易，毕竟官方已经将 Spring Boot 升级到 2.x 版本很久很久啦。🙂

开发环境 #

JDK 1.8 +
Maven 3.5 +
IntelliJ IDEA ULTIMATE 2018.2 + (注意：务必使用 IDEA 开发，同时保证安装 lombok 插件)
Mysql 5.7 + (尽量保证使用 5.7 版本以上，因为 5.7 版本加了一些新特性，同时不向下兼容。本 demo 里会尽量避免这种不兼容的地方，但还是建议尽量保证 5.7 版本以上)

运行方式 #

提示：如果是 fork 的朋友，同步代码的请参考：git 如何更新 fork 的项目到原项目的最新版本

git clone https://github.com/xkcoding/spring-boot-demo.git
使用 IDEA 打开 clone 下来的项目
在 IDEA 中 Maven Projects 的面板导入项目根目录下的 pom.xml 文件
Maven Projects 找不到的童鞋，可以勾上 IDEA 顶部工具栏的 View -> Tool Buttons ，然后 Maven Projects 的面板就会出现在 IDEA 的右侧
找到各个 Module 的 Application 类就可以运行各个 demo 了

注意：

每个 demo 均有详细的 README 配套，使用 demo 前记得先看看哦~
运行各个 demo 之前，有些是需要事先初始化数据库数据的，亲们别忘记了哦~

项目趋势 #

(opens new window)

其他 #

开发计划 #

查看 TODO 文件

各 Module 介绍 #

注意：这里采取 Maven 多模块的设计，父级 pom 管理 SpringBoot 版本，所以每个模块下就不需要申明版本了，独立项目需要注意！

Module 名称	Module 介绍
demo-helloworld	spring-boot 的一个 helloworld
demo-properties	spring-boot 读取配置文件中的内容
demo-actuator	spring-boot 集成 spring-boot-starter-actuator 用于监控 spring-boot 的启动和运行状态
demo-admin-client	spring-boot 集成 spring-boot-admin 来可视化的监控 spring-boot 程序的运行状态，可以与 actuator 互相搭配使用，客户端示例
demo-admin-server	spring-boot 集成 spring-boot-admin 来可视化的监控 spring-boot 程序的运行状态，可以与 actuator 互相搭配使用，服务端示例
demo-logback	spring-boot 集成 logback 日志
demo-log-aop	spring-boot 使用 AOP 切面的方式记录 web 请求日志
demo-exception-handler	spring-boot 统一异常处理，包括2种，第一种返回统一的 json 格式，第二种统一跳转到异常页面
demo-template-freemarker	spring-boot 集成 Freemarker 模板引擎
demo-template-thymeleaf	spring-boot 集成 Thymeleaf 模板引擎
demo-template-beetl	spring-boot 集成 Beetl 模板引擎
demo-template-enjoy	spring-boot 集成 Enjoy 模板引擎
demo-orm-jdbctemplate	spring-boot 集成 Jdbc Template 操作数据库，并简易封装通用 Dao 层
demo-orm-jpa	spring-boot 集成 spring-boot-starter-data-jpa 操作数据库
demo-orm-mybatis	spring-boot 集成原生mybatis，使用 mybatis-spring-boot-starter (opens new window) 集成
demo-orm-mybatis-mapper-page	spring-boot 集成通用Mapper (opens new window)和PageHelper (opens new window)，使用 mapper-spring-boot-starter (opens new window) 和 pagehelper-spring-boot-starter (opens new window) 集成
demo-orm-mybatis-plus	spring-boot 集成 mybatis-plus (opens new window)，使用 mybatis-plus-boot-starter (opens new window) 集成，集成 BaseMapper、BaseService、ActiveRecord 操作数据库
demo-orm-beetlsql	spring-boot 集成 beetl-sql (opens new window)，使用 beetl-framework-starter (opens new window) 集成
demo-upload	spring-boot 文件上传示例，包含本地文件上传以及七牛云文件上传
demo-cache-redis	spring-boot 整合 redis，操作redis中的数据，并使用redis缓存数据
demo-cache-ehcache	spring-boot 整合 ehcache，使用 ehcache 缓存数据
demo-email	spring-boot 整合 email，包括发送简单文本邮件、HTML邮件（包括模板HTML邮件）、附件邮件、静态资源邮件
demo-task	spring-boot 快速实现定时任务
demo-task-quartz	spring-boot 整合 quartz，并实现对定时任务的管理，包括新增定时任务，删除定时任务，暂停定时任务，恢复定时任务，修改定时任务启动时间，以及定时任务列表查询，`提供前端页面`
demo-task-xxl-job	spring-boot 整合xxl-job (opens new window)，并提供绕过 `xxl-job-admin` 对定时任务的管理的方法，包括定时任务列表，触发器列表，新增定时任务，删除定时任务，停止定时任务，启动定时任务，修改定时任务，手动触发定时任务
demo-swagger	spring-boot 集成原生的 `swagger` 用于统一管理、测试 API 接口
demo-swagger-beauty	spring-boot 集成第三方 `swagger` swagger-bootstrap-ui (opens new window) 美化API文档样式，用于统一管理、测试 API 接口
demo-rbac-security	spring-boot 集成 spring security 完成基于RBAC权限模型的权限管理，支持自定义过滤请求，动态权限认证，使用 JWT 安全认证，支持在线人数统计，手动踢出用户等操作
demo-rbac-shiro	spring-boot 集成 shiro 实现权限管理待完成
demo-session	spring-boot 集成 Spring Session 实现Session共享、重启程序Session不失效
demo-oauth	spring-boot 实现 oauth 服务器功能，实现授权码机制待完成
demo-social	spring-boot 集成第三方登录，集成 `justauth-spring-boot-starter` 实现QQ登录、GitHub登录、微信登录、谷歌登录、微软登录、小米登录、企业微信登录。
demo-zookeeper	spring-boot 集成 Zookeeper 结合AOP实现分布式锁
demo-mq-rabbitmq	spring-boot 集成 RabbitMQ 实现基于直接队列模式、分列模式、主题模式、延迟队列的消息发送和接收
demo-mq-rocketmq	spring-boot 集成 RocketMQ，实现消息的发送和接收待完成
demo-mq-kafka	spring-boot 集成 kafka，实现消息的发送和接收
demo-websocket	spring-boot 集成 websocket，后端主动推送前端服务器运行信息
demo-websocket-socketio	spring-boot 使用 netty-socketio 集成 websocket，实现一个简单的聊天室
demo-ureport2	spring-boot 集成 ureport2 实现复杂的自定义的中国式报表
demo-uflo	spring-boot 集成 uflo 快速实现轻量级流程引擎待完成
demo-urule	spring-boot 集成 urule 快速实现规则引擎待完成
demo-activiti	spring-boot 集成 activiti 7 流程引擎待完成
demo-async	spring-boot 使用原生提供的异步任务支持，实现异步执行任务
demo-war	spring-boot 打成 war 包的配置
demo-elasticsearch	spring-boot 集成 ElasticSearch，集成 `spring-boot-starter-data-elasticsearch` 完成对 ElasticSearch 的高级使用技巧，包括创建索引、配置映射、删除索引、增删改查基本操作、复杂查询、高级查询、聚合查询等
demo-dubbo	spring-boot 集成 Dubbo，分别为公共模块 `spring-boot-demo-dubbo-common`、服务提供方`spring-boot-demo-dubbo-provider`、服务调用方`spring-boot-demo-dubbo-consumer`
demo-mongodb	spring-boot 集成 MongoDB，使用官方的 starter 实现增删改查
demo-neo4j	spring-boot 集成 Neo4j 图数据库，实现一个校园人物关系网的demo
demo-docker	spring-boot 容器化
demo-multi-datasource-jpa	spring-boot 使用JPA集成多数据源
demo-multi-datasource-mybatis	spring-boot 使用Mybatis集成多数据源，使用 Mybatis-Plus 提供的开源解决方案实现
demo-sharding-jdbc	spring-boot 使用 `sharding-jdbc` 实现分库分表，同时ORM采用 Mybatis-Plus
demo-tio	spring-boot 集成 tio 网络编程框架待完成
demo-grpc	spring-boot 集成grpc，配置tls/ssl，参见ISSUE#5 (opens new window) 待完成
demo-codegen	spring-boot 集成 velocity 模板技术实现的代码生成器，简化开发
demo-graylog	spring-boot 集成 graylog 实现日志统一收集
demo-sso	spring-boot 集成 SSO 单点登录，参见 ISSUE#12 (opens new window) 待完成
demo-ldap	spring-boot 集成 LDAP，集成 `spring-boot-starter-data-ldap` 完成对 Ldap 的基本 CURD操作, 并给出以登录为实战的 API 示例，参见 ISSUE#23 (opens new window)，感谢 @fxbin (opens new window)
demo-dynamic-datasource	spring-boot 动态添加数据源、动态切换数据源
demo-ratelimit-guava	spring-boot 使用 Guava RateLimiter 实现单机版限流，保护 API
demo-ratelimit-redis	spring-boot 使用 Redis + Lua 脚本实现分布式限流，保护 API
demo-https	spring-boot 集成 HTTPS
demo-elasticsearch-rest-high-level-client	spring boot 集成 ElasticSearch 7.x 版本，使用官方 Rest High Level Client 操作 ES 数据
demo-flyway	spring boot 集成 Flyway，项目启动时初始化数据库表结构，同时支持数据库脚本版本控制

License #

MIT (opens new window)

待办列表