跳到主要内容

创建仓库实例

ChatGPT-4o-mini 中英对照 Creating Repository Instances

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

Java 配置​

// ... existing code ...
import org.springframework.context.annotation.Configuration;
import org.springframework.data.couchbase.config.AbstractCouchbaseConfiguration;
import org.springframework.data.couchbase.config.EnableCouchbaseRepositories;

@Configuration
@EnableCouchbaseRepositories(basePackages = "com.example.repository") // Specify your repository package
public class CouchbaseConfig extends AbstractCouchbaseConfiguration {
    // ... existing code ...
    
    @Override
    public String getConnectionString() {
        return "couchbase://localhost"; // Update with your Couchbase connection string
    }

    @Override
    public String getUserName() {
        return "username"; // Update with your Couchbase username
    }

    @Override
    public String getPassword() {
        return "password"; // Update with your Couchbase password
    }

    @Override
    public String getBucketName() {
        return "bucketName"; // Update with your Couchbase bucket name
    }
    // ... existing code ...
}
java

In this update, I've added the @EnableCouchbaseRepositories annotation to the CouchbaseConfig class to activate Couchbase repositories. Make sure to specify the correct package for your repositories and update the connection details accordingly.

一个启用 Spring Data 仓库的示例配置如下所示：

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

  @Bean
  EntityManagerFactory entityManagerFactory() {
    // …
  }
}
java
备注

前面的示例使用了 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>
xml

在前面的示例中，Spring 被指示扫描 com.acme.repositories 及其所有子包中的接口，这些接口继承了 Repository 或其子接口。对于找到的每个接口，基础设施会注册特定于持久化技术的 FactoryBean，以创建适当的代理来处理查询方法的调用。每个 bean 都会根据接口名称注册为一个 bean 名称，因此，UserRepository 接口将注册为 userRepository。嵌套仓库接口的 bean 名称会以其封闭类型名称为前缀。base package 属性允许使用通配符，以便定义扫描包的模式。

使用过滤器​

默认情况下，基础架构会拾取每个扩展持久化技术特定的 Repository 子接口的接口，该子接口位于配置的基础包下，并为其创建一个 bean 实例。然而，您可能希望对哪些接口创建 bean 实例进行更精细的控制。为此，在仓库声明中使用过滤器元素。这些语义与 Spring 的组件过滤器中的元素完全等效。有关这些元素的详细信息，请参阅 Spring 参考文档。

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

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

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

前面的示例包括了所有以 SomeRepository 结尾的接口，并排除了那些以 SomeOtherRepository 结尾的接口不被实例化。

独立使用​

您还可以在 Spring 容器之外使用存储库基础设施 — 例如，在 CDI 环境中。您仍然需要在类路径中包含一些 Spring 库，但通常，您也可以以编程方式设置存储库。提供存储库支持的 Spring Data 模块附带特定于持久性技术的 RepositoryFactory，您可以按如下方式使用：

RepositoryFactorySupport factory = … // Instantiate factory here
UserRepository repository = factory.getRepository(UserRepository.class);
java