标签: 发布日志

3.5.1

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

主要更新

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

Mango Crisp2025年11月28日大约 4 分钟

3.5.0

重要！重要！

介于开源需要，本项目已经由组织 TayBct 来维护，原来的部分仓库已经转移到组织 TayBct 的项目下，请移步

Mango Crisp2025年10月27日大约 6 分钟

3.2.4

基于 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

Mango Crisp2025年9月28日大约 5 分钟

3.2.3

基于 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分支是我做了框架适配的

Mango Crisp2025年8月20日大约 3 分钟

3.2.2

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

主要更新

工具包

核心模块

SM2 16进制加密字符串公/私钥加载为密钥key方法
Excel 导出工具
- 配置字典翻译器
- 导出配置可以直接设置
- 纵向合并相同单元格
MybatisPlus
- 不能动态的判断数据库类型，如果存在多个数据源的情况就不能准确的去判断当前连接的数据源类型，现在可以通过${_database_id_}来得到连接的数据库类型，用以替代 ${_databaseId}（单数据源的情况下还是可以正常使用 ${_databaseId}）
DBFieldUtil
- 忽略掉打了忽略标签的字段导出
- 默认合并相同项
TreeUtil 树结构工具优化
- 不改变原数据类型
- 可自定义排序规则
- 不排序或者按数据排序可以实现100万数据在 500 毫秒内完成生成树和排序
- 不限定 root 节点
- 可以指定排除某些节点

数据同步工具

新增库对库数据同步工具：io.github.mangocrisp.spring.taybct.tool.core.ds.sync,目前实现了PGSQL ORACLE MySQL 三库之前的库对库流式同步，并且提供了 IDataSyncHandler 接口用于扩展，你还可以同步其他类型的数据库，只需要实现 IDataSyncHandler 接口即可

示例代码

import io.github.mangocrisp.spring.taybct.tool.core.ds.sync.DataSyncConfig;
import io.github.mangocrisp.spring.taybct.tool.core.ds.sync.DataSyncService;
import io.github.mangocrisp.spring.taybct.tool.core.ds.sync.DriverType;
import lombok.extern.slf4j.Slf4j;
import org.junit.Test;
import org.springframework.boot.test.context.SpringBootTest;

/**
* <pre>
* 同步数据测试（流式）
* </pre>
*
* @author XiJieYin
* @since 2025/4/15 11:35
*/
@SpringBootTest
@Slf4j
public class SyncDataTest {

    @Test
    public void test1() {
        DataSyncService dataSyncService = new DataSyncService();
        dataSyncService.sync(DataSyncConfig.builder()

                // 读取
                // postgresSQL
//                .sourceDriver(DriverType.postgresSQL)
//                .sourceUrl("jdbc:postgresql://192.168.1.28:5432/tianhe-police-intelligence?currentSchema=public")
//                .sourceSchema("public")
//                .sourceUser("postgres")
//                .sourcePass("password")
//                .sourceTable("PLSG_TRAVEL_APPLY")
//                .sqlSelect("SELECT * FROM PLSG_TRAVEL_APPLY WHERE CREATE_TIME > ?::TIMESTAMP")

                // MySQL
//                .sourceDriver(DriverType.mysqlCJ)
//                .sourceUrl("jdbc:mysql://localhost:3306/plsg?useSSL=false&useUnicode=true&characterEncoding=utf-8&zeroDateTimeBehavior=convertToNull&transformedBitIsBoolean=true&tinyInt1isBit=false&allowMultiQueries=true&serverTimezone=GMT%2B8")
//                .sourceSchema("plsg")
//                .sourceUser("root")
//                .sourcePass("password")
//                .sourceTable("PLSG_TRAVEL_APPLY")
//                .sqlSelect("SELECT * FROM PLSG_TRAVEL_APPLY WHERE CREATE_TIME > ?")

                // oracle
                .sourceDriver(DriverType.oracle7AndThen)
                .sourceUrl("jdbc:oracle:thin:@192.168.1.28:1521/ORCL")
                .sourceSchema("PLSG")
                .sourceUser("PLSG")
                .sourcePass("PLSG")
                .sourceTable("PLSG_TRAVEL_APPLY")
                .sqlSelect("SELECT * FROM PLSG_TRAVEL_APPLY WHERE CREATE_TIME > TO_DATE(?,'yyyy-MM-dd HH24:mi:ss')")

                // 写入
                // postgresSQL
                .targetDriver(DriverType.postgresSQL)
                .targetUrl("jdbc:postgresql://192.168.1.28:5432/tianhe-police-intelligence?currentSchema=public")
                .targetSchema("public")
                .targetUser("postgres")
                .targetPass("password")
                .targetTable("plsg_travel_apply")
                .fieldUniqueKye("id")
                .fieldLastSyncTime("CREATE_TIME")
                .sqlLastSyncTime("SELECT MAX(CREATE_TIME) CREATE_TIME FROM plsg_travel_apply")

                // mysql
//                .targetDriver(DriverType.mysqlCJ)
//                .targetUrl("jdbc:mysql://localhost:3306/plsg?useSSL=false&useUnicode=true&characterEncoding=utf-8&zeroDateTimeBehavior=convertToNull&transformedBitIsBoolean=true&tinyInt1isBit=false&allowMultiQueries=true&serverTimezone=GMT%2B8")
//                .targetSchema("plsg")
//                .targetUser("root")
//                .targetPass("password")
//                .targetTable("plsg_travel_apply")
//                .fieldLastSyncTime("CREATE_TIME")
//                .sqlLastSyncTime("SELECT MAX(CREATE_TIME) CREATE_TIME FROM plsg_travel_apply")

                // oracle
//                .targetDriver(DriverType.oracle7AndThen)
//                .targetUrl("jdbc:oracle:thin:@192.168.1.28:1521/ORCL")
//                .targetSchema("PERSONNEL")
//                .targetUser("PERSONNEL")
//                .targetPass("PERSONNEL")
//                .targetTable("PLSG_TRAVEL_APPLY")
//                .fieldLastSyncTime("CREATE_TIME")
//                .sqlLastSyncTime("SELECT MAX(CREATE_TIME) CREATE_TIME FROM PLSG_TRAVEL_APPLY")
                .build());
    }
}

