投影
Spring Data 查詢方法通常返回一個或多個由 Repository 管理的聚合根（aggregate root）例項。然而，有時可能需要基於這些型別的特定屬性建立投影（projections）。Spring Data 允許建模專用的返回型別，以便更有選擇地檢索受管聚合的部分檢視。
假設一個 Repository 和聚合根型別，示例如下
class Person {
@Id UUID id;
String firstname, lastname;
Address address;
static class Address {
String zipCode, city, street;
}
}
interface PersonRepository extends Repository<Person, UUID> {
Collection<Person> findByLastname(String lastname);
}現在假設我們只想檢索人員的姓名屬性。Spring Data 提供了哪些方法來實現這一點？本章的其餘部分將回答這個問題。
| 投影型別是位於實體型別層次結構之外的型別。實體實現的超類和介面位於型別層次結構內部，因此返回超型別（或實現的介面）將返回完全具象化（fully materialized）的實體例項。 |
基於介面的投影
限制查詢結果僅包含姓名屬性的最簡單方法是宣告一個介面，該介面暴露要讀取屬性的訪問器方法（accessor methods），示例如下
interface NamesOnly {
String getFirstname();
String getLastname();
}這裡重要的是，這裡定義的屬性與聚合根中的屬性完全匹配。這樣做就可以新增一個查詢方法，如下所示
interface PersonRepository extends Repository<Person, UUID> {
Collection<NamesOnly> findByLastname(String lastname);
}查詢執行引擎在執行時為返回的每個元素建立該介面的代理例項，並將對暴露方法的呼叫轉發到目標物件。
在您的 Repository 中宣告一個覆蓋基礎方法（例如在 CrudRepository、特定儲存的 repository 介面或 Simple…Repository 中宣告的方法）會導致呼叫基礎方法，無論宣告的返回型別如何。請確保使用相容的返回型別，因為基礎方法不能用於投影。一些儲存模組支援 @Query 註解，將覆蓋的基礎方法轉換為查詢方法，然後可用於返回投影。 |
投影可以遞迴使用。如果您想包含一些 Address 資訊，可以為此建立一個投影介面，並在 getAddress() 的宣告中返回該介面，示例如下
interface PersonSummary {
String getFirstname();
String getLastname();
AddressSummary getAddress();
interface AddressSummary {
String getCity();
}
}在方法呼叫時，獲取目標例項的 address 屬性，並將其包裝到一個投影代理中。
封閉式投影
如果一個投影介面的所有訪問器方法都與目標聚合的屬性匹配，則認為它是一個封閉式投影。以下示例（我們在本章前面也使用過）是一個封閉式投影
interface NamesOnly {
String getFirstname();
String getLastname();
}如果您使用封閉式投影，Spring Data 可以最佳化查詢執行，因為我們知道支援投影代理所需的所有屬性。有關更多詳細資訊，請參閱參考文件中特定於模組的部分。
開放式投影
投影介面中的訪問器方法也可以使用 @Value 註解計算新值，示例如下
interface NamesOnly {
@Value("#{target.firstname + ' ' + target.lastname}")
String getFullName();
…
}支援投影的聚合根在 target 變數中可用。使用 @Value 的投影介面是開放式投影。在這種情況下，Spring Data 無法應用查詢執行最佳化，因為 SpEL 表示式可以使用聚合根的任何屬性。
@Value 中使用的表示式不應過於複雜——您應該避免在 String 變數中進行程式設計。對於非常簡單的表示式，一個選項是求助於預設方法（Java 8 中引入），示例如下
interface NamesOnly {
String getFirstname();
String getLastname();
default String getFullName() {
return getFirstname().concat(" ").concat(getLastname());
}
}這種方法要求您能夠純粹基於投影介面上暴露的其他訪問器方法來實現邏輯。第二種更靈活的選擇是在 Spring bean 中實現自定義邏輯，然後從 SpEL 表示式中呼叫它，示例如下
@Component
class MyBean {
String getFullName(Person person) {
…
}
}
interface NamesOnly {
@Value("#{@myBean.getFullName(target)}")
String getFullName();
…
}請注意 SpEL 表示式如何引用 myBean 並呼叫 getFullName(…) 方法，以及如何將投影目標作為方法引數轉發。由 SpEL 表示式評估支援的方法也可以使用方法引數，然後可以在表示式中引用這些引數。方法引數透過一個名為 args 的 Object 陣列可用。以下示例展示瞭如何從 args 陣列中獲取方法引數
interface NamesOnly {
@Value("#{args[0] + ' ' + target.firstname + '!'}")
String getSalutation(String prefix);
}同樣，對於更復雜的表示式，您應該使用一個 Spring bean 並讓表示式呼叫一個方法，如前面所述。
基於類的投影 (DTO)
定義投影的另一種方法是使用值型別 DTO（Data Transfer Objects），它們持有要檢索欄位的屬性。這些 DTO 型別的使用方式與投影介面完全相同，但不會發生代理，也不能應用巢狀投影。
如果儲存透過限制要載入的欄位來最佳化查詢執行，則要載入的欄位由暴露的建構函式的引數名稱確定。
以下示例展示了一個投影 DTO
record NamesOnly(String firstname, String lastname) {
}Java Record 是定義 DTO 型別的理想選擇，因為它們遵循值語義：所有欄位都是 private final，並且會自動建立 equals(…)/hashCode()/toString() 方法。或者，您可以使用定義您想投影的屬性的任何類。
動態投影
到目前為止，我們已經將投影型別用作返回型別或集合的元素型別。然而，您可能希望在呼叫時選擇要使用的型別（這使得它成為動態的）。要應用動態投影，請使用如下例所示的查詢方法
interface PersonRepository extends Repository<Person, UUID> {
<T> Collection<T> findByLastname(String lastname, Class<T> type);
}這樣，該方法就可以用於獲取聚合本身，或者應用投影后獲取，示例如下
void someMethod(PersonRepository people) {
Collection<Person> aggregates =
people.findByLastname("Matthews", Person.class);
Collection<NamesOnly> aggregates =
people.findByLastname("Matthews", NamesOnly.class);
}型別為 Class 的查詢引數會被檢查是否符合動態投影引數的要求。如果查詢的實際返回型別等於 Class 引數的泛型引數型別，則匹配的 Class 引數不能用於查詢或 SpEL 表示式中。如果想將 Class 引數用作查詢引數，請確保使用不同的泛型引數，例如 Class<?>。 |
|
使用基於類的投影時，型別必須宣告一個建構函式，以便 Spring Data 可以確定其輸入屬性。如果您的類定義了多個建構函式，則在沒有進一步提示的情況下，無法將其用於 DTO 投影。在這種情況下，如下文所述，使用 |
