上表中的关键字可与 结合使用delete…By以创建删除匹配文档的查询。
interface PersonRepository extends Repository {
void deleteWithoutResultByLastname(String lastname);
boolean deleteByLastname(String lastname);
}
删除查询返回查询是应用还是终止而不使用返回值void。
Spring Data 查询方法通常返回存储库管理的聚合根的一个或多个实例。但是,有时可能需要根据这些类型的某些属性创建投影。Spring Data 允许对专用返回类型进行建模,以更有选择地检索托管聚合的部分视图。
想象一个存储库和聚合根类型,例如以下示例:
示例 76. 示例聚合和存储库
class Person {
@Id UUID id;
String firstname, lastname;
Address address;
static class Address {
String zipCode, city, street;
}
}
interface PersonRepository extends Repository {
Collection findByLastname(String lastname);
}
现在假设我们只想检索此人的姓名属性。Spring Data 提供什么方法来实现这一目标?本章的其余部分回答了这个问题。
将查询结果限制为仅名称属性的最简单方法是声明一个接口,该接口公开要读取的属性的访问器方法,如以下示例所示:
示例 77. 用于检索属性子集的投影接口
interface NamesOnly {
String getFirstname();
String getLastname();
}
这里的重要一点是这里定义的属性与聚合根中的属性完全匹配。这样做可以添加一个查询方法,如下所示:
示例 78. 使用基于接口的投影和查询方法的存储库
interface PersonRepository extends Repository {
Collection findByLastname(String lastname);
}
查询执行引擎在运行时为每个返回的元素创建该接口的代理实例,并将对公开方法的调用转发到目标对象。
在您Repository中声明一个覆盖基本方法的方法(例如,在 中声明CrudRepository,特定于商店的存储库接口或Simple…Repository)会导致对基本方法的调用,而不管声明的返回类型如何。确保使用兼容的返回类型,因为基本方法不能用于投影。一些商店模块支持@Query注释将覆盖的基本方法转换为查询方法,然后可用于返回投影。
可以递归地使用投影。如果您还想包含一些Address信息,请为此创建一个投影接口并从 的声明中返回该接口getAddress(),如下例所示:
示例 79. 用于检索属性子集的投影接口
interface PersonSummary {
String getFirstname();
String getLastname();
AddressSummary getAddress();
interface AddressSummary {
String getCity();
}
}
在方法调用时,address获取目标实例的属性并依次包装到投影代理中。
其访问器方法都与目标聚合的属性匹配的投影接口被认为是封闭投影。以下示例(我们在本章前面也使用过)是一个封闭投影:
示例 80. 闭合投影
interface NamesOnly {
String getFirstname();
String getLastname();
}
如果使用封闭投影,Spring Data 可以优化查询执行,因为我们知道支持投影代理所需的所有属性。有关更多详细信息,请参阅参考文档中特定于模块的部分。
投影接口中的访问器方法也可用于通过使用@Value注释计算新值,如以下示例所示:
例 81. 一个开放的投影
interface NamesOnly {
@Value("#{target.firstname + ' ' + target.lastname}")
String getFullName();
…
}
支持投影的聚合根在target变量中可用。使用的投影界面@Value是开放式投影。在这种情况下,Spring Data 无法应用查询执行优化,因为 SpEL 表达式可以使用聚合根的任何属性。
中使用的表达式@Value不应太复杂——您希望避免在String变量中编程。对于非常简单的表达式,一种选择可能是采用默认方法(在 Java 8 中引入),如以下示例所示:
示例 82. 使用自定义逻辑的默认方法的投影界面
interface NamesOnly {
String getFirstname();
String getLastname();
default String getFullName() {
return getFirstname().concat(" ").concat(getLastname());
}
}
这种方法要求您能够纯粹基于投影接口上公开的其他访问器方法来实现逻辑。第二个更灵活的选择是在 Spring bean 中实现自定义逻辑,然后从 SpEL 表达式调用它,如以下示例所示:
示例 83. 示例 Person 对象
@Component
class MyBean {
String getFullName(Person person) {
…
}
}
interface NamesOnly {
@Value("#{@myBean.getFullName(target)}")
String getFullName();
…
}
请注意 SpEL 表达式如何引用myBean和调用该getFullName(…)方法并将投影目标作为方法参数转发。由 SpEL 表达式评估支持的方法也可以使用方法参数,然后可以从表达式中引用这些参数。方法参数可通过Object名为的数组获得args。以下示例显示了如何从args数组中获取方法参数:
示例 84. 示例 Person 对象
interface NamesOnly {
@Value("#{args[0] + ' ' + target.firstname + '!'}")
String getSalutation(String prefix);
}
同样,对于更复杂的表达式,您应该使用 Spring bean 并让表达式调用一个方法,如前所述。
投影接口中的 getter 可以使用可为空的包装器来提高空安全性。当前支持的包装器类型有:
示例 85. 使用可为空包装器的投影接口
interface NamesOnly {
Optional getFirstname();
}
如果基础投影值不是null,则使用包装器类型的当前表示返回值。如果支持值是null,则 getter 方法返回所用包装器类型的空表示。
定义投影的另一种方法是使用值类型 DTO(数据传输对象),这些 DTO 包含应该检索的字段的属性。这些 DTO 类型的使用方式与使用投影接口的方式完全相同,只是不发生代理并且不可以应用嵌套投影。
如果存储通过限制要加载的字段来优化查询执行,则要加载的字段由公开的构造函数的参数名称确定。
以下示例显示了一个投影 DTO:
例 86. 一个投影 DTO
class NamesOnly {
private final String firstname, lastname;
NamesOnly(String firstname, String lastname) {
this.firstname = firstname;
this.lastname = lastname;
}
String getFirstname() {
return this.firstname;
}
String getLastname() {
return this.lastname;
}
// equals(…) and hashCode() implementations
}
避免投影 DTO 的样板代码
您可以使用Project Lombok显着简化 DTO 的代码,它提供了一个@Value注解(不要与@Value前面的接口示例中显示的Spring 的注解混淆)。如果使用 Project Lombok 的@Value注释,之前显示的示例 DTO 将变为以下内容:
@Value class NamesOnly { String firstname, lastname; }
字段是private final默认的,并且该类公开了一个构造函数,该构造函数接受所有字段并自动获取equals(…)和hashCode()实现方法。
到目前为止,我们已经使用投影类型作为集合的返回类型或元素类型。但是,您可能希望选择在调用时使用的类型(这使其成为动态的)。要应用动态投影,请使用如下例所示的查询方法:
示例 87. 使用动态投影参数的存储库
interface PersonRepository extends Repository {
Collection findByLastname(String lastname, Class type);
}
这样,该方法可用于按原样或应用投影获取聚合,如以下示例所示:
示例 88.使用具有动态投影的存储库
void someMethod(PersonRepository people) {
Collection aggregates =
people.findByLastname("Matthews", Person.class);
Collection aggregates =
people.findByLastname("Matthews", NamesOnly.class);
}
内容来源:Spring中国教育管理中心(Spring认证)
2021年2月,VMware公司正式与北京中科卓望网络科技有限公司(以下简称:中科卓望)达成战略合作,授予其 Spring 中国教育管理中心,携手 VMware 全球最新 Spring技术和认证体系,帮助中国院校构建专业教学内容,全面赋能未来开发人
#头条话题发明家##互联网行业哪个职位比较有前途#
页面更新:2024-03-20
本站资料均由网友自行发布提供,仅用于学习交流。如有版权问题,请与我联系,QQ:4156828
© CopyRight 2008-2024 All Rights Reserved. Powered By bs178.com 闽ICP备11008920号-3
闽公网安备35020302034844号