Hibernate Envers：仅获取更改的字段

Question

我怎样才能只从被审计实体获取修改过的字段？

当我使用

AuditQuery query = getAuditReader().createQuery().forEntitiesAtRevision(MyEntity.class, revisionNumber).getResultList()

我得到了所有领域；但我只想修改字段？

Answer 1

无修改标志功能

如果您没有在注释上使用Modified Flags功能@Audited，获得审计属性从修订版 X 更改为修订版 Y 的唯一方法是实际获取两个修订版，然后自己比较两个对象实例之间的实际字段值。

具有修改标志功能

假设您在注释上使用Modified Flags功能@Audited，目前唯一的方法是获取给定实体实例的修订号，并使用这些修订和审计列的先验知识，使用 Envers 查询 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
    }
  }
}

Modified Flags 属性更改查询

在 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。