核心概念

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

Spring Data 將域型別視為實體，更具體地說是聚合。因此，您將在整個文件中看到“實體”一詞，它可以與“域型別”或“聚合”互換使用。

正如您在介紹中可能已經注意到的那樣，它已經暗示了領域驅動的概念。我們從 DDD 的意義上考慮領域物件。領域物件具有識別符號（否則這些將是沒有識別符號的值物件），並且在處理某些資料訪問模式時，我們某種程度上需要引用識別符號。當我們談論倉庫和查詢方法時，引用識別符號將變得更有意義。

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)，它們針對域型別識別符號屬性，無論其屬性名稱如何。有關更多資訊，請參閱“定義查詢方法”。

您可以使用 @Query 註解您的查詢方法，以在名為 Id 的屬性不引用識別符號時提供自定義查詢。遵循此路徑很容易導致混淆，並且不鼓勵這樣做，因為如果 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`。

Cassandra 在插入資料時無法生成識別符號。因此，實體必須與識別符號值相關聯。Spring Data 預設透過識別符號檢查來確定實體是否為新。如果您想使用審計，請確保使用樂觀鎖定或實現 Persistable 以進行正確的實體狀態檢測。