定义参数校验异常需要创建一个继承自 runtimeexception 的类,并在构造函数中调用父类构造方法传入错误信息。具体做法是编写一个名为 paramvalidationexception 的类,提供带消息和带消息加原因的构造函数,以便在业务逻辑中抛出并携带具体的校验失败详情。

如何设计异常类的继承结构
直接回答本节问题:异常类应继承 RuntimeException 以实现非受检异常的自动传播,避免强制捕获。通过继承关系,可以将所有自定义校验异常统一归类,便于全局异常处理器进行拦截和处理。

public class ParamValidationException extends RuntimeException {
private String fieldName;
private Object invalidValue;
public ParamValidationException(String message) {
super(message);
}
public ParamValidationException(String message, Throwable cause) {
super(message, cause);
}
public ParamValidationException(String fieldName, Object invalidValue) {
super("Validation failed for field: " + fieldName);
this.fieldName = fieldName;
this.invalidValue = invalidValue;
}
public String getFieldName() {
return fieldName;
}
public Object getInvalidValue() {
return invalidValue;
}
}
上述代码定义了异常类的基本结构。第一个构造函数接受简单的错误描述字符串。第二个构造函数允许传递底层原因,用于记录更详细的堆栈信息。第三个构造函数专门针对字段校验场景,存储了出错的字段名和非法值,方便后续提取结构化数据。使用时只需 throw new ParamValidationException("age", -1) 即可抛出。
立即学习“Java免费学习笔记(深入)”;
如何在业务层抛出并携带具体校验信息
直接回答本节问题:在业务逻辑中,当检测到参数不符合要求时,实例化异常对象并抛出。通过构造函数将具体的字段名和非法值传递给异常对象,确保异常信息中包含足够的上下文。

public class UserService {
public void createUser(String name, int age) {
if (name == null || name.isEmpty()) {
throw new ParamValidationException("name", null);
}
if (age < 0 || age > 150) {
throw new ParamValidationException("age", age);
}
System.out.println("User created successfully");
}
public static void main(String[] args) {
UserService service = new UserService();
try {
service.createUser("John", -5);
} catch (ParamValidationException e) {
System.out.println("Field: " + e.getFieldName());
System.out.println("Value: " + e.getInvalidValue());
System.out.println("Message: " + e.getMessage());
}
}
}
这段代码展示了如何在实际业务中使用该异常。在 createUser 方法中,对 name 和 age 进行了校验。如果校验失败,抛出 ParamValidationException 并传入具体的字段名和值。在 main 方法的测试中,捕获异常后打印出字段名、非法值和错误消息,验证了异常信息的完整性。
全局异常处理器如何捕获并返回标准化响应
直接回答本节问题:使用 Spring Boot 的 @ControllerAdvice 和 @ExceptionHandler 注解来统一处理 ParamValidationException。在处理器中获取异常中的字段信息和错误消息,构建统一的 JSON 响应格式返回给客户端。
import org.springframework.http.HttpStatus;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.ResponseStatus;
import org.springframework.web.bind.annotation.RestControllerAdvice;
import java.util.HashMap;
import java.util.Map;
@RestControllerAdvice
public class GlobalExceptionHandler {
@ExceptionHandler(ParamValidationException.class)
@ResponseStatus(HttpStatus.BAD_REQUEST)
public Map<String, Object> handleParamValidationException(ParamValidationException ex) {
Map<String, Object> response = new HashMap<>();
response.put("error", "VALIDATION_ERROR");
response.put("message", ex.getMessage());
response.put("field", ex.getFieldName());
response.put("invalidValue", ex.getInvalidValue());
return response;
}
}
该全局异常处理器拦截所有 ParamValidationException 类型的异常。它设置 HTTP 状态码为 400 Bad Request,并构建一个包含错误类型、消息、字段名和非法值的 Map 作为响应体。这样前端可以解析这个标准的 JSON 结构,展示具体的校验错误信息,例如提示用户“年龄不能为负数”。


















