无修改标志功能
如果您没有在 @Audited 注释上使用 Modified Flags 功能,则获得已审计属性从修订 X 更改为修订 Y 的唯一方法是实际获取两个修订,然后自己比较两个对象实例之间的实际字段值。
具有修改标志功能
假设您在 @Audited 注释上使用 Modified Flags 功能,目前唯一的方法是获取给定实体实例的修订号并使用这些修订和审计的先验知识列,使用 Envers Query API 来询问属性是否针对该修订进行了更改。
显然,这种方法并不理想,因为它确实在用户代码部分强加了一些先验知识,以了解为了获得所需结果而审计的字段。
List<Number> revisions = reader.getRevisions( MyEntity.class, myEntityId );
for ( Number revisionNumber : revisions ) {
for ( String propertyName : propertyNamesToCheckList ) {
final Long hits = reader.createQuery()
.forRevisionsOfEntity( MyEntity.class, false, false )
.add( AuditEntity.id().eq( myEntityId ) )
.add( AuditEntity.revisionNumber().eq( revisionNumber ) )
.add( AuditEntity.propertyName( propertyName ).hasChanged() )
.addProjection( AuditEntity.id().count() )
.getSingleResult();
if ( hits == 1 ) {
// propertyName changed at revisionNumber
}
else {
// propertyName didn't change at revisionNumber
}
}
}
修改标志属性更改查询
在 Hibernate Envers 6.0 中,我们引入了一个新的查询,它将forRevisionsOfEntity 与修改后的标志查询机制结合起来,不仅可以获得给定实体类类型和主键的修改后的实例,还可以获得一个字段列表每次修订都会修改。
以下伪代码给出了未来 API 的示例:
List results = reader.forRevisionsOfEntityWithChanges( MyEntity.class false )
.add( AuditEntity.id().eq( entityId ) )
.getResultList();
Object previousEntity = null;
for ( Object row : results ) {
Object[] rowArray = (Object[]) row;
final MyEntity entity = rowArray[0];
final RevisionType revisionType = (RevisionType) rowArray[2];
final Set<String> propertiesChanged = (Set<String>) rowArray[3];
for ( String propertyName : propertiesChanged ) {
// using the property name here you know
// 1. that the property changed in this revision (no compare needed)
// 2. Can get old/new values easily from previousEntity and entity
}
}
此功能可能会被扩展或更改,因为它将被视为实验性,但这是用户所要求的,我们至少打算基于此功能提供第一次通过在修改过的标志上。
我们目前还没有决定是否或如何支持非修改标志,所以目前唯一的选择是蛮力 bean 比较。
有关此功能的更多详细信息,请参阅HHH-8058。