基于 SpringBoot 3.5.6 开发的 Java 后端后台管理业务基础框架，常用的业务功能已经集成，开箱即用，相关使用说明，可以参考：

• 快速开始
• 指南

主要更新

3.5.1 将兼容使用 Gradle 管理项目，随着项目的体积越来越大，模块越来越多，在传统的 Maven 项目中，无论是编译或是打包运行，都让项目变得越来越缓慢，所以引入了 Gradle 的项目配置，新项目直接选择使用 Gradle 管理就行了，如果是老项目升级，可以参考：Maven 项目迁移到 Gradle

• 更新存在漏洞的相关依赖

在实际项目中，我们需要保存文件，比如用户上传的头像，或者上传的文档，一般不会保存到数据库中，而是保存到文件系统，比如本地文件系统，或者云存储。文件服务整合本地文件系统、阿里云OSS、MinIO、FastDFS，提供统一的接口操作文件的上传和下载删除操作，开发者后续也可以自行实现接口扩展。

除了已经集成的 RPC 框架（Spring Cloud OpenFeign、Apache Dubbo）之外，也提供了消息队列的解决方案，比如 Kafka、RabbitMQ 等。

基于 SpringBoot 3.2.5 开发的 Java 后端后台管理业务基础框架，常用的业务功能已经集成，开箱即用，相关使用说明，可以参考：

• 快速开始
• 指南

主要更新

工具包

• 核心模块
  • 【优化】WebSocket 优化
      1. 新增 topic 类型 system，用于系统发送消息，例如连接是否成功这种提示
      2. 消息载体改为 WSR（类似 R 对象），这种类似 http 接口的消息返回方式，让返回结构统一
      3. 新增了消息发送状态的判断方法以及默认的实现
      4. 优化了二进制传输
      5. 消息用户的反馈更精准（使用 session 绑定每次的消息）
  • 【优化】History 相关的都修改为 DBOperateHistory，因为有些 Bean 冲突问题
  • 【优化】修改部分 final class 为 record
  • 【修复】MyBatisUtil 获取 JSON 的时候需要做非空判断

    if (field.isAnnotationPresent(TableFieldJSON.class) && ObjectUtil.isNotEmpty(fieldValue))
  • 【修复】文件上传空文件拦截异常，如果上传了一个空的文件，比如一个空的 word 文件，就会报异常

    /**
     * 检测文件是否为空
    *
    * @param wordFile 文件
    */
    private static void checkWordFileEmpty(MultipartFile wordFile){
        if (isWordFileEmpty(wordFile)){
            throw new FileUploadException("上传文件不能为空");
        }
    }
  • 【修复】修复不合适的依赖

    import org.ehcache.impl.internal.concurrent.ConcurrentHashMap;
    修改为
    import java.util.concurrent.ConcurrentHashMap;
  • 【升级】为了让项目可以最小化运行，兼容了 Sqlite
    top 情况：

    top - 17:25:51 up 13 days, 6 min,  3 users,  load average: 0.00, 0.00, 0.00
    Tasks: 110 total,   2 running, 108 sleeping,   0 stopped,   0 zombie
    %Cpu(s):  0.2 us,  0.0 sy,  0.0 ni, 99.7 id,  0.2 wa,  0.0 hi,  0.0 si,  0.0 st
    MiB Mem :   1613.1 total,    143.8 free,    817.9 used,    819.9 buff/cache
    MiB Swap:      0.0 total,      0.0 free,      0.0 used.    795.2 avail Mem
    
      PID USER      PR  NI    VIRT    RES    SHR S  %CPU  %MEM     TIME+ COMMAND
    87183 root      20   0 3039528 505164  29056 S   1.0  30.6   1:59.76 java
    free 情况：

                  total        used        free      shared  buff/cache   available
    Mem:           1.6Gi       817Mi       143Mi       2.6Mi       819Mi       795Mi
    Swap:             0B          0B          0B

基于 SpringBoot 3.2.5 开发的 Java 后端后台管理业务基础框架，常用的业务功能已经集成，开箱即用，相关使用说明，可以参考：

• 快速开始
• 指南

主要更新

• 工具包

  • 核心模块
    • 新增 WebSocket 通用适配器，可以在 WebMVC 和 Spring WebFlux 中使用，详见使用示例：
    • 修复@TableFieldJSON注解转换类型为数据库（PGSQL）需要的 PGobject 时的异常现象
    • 第三方登录接口工具ApiGateWay优化，新增了不需要鉴权就直接获取数据的withInfoJSON方法，因为有些第三方接口本身就是免登录的，不一定需要鉴权信息

• 框架

  • 授权码模式鉴权优化，现在可以利用前端页面来实现获取授权码跳转，但是需要配置相关的链接：
    配置

    taybct:
      secure:
        auth:
          login-page:
            # 开启重定向到登录页面
            redirect: true
            # 登录页面
            redirect-login-page: https://127.0.0.1/#/login
            # 登录页面登录成功之后用于获取 code 的接口地址
            params-redirect-api: https://127.0.0.1/api/auth/oauth/authorize
            # 前端获取参数需要加密的 url 加密类型
            params-redirect-api-encode-type: uri_component
  • 优化一些描述不准确的注释
  • 去除不正确的POM依赖,Spring Gateway是基于WebFlux的，不需要用到Undertow
  • 优化鉴权服务器的默认配置，优化一些过时的方法
  • 修复更改头像的BUG
  • 菜单路由查询添加meta信息
  • 优化MyBatisX模板
    • 注释问题
    • 添加了适配Pure Admin的前端模板
  • 优化角色管理
    • 如果添加角色的时候未指定状态默认就是有效的状态
    • 角色也可以按部门来过滤，但是这个得需要有给角色设置部门的功能才行
  • 优化用户管理
    • 查看个人信息的时候把手机号也返回
    • 个人信息需要返回性别

• 便捷性

  • 优化后端业务代码模板
  • 新增适配后端的前端模板代码
  • 新增了与框架适配的前端后台管理模板代码 ，使用的时候需要接取spring-taybct分支的代码，不要拉main分支，因为，我会定期使用main分支同步原作者大佬的代码，只有spring-taybct分支是我做了框架适配的

websocket reactive 路径匹配，类似 @ServerEndpoint，但是这个注解是在 WebFlux 里面使用的

可以查看这个示例：exp-websocket-reactive

数据库表实体类

BaseEntity

基础实体类，包含主键、创建时间、更新时间、创建人、更新人五个基础字段，以及一个非数据库扩展字段expansion用于扩展数据传输等

DeleteLogicEntity

可以在需要启动运行的模块里面添加这个依赖

<!--启动模块-->
<dependency>
    <groupId>io.github.mangocrisp</groupId>
    <artifactId>spring-taybct-tool-launch</artifactId>
</dependency>