Hibernate Envers：只获取更改的字段

Question

我如何只从经过审核的实体获得修改过的字段？

当我使用

时

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

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

Answer 1

没有修改标志功能

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

使用修改标志功能

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

修改标志属性更改查询

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

此功能可能会被扩展或更改，因为它将被视为 experimental ，但它是用户要求的，我们至少打算在此功能的基础上提供第一次传递在修改过的旗帜上。

我们目前还没有决定是否或如何支持非修改标志，所以再次选择目前只有蛮力比较的唯一选择。

有关此功能的详细信息，请参阅HHH-8058。