跳至主要內容
通用业务代码

相关信息

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

数据库表实体类

BaseEntity

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

DeleteLogicEntity

Mango Crisp2025年6月6日大约 6 分钟代码笔记后端JavaSpringBootSpring Taybct开发框架轮子
启动模块

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

<!--启动模块-->
<dependency>
    <groupId>io.github.mangocrisp</groupId>
    <artifactId>spring-taybct-tool-launch</artifactId>
</dependency>
Mango Crisp2025年6月6日小于 1 分钟代码笔记后端JavaSpringBootSpring Taybct开发框架轮子
工具类

相关信息

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

Mango Crisp2025年6月6日小于 1 分钟代码笔记后端JavaSpringBootSpring Taybct开发框架轮子
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 分钟代码笔记后端JavaSpringBootSpring Taybct开发框架发布日志
数据权限范围

相关信息

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

Mango Crisp2025年2月13日大约 6 分钟代码笔记后端JavaSpringBootSpring Taybct开发框架指南
数据库兼容

相关信息

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

怎么使用

这里兼容主要是基于 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 分钟代码笔记后端JavaSpringBootSpring Taybct开发框架指南
强制下线

相关信息

强制登出用户的时候，需要处理用户缓存，或者修改了角色，需要强制拿出这些角色相关的用户的话，需要开发人员自行决定是否要这样做。下面这两个配置类，需要放在 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 分钟代码笔记后端JavaSpringBootSpring Taybct开发框架指南
MyBatis 额外参数配置

相关信息

我们在做数据库操作，写 xml sql 语句的时候，一些通用的参数，或者我们想添加一个并不是实体类里面有的参数，我们的处理方式可能是加一个 VO，或者 DTO 类来实现，或者是在方法里面多写一些的参数，但是，其实可以把这些参数，通过 MyBatis 拦截器的方式添加到参数里面，然后就可以在 XML 里面调用来写动态 SQL 了，框架使用了 MyBatisExtraParamsInterceptor 拦截器用来添加额外参数

Mango Crisp2025年2月13日大约 4 分钟代码笔记后端JavaSpringBootSpring Taybct开发框架指南
任务调度

相关信息

在项目开发中如果需要让程序自动在某个时刻去执行一些命令，就需要使用到任务调度

如何使用

引入依赖 spring-taybct-tool-scheduling

        <!--任务调度-->
        <dependency>
            <groupId>io.github.mangocrisp</groupId>
            <artifactId>spring-taybct-tool-scheduling</artifactId>
        </dependency>
Mango Crisp2025年2月13日大约 3 分钟代码笔记后端JavaSpringBootSpring Taybct开发框架指南
Sentinel 网关限流

官网

https://sentinelguard.io/zh-cn/

限流规则

  • resource 资源名，资源名是限流规则的作用对象
  • count 限流阈值
  • grade 限流阈值类型，QPS 模式（1）或并发线程数模式（0） QPS 模式
  • limitApp 流控针对的调用来源 default，代表不区分调用来源
  • strategy 调用关系限流策略：直接、链路、关联 根据资源本身（直接）
  • controlBehavior 流控效果（直接拒绝 / 排队等待 / 慢启动模式），不支持按调用关系限流 直接拒绝
  • clusterMode 是否集群限流 否
Mango Crisp2025年2月13日大约 9 分钟代码笔记后端JavaSpringBootSpring Taybct开发框架指南
Mango Crisp 的小破站
Copyright © 2025 Mango Crisp Apache 2.0 Licensed