13-12-17 Spring Data JPA中文文档[1.4.3] - 产品研发部Java架构组 - 产品研发部Wiki
192.168.0.242:8090/pages/viewpage.action?pageId=1802242 4/19
1.2.2 定义查询方法
SpringData通过方法名有两种方式去解析出用户的查询意图：一种是直接通过方法的命名规则去解析，第二种是通过Query去解析，那么当同时存在几种方式时，SpringData怎么去选择这两
种方式呢？好了，SpringData有一个策略去决定到底使用哪种方式：
查询策略：
接下来我们将介绍策略的信息，你可以通过配置<repository>的query-lookup-strategy属性来决定。
CREATE
通过解析方法名字来创建查询。这个策略是删除方法中固定的前缀，然后再来解析其余的部分。
USE_DECLARED_QUERY
它会根据已经定义好的语句去查询，如果找不到，则会抛出异常信息。这个语句可以在某个注解或者方法上定义。根据给定的规范来查找可用选项，如果在方法被调用时没有找到定义的查
询，那么会抛出异常。
CREATE_IF_NOT_FOUND(默认)
这个策略结合了以上两个策略。他会优先查询是否有定义好的查询语句，如果没有，就根据方法的名字去构建查询。这是一个默认策略，如果不特别指定其他策略，那么这个策略会在项目
中沿用。
构建查询
查询构造器是内置在SpringData中的，他是非常强大的，这个构造器会从方法名中剔除掉类似find...By, read...By, 或者get...By的前缀，然后开始解析其余的名字。你可以在方法名中加入更
多的表达式，例如你需要Distinct的约束，那么你可以在方法名中加入Distinct即可。在方法中，第一个By表示着查询语句的开始，你也可以用And或者Or来关联多个条件。
根据方法名解析的查询结果跟数据库是相关，但是，还有几个问题需要注意：
多个属性的查询可以通过连接操作来完成，例如And，Or。当然还有其他的，例如Between，LessThan，GreaterThan，Like。这些操作时跟数据库相关的，当然你还需要看看相关的
数据库文档是否支持这些操作。
你可以使用IngoreCase来忽略被标记的属性的大小写，也可以使用AllIgnoreCase来忽略全部的属性，当然这个也是需要数据库支持才允许的。
你可以使用OrderBy来进行排序查询，排序的方向是Asc跟Desc，如果需要动态排序，请看后面的章节。
属性表达式
好了，将了那么多了，具体的方法名解析查询需要怎样的规则呢？这种方法名查询只能用在被管理的实体类上，就好像之前的案例。假设一个类Person中有个Address，并且Address还有
ZipCode，那么根据ZipCode来查询这个Person需要怎么做呢？
在上面的例子中，我们用x.address.zipCode去检索属性，这种解析算法会在方法名中先找出实体属性的完整部分(AddressZipCode)，检查这部分是不是实体类的属性，如果解析成功，则按
照驼峰式从右到左去解析属性，如：AddressZipCode将分为AddressZip跟Code，在这个时候，我们的属性解析不出Code属性，则会在此用同样的方式切割，分为Address跟ZipCode（如果
第一次分割不能匹配，解析器会向左移动分割点），并继续解析。
为了避免这种解析的问题，你可以用“_”去区分，如下所示：
特殊参数处理
上面的例子已经展示了绑定简单的参数，那么除此之外，我们还可以绑定一些指定的参数，如Pageable和Sort来动态的添加分页、排序查询。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
public interface PersonRepository extends Repository<User, Long> {
List<Person> findByEmailAddressAndLastname(EmailAddress emailAddress, String lastname);
// 需要在语句中使用Distinct关键字，你需要做的是如下
List<Person> findDistinctPeopleByLastnameOrFirstname(String lastname, String firstname);
List<Person> findPeopleDistinctByLastnameOrFirstname(String lastname, String firstname);
// 如果你需要忽略大小写，那么你要用IgnoreCase关键字，你需要做的是如下
List<Person> findByLastnameIgnoreCase(String lastname);
// 所有属性都忽略大小写呢？AllIgnoreCase可以帮到您
List<Person> findByLastnameAndFirstnameAllIgnoreCase(String lastname, String firstname);
// 同样的，如果需要排序的话，那你需要：OrderBy
List<Person> findByLastnameOrderByFirstnameAsc(String lastname);
List<Person> findByLastnameOrderByFirstnameDesc(String lastname);
}
List<Person> findByAddressZipCode(ZipCode zipCode);
List<Person> findByAddress_ZipCode(ZipCode zipCode);
1
2
Page<User> findByLastname(String lastname, Pageable pageable);
评论0