此版本仍在开发中,尚不被认为是稳定的。对于最新的稳定版本,请使用 Spring Data Commons 3.5.3! |
创建存储库实例
本节介绍如何为定义的存储库接口创建实例和 Bean 定义。
Java 配置
使用特定于商店的@EnableJpaRepositories
注释,以定义存储库激活的配置。
有关基于 Java 的 Spring 容器配置的介绍,请参阅 Spring 参考文档中的 JavaConfig。
启用 Spring Data 存储库的示例配置类似于以下内容:
@Configuration
@EnableJpaRepositories("com.acme.repositories")
class ApplicationConfiguration {
@Bean
EntityManagerFactory entityManagerFactory() {
// …
}
}
前面的示例使用特定于 JPA 的注释,您可以根据实际使用的 store 模块进行更改。这同样适用于EntityManagerFactory 豆。请参阅介绍特定于商店的配置的部分。 |
XML 配置
每个 Spring Data 模块都包含一个repositories
元素,用于定义 Spring 为您扫描的基本包,如以下示例所示:
<?xml version="1.0" encoding="UTF-8"?>
<beans:beans xmlns:beans="http://www.springframework.org/schema/beans"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns="http://www.springframework.org/schema/data/jpa"
xsi:schemaLocation="http://www.springframework.org/schema/beans
https://www.springframework.org/schema/beans/spring-beans.xsd
http://www.springframework.org/schema/data/jpa
https://www.springframework.org/schema/data/jpa/spring-jpa.xsd">
<jpa:repositories base-package="com.acme.repositories" />
</beans:beans>
在前面的示例中,指示 Spring 进行扫描com.acme.repositories
及其所有用于扩展接口的子包Repository
或其子接口之一。
对于找到的每个接口,基础结构都会注册特定于持久性技术FactoryBean
创建处理查询方法调用的适当代理。
每个 Bean 都注册在派生自接口名称的 Bean 名称下,因此接口UserRepository
将在userRepository
.
嵌套存储库接口的 Bean 名称以其封闭类型名称为前缀。
基本包属性允许通配符,以便您可以定义扫描包的模式。
使用过滤器
默认情况下,基础设施会选择扩展特定于持久性技术的每个接口Repository
子接口,并为其创建一个 bean 实例。
但是,您可能希望更细粒度地控制哪些接口为它们创建了 Bean 实例。
为此,请在存储库声明中使用过滤器元素。
语义与 Spring 组件过滤器中的元素完全等同。
有关详细信息,请参阅这些元素的 Spring 参考文档。
例如,要将某些接口从实例化中排除为存储库 Bean,您可以使用以下配置:
-
Java
-
XML
@Configuration
@EnableJpaRepositories(basePackages = "com.acme.repositories",
includeFilters = { @Filter(type = FilterType.REGEX, pattern = ".*SomeRepository") },
excludeFilters = { @Filter(type = FilterType.REGEX, pattern = ".*SomeOtherRepository") })
class ApplicationConfiguration {
@Bean
EntityManagerFactory entityManagerFactory() {
// …
}
}
<repositories base-package="com.acme.repositories">
<context:include-filter type="regex" expression=".*SomeRepository" />
<context:exclude-filter type="regex" expression=".*SomeOtherRepository" />
</repositories>
前面的示例包括以SomeRepository
并排除以SomeOtherRepository
避免被实例化。
独立使用
您还可以在 Spring 容器之外使用存储库基础架构——例如,在 CDI 环境中。您的类路径中仍然需要一些 Spring 库,但通常,您也可以以编程方式设置存储库。提供存储库支持的 Spring Data 模块附带了特定于持久化技术的RepositoryFactory
您可以使用,如下所示:
RepositoryFactorySupport factory = … // Instantiate factory here
UserRepository repository = factory.getRepository(UserRepository.class);