在JeecgBoot项目中实现表主键自增的增强方案

背景介绍

JeecgBoot作为一款流行的快速开发框架，其Online表单功能默认使用UUID作为表的主键ID。这种设计虽然保证了全局唯一性，但在某些业务场景下并不理想，特别是当业务需要更直观、有序的数字ID时。

默认设计的局限性

框架默认采用UUID作为主键存在以下问题：

1. 可读性差：UUID是一串无意义的字符，不利于人工识别和记忆
2. 排序困难：UUID无法按插入顺序自然排序
3. 业务需求：某些业务场景需要连续的数字ID便于业务处理

解决方案设计

我们可以通过实现CgformEnhanceJavaInter接口来增强表单插入逻辑，实现数字自增ID功能。核心思路是：

1. 在数据插入前拦截操作
2. 查询当前表最大ID值
3. 为新记录设置递增后的ID值

具体实现代码

@Component("CgformEnhanceInsertSetId")
public class CgformEnhanceInsertSetId implements CgformEnhanceJavaInter {

    // 定义需要自增ID的表名映射
    private static final Map<String, Integer> predefinedMap;

    // 静态初始化需要增强的表
    static {
        predefinedMap = new HashMap<>();
        predefinedMap.put("库名.表名", 1); // 对应online表单开发中的表名
        // 可添加更多需要自增ID的表
    }

    @Autowired
    private JdbcTemplate jdbcTemplate; 

    @Override
    public void execute(String tableName, JSONObject json) throws BusinessException {
        // 检查当前表是否需要自增ID处理
        if(predefinedMap.containsKey(tableName)) {
            // 查询当前表最大ID值
            String sql = "SELECT COALESCE(MAX(id), 0) FROM " + tableName;
            Long maxId = jdbcTemplate.queryForObject(sql, Long.class);

            if (maxId != null) {
                // 设置递增后的ID
                json.put("id", ++maxId);
            }
        }
    }
}

实现要点解析

1. 表名映射管理：通过静态Map维护需要自增ID的表名，便于集中管理
2. 线程安全考虑：使用JdbcTemplate进行数据库操作，确保线程安全
3. 空值处理：使用COALESCE函数处理表为空的情况，默认从0开始
4. 增量处理：采用前置++操作符确保ID递增

使用注意事项

1. 并发控制：此方案在高并发场景下可能出现ID重复问题，应考虑：

   • 添加数据库锁
   • 使用序列(Sequence)
   • 或采用分布式ID生成方案

2. 表设计配合：确保数据库表的主键字段类型为数值型(如BIGINT)

3. 性能影响：每次插入前需要查询MAX(id)，对性能有一定影响，可考虑缓存机制

扩展思考

对于更复杂的业务场景，可以进一步优化：

1. 分表分库支持：增加分表逻辑，确保ID在分片环境下唯一
2. ID生成策略：支持多种ID生成算法(雪花算法等)
3. 配置化管理：将表名映射改为可动态配置的方式

总结

通过这种增强实现，我们可以在保持JeecgBoot框架原有功能的基础上，灵活地为特定表实现自增ID功能。这种方案既解决了业务需求，又保持了框架的扩展性，是一种实用的折中方案。开发者可以根据实际业务场景，进一步调整和优化这一实现。