spring-boot-plus是易于使用,快速,高效,功能丰富,开源的spring boot 脚手架.

  • 2019 年 11 月 3 日
  • 笔记

spring-boot-plus logo

Everyone can develop projects independently, quickly and efficiently!

spring-boot-plus version spring boot version code style

spring-boot-plus是一套集成spring boot常用开发组件的后台快速开发框架

Spring-Boot-Plus是易于使用,快速,高效,功能丰富,开源的spring boot 脚手架.

前后端分离,专注于后端服务

目标

每个人都可以独立、快速、高效地开发项目!

版本库

GITHUB | GITEE

官网

springboot.plus

主要特性

  1. 集成spring boot 常用开发组件集、公共配置、AOP日志等
  2. 集成mybatis plus快速dao操作
  3. 快速生成后台代码: entity/param/vo/controller/service/mapper/xml
  4. 集成swagger2,可自动生成api文档
  5. 集成jwt、shiro/spring security权限控制
  6. 集成redis、spring cache、ehcache缓存
  7. 集成rabbit/rocket/kafka mq消息队列
  8. 集成druid连接池,JDBC性能和慢查询检测
  9. 集成spring boot admin,实时检测项目运行情况
  10. 使用assembly maven插件进行不同环境打包部署,包含启动、重启命令,配置文件提取到外部config目录

项目架构

spring-boot-plus-architecture.jpg

项目环境

中间件 版本 备注
JDK 1.8+ JDK1.8及以上
MySQL 5.7+ 5.7及以上
Redis 3.2+

技术选型

技术 版本 备注
Spring Boot 2.2.0.RELEASE 最新发布稳定版
Spring Framework 5.2.0.RELEASE 最新发布稳定版
Mybatis 3.5.2 持久层框架
Mybatis Plus 3.2.0 mybatis增强框架
Alibaba Druid 1.1.20 数据源
Fastjson 1.2.62 JSON处理工具集
swagger2 2.6.1 api文档生成工具
commons-lang3 3.9 常用工具包
commons-io 2.6 IO工具包
commons-codec 1.13 加密解密等工具包
commons-collections4 4.4 集合工具包
reflections 0.9.11 反射工具包
hibernate-validator 6.0.17.Final 后台参数校验注解
Shiro 1.4.1 权限控制
JWT 3.8.3 JSON WEB TOKEN
hutool-all 5.0.3 常用工具集
lombok 1.18.10 注解生成Java Bean等工具
mapstruct 1.3.1.Final 对象属性复制工具

CHANGELOG

CHANGELOG.md

Java Docs

Java Api Docs

使用

克隆 spring-boot-plus

git clone https://github.com/geekidea/spring-boot-plus.git  cd spring-boot-plus

Maven 构建

默认使用local环境,对应配置文件:application-local.yml

mvn clean package -Plocal

5分钟完成增删改查

1. 创建数据库表

