核心概念

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

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

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

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。

Repository 介面隱含了一些保留方法，例如 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。

除了查詢方法之外，還提供了針對 count 查詢和 delete 查詢的查詢派生。以下列表顯示了派生 count 查詢的介面定義

派生 Count 查詢

interface UserRepository extends CrudRepository<User, Long> {

  long countByLastname(String lastname);
}

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

派生 Delete 查詢

interface UserRepository extends CrudRepository<User, Long> {

  long deleteByLastname(String lastname);

  List<User> removeByLastname(String lastname);
}