如何避免每个业务系统中都有几十个枚举查询

前端下拉框要查「支付方式有哪些」「费项类型有哪些」------每来一个枚举就写一个字典接口,重复且无趣。这套组件的做法是:枚举实现一个三元组接口、在注册表登个记,前端就能通用查询,新增枚举零接口代码。

怎么用

不用这套组件(传统写法)

每来一个枚举就抄一套 Controller + Service,新增一个字典就得改三处:

less 复制代码
// 支付方式字典接口
@GetMapping("payment-type/list")
public Result<List<DictDto>> paymentTypeList() {
    return Result.success(Arrays.stream(PaymentType.values())
        .map(e -> new DictDto(e.getCode(), e.getName()))
        .collect(Collectors.toList()));
}
​
// 费项类型字典接口......再抄一遍
@GetMapping("fee-type/list")
public Result<List<DictDto>> feeTypeList() { ... }
// 优惠类型、销售渠道、启用状态......每个枚举都要再抄一个接口

用了这套组件

新增一个枚举只需两步,不写任何接口代码:

① 枚举实现 BaseEnum 三元组:

arduino 复制代码
// business-domain: PaymentType
public enum PaymentType implements BaseEnum<String, String, String> {
    ALIPAY("alipay", "支付宝"),
    WECHAT("wechat", "微信支付"),
    BALANCE("balance", "余额"),
    BANK_CARD("bankCard", "银行卡");
​
    private final String code;
    private final String name;
    // getValue() 返回 code
}

② 在 BaseType 加一行注册:

vbnet 复制代码
// business-application: BaseType implements BaseEnum<String, String, String>
PAYMENT_TYPE("paymentType", "支付方式", PaymentType.class),
// ... 加一行即生效

前端调通用接口即可,baseType 传注册 code:

python 复制代码
GET open/value/object/list?baseType=paymentType      → 支付方式列表
GET open/value/object/map                            → 全部字典一次性返回

怎么实现的

1. 枚举契约:BaseEnum 三元组

csharp 复制代码
// foundation-domain: BaseEnum<T, I, J>
public interface BaseEnum<T, I, J> {
    T getCode();    // 业务 code(如 "alipay")
    I getName();    // 展示名(如 "支付宝")
    J getValue();   // 值
}

所有业务枚举同一形态,可被通用机制统一处理。

2. 注册表:BaseType

每个枚举在 BaseType 注册一项,可选拴一个 EnumFilter 做业务裁剪:

vbnet 复制代码
// business-application: BaseType implements BaseEnum<String, String, String>
PAYMENT_TYPE("paymentType", "支付方式", PaymentType.class),
DISCOUNT_TYPE("discountType", "优惠类型", DiscountType.class),
FEE_TYPE("feeType", "费项类型", FeeType.class),
SALES_CHANNEL("salesChannel", "销售渠道", SalesChannel.class),
ENABLE_STATUS("enableStatus", "启用状态", EnableStatus.class);

BaseType 把「枚举类」与「对外 code」绑定,新增枚举只加一行注册,Controller/Service 一行不改。

3. 通用接口:一个 Controller 通吃

less 复制代码
// business-web: ValueObjectController  (路径 open/value/object)
@GetMapping("list")
public Result<List<ValueObjectDto>> list(@RequestParam BaseType baseType) {
    return Result.success(valueObjectService.valueList(baseType));
}
@GetMapping("map")
public Result<Map<String, List<ValueObjectDto>>> map() {
    return Result.success(valueObjectService.valueMap());   // 一次性返回全部,按 code 分组
}

@RequestParam BaseType 直接接收枚举 code 字符串反查为 BaseType(BaseType.codeOf 走 EnumUtils.codeOf)。

4. 服务实现:反射读常量

scss 复制代码
// business-application: ValueObjectServiceImpl
public List<ValueObjectDto> valueList(BaseType baseType) {
    BaseEnum[] constants = baseType.getEnumClass().getEnumConstants();
    List<ValueObjectDto> list = Arrays.stream(constants)
        .map(e -> new ValueObjectDto(e.getName(), e.getName(), e.getCode().toString()))
        .collect(Collectors.toList());
    if (baseType.getFilter() != null) {
        EnumFilter filter = findFilter(baseType);     // 按业务上下文裁剪
        if (filter != null) list = filter.filterValue(list);
    }
    return list;
}

getEnumConstants() 直接取枚举项,无需为每类枚举写字典转换;EnumFilter 让同一枚举在不同业务上下文露出不同可选项(如某渠道只支持部分支付方式)。

vbnet 复制代码
枚举 implements BaseEnum(code / name / value)
        │
        ▼
BaseType 注册表("paymentType" → PaymentType.class,可拴 EnumFilter)
        │
        ▼
ValueObjectController(open/value/object)
   GET list?baseType=paymentType        GET map(全部字典一次性返回)
        │
        ▼
ValueObjectServiceImpl
   getEnumClass().getEnumConstants() 反射取枚举项
        ├─ 映射成 ValueObjectDto
        └─ EnumFilter 按业务上下文裁剪(如某渠道只支持部分支付方式)
​
新增枚举:① implements BaseEnum   ② BaseType 加一行   ------ 零接口代码

关键点

  • 契约驱动 :BaseEnum 统一 code/name/value 三元组,所有业务枚举同一形态,可被通用机制处理。
  • 注册表解耦 :BaseType 把「枚举类」与「对外 code」绑定,新增枚举只加一行注册,Controller/Service 一行不改。
  • 反射读常量 :getEnumConstants() 直接取枚举项,无需为每类枚举写字典转换。
  • 按业务裁剪 :EnumFilter 让同一枚举在不同业务上下文露出不同可选项(如某渠道只支持部分支付方式),扩展点干净。
  • 批量拉取 :map 接口一次性返回所有枚举字典,前端首屏加载省去多次请求。
相关推荐
ServBay11 分钟前
Local harness 将退役,VS Code 本地开发要不要搬到云端?
后端·ai编程·visual studio code
ashiho43 分钟前
【LeetCode hot 100】3. 无重复字符的最长子串 (三种解法)
java·数据结构·后端·算法·leetcode·滑动窗口
张一凡932 小时前
你的 AGENTS.md,真的管到模型写代码了吗?
前端·后端·agent
00后程序员2 小时前
iOS 实时活动怎么开发,Windows 上用 KXBuild 和 ActivityKit 写灵动岛
后端·ios
程序员cxuan2 小时前
推荐 10 个 WorkBuddy 中的邪修用法
人工智能·后端·程序员
Bacon2 小时前
给项目做一次"全身 CT":Agent Skills 生态里的代码体检全链路
前端·人工智能·后端
Java旅途2 小时前
课程表编排与调课申请系统|排得开,也能把每次调整管清楚
后端
象牙塔五六七3 小时前
Java 泛型精讲:从 Stream 源码说起
后端
掘金挖土3 小时前
前端手摸手跑路之 AI 应用开发(十二)
前端·后端
程序员cxuan3 小时前
GPT-6.2 Astra 发布了,但口碑崩了。。。
人工智能·后端·程序员