-- ----------------------------  -- Table structure for foo_bar  -- ----------------------------  DROP TABLE IF EXISTS `foo_bar`;  CREATE TABLE `foo_bar`  (      `id`            bigint(20)  NOT NULL COMMENT '主键',      `name`          varchar(20) NOT NULL COMMENT '名称',      `foo`           varchar(20)          DEFAULT NULL COMMENT 'Foo',      `bar`           varchar(20) NOT NULL COMMENT 'Bar',      `remark`        varchar(200)         DEFAULT NULL COMMENT '备注',      `state`         int(11)     NOT NULL DEFAULT '1' COMMENT '状态,0:禁用,1:启用',      `version`       int(11)     NOT NULL DEFAULT '0' COMMENT '版本',      `create_time`   timestamp   NULL     DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',      `update_time`   timestamp   NULL     DEFAULT NULL COMMENT '修改时间',      PRIMARY KEY (`id`)  ) ENGINE = InnoDB    DEFAULT CHARSET = utf8mb4    COLLATE = utf8mb4_general_ci COMMENT ='FooBar';    -- ----------------------------  -- Records of foo_bar  -- ----------------------------  INSERT INTO foo_bar (id, name, foo, bar, remark, state, version, create_time, update_time)      VALUES (1, 'FooBar', 'foo', 'bar', 'remark...', 1, 0, '2019-11-01 14:05:14', null);  INSERT INTO foo_bar (id, name, foo, bar, remark, state, version, create_time, update_time)      VALUES (2, 'HelloWorld', 'hello', 'world', null, 1, 0, '2019-11-01 14:05:14', null);  

2.使用代码生成器生成增删改查代码

修改数据库信息

修改组件名称/作者/数据库表名称/主键id

/src/test/java/io/geekidea/springbootplus/test/SpringBootPlusGenerator.java
/**   * spring-boot-plus代码生成器入口类   *   * @author geekidea   * @date 2019-10-22   **/  public class SpringBootPlusGenerator {        public static void main(String[] args) {          CodeGenerator codeGenerator = new CodeGenerator();          // 公共配置          // 数据库配置          codeGenerator                  .setUserName("root")                  .setPassword("root")                  .setDriverName("com.mysql.jdbc.Driver")                  .setDriverUrl("jdbc:mysql://localhost:3306/spring_boot_plus?useUnicode=true&characterEncoding=UTF-8&useSSL=false");            // 包信息          codeGenerator                  .setProjectPackagePath("io/geekidea/springbootplus")                  .setParentPackage("io.geekidea.springbootplus");            // 组件作者等配置          codeGenerator                  .setModuleName("foobar")                  .setAuthor("geekidea")                  .setPkIdColumnName("id");            // 生成策略          codeGenerator                  .setGeneratorStrategy(CodeGenerator.GeneratorStrategy.ALL)                  .setPageListOrder(true)                  .setParamValidation(true);            // 生成实体映射相关代码,可用于数据库字段更新          // 当数据库字段更新时,可自定义自动生成哪些那文件          codeGenerator                  .setGeneratorEntity(true)                  .setGeneratorQueryParam(true)                  .setGeneratorQueryVo(true);            // 生成业务相关代码          codeGenerator                  .setGeneratorController(true)                  .setGeneratorService(true)                  .setGeneratorServiceImpl(true)                  .setGeneratorMapper(true)                  .setGeneratorMapperXml(true);            // 是否生成Shiro RequiresPermissions注解          codeGenerator.setRequiresPermissions(false);            // 是否覆盖已有文件          codeGenerator.setFileOverride(true);            // 初始化公共变量          codeGenerator.init();            // 需要生成的表数组          // xxx,yyy,zzz为需要生成代码的表名称          String[] tables = {                  "foo_bar"          };            // 循环生成          for (String table : tables) {              // 设置需要生成的表名称              codeGenerator.setTableName(table);              // 生成代码              codeGenerator.generator();          }        }    }

生成的代码结构

/src/main/java/io/geekidea/springbootplus/foobar
└── foobar      ├── controller      │   └── FooBarController.java      ├── entity      │   └── FooBar.java      ├── mapper      │   └── FooBarMapper.java      ├── param      │   └── FooBarQueryParam.java      ├── service      │   ├── FooBarService.java      │   └── impl      │       └── FooBarServiceImpl.java      └── vo          └── FooBarQueryVo.java

Mapper XML

/src/main/resources/mapper/foobar/FooBarMapper.xml

3. 启动项目

项目入口类

/src/main/java/io/geekidea/springbootplus/SpringBootPlusApplication.java
/**   * spring-boot-plus 项目启动入口   * @author geekidea   * @since 2018-11-08   */  @EnableAsync  @EnableScheduling  @EnableTransactionManagement  @EnableConfigurationProperties  @EnableAdminServer  @MapperScan({"io.geekidea.springbootplus.**.mapper"})  @SpringBootApplication  public class SpringBootPlusApplication {        public static void main(String[] args) {          // 启动spring-boot-plus          ConfigurableApplicationContext context = SpringApplication.run(SpringBootPlusApplication.class, args);          // 打印项目信息          PrintApplicationInfo.print(context);      }    }

4. 访问项目swagger文档

http://127.0.0.1:8888/swagger-ui.html

5. 系统用户 增删改查分页Swagger

sys_user_swagger-zh.png

快速开始

快速开始

详细文档

https://springboot.plus

CentOS快速安装环境/构建/部署/启动spring-boot-plus项目

1. 下载安装脚本

安装 jdk, git, maven, redis, mysql

wget -O download-install-all.sh https://springboot.plus/bin/download-install-all.sh

2. 运行安装脚本

sh download-install-all.sh

3. 修改MySQL密码

ALTER USER 'root'@'localhost' IDENTIFIED BY 'Springbootplus666!';  exit  mysql -uroot -pSpringbootplus666!

4. 导入MySQL脚本

create database if not exists spring_boot_plus character set utf8mb4;  use spring_boot_plus;  source /root/mysql_spring_boot_plus.sql;  show tables;  exit

5. 下载部署脚本 deploy.sh

wget -O deploy.sh https://springboot.plus/bin/deploy.sh

6. 执行脚本

sh deploy.sh

7.访问项目

SpringBootAdmin管理页面

http://47.105.159.10:8888

spring-boot-plus Swagger文档页面

http://47.105.159.10:8888/docs

8. 查看项目运行日志

tail -f -n 1000 /root/spring-boot-plus-server/logs/spring-boot-plus.log

spring-boot-plus Views

spring-boot-plus IDEA Sources Views

spring-boot-plus-idea

Spring Boot Admin Instances

spring-boot-admin instances

Spring Boot Admin Statistics

spring-boot-admin statistics

Spring Boot Admin Log

spring-boot-admin log

spring-boot-plus Swagger文档

spring-boot-plus swagger docs

spring-boot-plus Java Api Docs

spring-boot-plus Java Api Docs

spring-boot-plus 视频 ?

License

spring-boot-plus is under the Apache 2.0 license. See the LICENSE file for details.