![spring-boot-plus]( "spring-boot-plus")
spring-boot-plus是一套集成spring boot常用开发组件的后台快速开发框架
Spring-Boot-Plus是易于使用，快速，高效，功能丰富，开源的spring boot 脚手架.
前后端分离,专注于后端服务
目标
每个人都可以独立、快速、高效地开发项目！
版本库
官网
主要特性
- 集成spring boot 常用开发组件集、公共配置、AOP日志等
- 集成mybatis plus快速dao操作
- 快速生成后台代码: entity/param/vo/controller/service/mapper/xml
- 集成swagger2，可自动生成api文档
- 集成jwt、shiro/spring security权限控制
- 集成redis、spring cache、ehcache缓存
- 集成rabbit/rocket/kafka mq消息队列
- 集成druid连接池，JDBC性能和慢查询检测
- 集成spring boot admin，实时检测项目运行情况
- 使用assembly maven插件进行不同环境打包部署,包含启动、重启命令，配置文件提取到外部config目录
项目架构
![spring-boot-plus-architecture.jpg]( "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
Java 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]( "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-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 docs]( "spring-boot-plus swagger docs")
![spring-boot-plus Java Api Docs]( "spring-boot-plus Java Api Docs")
spring-boot-plus 视频 :movie_camera:
License
spring-boot-plus is under the Apache 2.0 license. See the LICENSE file for details.
