使用 javax.validation 或 jakarta.validation 提供的 @min 和 @max 注解可以校验基本数据类型及其包装类的取值范围。在实体类字段上添加这两个注解并指定 value 属性,即可在调用 validator.validate() 时自动触发范围检查。

@Min 和 @Max 如何定义上下限
这两个注解分别用于设定数值的下限和上限。当字段的实际值小于 @Min 的 value 或大于 @Max 的 value 时,校验将失败。它们支持自定义错误消息,通过 message 属性覆盖默认提示。

import javax.validation.constraints.Min;
import javax.validation.constraints.Max;
public class User {
@Min(value = 0, message = "年龄不能为负")
@Max(value = 150, message = "年龄不能超过150")
private int age;
public int getAge() { return age; }
public void setAge(int age) { this.age = age; }
}
上述代码定义了 age 字段的合法范围为 [0, 150]。若传入 -1,校验器会返回包含 "年龄不能为负" 的错误对象;若传入 200,则返回 "年龄不能超过150" 的错误对象。注意,基本类型 int 无法为 null,若需允许空值,应改用 Integer 包装类。
立即学习“Java免费学习笔记(深入)”;
如何处理边界值与默认行为
校验是包含边界的闭区间判断。即值等于 @Min 或 @Max 的 value 时,校验视为通过。若未指定 value,注解将无法编译,因为范围校验必须明确界限。对于浮点数 double 或 float,同样适用此逻辑,但需注意精度问题可能导致意外结果,建议在高精度场景下结合 @DecimalMin 和 @DecimalMax。

import javax.validation.Validation;
import javax.validation.Validator;
import javax.validation.ConstraintViolation;
import java.util.Set;
public class Main {
public static void main(String[] args) {
Validator validator = Validation.buildDefaultValidatorFactory().getValidator();
User user = new User();
user.setAge(150); // 边界值
Set<ConstraintViolation<User>> violations = validator.validate(user);
System.out.println(violations.isEmpty()); // 输出 true
}
}
运行上述代码,由于 age 设为 150,恰好等于 @Max 的上限,因此 violations 集合为空,isEmpty() 返回 true。这证实了边界值是合法的。若改为 151,则集合非空,校验失败。
当输入超出范围时校验器返回什么
当输入值违反 @Min 或 @Max 的限制时,Validator.validate() 方法不会抛出异常,而是返回一个 Set<constraintviolation>></constraintviolation> 对象。该集合中包含具体的违规信息,可通过 getMessage() 获取自定义或默认的错误提示,通过 getPropertyPath() 定位出错字段。若集合为空,表示所有字段均符合范围要求。


















