Java中用枚举定义合法状态集、包装类封装校验逻辑，构建类型安全、可校验、易扩展的状态表达体系：枚举杜绝魔法值，包装类强制通过工厂方法构造并校验，Service/Controller层统一使用，结合Optional提升空安全。
Java 中用包装类配合枚举处理业务状态码，核心不是“用 Integer 还是 int”，而是构建**类型安全、可校验、易扩展**的状态表达体系。关键在于：枚举定义语义明确的状态集，包装类（如 StatusCode）封装校验逻辑，二者协同把“数字魔数”变成有行为、可约束的对象。
用枚举定义合法状态集，杜绝魔法值
状态码本质是有限、有含义的取值范围。直接用 int 或 Integer 无法约束传入值是否合法，容易出现 new StatusCode(999) 这类无效构造。
正确做法是让枚举成为唯一合法状态来源：
public enum BizStatus {
SUCCESS(200, "操作成功"),
NOT_FOUND(404, "资源不存在"),
INVALID_PARAM(400, "参数错误"),
SYSTEM_ERROR(500, "系统异常");
private final int code;
private final String message;
BizStatus(int code, String message) {
this.code = code;
this.message = message;
}
public int getCode() { return code; }
public String getMessage() { return message; }
}
这样所有状态都来自枚举常量，语义清晰，IDE 可补全，编译期防错。
立即学习“Java免费学习笔记（深入）”；
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
自定义包装类封装校验逻辑，拒绝非法构造
包装类不是简单套一层 Integer，而是承担“准入校验”职责。它应禁止通过任意数字构造，只允许从合法枚举或已知有效值创建：
public final class StatusCode {
private final int value;
// ✅ 只允许从枚举构造
private StatusCode(int value) {
this.value = value;
}
// ✅ 入口唯一：必须传入枚举
public static StatusCode of(BizStatus status) {
return new StatusCode(status.getCode());
}
// ✅ 可选：支持从已知合法整数构造（需白名单或范围检查）
public static StatusCode of(int rawCode) {
// 检查是否在已知业务状态范围内（例如 200-600）
if (rawCode < 200 || rawCode > 600) {
throw new IllegalArgumentException("Invalid status code: " + rawCode);
}
return new StatusCode(rawCode);
}
// ✅ 提供安全获取方式，避免暴露原始值
public int getValue() { return value; }
public boolean isSuccess() { return value == BizStatus.SUCCESS.getCode(); }
public String getReason() {
return Arrays.stream(BizStatus.values())
.filter(s -> s.getCode() == value)
.map(BizStatus::getMessage)
.findFirst()
.orElse("未知状态");
}
}
这样外部无法写出 new StatusCode(123)，强制走 of() 工厂方法，校验逻辑集中可控。
在 Service/Controller 层统一使用包装类入参与返回
把校验前移到调用入口，避免层层传递原始 int 后再判断：
- Controller 接收时用枚举或包装类（推荐枚举，更语义化）：
public ResponseEntity> handle(@RequestParam BizStatus status) - Service 返回结果封装为带
StatusCode的 DTO：public ResultDTO<string> processOrder() { return ResultDTO.success("ok", StatusCode.of(BizStatus.SUCCESS)); }</string> - 跨服务调用时，DTO 中的 status 字段类型设为
StatusCode，并提供 JSON 序列化适配器（如 JacksonJsonDeserializer），确保反序列化时自动校验。
补充：结合 Optional 与断言强化空安全与流程控制
包装类可自然融入函数式风格，避免 null 状态码：
// 查询状态码，可能为空
public Optional<StatusCode> getStatusByOrder(String orderId) {
Integer raw = dao.findStatus(orderId);
return Optional.ofNullable(raw)
.map(StatusCode::of); // 自动校验，非法值会抛异常
}
// 使用时无需判空，直接 map/filter
return getStatusByOrder(id)
.filter(StatusCode::isSuccess)
.map(s -> "处理成功：" + s.getReason())
.orElse("状态异常或未找到");
也可在关键路径加断言：
Objects.requireNonNull(status, "状态码不可为空");<br>
if (!BizStatus.contains(status.getValue())) { throw new BizException("非法状态码"); } 
