投影
投影
Spring Data 查询方法通常返回仓库管理的一个或多个聚合根实例。但是，有时可能需要根据这些类型的某些属性创建投影。Spring Data 允许建模专用返回类型，以便更选择性地检索托管聚合的局部视图。
想象一下一个仓库和聚合根类型，例如以下示例
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 提供了哪些方法来实现这一点？本章的其余部分将回答这个问题。
| 投影类型是位于实体类型层次结构之外的类型。实体实现的超类和接口位于类型层次结构内，因此返回超类型（或已实现的接口）将返回完全物化的实体的实例。 |
基于接口的投影
限制查询结果仅为姓名属性的最简单方法是声明一个接口，该接口公开要读取的属性的访问器方法，如下例所示
interface NamesOnly {
String getFirstname();
String getLastname();
}这里的重要一点是此处定义的属性与聚合根中的属性完全匹配。这样做允许添加查询方法，如下所示
interface PersonRepository extends Repository<Person, UUID> {
Collection<NamesOnly> findByLastname(String lastname);
}查询执行引擎在运行时为每个返回的元素创建该接口的代理实例，并将对公开方法的调用转发到目标对象。
在您的Repository中声明覆盖基本方法（例如，在CrudRepository、特定于存储的仓库接口或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的对象数组获得。以下示例演示如何从args数组获取方法参数
interface NamesOnly {
@Value("#{args[0] + ' ' + target.firstname + '!'}")
String getSalutation(String prefix);
}同样，对于更复杂的表达式，您应该使用 Spring bean 并让表达式调用方法，如前面所述。
基于类的投影 (DTO)
定义投影的另一种方法是使用值类型 DTO（数据传输对象），其中包含要检索的字段的属性。这些 DTO 类型可以与投影接口完全相同的方式使用，只是不发生代理，并且不能应用嵌套投影。
如果存储通过限制要加载的字段来优化查询执行，则要加载的字段将从公开的构造函数的参数名称中确定。
以下示例显示了一个投影 DTO
record NamesOnly(String firstname, String lastname) {
}Java 记录非常适合定义 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<?>。 |
