CustomException 通过枚举管理状态
java 中自定义异常使用异常枚举管理状态,核心做法是定义一个包含所有业务状态的 enum,并在自定义异常类中持有该枚举实例作为字段。构造异常时传入枚举值,通过重写 getmessage() 方法直接返回枚举的描述信息,从而在抛出和捕获异常时能清晰获取具体的错误状态。
public enum ErrorCode {
USER_NOT_FOUND("用户不存在"),
INVALID_INPUT("输入无效");
private final String message;
ErrorCode(String message) {
this.message = message;
}
public String getMessage() {
return message;
}
}
public class BusinessException extends Exception {
private final ErrorCode errorCode;
public BusinessException(ErrorCode errorCode) {
super(errorCode.getMessage());
this.errorCode = errorCode;
}
public ErrorCode getErrorCode() {
return errorCode;
}
}
调用方只需抛出新的 BusinessException 并传入对应的枚举值,如 throw new BusinessException(ErrorCode.USER_NOT_FOUND)。捕获该异常后,可以通过 e.getErrorCode() 获取枚举对象进行逻辑判断,或通过 e.getMessage() 获取中文描述用于日志或前端展示。这种方式将错误码、描述和类型强绑定,避免了魔法字符串和分散的错误处理逻辑。
如何根据枚举状态区分处理逻辑
在业务代码中根据枚举状态区分处理逻辑,主要依赖对异常类型的精确捕获和枚举值的比较。由于自定义异常持有了枚举引用,可以在 catch 块中直接使用 switch 语句或 equals 方法检查 getErrorCode() 的返回值,从而执行不同的恢复或降级策略。
try {
// 模拟可能抛出异常的业务逻辑
throw new BusinessException(ErrorCode.INVALID_INPUT);
} catch (BusinessException e) {
switch (e.getErrorCode()) {
case USER_NOT_FOUND:
System.out.println("记录缺失用户日志");
break;
case INVALID_INPUT:
System.out.println("提示用户修正输入");
break;
default:
System.out.println("未知错误,记录通用日志");
}
}
这种处理方式使得错误处理逻辑与业务状态紧密耦合且清晰可见。当新增一种错误状态时,只需在枚举中添加新值,并在相关的 catch 块或全局异常处理器中补充对应的分支即可。相比传统的基于错误码整数的判断,枚举提供了编译时的类型安全,防止了非法状态值的传入。
全局异常处理器如何统一返回枚举状态
在全局异常处理器(如 Spring Boot 的 @ControllerAdvice)中统一返回枚举状态,需要将捕获到的自定义异常转换为标准的 HTTP 响应结构。处理器提取异常中的枚举对象,将其映射为统一的 JSON 格式,包含状态码、错误描述和具体的枚举标识,确保前端或调用方能解析出标准化的错误信息。
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.RestControllerAdvice;
import java.util.HashMap;
import java.util.Map;
@RestControllerAdvice
public class GlobalExceptionHandler {
@ExceptionHandler(BusinessException.class)
public Map<string object> handleBusinessException(BusinessException e) {
Map<string object> result = new HashMap();
result.put("status", "error");
result.put("errorCode", e.getErrorCode().name());
result.put("message", e.getErrorCode().getMessage());
return result;
}
}</string></string>
当业务层抛出 BusinessException 时,Spring 会自动拦截并交由该处理器处理。处理器通过 e.getErrorCode().name() 获取枚举常量名,通过 e.getErrorCode().getMessage() 获取人类可读的描述。最终返回的 JSON 结构如 {"status":"error","errorCode":"USER_NOT_FOUND","message":"用户不存在"}。这种做法实现了错误信息的集中管理和标准化输出,便于前端统一处理各类业务异常。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南











