spring-boot-demo

项目简介

spring boot demo 是一个用来深度学习并实战 spring boot 的项目，目前总共包含 66 个集成demo，已经完成 55 个。

该项目已成功集成 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(数据库初始化)、UReport2(中国式复杂报表)。

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

分支介绍

• 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 的朋友，同步代码的请参考：https://xkcoding.com/2018/09/18/how-to-update-the-fork-project.html

1. git clone https://github.com/xkcoding/spring-boot-demo.git
2. 使用 IDEA 打开 clone 下来的项目
3. 在 IDEA 中 Maven Projects 的面板导入项目根目录下 的 pom.xml 文件
4. Maven Projects 找不到的童鞋，可以勾上 IDEA 顶部工具栏的 View -> Tool Buttons ，然后 Maven Projects 的面板就会出现在 IDEA 的右侧
5. 找到各个 Module 的 Application 类就可以运行各个 demo 了
6. 注意：每个 demo 均有详细的 README 配套，食用 demo 前记得先看看哦~
7. 注意：运行各个 demo 之前，有些是需要事先初始化数据库数据的，亲们别忘记了哦~

项目趋势

其他

团队纳新

组内招人啦，HC 巨多，Base 杭州，感兴趣的小伙伴，查看 岗位详情

开源推荐

• JustAuth：史上最全的整合第三方登录的开源库，https://github.com/justauth/JustAuth
• Mica：SpringBoot 微服务高效开发工具集，https://github.com/lets-mica/mica
• awesome-collector：https://github.com/P-P-X/awesome-collector
• SpringBlade：完整的线上解决方案(企业开发必备)，https://github.com/chillzhuang/SpringBlade
• Pig：宇宙最强微服务认证授权脚手架(架构师必备)，https://github.com/pigxcloud/pig

开发计划

查看 TODO 文件

各 Module 介绍

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 集成