【Java 枚举类型的 3 种核心应用场景】
场景 1:状态 / 类型定义(最常用场景)
核心思想
用枚举常量替代零散的 “魔法数字” 或字符串,将系统中固定的状态、类型封装成统一的枚举集合,既避免了非法值的传入,又大幅提升了代码的可读性和可维护性。
代码示例:订单状态枚举
java
/**
* 订单状态枚举
* 定义订单的所有合法状态,替代传统的0/1/2魔法数字
*/
public enum OrderStatus {
// 枚举常量:每个常量对应一种订单状态
UNPAID(0, "未支付"),
PAID(1, "已支付"),
SHIPPED(2, "已发货"),
COMPLETED(3, "已完成"),
CANCELLED(4, "已取消");
// 状态码
private final int code;
// 状态描述
private final String desc;
// 枚举构造方法(必须为private,默认也是private)
OrderStatus(int code, String desc) {
this.code = code;
this.desc = desc;
}
/**
* 根据状态码获取对应的枚举实例
* @param code 状态码
* @return 对应的OrderStatus枚举
*/
public static OrderStatus getByCode(int code) {
for (OrderStatus status : OrderStatus.values()) {
if (status.code == code) {
return status;
}
}
throw new IllegalArgumentException("无效的订单状态码:" + code);
}
// Getter方法
public int getCode() {
return code;
}
public String getDesc() {
return desc;
}
}
使用示例
java
public class OrderService {
public static void main(String[] args) {
// 1. 直接使用枚举常量,语义清晰
OrderStatus status = OrderStatus.PAID;
System.out.println("订单状态:" + status.getDesc()); // 输出:订单状态:已支付
// 2. 根据状态码解析枚举,避免非法值
int code = 2;
OrderStatus parsedStatus = OrderStatus.getByCode(code);
System.out.println("解析后的状态:" + parsedStatus.getDesc()); // 输出:解析后的状态:已发货
}
}
场景 2:策略模式(替换大量 if/else)
核心思想
将不同分支的业务逻辑封装到枚举常量的方法中,利用枚举的 “多态特性”,彻底消除冗长的if/else或switch分支判断,让代码更简洁、更易扩展。
代码示例:支付方式策略枚举
java
/**
* 支付方式策略枚举
* 每个枚举常量对应一种支付逻辑,替代传统的if/else分支
*/
public enum PayStrategy {
// 每个枚举常量实现抽象方法,定义自己的支付逻辑
ALIPAY {
@Override
public void pay(double amount) {
System.out.println("✅ 支付宝支付成功,金额:" + amount + " 元");
// 可扩展支付宝支付的具体逻辑,如调用第三方接口、记录日志等
}
},
WECHAT_PAY {
@Override
public void pay(double amount) {
System.out.println("✅ 微信支付成功,金额:" + amount + " 元");
}
},
CREDIT_CARD {
@Override
public void pay(double amount) {
System.out.println("✅ 银行卡支付成功,金额:" + amount + " 元");
}
};
/**
* 抽象支付方法,由每个枚举常量实现具体逻辑
* @param amount 支付金额
*/
public abstract void pay(double amount);
}
使用示例
java
public class PayService {
public static void main(String[] args) {
// 无需写if(alipay) / else if(wechat)的分支判断
PayStrategy strategy = PayStrategy.ALIPAY;
strategy.pay(99.9); // 输出:✅ 支付宝支付成功,金额:99.9 元
// 切换支付方式,直接更换枚举常量即可
strategy = PayStrategy.WECHAT_PAY;
strategy.pay(199.0); // 输出:✅ 微信支付成功,金额:199.0 元
}
}
场景 3:统一返回码(后端接口必备)
核心思想
定义一套标准的接口响应码和响应消息,前后端交互时遵循统一规范,避免不同接口自定义状态码导致的混乱,提升接口的可读性和可维护性。
代码示例:全局响应码枚举
java
/**
* 全局接口响应码枚举
* 定义前后端交互的标准响应码和消息
*/
public enum ResultCode {
// 通用响应码
SUCCESS(200, "操作成功"),
FAIL(500, "服务器异常"),
PARAM_ERROR(400, "请求参数错误"),
UNAUTHORIZED(401, "未授权,请重新登录"),
FORBIDDEN(403, "无访问权限"),
NOT_FOUND(404, "请求资源不存在"),
TIMEOUT(504, "请求超时");
// 响应码
private final int code;
// 响应消息
private final String message;
ResultCode(int code, String message) {
this.code = code;
this.message = message;
}
// Getter方法
public int getCode() {
return code;
}
public String getMessage() {
return message;
}
}
配合通用响应类使用
java
/**
* 通用接口响应类
* @param <T> 响应数据类型
*/
public class Result<T> {
private int code;
private String message;
private T data;
// 私有构造方法,禁止直接实例化
private Result() {}
/**
* 成功响应(带数据)
* @param data 响应数据
* @return 成功响应对象
*/
public static <T> Result<T> success(T data) {
Result<T> result = new Result<>();
result.setCode(ResultCode.SUCCESS.getCode());
result.setMessage(ResultCode.SUCCESS.getMessage());
result.setData(data);
return result;
}
/**
* 失败响应(自定义响应码)
* @param resultCode 响应码枚举
* @return 失败响应对象
*/
public static <T> Result<T> fail(ResultCode resultCode) {
Result<T> result = new Result<>();
result.setCode(resultCode.getCode());
result.setMessage(resultCode.getMessage());
return result;
}
// Getter和Setter方法
public int getCode() { return code; }
public void setCode(int code) { this.code = code; }
public String getMessage() { return message; }
public void setMessage(String message) { this.message = message; }
public T getData() { return data; }
public void setData(T data) { this.data = data; }
}
使用示例
java
public class UserController {
// 模拟用户查询接口
public Result<String> getUserInfo(String userId) {
if (userId == null || userId.isEmpty()) {
// 参数错误,返回标准响应码
return Result.fail(ResultCode.PARAM_ERROR);
}
// 模拟查询成功
return Result.success("用户信息:张三,ID:" + userId);
}
public static void main(String[] args) {
UserController controller = new UserController();
// 1. 参数错误场景
Result<String> failResult = controller.getUserInfo("");
System.out.println("响应码:" + failResult.getCode() + ", 响应消息:" + failResult.getMessage());
// 输出:响应码:400, 响应消息:请求参数错误
// 2. 成功场景
Result<String> successResult = controller.getUserInfo("1001");
System.out.println("响应码:" + successResult.getCode() + ", 响应消息:" + successResult.getMessage() + ", 数据:" + successResult.getData());
// 输出:响应码:200, 响应消息:操作成功, 数据:用户信息:张三,ID:1001
}
}
更多推荐


所有评论(0)