在 java 中为 setter 方法添加参数校验，最直接且符合现代开发规范的做法是在 setter 内部使用 jsr-380 (bean validation) 提供的 @validated 注解配合 methodvalidationpostprocessor，或者在方法体内手动抛出 illegalargumentexception。对于简单的业务逻辑，手动检查并抛出异常是零依赖且最稳妥的方案；若项目已集成 spring boot 或 jakarta ee，则推荐使用声明式校验注解，由框架自动拦截非法输入。
手动校验与异常处理的具体实现
手动校验的核心在于在 setter 方法体中增加条件判断，当输入值不满足业务规则时立即抛出运行时异常。这种方式不需要引入额外的库，适用于所有 Java 环境。例如，设置用户年龄时，需确保传入的整数非负且不超过合理上限（如 150）。如果传入的值无效，程序会中断当前调用链，防止脏数据进入对象状态。
import java.util.Objects;
public class User {
private String name;
private int age;
public void setName(String name) {
if (name == null || name.trim().isEmpty()) {
throw new IllegalArgumentException("Name cannot be empty");
}
this.name = name.trim();
}
public void setAge(int age) {
if (age < 0 || age > 150) {
throw new IllegalArgumentException("Age must be between 0 and 150");
}
this.age = age;
}
}
上述代码展示了两个典型的 setter 实现。setName 方法检查了空值和纯空格字符串，并通过 trim() 清理输入。setAge 方法定义了明确的数值边界。当调用者尝试设置 age = -1 时，将直接触发 IllegalArgumentException。这种即时反馈机制有助于在单元测试或调试阶段快速定位数据源问题。
立即学习“Java免费学习笔记（深入）”；
基于 Bean Validation 的声明式校验
在 Spring Boot 项目中，可以通过 @Validated 注解在类级别启用方法级校验，并结合 @Min、@NotBlank 等约束注解定义规则。这种方式将校验逻辑从业务代码中剥离，使 setter 更加简洁。需要注意的是，默认情况下 Spring 不会拦截普通 Bean 的方法调用，必须配置 MethodValidationPostProcessor 或使用 AOP 代理才能生效。
import jakarta.validation.constraints.Min;
import jakarta.validation.constraints.NotBlank;
import org.springframework.validation.annotation.Validated;
@Validated
public class ValidatedUser {
@NotBlank(message = "Name is required")
private String name;
@Min(value = 0, message = "Age cannot be negative")
private int age;
public void setName(String name) {
this.name = name;
}
public void setAge(int age) {
this.age = age;
}
}
在此示例中，ValidatedUser 类被标记为 @Validated。当调用 setName(null) 时，框架会自动检测到违反 @NotBlank 约束的行为，并抛出 ConstraintViolationException。这与手动抛出的 IllegalArgumentException 不同，前者携带更详细的元数据（如违规字段和消息），便于统一的全局异常处理器捕获并转换为标准的 HTTP 错误响应。若未配置后置处理器，这些注解将被忽略，setter 行为退化为普通的字段赋值。
校验失败时的回滚与状态一致性
当 setter 中的校验失败抛出异常时，对象的当前状态保持不变，因为赋值语句尚未执行。这保证了对象的一致性，即不会出现部分更新导致的中间态脏数据。开发者应确保在调用 setter 前做好异常捕获，或在事务边界内处理，以避免因单个字段校验失败导致整个业务事务回滚。对于复杂对象，建议结合构造函数进行不可变设计，或通过 Builder 模式在构建阶段完成所有校验，从而减少 setter 的使用频率。
