枚举是编译期静态类型，不能动态映射字典表，但可通过注解+工具类实现语义一致的双向转换与运行时校验；核心是让枚举成为字典表的“可验证契约”，而非替代。
Java 枚举类本身是编译期确定的静态类型，无法直接“动态”映射数据库字典表；但可以通过约定 + 工具层设计，让枚举在运行时与字典表保持语义一致、支持查库补充、校验和转换。关键不是让枚举变动态，而是让枚举成为字典表的“可验证契约”。
用枚举定义业务语义，字典表负责运行时扩展
枚举不替代字典表，而是作为核心业务状态的“可信快照”。比如订单状态：
- 枚举 OrderStatus 定义 PENDING、PAID、SHIPPED、COMPLETED —— 这些是代码中明确允许、逻辑强依赖的状态
- 数据库 sys_dict 表（或专用 order_status 表）存储所有可能值，含 code（同枚举名）、label、sort、enabled 等字段
- 枚举只包含当前系统已实现、需强校验的状态；新增状态（如 REFUNDED）先加枚举、再同步插入字典表 —— 保证代码与数据口径一致
提供双向转换工具类，避免硬编码字符串
写一个通用工具类（如 DictMapper），封装枚举 ↔ 字典记录的转换逻辑：
-
toEnum(String code, Class
enumClass) ：根据 code 查缓存（如 ConcurrentHashMap）或查库，返回对应枚举；查不到抛自定义异常（如 DictCodeNotFoundException） - toLabel(E e)：优先从枚举自身的 getLabel() 方法取（推荐）， fallback 到查字典表获取 label（用于兼容未在枚举中声明但 DB 存在的旧数据）
- 启动时预热：扫描所有枚举类，读取其 @DictTable("order_status") 注解，批量加载对应字典表有效数据到本地缓存
用注解驱动元信息，解耦枚举与 SQL
给枚举类和枚举常量加轻量注解，描述映射关系：
- @DictTable("order_status") 放在枚举类上，声明所属字典表
- @DictCode("PAID") 可选：显式指定 code 值（默认用枚举名大写）
- @DictLabel("已支付") 可选：覆盖默认中文名（便于 i18n 或前端直出）
- 这样工具类无需硬编码表名/字段，也不需要为每个枚举写 DAO —— 通过反射 + 注解自动适配
运行时校验与兜底策略要明确
生产环境必须处理“DB 有、枚举没有”的情况，不能简单失败：
- 入库前校验：接收外部 code（如 API 参数）时，先调 toEnum(code, OrderStatus.class)；若失败且是关键字段，拒绝请求
- 查询展示：前端需要 label 时，优先用枚举的 getLabel()；若枚举无此值，查字典表返回 label，并打 warn 日志（提示需补枚举）
- 后台管理页：字典维护界面应校验新增 code 是否已在对应枚举中存在，避免遗漏——可加定时任务扫描字典表对比枚举类
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
