此版本仍在开发中,尚未被视为稳定版。如需使用最新的稳定版本,请访问 Spring Data JPA 4.0.4spring-doc.cadn.net.cn

配置

作为使用 Spring Data Envers 的起点,你需要一个类路径中包含 Spring Data JPA 的项目,并额外添加 spring-data-envers 依赖:spring-doc.cadn.net.cn

<dependencies>

  <!-- other dependency elements omitted -->

  <dependency>
    <groupId>org.springframework.data</groupId>
    <artifactId>spring-data-envers</artifactId>
    <version>3.5.11-SNAPSHOT</version>
  </dependency>

</dependencies>

这也作为传递依赖将 hibernate-envers 引入到项目中。spring-doc.cadn.net.cn

要启用 Spring Data Envers 和 Spring Data JPA,我们需要配置两个 Bean 以及一个特殊的 repositoryFactoryBeanClassspring-doc.cadn.net.cn

@Configuration
@EnableEnversRepositories
@EnableTransactionManagement
public class EnversDemoConfiguration {

	@Bean
	public DataSource dataSource() {

		EmbeddedDatabaseBuilder builder = new EmbeddedDatabaseBuilder();
		return builder.setType(EmbeddedDatabaseType.HSQL).build();
	}

	@Bean
	public LocalContainerEntityManagerFactoryBean entityManagerFactory() {

		HibernateJpaVendorAdapter vendorAdapter = new HibernateJpaVendorAdapter();
		vendorAdapter.setGenerateDdl(true);

		LocalContainerEntityManagerFactoryBean factory = new LocalContainerEntityManagerFactoryBean();
		factory.setJpaVendorAdapter(vendorAdapter);
		factory.setPackagesToScan("example.springdata.jpa.envers");
		factory.setDataSource(dataSource());
		return factory;
	}

	@Bean
	public PlatformTransactionManager transactionManager(EntityManagerFactory entityManagerFactory) {

		JpaTransactionManager txManager = new JpaTransactionManager();
		txManager.setEntityManagerFactory(entityManagerFactory);
		return txManager;
	}
}

要实际使用 Spring Data Envers,请将一个或多个存储库通过添加扩展接口使其成为 RevisionRepositoryspring-doc.cadn.net.cn

interface PersonRepository
    extends CrudRepository<Person, Long>,
    RevisionRepository<Person, Long, Long> (1)
{}
1 第一个类型参数(Person)表示实体类型,第二个(Long)表示 ID 属性的类型,最后一个(Long)是修订版本号的类型。 在默认配置下,Envers 的修订版本号参数应为 IntegerLong

该仓库对应的实体必须是一个启用了 Envers 审计功能的实体(即,它必须带有 @Audited 注解):spring-doc.cadn.net.cn

@Entity
@Audited
class Person {

	@Id @GeneratedValue
	Long id;
	String name;
	@Version Long version;
}