我开源了团队内部基于SpringBoot Web快速开发的API脚手架v1.6.0更新

技术分享 3年前 (2023-07-26) 0 999+

关注

什么是 rest-api-spring-boot-starter

rest-api-spring-boot-starter 适用于SpringBoot Web API 快速构建让开发人员快速构建统一规范的业务RestFull API 不在去关心一些繁琐。重复工作，而是把重点聚焦到业务。

动机

每次Web API常用功能都需要重新写一遍。或者复制之前的项目代码。于是我封装了这么一个stater

抽出SpringBoot Web API 每个项目必备需要重复写的模块，和必备功能。
并且扩展了我工作中用到的所有工具库。解放双手提高开发效率

版本更新

目前最新版本1.6.2 支持功能如下:

支持一键配置自定义RestFull API 统一格式返回
支持RestFull API 错误国际化
支持全局异常处理，全局参数验证处理
业务错误断言工具封装，遵循错误优先返回原则
封装Redis key,value 操作工具类。统一key管理 spring cache缓存实现
RestTemplate 封装 POST,GET 请求工具
日志集成。自定义日志路径，按照日志等级分类，支持压缩和文件大小分割。按时间显示
工具库集成集成了lombok，hutool，commons-lang3，guava。不需要自己单个引入
集成mybatisPlus一键代码生成
日志记录，服务监控，支持日志链路查询。自定义数据源
OpenApi3文档集成支持一键配置。支持多种文档和自动配置
生成JWT标准Token和权限认证
接口限流，Ip城市回显
HttpUserAgent请求设备工具封装
RequestUtil参数解析封装工具
GitHub 地址
gitee 地址

Web JWT Token 权限支持

JWT Web Token

可以轻松自定义生成自己JWT Web Token.和基于JWT 的userJwtToken

通过userJwtToken你可以轻松生成基于用户登录认证的Token

@Autowired private UserJwtToken userJwtToken; @GetMapping("/login") public Result login() {     UserEntry userEntry = new UserEntry();     userEntry.setUserId("2");     userEntry.setUsername("billy");     userEntry.setHobby("eat");     userJwtToken.rememberMe=true;     String token = userJwtToken.createdToken(userEntry.getUserId(), userEntry.getUsername(), userEntry);     return Result.buildSuccess(token); }

解析token获取用户信息

@GetMapping("/user") public Result getUser() {     String token = "eyJhbGciOiJIUzI1NiIsInppcCI6IkRFRiJ9.eNqqViouTVKyUkrKzMmpVNJRyiwuBvKMgKyskkwoK7WiQMnK0MzC0tTUwsDEWEeptDi1SMmqGkx7pkBVgTh5ibmpSIZl5CclVQL5qYklSrW1AAAAAP__.8nWRs40LbRTIQBhJ8jVaANPcvsmX0zoLR66R-b2Uc4M";     String userName=userJwtToken.getUserName(token);     String userId= userJwtToken.getUserId(token);     UserEntry userEntry=userJwtToken.parseUserToken(token,UserEntry.class);     return Result.buildSuccess(userId); }

自定义Token秘钥和签名配置

jwt:   secret: 123456   # 秘钥 建议加密后秘钥如md5 不要使用明文长度大于6位   expiration: 86400 # token 过期时间（单位秒 1天后过期）   token-header: Token  #header token 名称   remember-me-expiration: 604800  #记住我 token过期时间(单位秒 7天后过期)   user-sign: true # 是否自定义签名。为true需要实现加密接口。和 配置 jwtCfg注入对应bean

自定义签名认证和动态秘钥授权需要实现UserSign接口配置UserJwtConfig配置类注入自定义签名bean

package cn.soboys.superaide.config;  import cn.soboys.restapispringbootstarter.authorization.UserSign; import io.jsonwebtoken.SignatureAlgorithm;  /**  * @author 公众号 程序员三时  * @version 1.0  * @date 2023/7/16 00:20  * @webSite https://github.com/coder-amiao  */ public class MyUserSign implements UserSign {      @Override     public SignatureAlgorithm sign() {         return SignatureAlgorithm.HS256;     }      @Override     public String AuthKey() {         return null;     } }

