如何在JPA Attribute Converter中实现基于实体字段的加密密钥分离？

当然可以实现这个需求，JPA Attribute Converter确实无法访问实体的其他字段，但可以通过以下几种替代方案达成目标：

方案1：使用JPA生命周期回调方法 #

直接在实体类中通过@PrePersist、@PreUpdate、@PostLoad注解定义生命周期方法，这些方法可以访问实体的所有字段，轻松根据org的值选择对应密钥处理name字段的加解密。

示例代码：

@Entity
public class User {
    @Id
    private Long id;
    private String org;
    // 数据库中存储加密后的名称
    private String encryptedName;
    // 业务逻辑中使用的明文名称，不映射到数据库
    @Transient
    private String name;

    // 保存/更新前加密明文名称
    @PrePersist
    @PreUpdate
    private void encryptName() {
        String encryptionKey = "external".equals(org) ? "123456" : "qwert";
        this.encryptedName = EncryptionUtil.encrypt(this.name, encryptionKey);
    }

    // 加载实体后解密数据库中的加密值
    @PostLoad
    private void decryptName() {
        String encryptionKey = "external".equals(org) ? "123456" : "qwert";
        this.name = EncryptionUtil.decrypt(this.encryptedName, encryptionKey);
    }

    // getter、setter 省略
}

核心思路是用@Transient修饰明文name字段供业务使用，数据库存储加密后的encryptedName，生命周期方法在合适时机完成加解密转换。

方案2：使用JPA实体监听器（EntityListener） #

如果不想在实体类中耦合加解密逻辑，可以把逻辑抽离到单独的实体监听器类中，通过@EntityListeners注解绑定到实体上。

示例代码：

// 监听器类
public class UserEncryptionListener {
    @PrePersist
    @PreUpdate
    public void handleEncryption(User user) {
        String key = "external".equals(user.getOrg()) ? "123456" : "qwert";
        user.setEncryptedName(EncryptionUtil.encrypt(user.getName(), key));
    }

    @PostLoad
    public void handleDecryption(User user) {
        String key = "external".equals(user.getOrg()) ? "123456" : "qwert";
        user.setName(EncryptionUtil.decrypt(user.getEncryptedName(), key));
    }
}

// 实体类
@Entity
@EntityListeners(UserEncryptionListener.class)
public class User {
    @Id
    private Long id;
    private String org;
    private String encryptedName;
    @Transient
    private String name;

    // getter、setter 省略
}

这种方案更适合多个实体有类似加解密需求的场景，便于统一维护逻辑。

方案3：自定义Hibernate类型（仅适用于Hibernate作为JPA实现） #

如果项目使用Hibernate作为JPA的底层实现，可以自定义UserType来实现动态密钥加密。自定义类型可以在加解密时获取到实体对象（即owner参数），从而读取org字段的值选择密钥。

示例代码：

public class DynamicEncryptionType implements UserType {
    @Override
    public int[] sqlTypes() {
        return new int[]{Types.VARCHAR};
    }

    @Override
    public Class<?> returnedClass() {
        return String.class;
    }

    // 省略 equals、hashCode、deepCopy 等基础方法

    @Override
    public Object nullSafeGet(ResultSet rs, String[] names, SharedSessionContractImplementor session, Object owner) throws SQLException {
        String encryptedValue = rs.getString(names[0]);
        if (encryptedValue == null) return null;
        // 强转owner为实体类，获取org字段
        User user = (User) owner;
        String key = "external".equals(user.getOrg()) ? "123456" : "qwert";
        return EncryptionUtil.decrypt(encryptedValue, key);
    }

    @Override
    public void nullSafeSet(PreparedStatement st, Object value, int index, SharedSessionContractImplementor session) throws SQLException {
        if (value == null) {
            st.setNull(index, Types.VARCHAR);
            return;
        }
        // 获取当前实体对象
        User user = (User) session.getPersistenceContext().getEntityEntry(session.getEntity(null)).getEntity();
        String key = "external".equals(user.getOrg()) ? "123456" : "qwert";
        String encryptedValue = EncryptionUtil.encrypt((String) value, key);
        st.setString(index, encryptedValue);
    }
}

// 实体类中使用自定义类型
@Entity
public class User {
    @Id
    private Long id;
    private String org;
    @Type(type = "com.example.DynamicEncryptionType")
    private String name;

    // getter、setter 省略
}

注意：该方案依赖Hibernate的私有API，兼容性不如前两种标准JPA方案，仅适合固定使用Hibernate的项目。

内容的提问来源于stack exchange，提问作者The MW