Java封装配合注解校验的核心是将验证逻辑从业务代码剥离并绑定到数据模型：私有字段+getter/setter提供安全边界，注解声明规则，框架自动触发校验。

Java 中封装配合注解实现校验，核心是把数据验证逻辑从业务代码中剥离，交由框架（如 Hibernate Validator）在对象创建、参数接收或手动触发时自动执行。关键在于：封装提供私有字段 + 公共 getter/setter 的安全访问边界，而注解则声明“这个字段应满足什么规则”，两者结合后，校验不再散落在 service 或 controller 里，而是紧贴数据模型本身。

封装是校验的前提：字段私有化 + 标准访问器

没有良好的封装，注解校验就失去意义——外部可随意修改字段值，绕过 setter 中可能的逻辑，也使注解无法被框架有效拦截（比如直接反射赋值跳过验证）。正确做法是：

• 所有需要校验的字段声明为 private
• 提供 public 的 getter/setter（哪怕只是默认生成），因为 Hibernate Validator 默认通过 setter 触发验证（如 @Validated + @RequestBody）
• 避免在 setter 中手动写 if-else 校验，交给注解统一管理，保持职责单一

常用校验注解直接加在封装字段上

在私有字段上方添加 JSR-303/JSR-380 标准注解（如 @NotBlank、@Min、@Email），框架会在合适时机读取并执行。例如：

public class User {
    @NotBlank(message = "用户名不能为空")
    @Size(min = 2, max = 20, message = "用户名长度必须在2-20之间")
    private String username;

    @Email(message = "邮箱格式不正确")
    private String email;

    @Min(value = 0, message = "年龄不能小于0")
    private Integer age;
    
    // getter/setter 省略
}

注意：注解写在字段上即可生效（无需写在 getter 上），但需确保使用的是支持字段级校验的验证器（Hibernate Validator 默认支持）。

Alibabacloud Sdk Client Initialization For Java

在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。

下载

立即学习“Java免费学习笔记（深入）”；

配合 Spring 实现自动校验（Controller 层最典型）

Spring MVC 借助 @Valid 或 @Validated 触发校验，与封装类天然协作：

• 在 Controller 方法参数前加 @Valid，Spring 会自动校验传入对象的字段注解，并将错误放入 BindingResult
• 若用 @RequestBody 接收 JSON，Jackson 反序列化后，Spring 仍能对已封装的对象执行字段级注解校验
• 示例：
  

  public ResponseEntity<?> createUser(@Valid @RequestBody User user, BindingResult result) {<br>
      if (result.hasErrors()) {<br>
        return ResponseEntity.badRequest().body(result.getAllErrors());<br>
      }<br>
      // 正常处理<br>
    }

自定义注解 + 封装类协同增强校验能力

当内置注解不够用（如“密码和确认密码必须一致”），可自定义约束注解，作用目标仍是封装类本身：

• 定义注解（如 @PasswordMatch），标注在封装类上（不是字段）
• 编写对应 ConstraintValidator，从封装类实例中取出两个字段（如 password 和 confirmPassword）做比对
• 这样既保持封装完整性，又让复杂规则成为类的“契约”一部分