spring-boot-demo 65个集成demo
地址
说明
spring boot demo 是一个用来深度学习并实战 spring boot 的项目，目前总共包含 65 个集成demo，已经完成 53 个。 该项目已成功集成
actuator(监控)
admin(可视化监控)
logback(日志)
aopLog(通过AOP记录web请求日志)
统一异常处理(json级别和页面级别)
freemarker(模板引擎)
thymeleaf(模板引擎)
Beetl(模板引擎)
Enjoy(模板引擎)
JdbcTemplate(通用JDBC操作数据库)
JPA(强大的ORM框架)
mybatis(强大的ORM框架)
通用Mapper(快速操作Mybatis)
PageHelper(通用的Mybatis分页插件)
mybatis-plus
项目简介
spring boot demo 是一个用来深度学习并实战 spring boot 的项目，目前总共包含 66 个集成demo，已经完成 54 个。
该项目已成功集成 actuator(监控)、admin(可视化监控)、logback(日志)、aopLog(通过AOP记录web请求日志)、统一异常处理(json级别和页面级别)、freemarker(模板引擎)、thymeleaf(模板引擎)、Beetl(模板引擎)、Enjoy(模板引擎)、JdbcTemplate(通用JDBC操作数据库)、JPA(强大的ORM框架)、mybatis(强大的ORM框架)、通用Mapper(快速操作Mybatis)、PageHelper(通用的Mybatis分页插件)、mybatis-plus(快速操作Mybatis)、BeetlSQL(强大的ORM框架)、upload(本地文件上传和七牛云文件上传)、redis(缓存)、ehcache(缓存)、email(发送各种类型邮件)、task(基础定时任务)、quartz(动态管理定时任务)、xxl-job(分布式定时任务)、swagger(API接口管理测试)、security(基于RBAC的动态权限认证)、SpringSession(Session共享)、Zookeeper(结合AOP实现分布式锁)、RabbitMQ(消息队列)、Kafka(消息队列)、websocket(服务端推送监控服务器运行信息)、socket.io(聊天室)、ureport2(中国式报表)、打包成war文件、集成 ElasticSearch(基本操作和高级查询)、Async(异步任务)、集成Dubbo(采用官方的starter)、MongoDB(文档数据库)、neo4j(图数据库)、docker(容器化)、JPA多数据源、Mybatis多数据源、代码生成器、GrayLog(日志收集)、JustAuth(第三方登录)、LDAP(增删改查)、动态添加/切换数据源、单机限流(AOP + Guava RateLimiter)、分布式限流(AOP + Redis + Lua)、ElasticSearch 7.x(使用官方 Rest High Level Client)、HTTPS、Flyway(数据库初始化)。
如果大家还有想要集成的demo，也可在
感谢
分支介绍
- master 分支：基于 Spring Boot 版本
2.1.0.RELEASE，每个 Module 的 parent 依赖根目录下的 pom.xml，主要用于管理每个 Module 的通用依赖版本，方便大家学习。 - v-1.5.x 分支：基于 Spring Boot 版本
1.5.8.RELEASE，每个 Module 均依赖 spring-boot-demo-parent，有挺多同学们反映这种方式对新手不是很友好，运行起来有些难度，因此 此分支(v-1.5.x)会停止开发维护 ，所有内容会慢慢以 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 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 之前，有些是需要事先初始化数据库数据的，亲们别忘记了哦~
开发计划
查看
各 Module 介绍
| Module 名称 | Module 介绍 |
|---|---|
| spring-boot 的一个 helloworld | |
| spring-boot 读取配置文件中的内容 | |
| spring-boot 集成 spring-boot-starter-actuator 用于监控 spring-boot 的启动和运行状态 | |
| spring-boot 集成 spring-boot-admin 来可视化的监控 spring-boot 程序的运行状态，可以与 actuator 互相搭配使用，客户端示例 | |
| spring-boot 集成 spring-boot-admin 来可视化的监控 spring-boot 程序的运行状态，可以与 actuator 互相搭配使用，服务端示例 | |
| spring-boot 集成 logback 日志 | |
| spring-boot 使用 AOP 切面的方式记录 web 请求日志 | |
| spring-boot 统一异常处理，包括2种，第一种返回统一的 json 格式，第二种统一跳转到异常页面 | |
| spring-boot 集成 Freemarker 模板引擎 | |
| spring-boot 集成 Thymeleaf 模板引擎 | |
| spring-boot 集成 Beetl 模板引擎 | |
| spring-boot 集成 Enjoy 模板引擎 | |
| spring-boot 集成 Jdbc Template 操作数据库，并简易封装通用 Dao 层 | |
| spring-boot 集成 spring-boot-starter-data-jpa 操作数据库 | |
| spring-boot 集成原生mybatis，使用 | |
| spring-boot 集成 | |
| spring-boot 集成 | |
| spring-boot 集成 | |
| spring-boot 文件上传示例，包含本地文件上传以及七牛云文件上传 | |
| spring-boot 整合 redis，操作redis中的数据，并使用redis缓存数据 | |
| spring-boot 整合 ehcache，使用 ehcache 缓存数据 | |
| spring-boot 整合 email，包括发送简单文本邮件、HTML邮件（包括模板HTML邮件）、附件邮件、静态资源邮件 | |
| spring-boot 快速实现定时任务 | |
spring-boot 整合 quartz，并实现对定时任务的管理，包括新增定时任务，删除定时任务，暂停定时任务，恢复定时任务，修改定时任务启动时间，以及定时任务列表查询，提供前端页面 |
|
| spring-boot 整合 | |
spring-boot 集成原生的 swagger 用于统一管理、测试 API 接口 |
|
spring-boot 集成第三方 swagger |
|
| spring-boot 集成 spring security 完成基于RBAC权限模型的权限管理，支持自定义过滤请求，动态权限认证，使用 JWT 安全认证，支持在线人数统计，手动踢出用户等操作 | |
| spring-boot 集成 shiro 实现权限管理 待完成 |
|
| spring-boot 集成 Spring Session 实现Session共享、重启程序Session不失效 | |
| spring-boot 实现 oauth 服务器功能，实现授权码机制 待完成 |
|
spring-boot 集成第三方登录，集成 justauth-spring-boot-starter 实现QQ登录、GitHub登录、微信登录、谷歌登录、微软登录、小米登录、企业微信登录。 |
|
| spring-boot 集成 Zookeeper 结合AOP实现分布式锁 | |
| spring-boot 集成 RabbitMQ 实现基于直接队列模式、分列模式、主题模式、延迟队列的消息发送和接收 | |
| spring-boot 集成 RocketMQ，实现消息的发送和接收 待完成 |
|
| spring-boot 集成 kafka，实现消息的发送和接收 | |
| spring-boot 集成 websocket，后端主动推送前端服务器运行信息 | |
| spring-boot 使用 netty-socketio 集成 websocket，实现一个简单的聊天室 | |
| spring-boot 集成 ureport2 实现复杂的自定义的中国式报表 待完成 |
|
| spring-boot 集成 uflo 快速实现轻量级流程引擎 待完成 |
|
| spring-boot 集成 urule 快速实现规则引擎 待完成 |
|
| spring-boot 集成 activiti 7 流程引擎 待完成 |
|
| spring-boot 使用原生提供的异步任务支持，实现异步执行任务 | |
| spring-boot 打成 war 包的配置 | |
spring-boot 集成 ElasticSearch，集成 spring-boot-starter-data-elasticsearch 完成对 ElasticSearch 的高级使用技巧，包括创建索引、配置映射、删除索引、增删改查基本操作、复杂查询、高级查询、聚合查询等 |
|
spring-boot 集成 Dubbo，分别为公共模块 spring-boot-demo-dubbo-common、服务提供方spring-boot-demo-dubbo-provider、服务调用方spring-boot-demo-dubbo-consumer |
|
| spring-boot 集成 MongoDB，使用官方的 starter 实现增删改查 | |
| spring-boot 集成 Neo4j 图数据库，实现一个校园人物关系网的demo | |
| spring-boot 容器化 | |
| spring-boot 使用JPA集成多数据源 | |
| spring-boot 使用Mybatis集成多数据源，使用 Mybatis-Plus 提供的开源解决方案实现 | |
spring-boot 使用 sharding-jdbc 实现分库分表，同时ORM采用 Mybatis-Plus |
|
| spring-boot 集成 tio 网络编程框架 待完成 |
|
| spring-boot 集成grpc，配置tls/ssl，参见 | |
| spring-boot 集成 velocity 模板技术实现的代码生成器，简化开发 | |
| spring-boot 集成 graylog 实现日志统一收集 | |
| spring-boot-demo-sso | spring-boot 集成 SSO 单点登录，参见 |
spring-boot 集成 LADP，集成 spring-boot-starter-data-ldap 完成对 Ldap 的基本 CURD操作, 并给出以登录为实战的 API 示例，参见 |
|
| spring-boot 动态添加数据源、动态切换数据源 | |
| spring-boot 使用 Guava RateLimiter 实现单机版限流，保护 API | |
| spring-boot 使用 Redis + Lua 脚本实现分布式限流，保护 API | |
| spring-boot 集成 HTTPS | |
| spring boot 集成 ElasticSearch 7.x 版本，使用官方 Rest High Level Client 操作 ES 数据 | |
| spring boot 集成 Flyway，项目启动时初始化数据库表结构，同时支持数据库脚本版本控制 |
附录
根目录下的 pom.xml
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>com.xkcoding</groupId>
<artifactId>spring-boot-demo</artifactId>
<version>1.0.0-SNAPSHOT</version>
<modules>
<module>spring-boot-demo-helloworld</module>
<module>spring-boot-demo-properties</module>
<module>spring-boot-demo-actuator</module>
<module>spring-boot-demo-admin</module>
<module>spring-boot-demo-logback</module>
<module>spring-boot-demo-log-aop</module>
<module>spring-boot-demo-exception-handler</module>
<module>spring-boot-demo-template-freemarker</module>
<module>spring-boot-demo-template-thymeleaf</module>
<module>spring-boot-demo-template-beetl</module>
<module>spring-boot-demo-template-enjoy</module>
<module>spring-boot-demo-orm-jdbctemplate</module>
<module>spring-boot-demo-orm-jpa</module>
<module>spring-boot-demo-orm-mybatis</module>
<module>spring-boot-demo-orm-mybatis-mapper-page</module>
<module>spring-boot-demo-orm-mybatis-plus</module>
<module>spring-boot-demo-orm-beetlsql</module>
<module>spring-boot-demo-upload</module>
<module>spring-boot-demo-cache-redis</module>
<module>spring-boot-demo-cache-ehcache</module>
<module>spring-boot-demo-email</module>
<module>spring-boot-demo-task</module>
<module>spring-boot-demo-task-quartz</module>
<module>spring-boot-demo-task-xxl-job</module>
<module>spring-boot-demo-swagger</module>
<module>spring-boot-demo-swagger-beauty</module>
<module>spring-boot-demo-rbac-security</module>
<module>spring-boot-demo-rbac-shiro</module>
<module>spring-boot-demo-session</module>
<module>spring-boot-demo-oauth</module>
<module>spring-boot-demo-social</module>
<module>spring-boot-demo-zookeeper</module>
<module>spring-boot-demo-mq-rabbitmq</module>
<module>spring-boot-demo-mq-rocketmq</module>
<module>spring-boot-demo-mq-kafka</module>
<module>spring-boot-demo-websocket</module>
<module>spring-boot-demo-websocket-socketio</module>
<module>spring-boot-demo-ureport2</module>
<module>spring-boot-demo-uflo</module>
<module>spring-boot-demo-urule</module>
<module>spring-boot-demo-activiti</module>
<module>spring-boot-demo-async</module>
<module>spring-boot-demo-dubbo</module>
<module>spring-boot-demo-war</module>
<module>spring-boot-demo-elasticsearch</module>
<module>spring-boot-demo-mongodb</module>
<module>spring-boot-demo-neo4j</module>
<module>spring-boot-demo-docker</module>
<module>spring-boot-demo-multi-datasource-jpa</module>
<module>spring-boot-demo-multi-datasource-mybatis</module>
<module>spring-boot-demo-sharding-jdbc</module>
<module>spring-boot-demo-tio</module>
<module>spring-boot-demo-codegen</module>
<module>spring-boot-demo-graylog</module>
<module>spring-boot-demo-ldap</module>
<module>spring-boot-demo-dynamic-datasource</module>
<module>spring-boot-demo-ratelimit-guava</module>
<module>spring-boot-demo-ratelimit-redis</module>
<module>spring-boot-demo-elasticsearch-rest-high-level-client</module>
<module>spring-boot-demo-https</module>
<module>spring-boot-demo-flyway</module>
</modules>
<packaging>pom</packaging>
<name>spring-boot-demo</name>
<url>http://xkcoding.com</url>
<properties>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
<project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
<java.version>1.8</java.version>
<maven.compiler.source>1.8</maven.compiler.source>
<maven.compiler.target>1.8</maven.compiler.target>
<spring.boot.version>2.1.0.RELEASE</spring.boot.version>
<mysql.version>8.0.12</mysql.version>
<hutool.version>5.0.0</hutool.version>
<guava.version>28.1-jre</guava.version>
<user.agent.version>1.20</user.agent.version>
</properties>
<repositories>
<repository>
<id>aliyun</id>
<name>aliyun</name>
<url>https://maven.aliyun.com/repository/public</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>false</enabled>
</snapshots>
</repository>
</repositories>
<dependencyManagement>
<dependencies>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-dependencies</artifactId>
<version>${spring.boot.version}</version>
<type>pom</type>
<scope>import</scope>
</dependency>
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>${mysql.version}</version>
</dependency>
<!-- hutool工具类 -->
<dependency>
<groupId>cn.hutool</groupId>
<artifactId>hutool-all</artifactId>
<version>${hutool.version}</version>
</dependency>
<!-- guava工具类 -->
<dependency>
<groupId>com.google.guava</groupId>
<artifactId>guava</artifactId>
<version>${guava.version}</version>
</dependency>
<!-- 解析 UserAgent 信息 -->
<dependency>
<groupId>eu.bitwalker</groupId>
<artifactId>UserAgentUtils</artifactId>
<version>${user.agent.version}</version>
</dependency>
</dependencies>
</dependencyManagement>
<build>
<pluginManagement>
<plugins>
<plugin>
<artifactId>maven-clean-plugin</artifactId>
<version>3.0.0</version>
</plugin>
<plugin>
<artifactId>maven-resources-plugin</artifactId>
<version>3.0.2</version>
</plugin>
<plugin>
<artifactId>maven-compiler-plugin</artifactId>
<version>3.7.0</version>
</plugin>
<plugin>
<artifactId>maven-surefire-plugin</artifactId>
<version>2.20.1</version>
</plugin>
<plugin>
<artifactId>maven-jar-plugin</artifactId>
<version>3.0.2</version>
</plugin>
<plugin>
<artifactId>maven-install-plugin</artifactId>
<version>2.5.2</version>
</plugin>
<plugin>
<artifactId>maven-deploy-plugin</artifactId>
<version>2.8.2</version>
</plugin>
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
<version>${spring.boot.version}</version>
<executions>
<execution>
<goals>
<goal>repackage</goal>
</goals>
</execution>
</executions>
</plugin>
</plugins>
</pluginManagement>
</build>
</project>
官方提供的 starter 介绍
| 名称 | 描述 |
|---|---|
| spring-boot-starter | Spring Boot 核心包，包括自动装配，日志，以及YAML文件解析 |
| spring-boot-starter-actuator | 帮助在生产环境下监控和管理 Spring Boot 应用 |
| spring-boot-starter-amqp | Spring Boot 快速集成 RabbitMQ |
| spring-boot-starter-aop | 提供切面编程特性，包含 spring-aop 和 AspectJ 依赖 |
| spring-boot-starter-batch | 快速集成 Spring Batch 批处理框架，包括操作 HSQLDB 数据库 |
| spring-boot-starter-cache | Support for Spring’s Cache abstraction. |
| spring-boot-starter-data-elasticsearch | Spring Boot 快速集成 ElasticSearch 查询分析引擎 |
| spring-boot-starter-data-jpa | Spring Boot 快速集成 JPA 操作数据库 |
| spring-boot-starter-data-mongodb | Spring Boot 快速集成 MongoDB 非关系型数据库 |
| spring-boot-starter-data-rest | Spring Boot 暴露数据库查询端点为 REST 服务 |
| spring-boot-starter-data-solr | Spring Boot 快速集成 Solr 实现全文索引 |
| spring-boot-starter-freemarker | 提供 FreeMarker 模板引擎 |
| spring-boot-starter-groovy-templates | 提供 Groovy 模板引擎 |
| spring-boot-starter-integration | 提供通用的集成 spring-integration 模块 |
| spring-boot-starter-jdbc | 快速集成 JDBC 操作数据库 |
| spring-boot-starter-jersey | 提供 Jersey 提供 RESTful 服务 |
| spring-boot-starter-jta-atomikos | 集成 JTA Atomikos 实现分布式事务 |
| spring-boot-starter-jta-bitronix | 集成 JTA Bitronix 实现分布式事务 |
| spring-boot-starter-mail | 快速邮件集成 |
| spring-boot-starter-mustache | 提供 Mustache 模板引擎 |
| spring-boot-starter-redis | Spring Boot 快速集成 Redis |
| spring-boot-starter-security | Support for spring-security. |
| spring-boot-starter-social-facebook | Support for spring-social-facebook. |
| spring-boot-starter-social-linkedin | Support for spring-social-linkedin. |
| spring-boot-starter-social-twitter | Support for spring-social-twitter. |
| spring-boot-starter-test | 提供通用单元测试依赖，包括 JUnit, Hamcrest , Mockito |
| spring-boot-starter-thymeleaf | 提供 Thymeleaf 模板引擎，包括 Thymeleaf 的自动装配等 |
| spring-boot-starter-velocity | 提供 Velocity 模板引擎 |
| spring-boot-starter-web | 提供全栈的 web 开发特性，包括 Spring MVC 依赖和 Tomcat 容器 |
| spring-boot-starter-websocket | Spring Boot 集成 WebSocket 功能 |
| spring-boot-starter-ws | Spring Boot 集成 WebService 功能 |
开源推荐
JustAuth：史上最全的整合第三方登录的开源库，Mica：SpringBoot 微服务高效开发工具集，awesome-collector：SpringBlade：完整的线上解决方案(企业开发必备)，Pig：宇宙最强微服务认证授权脚手架(架构师必备)，
此博客主要用于记录相关知识点，大部分内容来自网络文章，特此感谢各位作者
