本文详解 jpa `@access` 注解如何在单个实体中混合使用 `field` 和 `property` 访问策略，通过代码示例、测试验证与关键注意事项，帮助开发者精准控制字段读写时机（如 setter 前置处理），避免默认策略导致的逻辑遗漏。
在 JPA 规范中，实体的访问类型（Access Type）决定了持久化上下文如何读取和写入实体成员——是直接操作字段（AccessType.FIELD），还是通过 getter/setter 方法（AccessType.PROPERTY）。默认情况下，JPA 采用“就近声明决定全局访问类型”规则：若 @Id 注解标注在字段上，则整个实体默认为 FIELD 访问；若标注在 getter 上，则默认为 PROPERTY 访问。但这一全局设定并非不可打破——@Access 注解允许你在特定字段或属性级别显式覆盖默认行为，实现细粒度控制。
以 Student 实体为例：
将 WCAG 2 AA 无障碍标准应用于设计系统、UI 组件和网页——通过可运行的验证器进行对比度计算，采用设计 token 模式使颜色天生可访问，设定排版和焦点状态规则，并提供语义检查清单。适用于构建或审查 UI。
@Entity
public class Student {
@Id
@GeneratedValue
private Long ID; // ← @Id 在字段 → 默认全局为 FIELD
private String firstName; // ← 未加 @Access → 按默认 FIELD 访问：绕过 setter/getter
@Access(AccessType.PROPERTY) // ← 显式声明：lastName 必须走 getter/setter
private String lastName;
// ... getter/setter（注意：getlastName() 是笔误，应为 getLastName()）
public String getFirstName() {
System.out.println("~~~~~~~~getFirstName~~~~~~~~~");
return firstName;
}
public void setFirstName(String firstName) {
this.firstName = "FirstName: " + firstName; // ← 此逻辑在 FIELD 模式下*不会被调用*
System.out.println("~~~~~~~~setFirstName~~~~~~~~~");
}
public String getLastName() { // 修正方法名
System.out.println("~~~~~~~~getLastName~~~~~~~~~");
return lastName;
}
public void setLastName(String lastName) {
this.lastName = "LastName: " + lastName; // ← 此逻辑在 PROPERTY 模式下*会被调用*
System.out.println("~~~~~~~~setLastName~~~~~~~~~");
}
}关键点在于：
✅ firstName 使用默认 FIELD 访问 → JPA 直接读写字段值，完全跳过 setFirstName() 和 getFirstName() 方法；
✅ lastName 受 @Access(AccessType.PROPERTY) 控制 → JPA 强制通过 setLastName() 初始化、通过 getLastName() 读取，确保前置/后置逻辑生效。
为实证该行为，可编写如下集成测试（需配置内存数据库如 H2）：
@Test
public void testAccessAnnotation() {
EntityManager em = entityManagerFactory.createEntityManager();
em.getTransaction().begin();
Student student = new Student();
student.setFirstName("John"); // 调用但*不参与持久化*（FIELD 模式忽略）
student.setLastName("Doe"); // 调用且*参与持久化*（PROPERTY 模式生效）
em.persist(student);
em.flush(); // 确保 INSERT 执行
Long id = student.getID();
em.clear(); // 清除一级缓存，强制从 DB 重新加载
// 重新查询
Student loaded = em.find(Student.class, id);
// 断言：firstName 保持原始值（"John"），未被 setter 修饰
assertEquals("John", loaded.getFirstName());
// lastName 被 setter 修饰（"LastName: Doe"）
assertEquals("LastName: Doe", loaded.getLastName());
em.getTransaction().commit();
em.close();
}⚠️ 注意事项： 方法命名必须规范：@Access(PROPERTY) 要求对应字段存在标准 JavaBean 命名的 getter/setter（如 lastName → getLastName()/setLastName()），getlastName() 这类错误命名将导致 PropertyNotFoundException； 混合访问需谨慎：同一实体内混用 FIELD 和 PROPERTY 可能增加维护复杂度，建议仅在必要场景（如敏感字段加密、审计字段自动填充）使用； Hibernate 特定行为：某些旧版 Hibernate 对 @Access 的字段级应用存在兼容性问题，推荐使用 5.6+ 或 6.x 版本，并确保 persistence.xml 或 application.properties 中启用标准 JPA 配置； 性能考量：PROPERTY 访问因反射调用 getter/setter，微幅低于 FIELD 访问，但通常可忽略；高吞吐场景可权衡是否值得为单字段启用。
总结而言，@Access 是 JPA 提供的底层控制能力，它让开发者摆脱“非此即彼”的访问类型限制，在保持简洁性的同时，为关键字段注入业务逻辑。正确理解并验证其行为，是构建健壮、可预测数据层的重要一环。