AuthKey返回null时候会使用你在属性文件配置的秘钥。没有会使用默认的

package cn.soboys.superaide.config;  import cn.soboys.restapispringbootstarter.authorization.*; import org.springframework.boot.autoconfigure.condition.ConditionalOnMissingBean; import org.springframework.context.annotation.Bean; import org.springframework.context.annotation.Configuration; import org.springframework.context.annotation.Primary;  /**  * @author 公众号 程序员三时  * @version 1.0  * @date 2023/7/15 09:49  * @webSite https://github.com/coder-amiao  * 用户jwt token生成配置  */ @Configuration public class UserJwtConfig {       @Bean     public UserSign MyUserSign() {         return new MyUserSign();     }       @Bean     public UserJwtToken userJwtToken(UserSign MyUserSign) {         UserJwtToken userJwtToken = new UserJwtToken();         userJwtToken.setUserSign(MyUserSign);         return userJwtToken;     } }

权限认证

基于JWT Web Token 也帮你封装了权限登录认证。你只需要在属性文件配置开启即可。

jwt:  authorization:     has-authorization: true     includes-url: /user    # 需要认证请求 多个用逗号隔开     excludes-url: /login,/register/**      # 配置无需认证的

全局帮你自动处理Token过期异常。和错误异常你只需要在heard中配置你自己的Token就行

{     "success": false,     "code": "401",     "msg": "未授权 ",     "requestId": "9a3ytEtOX0UuojSaA2LD",     "timestamp": "2023-07-17 17:08:05",     "data": null }

如果需要自定义自己认证授权逻辑,实现LoginAuthorization接口即可
并且在UserJwtConfig配置类中注入对应LoginAuthorization bean

如：

package cn.soboys.superaide.config;  import cn.soboys.restapispringbootstarter.Assert; import cn.soboys.restapispringbootstarter.HttpStatus; import cn.soboys.restapispringbootstarter.authorization.LoginAuthorization; import cn.soboys.restapispringbootstarter.authorization.UserJwtToken; import org.dromara.hutool.core.text.StrUtil; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.stereotype.Component;  import javax.servlet.http.HttpServletRequest; import javax.servlet.http.HttpServletResponse;  /**  * @author 公众号 程序员三时  * @version 1.0  * @date 2023/7/16 11:00  * @webSite https://github.com/coder-amiao  */ @Component public class MyLoginAuthorization implements LoginAuthorization { @Autowired private UserJwtToken userJwtToken;  @Override public Boolean authorization(HttpServletRequest request, HttpServletResponse response, Object handler) {     String token = request.getHeader("Token");      Assert.isFalse(StrUtil.isEmpty(token),HttpStatus.UNAUTHORIZED);     String userId = userJwtToken.getUserId(token);  //验证token有效合法性。      //其他数据库 或者业务操作     return true; } }

在配置类中注入bean

package cn.soboys.superaide.config;  import cn.soboys.restapispringbootstarter.authorization.*; import org.springframework.boot.autoconfigure.condition.ConditionalOnMissingBean; import org.springframework.context.annotation.Bean; import org.springframework.context.annotation.Configuration; import org.springframework.context.annotation.Primary;  /**  * @author 公众号 程序员三时  * @version 1.0  * @date 2023/7/15 09:49  * @webSite https://github.com/coder-amiao  * 用户jwt token生成配置  */ @Configuration public class UserJwtConfig {       @Bean     public UserSign MyUserSign() {         return new MyUserSign();     }      @Bean     @Primary     public LoginAuthorization loginAuthorizationSubject() {         return new MyLoginAuthorization();     }       @Bean     public UserJwtToken userJwtToken(UserSign MyUserSign) {         UserJwtToken userJwtToken = new UserJwtToken();         userJwtToken.setUserSign(MyUserSign);         return userJwtToken;     } }