核心概念

Spring Data 倉庫抽象中的核心介面是 Repository。它接受要管理的領域類以及領域類的識別符號型別作為型別引數。此介面主要作為標記介面，用於捕獲要使用的型別，並幫助您發現擴充套件此介面的其他介面。

Spring Data 將領域型別視為實體，更具體地說是聚合。因此，您會在整個文件中看到術語“entity”（實體），它可以與術語“domain type”（領域型別）或“aggregate”（聚合）互換使用。

正如您可能在引言中注意到的，它已經暗示了領域驅動設計的概念。我們將領域物件視為 DDD 意義上的物件。領域物件具有識別符號（否則它們將是無識別符號的值物件），當我們使用某些模式訪問資料時，我們需要以某種方式引用識別符號。當我們討論倉庫和查詢方法時，引用識別符號將變得更有意義。

The CrudRepository 和 ListCrudRepository 介面為被管理的實體類提供了複雜的 CRUD 功能。

CrudRepository 介面
public interface CrudRepository<T, ID> extends Repository<T, ID> {

  <S extends T> S save(S entity);      (1)

  Optional<T> findById(ID primaryKey); (2)

  Iterable<T> findAll();               (3)

  long count();                        (4)

  void delete(T entity);               (5)

  boolean existsById(ID primaryKey);   (6)

  // … more functionality omitted.
}
1 儲存給定的實體。
2 返回由給定 ID 標識的實體。
3 返回所有實體。
4 返回實體數量。
5 刪除給定的實體。
6 指示具有給定 ID 的實體是否存在。

此介面中宣告的方法通常被稱為 CRUD 方法。ListCrudRepository 提供了等效的方法，但它們返回 List，而 CrudRepository 方法返回 Iterable。

倉庫介面隱含了一些保留方法，如 findById(ID identifier)，這些方法無論其屬性名如何，都針對領域型別識別符號屬性。有關此內容的更多資訊，請參閱“定義查詢方法”。

如果名為 Id 的屬性未引用識別符號，您可以使用 @Query 註解您的查詢方法以提供自定義查詢。遵循該方法很容易導致混淆，並且不建議這樣做，因為如果 ID 型別與您的 Id 屬性的型別不同，您會很快遇到型別限制。
我們還提供了特定於持久化技術的抽象，例如 JpaRepository 或 MongoRepository。這些介面擴充套件了 CrudRepository，並在 CrudRepository 等通用的、與持久化技術無關的介面之外，暴露了底層持久化技術的能力。

除了 CrudRepository，還有 PagingAndSortingRepository 和 ListPagingAndSortingRepository，它們添加了額外的方法，以便於對實體進行分頁訪問。

PagingAndSortingRepository 介面
public interface PagingAndSortingRepository<T, ID>  {

  Iterable<T> findAll(Sort sort);

  Page<T> findAll(Pageable pageable);
}
擴充套件介面必須由實際的儲存模組支援。雖然本文件解釋了通用方案，請確保您的儲存模組支援您想要使用的介面。

要以每頁 20 個元素訪問 User 的第二頁，您可以執行以下操作：

PagingAndSortingRepository<User, Long> repository = // … get access to a bean
Page<User> users = repository.findAll(PageRequest.of(1, 20));

ListPagingAndSortingRepository 提供了等效的方法，但返回 List，而 PagingAndSortingRepository 方法返回 Iterable。

除了查詢方法，計數和刪除查詢的派生查詢也可用。以下列表顯示了派生計數查詢的介面定義：

派生計數查詢
interface UserRepository extends CrudRepository<User, Long> {

  long countByLastname(String lastname);
}

以下列表顯示了派生刪除查詢的介面定義：

實體狀態檢測策略
interface UserRepository extends CrudRepository<User, Long> {

  long deleteByLastname(String lastname);

  List<User> removeByLastname(String lastname);
}

下表描述了 Spring Data 提供的用於檢測實體是否為新的策略：

表 1. Spring Data 中檢測實體是否為新的選項

@Id 屬性檢查（預設）

預設情況下，Spring Data 會檢查給定實體的識別符號屬性。如果識別符號屬性為 null 或（對於基本型別）為 0，則假定該實體是新的。否則，假定它不是新的。

@Version 屬性檢查

如果存在用 @Version 註解的屬性且其值為 null，或者（對於基本型別的版本屬性）為 0，則該實體被認為是新的。如果版本屬性存在但具有不同的值，則該實體被認為不是新的。如果不存在版本屬性，Spring Data 會回退到檢查識別符號屬性。

實現 Persistable

如果實體實現了 Persistable，Spring Data 會將新實體檢測委託給實體的 isNew(…) 方法。詳情請參閱 Javadoc。

注意：如果您使用 AccessType.PROPERTY，Persistable 的屬性將被檢測並持久化。為避免這種情況，請使用 @Transient。

提供自定義的 EntityInformation 實現

您可以透過建立模組特定倉庫工廠的子類並覆蓋 getEntityInformation(…) 方法來定製倉庫基礎實現中使用的 EntityInformation 抽象。然後，您必須將模組特定倉庫工廠的自定義實現註冊為 Spring Bean。請注意，這通常很少需要。

Spring Data Commons