一、背景与动机

在日常开发中，我们经常会遇到以下几类需求：

• 敏感字段加密手机号、身份证号、银行卡号需要入库加密、查询解密
• 数据权限隔离不同部门/租户的数据需要隔离。查询时需要拼接对应的 WHERE 条件
• 异构数据库迁移项目从 MySQL 迁移到达梦等国产数据库，很多 SQL 语法不兼容，需要重写
• 字段自动填充创建时间、修改人、租户 ID 等字段需要在插入和更新时频繁维护

市面上的方案，要么只能兼容部分写法，要么要求在 Controller、Service、Mapper、入参响应层进行大量改动。一张业务表的加密功能，可能需要修改项目中十几处甚至几十处代码。不过，

sangsang 的目标就是：对业务代码零侵入。一处标注，全局生效，

是一个基于 MyBatis 拦截器的透明数据治理框架。通过动态 SQL 解析引擎在 SQL 执行前后自动 SQL，实现对业务代码零侵入的数据治理。

主要设计理念这方面，

• 零侵入所有 Controller、Service、Mapper、入参响应层都不需要改动。只在 @TableName 标注的实体类字段上做标注
• 全局生效一处标注，全项目应用。不需要在每一个 Mapper 方法上加注解
• 灵活 支持自定义策略和算法
• 性能调整LRU 缓存 SQL 解析结果，避免重复解析

说到技术栈。Java + MyBatis + JSQLParser 开源协议这方面，Apache License 2.0

三、主要功能

字段加解密

说到最常见的场景，使用者表中存储了手机号、身份证号等敏感信息，需要在入库时加密、查询时解密。

sangsang 提供两种加密模式：

模式	原理	特点

db 模式 : 利用数据库自身的加解密函数。框架自动 SQL，支持密文模糊查询，支持列运算。

pojo 模式 : 在 Java 层对 SQL 入参和响应进行加解密处理。算法选择性强，无数据库计算开销。

db 模式工作原理：

-- 原始 SQL
SELECT user_name,phone FROM tb_user WHERE phone =?-- 框架自动
后
SELECT
数据库解密函数 AS phone。user_name
FROM tb_user
WHERE phone = 数据库加密函数

pojo 模式工作原理：

-- 不改变执行的 sql
-- 在 mybatis 执行 sql 前后将入参和响应的字段调用 java 代码自动加解密处理

快速接入 - 字段加解密

Step 1 ：引入依赖

io.gitee.tired-of--water
sangsang-core
-alpha

Step 2 ：开启配置

# 配置实体类扫描方法
sangsang.scanEntityPackage=com.sangsang.*.entity
# 加密模式：db 或 pojo
sangsang.encryptor.patternType=db
# 自定义密钥
sangsang.encryptor.secretKey=TIREDTHEWATER

Step 3 ：创建 @TableName 实体类并标注字段

@TableName // 标识这个是 tb_user 表的实体类
public class User {
@FieldEncryptor // 标识这个字段需要密文存储，采用默认的算法
private String phone;@FieldEncryptor // 标识这个字段需要密文存储，采用默认的算法
private String idCard;}

完成以上三步后项目中所有涉及 Tb_user/Pho​ne​/idCard​/Phone​/IDCard​... 等字段的 SQL 均会自动处理加解密，包括 INSERT、UPDATE、SELECT 还有 WHERE 条件中的各种场景。

至于C​​亮点。密文模糊查询

C​​更多能力 - 加解密

• : 不同 字段 可以 使用 不同 的 加 密 算 法，通 过 @FieldEncryptor 指 定。
• 自定义 算法 ： 实现 FieldEncryptorStrategy 接口 即 可 扩 展。
• 分库分表 支持 ： 通 过 @ShardingTableEncryptor 注 解 + ShardingTableStrategy 接口，避免 为 每 张 分 表 重复 创建 实体 类。
/ul

C​​异构数据库语法转换

• MySQL -> 达梦 : 已 完 成，有 项目 生产 验证。/ li>
• Oracle -> MySQL : 开 发 中，当前仅实现了 SELECT 常见语法 的 转换。/ li> /ul>

 -- 原始 MySQL 语法 SELECT `user_name`,`phone` FROM `tb_user` WHERE `user_name` LIKE 'admin%' SELECT DATE_FORMAT FROM tb_user -- 自动转换为达梦语法 SELECT "user_name"。"phone" FROM "tb_user" WHERE "user_name" LIKE 'admin%' SELECT TO_CHAR FROM tb_user / code>

框架自动处理 ： 反 引号 转 双 引号 、 日期 函数 转 换 、 分页语法 转 换 、 标识符 转 换 等。/ p>

C​​快速接入 - 异构转换

      io.gitee.tired-of--water      sangsang-core      -alpha  

 #选择语法转换模式 sangsang.transformation.patternType=mysql2dm 

略

---