
本文深入解析 jpa 的 `@access` 注解如何在单个实体中混合使用 field 和 property 访问策略,并通过可运行的单元测试验证字段直写与属性拦截(getter/setter 调用)的实际行为差异。
在 JPA 规范中,实体属性的访问方式默认由 @Id 注解的位置决定:若 @Id 标注在字段上,则整个实体采用 AccessType.FIELD(直接读写私有字段);若标注在 getter 方法上,则采用 AccessType.PROPERTY(通过 getter/setter 访问)。但 JPA 同时支持细粒度控制——通过 @Access(AccessType.PROPERTY) 或 @Access(AccessType.FIELD) 显式覆盖单个属性的访问策略,从而实现同一实体内“字段直写 + 属性拦截”的混合访问模式。
关键在于:
- 未被 @Access 显式修饰的属性,继承实体级默认访问类型(本例中因 @Id 在字段上,默认为 FIELD);
- 被 @Access(AccessType.PROPERTY) 修饰的属性(如 lastName),强制 JPA 通过其 getter/setter 进行读写,即使其他属性走字段直写路径。
以下是一个精简、可验证的完整示例:
@Entity
public class Student {
@Id
@GeneratedValue
private Long ID;
// 默认 FIELD 访问:JPA 直接读写 firstName 字段,绕过 setFirstName/getFirstName
private String firstName;
// 显式 PROPERTY 访问:JPA 必须调用 setLastName/getlastName(注意方法名拼写需正确!)
@Access(AccessType.PROPERTY)
private String lastName;
// 正确的 getter/setter 命名(原问题中 getlastName 拼写错误,应为 getLastName)
public String getFirstName() {
System.out.println("~~~~~~~~getFirstName~~~~~~~~~"); // ✅ 不会被 JPA 调用(FIELD 模式)
return firstName;
}
public void setFirstName(String firstName) {
this.firstName = "FirstName: " + firstName; // ✅ 不会被 JPA 调用
System.out.println("~~~~~~~~setFirstName~~~~~~~~~");
}
public String getLastName() { // 修正:方法名应为 getLastName
System.out.println("~~~~~~~~getLastName~~~~~~~~~"); // ✅ JPA 会调用此 getter(PROPERTY 模式)
return lastName;
}
public void setLastName(String lastName) {
this.lastName = "LastName: " + lastName; // ✅ JPA 会调用此 setter
System.out.println("~~~~~~~~setLastName~~~~~~~~~");
}
}⚠️ 注意事项: @Access 仅对紧邻的下一个属性或方法生效,且必须与目标属性的声明位置一致(如修饰字段,则 getter/setter 必须存在且命名规范); getter/setter 方法名必须严格遵循 JavaBean 规范(如 getLastName,而非 getlastName),否则 JPA 无法识别; 混合访问时,@Id 仍需保持唯一性,且其访问方式(FIELD/PROPERTY)决定默认策略,不可冲突; 实际持久化行为需通过数据库实际值和日志输出双重验证,而非仅依赖 IDE 调试断点。
下面的单元测试可明确证明混合访问效果:
@Test
public void testAccessAnnotation() {
Student student = new Student();
student.setFirstName("John"); // 手动调用,仅影响内存对象
student.setLastName("Doe"); // 手动调用,仅影响内存对象
entityManager.getTransaction().begin();
entityManager.persist(student); // JPA 持久化:firstName 直写字段 → 存 "John";lastName 调用 setter → 存 "LastName: Doe"
entityManager.getTransaction().commit();
entityManager.clear();
// 重新加载实体
Student loaded = entityManager.find(Student.class, student.getID());
// 验证结果:
// - firstName 未经过 setter,数据库存的是原始值 "John"
assertEquals("John", loaded.getFirstName());
// - lastName 经过 setter 处理,数据库存的是 "LastName: Doe"
assertEquals("LastName: Doe", loaded.getLastName());
}运行该测试时,控制台将输出两行 ~~~~~~~~setLastName~~~~~~~~~(分别对应 persist 和 find 时的 setter 调用),而 ~~~~~~~~setFirstName~~~~~~~~~ 不会出现——这正是 @Access 精准控制访问路径的直接证据。
总结而言,@Access 是 JPA 提供的高级机制,适用于需要对特定字段实施业务逻辑封装(如自动加前缀、加密、审计赋值)而不影响其他字段性能的场景。合理使用它,既能保持代码清晰性,又能精准控制数据生命周期中的拦截时机。