PGobject 优化
- PGSQL 利用 MyBatis 查询回来的 JSON 数据类型会封装成 PGobject 对象，所以这个对象如果直接返回到前端，前端需要再获取一层里面的 json 属性，并且还需要再转换一遍 JSON.parse(json)，这里添加了 ToJSONObjectSerializer和ToJSONArraySerializer，搭配 @JsonSerialize() 注解可以来实现将 PGobject 对象转成 JSON 对象或者 JSON 数组。
- 现在可以直接存 JSON 对象或者 JSON 数组到数据库，但是 Bean 的属性的类型还是得用 Object，MyBatisUtil 会做处理转成 PGobject 存储到数据库

任务调度
- 基于 Redis 加锁实现分布式定时任务优化获取本机 ip 地址的方法
- 新增尝试执行一次任务，可以直接绕过时间限制来直接运行一次任务
文件模块
- FileServiceBuilder
  - 现在可以通过网址来转存文件，输入文件的地址，即可转存文件

框架
- 代码优化
  - 菜单获取树结构优化
- 依赖优化
  - gateway 是基于 webflux 的，不需要用到 undertow，这里排除不需要的依赖项
- 便捷性
  - 优化后端业务代码模板
    - 实体类添加注解@Accessors(chain = true),让生成的 setter 方法返回 this，从而支持链式调用，注意：如果搭配@TableField(fill = FieldFill.INSERT_UPDATE)等设置默认值的注解使用链式调用时，请谨慎使用 @Accessors(chain = true)，可能会出现类型错误
  - 优化适配后端的前端模板代码
    - ElTooltip 的使用，如果搭配 ElFormItem 使用需要指定 :trigger-keys="[]" 不然就会出现需要输入空格的 BUG

Mango Crisp2025年6月3日大约 4 分钟

3.5.2

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

主要更新

3.5.2 主要更新了工具升级和一些业务功能，以及修复一些配置错误

工具包

Mango Crisp2025年3月10日大约 1 分钟

3.5.3

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

主要更新

3.5.3 定时任务，控制台日志管理功能 、 SQL注入的安全问题相关优化 、解决WebSocket 多模块并发问题

Mango Crisp2025年3月10日大约 7 分钟

3.2.1

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

主要更新

工具包
- 核心模块
  - 新增注解：@SyncToAnywhere
- 文件模块
  - OSS 去掉一些无用配置
框架
- 安全
  - 新增接口白名单访问功能
  - 黑/白名单过滤 ip 支持过滤 CIDR 匹配 ip 规则
  - 删除原来的配置
```
taybct:
  secure:
    ignore:
      urls:
    black-list:
      urls:
```
    修改为：
```
taybct:
  secure:
    ignore:
      uris:
    black-list:
      uris:
```
- 便捷性
  - 优化后端业务代码模板
  - 新增适配后端的前端模板代码

Mango Crisp2025年2月12日大约 1 分钟

3.2.0

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

Mango Crisp2025年1月8日小于 1 分钟