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


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

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

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

## 目标

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

## 版本库

#### [GITHUB](https://github.com/geekidea/spring-boot-plus) | [GITEE](https://gitee.com/geekidea/spring-boot-plus)

## 官网

#### [springboot.plus](http://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目录

## 项目架构


### 项目环境

中间件 | 版本 | 备注

-|-|-

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](https://github.com/geekidea/spring-boot-plus/blob/master/CHANGELOG.md)

## Java Docs

#### [Java Api Docs](https://apidoc.gitee.com/geekidea/spring-boot-plus/)

## 使用

### 克隆 spring-boot-plus

```bash

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

cd spring-boot-plus

```

### Maven 构建

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

```bash

mvn clean package -Plocal

```

## 5分钟完成增删改查

### 1. 创建数据库表

```sql

-- ----------------------------

-- Table structure for foo_ba

-- ----------------------------

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_ba

-- ----------------------------

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

```text

/src/test/java/io/geekidea/springbootplus/test/SpringBootPlusGenerator.java

```

```java

/**

* spring-boot-plus代码生成器入口类

*

* @author geekidea

* @date 2019-10-22

**/

public class SpringBootPlusGenerator {

public static void main(String[] args) {

CodeGenerator codeGenerator = new CodeGenerator();

// 公共配置

// 数据库配置

codeGenerato

.setUserName("root")

.setPassword("root")

.setDriverName("com.mysql.jdbc.Driver")

.setDriverUrl("jdbc:mysql://localhost:3306/spring_boot_plus?useUnicode=true&characterEncoding=UTF-8&useSSL=false");

// 包信息

codeGenerato

.setProjectPackagePath("io/geekidea/springbootplus")

.setParentPackage("io.geekidea.springbootplus");

// 组件作者等配置

codeGenerato

.setModuleName("foobar")

.setAuthor("geekidea")

.setPkIdColumnName("id");

// 生成策略

codeGenerato

.setGeneratorStrategy(CodeGenerator.GeneratorStrategy.ALL)

.setPageListOrder(true)

.setParamValidation(true);

// 生成实体映射相关代码,可用于数据库字段更新

// 当数据库字段更新时，可自定义自动生成哪些那文件

codeGenerato

.setGeneratorEntity(true)

.setGeneratorQueryParam(true)

.setGeneratorQueryVo(true);

// 生成业务相关代码

codeGenerato

.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();

}

}

}

```

> 生成的代码结构

```text

/src/main/java/io/geekidea/springbootplus/fooba

```

```text

└── fooba

├── controlle

│   └── FooBarController.java

├── entity

│   └── FooBar.java

├── mappe

│   └── FooBarMapper.java

├── param

│   └── FooBarQueryParam.java

├── service

│   ├── FooBarService.java

│   └── impl

│   └── FooBarServiceImpl.java

└── vo

└── FooBarQueryVo.java

```

> Mapper XML

```text

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

```

### 3. 启动项目

> 项目入口类

```text

/src/main/java/io/geekidea/springbootplus/SpringBootPlusApplication.java

```

```java

/**

* spring-boot-plus 项目启动入口

* @author geekidea

* @since 2018-11-08

*/

@EnableAsync

@EnableScheduling

@EnableTransactionManagement

@EnableConfigurationProperties

@EnableAdminServe

@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](http://127.0.0.1:8888/swagger-ui.html)

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


## 快速开始

[快速开始](https://springboot.plus/guide/quick-start.html)

## 详细文档

[https://springboot.plus](https://springboot.plus)

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

### 1. 下载安装脚本

> 安装 `jdk`, `git`, `maven`, `redis`, `mysql`

```bash

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

```

### 2. 运行安装脚本

```bash

sh download-install-all.sh

```

### 3. 修改MySQL密码

```bash

ALTER USER 'root'@'localhost' IDENTIFIED BY 'Springbootplus666!';

exit

mysql -uroot -pSpringbootplus666!

```

### 4. 导入MySQL脚本

```bash

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`

```bash

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

```

### 6. 执行脚本

```bash

sh deploy.sh

```

### 7.访问项目

> SpringBootAdmin管理页面

[http://47.105.159.10:8888](http://47.105.159.10:8888)

> spring-boot-plus Swagger文档页面

[http://47.105.159.10:8888/docs](http://47.105.159.10:8888/docs)

### 8. 查看项目运行日志

```bash

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 Admin Instances](http://47.105.159.10:8888/instances/e211ba082db8/details)


### [Spring Boot Admin Statistics](http://47.105.159.10:8888/instances/e211ba082db8/details)


### [Spring Boot Admin Log](http://47.105.159.10:8888/instances/e211ba082db8/logfile)


### [spring-boot-plus Swagger文档](http://47.105.159.10:8888/swagger-ui.html)


### [spring-boot-plus Java Api Docs](http://geekidea.io/spring-boot-plus-apidocs/)


## spring-boot-plus 视频 :movie_camera:

- [5分钟完成增删改查](https://www.bilibili.com/video/av67401204)

- [CentOS 快速安装 JDK/Git/Maven/Redis/MySQL](https://www.bilibili.com/video/av67218836/)

- [CentOS 快速部署/构建/打包/运行项目](https://www.bilibili.com/video/av67218970/)

## License

spring-boot-plus is under the Apache 2.0 license. See the [LICENSE](https://github.com/geekidea/spring-boot-plus/blob/master/LICENSE) file for details.