建立 Repository 例項

本節介紹如何為定義的 Repository 介面建立例項和 Bean 定義。

Java 配置

在 Java 配置類上使用特定於儲存的 `@EnableJpaRepositories` 註解來定義用於 Repository 啟用的配置。有關 Spring 容器基於 Java 的配置的介紹，請參閱 Spring 參考文件中的 JavaConfig。

啟用 Spring Data Repositories 的示例配置類似於以下內容

基於註解的 Repository 配置示例
@Configuration
@EnableJpaRepositories("com.acme.repositories")
class ApplicationConfiguration {

  @Bean
  EntityManagerFactory entityManagerFactory() {
    // …
  }
}
前面的示例使用了特定於 JPA 的註解，你應該根據你實際使用的儲存模組進行更改。`EntityManagerFactory` Bean 的定義也同樣適用。請參閱介紹特定於儲存的配置的章節。

XML 配置

每個 Spring Data 模組都包含一個 `repositories` 元素，允許你定義一個 Spring 為你掃描的基礎包，如下例所示

透過 XML 啟用 Spring Data Repositories
<?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` 下。巢狀 Repository 介面的 Bean 名稱會帶有其包含型別名稱的字首。基礎包屬性允許使用萬用字元，以便你可以定義掃描包的模式。

使用過濾器

預設情況下，基礎設施會獲取配置的基礎包下擴充套件特定於持久化技術的 `Repository` 子介面的每個介面，併為其建立一個 Bean 例項。但是，你可能希望對哪些介面建立 Bean 例項進行更精細的控制。為此，請在 Repository 宣告中使用 filter 元素。其語義與 Spring 元件過濾器中的元素完全相同。有關詳細資訊，請參閱 Spring 參考文件中關於這些元素的說明。

例如，要從 Repository 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 容器之外使用 Repository 基礎設施，例如在 CDI 環境中。你仍然需要在類路徑中包含一些 Spring 庫，但通常你也可以以程式設計方式設定 Repositories。提供 Repository 支援的 Spring Data 模組附帶一個特定於持久化技術的 `RepositoryFactory`，你可以按如下方式使用它

Repository 工廠的獨立使用
RepositoryFactorySupport factory = … // Instantiate factory here
UserRepository repository = factory.getRepository(UserRepository.class);