枚举实现多态分支是轻量级物流状态管理最简洁方式:每个状态通过重写onevent方法定义自身流转逻辑,配合事件枚举保障类型安全,支持前置校验、终态判断等通用能力,且避免业务逻辑嵌入。

直接用枚举实现多态分支,是轻量级项目中管理物流状态转换最简洁、可读性最强的方式。它不依赖外部框架,编译期类型安全,逻辑集中,新增状态或调整流转规则只需改枚举本身。
用抽象方法定义状态行为
让每个枚举常量自行决定“收到某个事件后该变成什么状态”,把转换逻辑下放到具体枚举项里,而不是堆在外部 switch 或 if-else 中。
例如物流状态枚举:
- PENDING:订单刚创建,只允许触发“揽收”事件 → 转为 PICKED_UP
- PICKED_UP:只接受“发车” → IN_TRANSIT;拒绝“签收”等非法操作
- IN_TRANSIT:支持“到达中转站”“异常滞留”“签收完成”等不同事件,各自返回对应后续状态
代码结构类似:
public enum ShippingStatus {
PENDING {
@Override
public ShippingStatus onEvent(ShippingEvent event) {
return event == ShippingEvent.PICKUP ? PICKED_UP : null;
}
},
PICKED_UP {
@Override
public ShippingStatus onEvent(ShippingEvent event) {
return switch (event) {
case DEPART -> IN_TRANSIT;
case CANCEL -> CANCELLED;
default -> null;
};
}
},
IN_TRANSIT {
@Override
public ShippingStatus onEvent(ShippingEvent event) {
return switch (event) {
case ARRIVE_HUB -> AT_HUB;
case SIGN_FOR -> DELIVERED;
case EXCEPTION -> ON_HOLD;
default -> null;
};
}
},
// 其他状态...
public abstract ShippingStatus onEvent(ShippingEvent event);
}
配合事件枚举做类型安全驱动
把“动作”也定义成枚举(如 ShippingEvent.PICKUP、ShippingEvent.SIGN_FOR),避免字符串传参或 int 编码带来的运行时错误。
这样调用时非常清晰:
currentStatus = currentStatus.onEvent(ShippingEvent.SIGN_FOR);- 如果返回
null,说明当前状态不支持该事件,可统一抛出业务异常 - IDE 能自动补全事件类型,编译器能提前拦截非法调用
封装校验与默认行为
在枚举基类中补充通用逻辑,减少重复代码:
- 加一个
canAccept(ShippingEvent)方法,内部调用onEvent()并判空,用于前置校验 - 提供
getDisplayName()返回中文描述,方便日志和前端展示 - 增加
isTerminal()判断是否为终态(如 DELIVERED、CANCELLED),用于流程终止检查
这些方法都写在枚举内,对外隐藏实现细节,使用者只需关心“我能做什么”和“做完变成什么”。
避免常见陷阱
实际落地时要注意几点:
- 不要在
onEvent里写复杂业务逻辑(如调库存、发消息),只做状态判断;真正执行动作应由上层服务协调 - 枚举声明顺序无关紧要,别误用
ordinal()做流转校验——物流状态不是严格线性演进,可能跳步或回退(如异常后恢复) - 如果某状态对多数事件都不响应,显式返回
null比抛异常更合适;统一由调用方处理“不支持的操作” - 测试时可遍历所有
values(),对每个状态触发全部事件,验证返回结果是否符合预期,覆盖率高且容易自动化











