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

配置

作为使用 Spring Data Envers 的起点,您需要一个在类路径上具有 Spring Data JPA 的项目,以及一个额外的spring-data-enversDependency:spring-doc.cadn.net.cn

<dependencies>

  <!-- other dependency elements omitted -->

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

</dependencies>

这也带来了hibernate-envers作为临时依赖项添加到项目中。spring-doc.cadn.net.cn

要启用 Spring Data Envers 和 Spring Data JPA,我们需要配置两个 bean 和一个特殊的repositoryFactoryBeanClass:spring-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,请将一个或多个存储库放入RevisionRepository通过将其添加为扩展接口:spring-doc.cadn.net.cn

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

该存储库的实体必须是启用了 Envers 审计的实体(即,它必须具有@Auditedannotation):spring-doc.cadn.net.cn

@Entity
@Audited
class Person {

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