创建仓库实例

DeepSeek V3 中英对照 Creating Repository Instances

本节介绍如何为已定义的存储库接口创建实例和 bean 定义。

Java 配置

在 Java 配置类上使用特定于存储的 @EnableRedisRepositories 注解来定义仓库激活的配置。有关 Spring 容器基于 Java 的配置介绍，请参阅 Spring 参考文档中的 JavaConfig。

启用 Spring Data 仓库的示例配置类似于以下内容：

@Configuration
@EnableJpaRepositories("com.acme.repositories")
class ApplicationConfiguration {

  @Bean
  EntityManagerFactory entityManagerFactory() {
    // …
  }
}

备注

前面的示例使用了 JPA 特有的注解，你需要根据实际使用的存储模块进行相应的更改。这同样适用于 EntityManagerFactory bean 的定义。请参阅涵盖特定存储配置的部分。

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 名称会以其封闭类型名称为前缀。basePackage 属性允许使用通配符，因此你可以定义扫描包的模式。

使用过滤器

默认情况下，基础设施会扫描配置的基础包下所有扩展了特定持久化技术 Repository 子接口的接口，并为它们创建 bean 实例。然而，您可能希望对哪些接口创建 bean 实例进行更细粒度的控制。为此，可以在仓库声明中使用过滤器元素。其语义与 Spring 组件过滤器中的元素完全相同。详情请参阅 Spring 参考文档 中关于这些元素的说明。

例如，要从实例化中排除某些接口作为存储库 bean，你可以使用以下配置：

Java

@Configuration
@EnableRedisRepositories(basePackages = "com.acme.repositories",
    includeFilters = { @Filter(type = FilterType.REGEX, pattern = ".*SomeRepository") },
    excludeFilters = { @Filter(type = FilterType.REGEX, pattern = ".*SomeOtherRepository") })
class ApplicationConfiguration {

  @Bean
  EntityManagerFactory entityManagerFactory() {
    // …
  }
}

XML

<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);