itarge-framework

基于SpringBoot3的服务端项目骨架。对数据库访问,redis缓存，接口文档自动生成等功能进行了封装，减少大伙重复造轮子浪费的各种时间成本。如有新的需求，请联系我。后端开发须知

Rest接口统一返回json数据，格式定义在Result类中，

public class Result<T> {
    
    private Integer code;
    
    private String message;
    
    private T data;
}

数据库封装了crud代码自动生成、分页查询、动态表名等功能。

封装了mybatis-plus的自动生成数据库mapper、实体类entity、service等代码的功能。数据库代码自动生成方法参考：mybatis-plus代码自动生成

数据库生成代码执行方法在CodeGenerator类中

Redis缓存封装

Redis缓存用户信息、租户信息的操作封装在RedisService类中，如需缓存其他数据，添加相应方法即可。

接口调用次数限制

接口调用次数限制注解@RequestLimit ，防止接口被频繁调用。

@GetMapping("welink")
@RequestLimit(maxCount = 10, timeout = 60)
public TenantInfoRes welink(){
     TenantInfoRes tenantInfoRes = openAPI.getTenantInfo();
     return tenantInfoRes;
}

上边的接口调用限制为同一个token（用户）在60秒钟最多调用10次。

统一异常返回封装

所有类型的异常统一处理，异常处理代码封装在ExceptionAdvice类中，项目中需要用到的异常，直接抛出throw即可，会封装成统一的ResultVO返回前端。自定义的异常需要继承RuntimeException类，异常编号（code）需要在ResultEnum类中定义。

接口文档自动生成

整合 Smart-doc maven插件自动生成接口文档，方便前后端联调。后端开发者需要对每个controller接口进行注释，注释内容包括接口的用户、每个参数的意义，对于Object类型参数或者返回值，可以注释每个object中字段的意义，注释代码示例：

/**
 * <p>
 * 访客请求控制器
 * </p>
 *
 * @author WangRan
 * @since 2022-02-15
 */
@RestController
@RequestMapping("/apply")
public class ApplyController {
    
    @Autowired
    RedisService redisService;

    @Autowired
    IApplyService applyService;

    /**
     * 添加访客审批
     *
     * @param visitorDto 审批请求数据
     * @param authCode   请求token
     * @return
     */
    @PostMapping("add")
    public boolean addApply(@RequestBody VisitorDto visitorDto, @RequestHeader("authCode") String authCode) {
        UserBasicInfoRes userBasicInfoRes = redisService.getUserInfo(authCode);
        return applyService.addApply(visitorDto, userBasicInfoRes);
    }

    /**
     * 我的访客申请列表
     *
     * @param authCode 请求token
     * @return
     */
    @GetMapping("myapplication")
    public Page<VisitorDto> myApplication(long pageNum, long pageSize, @RequestHeader("authCode") String authCode) {
        UserBasicInfoRes userBasicInfoRes = redisService.getUserInfo(authCode);
        return applyService.findApplyByUserId(userBasicInfoRes.getUserId(), pageNum, pageSize);
    }

    /**
     * 待我审批的访客申请列表
     *
     * @param pageNum
     * @param pageSize
     * @param authCode
     * @return
     */
    @GetMapping("pendingapplication")
    public Page<VisitorDto> pendingApplication(long pageNum, long pageSize, @RequestHeader("authCode") String authCode) {
        UserBasicInfoRes userBasicInfoRes = redisService.getUserInfo(authCode);
        return applyService.findPendingApplyByUserId(userBasicInfoRes.getUserId(), pageNum, pageSize);
    }
}

对controller接口注释后，执行mvn clean package或者在IDEA插件中选择smart-doc:html生成接口文档。生成的文档可以在 http://ip:端口/项目名/static/debug-all.html 查看，效果如图：接口地址、参数类型、参数意义等都是根据注释的代码生成。 smart-doc插件更多功能见官网。

wangran99/springboot3-template