HIbernate Envers:修订的外键

HIbernate Envers: foreign key to revision

是否可以将外键添加到实体的修订版中?

例如,如果我有实体 Person:

@Entity
@Audited
public class Person {
    @Id
    @Column
    private Integer idPerson;
    @Column
    private String favoriteHobby;
}

我想修改一个人点。假设我创建了一本年鉴,我希望它包含那个人此刻最喜欢的爱好,但如果此人之后会更新 his/her 最喜欢的爱好,我希望年鉴包含旧的爱好。

在 SQL 中,这将通过创建一个包含 idPersonidRevisionidYearBook.

列的 table 来实现

但我不确定是否以及如何将其转换为实体、查询它、创建我的年鉴...而无需编写自定义查询或复制我的个人实体。

先从评论中回答你的问题,是的。

如果您将两个实体都标记为 @Audited,您对任一实体所做的任何更改都会导致在该特定实体的审计架构中创建一个新的审计行。

AuditReader API 模仿了许多旧的 Hibernate 标准 API。您基本上可以基于已审计的实体类型构建任何查询,并应用大量条件来过滤结果。

这里我想提一个警告。

让我们假设在交易中,我们创建了一个 Person 并将它们放在 YearBook:

final Session session = openSession();
try {
   session.getTransaction().begin();

   final Person person = new Person();
   person.setName( "John Doe" );
   person.setHobby( "Plays Guitar" );
   session.save( person );

   final YearBook yearBook = new YearBook();
   yearBook.setYear( 2018 );
   yearBook.getPeople().add( person );
   session.save( yearBook );

   session.getTransaction().commit();
}
catch( Exception ex ) {
   if ( session.getTransaction().isActive() ) {
     session.getTransaction().rollback();
   }
   throw ex;
}
finally {
  session.close();
}

这意味着在审计模式中,将为这两种实体类型创建一个新的审计行,并且这些行将与相同的修订号相关联。为简单起见,假设这是修订号 1.

在以后的交易中,您为此 John Doe 修改 Person

final Session session = openSession();
try {
  session.getTransaction().begin();

  final Person person = session.find( Person.class, personId );
  person.setHobby( "Video Games" );

  session.getTransaction().commit();
}
catch( Exception ex ) {
   if ( session.getTransaction().isActive() ) {
     session.getTransaction().rollback();
   }
   throw ex;
}
finally {
  session.close();
}

此时:

  • YearBook 作为单个修订版,修订版 #1.
  • Person for John Doe 有两个修订,修订 #1 和 #2.

这里需要注意的是,针对 YearBook 修订版 1 的查询永远不会 return 任何关于 Person 修订版 [=55] 的信息=]2。在几乎所有情况下,这绝对是理想的结果;然而,在某些特殊情况下,用户也希望 YearBook 触发修订。

如果您希望集合所有者在修改元素属性时也生成不影响集合本身状态的修订,则需要在容器上放置一个虚拟属性并将其修改为交易的一部分,因此两者都经过审计。

也就是说,您将如何在其修订版中获得 YearBook?使用 AuditReader API:

非常简单
final AuditReader reader = AuditReaderFactory.get( session );

// Get the revisions in ascending order from smallest to highest rev #
List<Number> revisions = reader
  .forRevisionsOfEntity( YearBook.class, false )
  .getResultList();

如果您已经知道您感兴趣的修订号,则可以使用以下方法获取该实体的确切快照:

final AuditReader reader = AuditReaderFactory.get( session );
final YearBook yearBook = reader.find( YearBook.class, yearBookId, revision );

查看文档,了解使用 Envers 提供的 AuditReader 界面创建查询的所有其他方法。