主页 | Mango Crisp

个人博客

个人博客（GitHub Pages）

个人博客

个人博客（GitLab Pages 或将不能继续使用）

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 分钟

ServerReactiveEndpoint

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

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

Mango Crisp2025年6月20日小于 1 分钟

通用业务代码

相关信息

对于数据库表的增删改查，这里封装了通用的抽象类，方便后续业务开发，这里，主要封装了通用的增删改查方法，以及通用的分页查询方法

数据库表实体类

BaseEntity

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

DeleteLogicEntity

Mango Crisp2025年6月6日大约 7 分钟

启动模块

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

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

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

工具类

相关信息

提供了一些方便业务开发的工具类，一些好用的通用工具类也有依赖进来，可以直接使用，例如：Hutool

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

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 分钟

OnlyOffice+VUE3+Java+OSS 实现在线协同编辑文档

在开发过程中需要这样的问题，客户需要在线编辑文档，能达到类似腾讯文档那样的协作编辑等一些功能，那么如何实现呢？手撸肯定是不够的，那么有没有现成的解决方案呢？答案是肯定的，今天就分享一下我使用的解决方案。

准备工作

docker 环境
简单的 OSS 服务（支持上传下载文件）
VUE、Java 环境等

提示

强烈建议使用 docker，因为 OnlyOffice 的依赖比较复杂（我已经替各位踩过坑了，头皮发麻），如果本地环境不方便，可以使用 docker 来快速搭建环境。

Mango Crisp2025年4月4日大约 9 分钟

数据权限范围

相关信息

为了解决系统数据权限范围过滤问题，可以使用 @DataScope 注解，目前开发了基础版本，后续会陆续完善。
在使用注解前，需要了解，什么是数据权限，数据权限，即，基于用户/角色关联绑定的部门，管理区域等一系列有父子级关系，或者无父子级关系的有标签性质的数据，单纯因为用户/角色关联了这些数据，用户再去访问/操作其他和这些权限关联的数据的时候，过滤掉用户/角色没有关联对应的权限数据的数据的操作，我们可以称之为数据权限过滤。在通常情况下，我们过滤数据权限，会写大量的过滤 sql ，或者大量的过滤逻，这里我们总结了这些过滤逻辑的通用情况下的操作，这里编写成了注解

Mango Crisp2025年2月13日大约 6 分钟

数据库兼容

相关信息

如果前端就知道了有后期更新数据库类型的可能性，便可以在开发的过程就做就好兼容性，方便后续直接切换数据库

怎么使用

这里兼容主要是基于 mybatis-plus 提供的便利性

这里，我在 spring-taybct-tool-mybatis 模块里面做了 Mybatis-plus 的基础配置，配置里面就有加入了方言的配置

    @Bean
    public DatabaseIdProvider databaseIdProvider() {
        VendorDatabaseIdProvider databaseIdProvider = new VendorDatabaseIdProvider();
        Properties properties = new Properties();
        properties.put("Oracle", "oracle");
        properties.put("MySQL", "mysql");
        properties.setProperty("PostgreSQL", "postgresql");
        properties.setProperty("DB2", "db2");
        properties.setProperty("SQL Server", "sqlserver");
        databaseIdProvider.setProperties(properties);
        return databaseIdProvider;
    }

Mango Crisp2025年2月13日大约 2 分钟

强制下线

相关信息

强制登出用户的时候，需要处理用户缓存，或者修改了角色，需要强制拿出这些角色相关的用户的话，需要开发人员自行决定是否要这样做。下面这两个配置类，需要放在 system 模块下

用户处理

@Component
@RequiredArgsConstructor
public class LoginCacheClear implements ILoginCacheClear {

    final RedisTemplate<Object, Object> redisTemplate;

    @Override
    public void accept(Collection<SysUser> sysUsers) {
        redisTemplate.delete(sysUsers.stream()
                .map(user -> Arrays.asList(
                        //TODO 这里有多少种登录方式就得加多少种，用户名，包含了邮箱
                        CacheConstants.OAuth.USERNAME + "::" +user.getUsername(),
                        CacheConstants.OAuth.OPENID + "::" + user.getUsername(),
                        CacheConstants.OAuth.PHONE + "::" + user.getPhone(),
                        CacheConstants.OAuth.USERID + "::" + user.getId()
                ))
                .flatMap(Collection::stream)
                .collect(Collectors.toSet()));
    }
}

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

Mango Crisp 的小破站

主要更新

数据库表实体类

BaseEntity

DeleteLogicEntity

主要更新

准备工作

怎么使用

用户处理