SpringBoot+JWT+Shiro+MybatisPlus实现Restful快速开发后端脚手架

超、凢脫俗 2021-11-17 10:50 211阅读 0赞

## 一、背景 ##

前后端分离已经成为互联网项目开发标准，它会为以后的大型分布式架构打下基础。[SpringBoot][]使编码配置部署都变得简单，越来越多的互联网公司已经选择SpringBoot作为微服务的入门级微框架。

[Mybatis-Plus][]是一个 [Mybatis][] 的增强工具，有代码生成器，并且提供了类似hibernate的单表CRUD操作，又保留了mybatis的特性支持定制化 SQL。

[Apache Shiro][]是一款强大易用的Java安全框架，Java官方推荐使用Shiro，它比Spring Security更简单易用，Spring自己的系列Spring side4也把权限扩建换成Shiro了。

现在API越来越流行，如何安全保护这些API？ [JSON Web Tokens][](JWT)能提供基于JSON格式的安全认证。JWT可以跨不同语言，自带身份信息，并且非常容易传递。

## 二、项目特性 ##

1.自定义@Log注解自动记录日志到数据库。

2.自定义@Pass注解接口不用进行认证身份。

3.使用JSONObject统一获取body请求参数，减少实体类的数量。完成自定义@ValidationParam注解验证请求参数是否为空。

![f3baf3e96123d41a8fff8bf2ac62684b9bb.jpg][]

4.使用bcrypt算法加密密码，著名代码托管网站Github和美国军方防火墙同样采用此算法，靠bcrypt算法会成功保住密码强度不算很高的大部分账户。

5.搭配Shiro注解配置权限，高度灵活，提供按钮级别的权限控制，后端接口只验证权限，不看角色。用自定义@CurrentUser注解获取当前登录用户，Controlle层统一异常处理：

![234950_u2kv_3577599.png][]

6.用SpringAOP切面编程进行声明式事务，过滤请求参数，防止XSS攻击。

7.使用POST请求登录返回token和权限信息(service层增删改方法命名规范会自动加上事物)，保证请求无状态，返回实体如果属性为空不显示。

![a12b5783657b7fd29f413c4a231bb6d6a7e.jpg][]

## 三、程序逻辑 ##

1.填写用户名密码用POST请求访问/login接口，返回token令牌等信息，失败则直接跳转401错误页面。

2.在之后需要验证身份的请求的Headers中添加Authorization和登录时返回的token令牌。

3.服务端进行token认证，失败跳转401页面。

4.用JWT做认证（登录），Shiro做授权。

## 四、运行项目 ##

项目结构：

![001735_h0LR_3577599.png][]

*  通过git下载源码，本项目基于JDK1.8
 *  采用Maven项目管理，模块化，导入IDE时直接选定liugh-parent的pom导入
 *  创建数据库liugh，数据库编码为UTF-8，执行liugh.sql文件，初始化数据
 *  修改application-dev.properties，更新MySQL账号和密码
 *  Eclipse、IDEA运行SpringbootApplication.java，则可启动项目。或在liugh-parent目录下运行命令mvn clean package，然后在liugh-web/target目录下运行java -jar liugh-web.jar命令
 *  启动一个redis服务
 *  访问登录接口：localhost:8081/api/login
 *  账号密码：13888888888/123456
 *  获取token访问其他接口
 *  注意!!!!!访问的接口url统一会加上/api/v1;编译器请安装lombok插件,不然会报红

运行截图：

![e734e53d9c9e92665fc8eae18168f845686.jpg][]

彩蛋：项目注释完整，并且自定义了启动图案~

GitHub地址：[https://github.com/qq53182347/liugh-parent][https_github.com_qq53182347_liugh-parent]

第一次做自己的项目，经验不足，如果大家有什么好的意见或批评，请务必issue一下。

转载于:https://www.cnblogs.com/lywJ/p/11252064.html

[SpringBoot]: https://projects.spring.io/spring-boot/
[Mybatis-Plus]: https://github.com/baomidou/mybatis-plus
[Mybatis]: http://www.mybatis.org/mybatis-3/
[Apache Shiro]: https://shiro.apache.org/
[JSON Web Tokens]: https://jwt.io/
[f3baf3e96123d41a8fff8bf2ac62684b9bb.jpg]: /images/20211116/1030ea427af0490ebf93349e490a58cb.png
[234950_u2kv_3577599.png]: https://static.oschina.net/uploads/space/2018/0512/234950_u2kv_3577599.png
[a12b5783657b7fd29f413c4a231bb6d6a7e.jpg]: /images/20211116/fa545f6961434789bf84ff33c08670c5.png
[001735_h0LR_3577599.png]: https://static.oschina.net/uploads/space/2018/0513/001735_h0LR_3577599.png
[e734e53d9c9e92665fc8eae18168f845686.jpg]: /images/20211116/da6dc4622d9d4e7e9255a310468d3ada.png
[https_github.com_qq53182347_liugh-parent]: https://github.com/qq53182347/liugh-parent