核心概念

在 Spring Data 倉儲抽象層中的核心介面是 Repository。它接受要管理的領域類別以及領域類別的 ID 類型作為類型引數。此介面主要作為標記介面，用於捕捉要使用的類型，並幫助您發現擴展此介面的介面。

Spring Data 認為領域類型是實體，更具體地說是聚合。因此，您會在整個文件中看到術語「實體」，它可以與術語「領域類型」或「聚合」互換使用。

正如您可能在導言中注意到的，它已經暗示了領域驅動概念。我們以 DDD 的意義來考慮領域物件。領域物件具有 ID（否則這些將是無身分識別的值物件），並且當使用某些模式來存取資料時，我們需要以某種方式參考 ID。當我們談論倉儲和查詢方法時，參考 ID 將變得更有意義。

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 屬性，無論其屬性名稱為何。在「定義查詢方法」中閱讀更多相關資訊。

如果名為 Id 的屬性未參考 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 會檢查給定實體的 ID 屬性。如果 ID 屬性為 `null` 或在原始類型的情況下為 `0`，則假定實體為新的。否則，假定它不是新的。
`@Version` 屬性檢查	如果存在以 `@Version` 註解的屬性且為 `null`，或者在原始類型版本屬性的情況下為 `0`，則實體被視為新的。如果版本屬性存在但具有不同的值，則實體被視為不是新的。如果不存在版本屬性，Spring Data 將回退到 ID 屬性的檢查。
實作 `Persistable`	如果實體實作了 `Persistable`，Spring Data 會將新偵測委派給實體的 isNew(…)` 方法。有關詳細資訊，請參閱 Javadoc。 `注意：如果您使用 AccessType.PROPERTY，則會偵測並持久儲存 Persistable 的屬性。為了避免這種情況，請使用 @Transient。`
提供自訂的 `EntityInformation` 實作	您可以透過建立模組特定倉儲工廠的子類別並覆寫 getEntityInformation(…)` 方法來自訂倉儲基礎實作中使用的 EntityInformation 抽象化。然後，您必須將模組特定倉儲工廠的自訂實作註冊為 Spring bean。請注意，這應該很少是必要的。