Spring Data JPA 简单查询--方法定义规则(详解)

短命女 2024-02-18 20:41 49阅读 0赞

**一、常用规则速查**

1　　 And　　　　并且  
2　　 Or　　　　 或  
3　　 Is,Equals　　　　等于  
4　　 Between　　　　 两者之间  
5　　 LessThan　　　　　　小于  
6　　 LessThanEqual 　　小于等于  
7　　 GreaterThan　　　　 大于  
8　　 GreaterThanEqual　 大于等于  
9　　 After　　　　之后（时间） >  
10　　Before　　　 之前（时间） <  
11　　IsNull　　　　　　　　等于Null  
12　　IsNotNull,NotNull　　 不等于Null  
13　　Like　　　　模糊查询。查询件中需要自己加 %  
14　　NotLike 不在模糊范围内。查询件中需要自己加 %  
15　　StartingWith　　以某开头  
16　　EndingWith　　 以某结束  
17　　Containing　　　包含某  
18　　OrderBy　　排序  
19　　Not　　　　不等于  
20　　In　　　　 某范围内  
21　　NotIn　　 某范围外  
22　　True　　　　真  
23　　False　　　 假  
24　　IgnoreCase　　忽略大小写

[![201704130928573.png][]][201704130928573.png]

**二、Spring Data 解析方法名--规则说明**

**1、规则描述**

按照Spring data 定义的规则，查询方法以find|read|get开头（比如 find、findBy、read、readBy、get、getBy），涉及条件查询时，条件的属性用条件关键字连接，要注意的是：条件属性首字母需大写。框架在进行方法名解析时，会先把方法名多余的前缀截取掉，然后对剩下部分进行解析。

如果方法的最后一个参数是 Sort 或者 Pageable 类型，也会提取相关的信息，以便按规则进行排序或者分页查询。

**2、举例说明**

比如 findByUserAddressZip()。框架在解析该方法时，首先剔除 findBy，然后对剩下的属性进行解析，详细规则如下（此处假设该方法针对的域对象为 AccountInfo 类型）：

先判断 userAddressZip （根据 POJO 规范，首字母变为小写，下同）是否为 AccountInfo 的一个属性，如果是，则表示根据该属性进行查询；如果没有该属性，继续第二步；

从右往左截取第一个大写字母开头的字符串（此处为 Zip），然后检查剩下的字符串是否为 AccountInfo 的一个属性，如果是，则表示根据该属性进行查询；如果没有该属性，则重复第二步，继续从右往左截取；最后假设 user 为 AccountInfo 的一个属性；

接着处理剩下部分（ AddressZip ），先判断 user 所对应的类型是否有 addressZip 属性，如果有，则表示该方法最终是根据 "AccountInfo.user.addressZip" 的取值进行查询；否则继续按照步骤 2 的规则从右往左截取，最终表示根据 "AccountInfo.user.address.zip" 的值进行查询。

可能会存在一种特殊情况，比如 AccountInfo 包含一个 user 的属性，也有一个 userAddress 属性，此时会存在混淆。读者可以明确在属性之间加上 "\_" 以显式表达意图，比如 "findByUser\_AddressZip()" 或者 "findByUserAddress\_Zip()"。（强烈建议：无论是否存在混淆，都要在不同类层级之间加上"\_" ，增加代码可读性）

**三、一些情况**

**1、当查询条件为null时。**

**举例说明如下：**

实体定义：对于一个客户实体Cus,包含有name和sex，均是String类型。

查询方法定义：List<Cus> findByNameAndSex(String name,String sex);

使用时：dao.findByNameAndSex(null, "男");

后台生成sql片断：where (cus0\_.name is null) and cus0\_.sex=?

**结论：**当查询时传值是null时，数据库中只有该字段是null的记录才符合条件，并不是说忽略这个条件。也就是说，这种查询方式，只适合于明确查询条件必须传的业务，对于动态查询（条件多少是动态的，例如一般的查询列表，由最终用户使用时决定输入那些查询条件），这种简单查询是不能满足要求的。

**2、排序**

[?][Link 1]

<table style="border-spacing:0px;border:1px solid rgb(204,204,204);margin-top:.54em;text-align:center;width:700px;clear:both;background:none;float:none;height:auto;line-height:1.1em;margin-right:0px;margin-bottom:0px;margin-left:0px;padding:0px;vertical-align:baseline;font-family:Consolas, 'Bitstream Vera Sans Mono', 'Courier New', Courier, monospace;font-size:1em;min-height:auto;"> 
 <tbody style="background:none;float:none;height:auto;line-height:1.1em;margin:0px;padding:0px;text-align:left;vertical-align:baseline;width:auto;font-size:1em;min-height:auto;"> 
  <tr style="background:none;border-top:0px;float:none;height:auto;line-height:1.1em;margin:0px;padding:0px;vertical-align:baseline;width:auto;font-size:1em;min-height:auto;"> 
   <td style="padding:.2em .46em;border-color:rgb(204,204,204);margin:0px;background:none;float:none;height:auto;line-height:1.1em;vertical-align:baseline;width:auto;font-family:Consolas, 'Bitstream Vera Sans Mono', 'Courier New', Courier, monospace;font-size:1em;min-height:auto;color:rgb(175,175,175);"> 
    <div style="line-height:15.4px;margin:0px;padding:0px .5em 0px 1em;background-image:none;border-width:0px 3px 0px 0px;border-right-style:solid;border-right-color:rgb(108,226,108);float:none;height:auto;text-align:right;vertical-align:baseline;width:auto;min-height:auto;white-space:pre;">
      1 
    </div> 
    <div style="line-height:15.4px;margin:0px;padding:0px .5em 0px 1em;background-image:none;border-width:0px 3px 0px 0px;border-right-style:solid;border-right-color:rgb(108,226,108);float:none;height:auto;text-align:right;vertical-align:baseline;width:auto;min-height:auto;white-space:pre;">
      2 
    </div> 
    <div style="line-height:15.4px;margin:0px;padding:0px .5em 0px 1em;background-image:none;border-width:0px 3px 0px 0px;border-right-style:solid;border-right-color:rgb(108,226,108);float:none;height:auto;text-align:right;vertical-align:baseline;width:auto;min-height:auto;white-space:pre;">
      3 
    </div></td> 
   <td style="padding:.2em .46em;border-color:rgb(204,204,204);width:667px;margin:0px;background:none;float:none;height:auto;line-height:1.1em;vertical-align:baseline;font-family:Consolas, 'Bitstream Vera Sans Mono', 'Courier New', Courier, monospace;font-size:1em;min-height:auto;"> 
    <div style="line-height:15.4px;margin:0px;padding:0px;background:none;border:0px;float:none;height:auto;vertical-align:baseline;width:auto;min-height:auto;"> 
     <div style="line-height:15.4px;margin:0px;padding:0px 1em;background-image:none;border:0px;float:none;height:auto;vertical-align:baseline;width:auto;min-height:auto;white-space:pre;"> 
      <code style="margin:3px auto 0px;padding:0px 0px 0px 5px;background:rgb(255,255,255);border-left:3px solid rgb(108,226,108);width:640px;font-size:14px;clear:both;border-top:0px;border-right:0px;border-bottom:0px;float:none;height:auto;vertical-align:baseline;font-family:Consolas, 'Bitstream Vera Sans Mono', 'Courier New', Courier, monospace;min-height:auto;color:#000000;">List&lt;Cus&gt; findBySexOrderByName(String sex); </code> 
      <code style="margin:3px auto 0px;padding:0px 0px 0px 5px;background:rgb(255,255,255);border-left:3px solid rgb(108,226,108);width:640px;font-size:14px;clear:both;border-top:0px;border-right:0px;border-bottom:0px;float:none;height:auto;vertical-align:baseline;font-family:Consolas, 'Bitstream Vera Sans Mono', 'Courier New', Courier, monospace;min-height:auto;color:rgb(0,130,0);">//名称正序（正序时，推荐此方式，简单）</code> 
     </div> 
     <div style="line-height:15.4px;margin:0px;padding:0px 1em;background-image:none;border:0px;float:none;height:auto;vertical-align:baseline;width:auto;min-height:auto;white-space:pre;"> 
      <code style="margin:3px auto 0px;padding:0px 0px 0px 5px;background:rgb(255,255,255);border-left:3px solid rgb(108,226,108);width:640px;font-size:14px;clear:both;border-top:0px;border-right:0px;border-bottom:0px;float:none;height:auto;vertical-align:baseline;font-family:Consolas, 'Bitstream Vera Sans Mono', 'Courier New', Courier, monospace;min-height:auto;color:#000000;">List&lt;Cus&gt; findBySexOrderByNameAsc(String sex); </code> 
      <code style="margin:3px auto 0px;padding:0px 0px 0px 5px;background:rgb(255,255,255);border-left:3px solid rgb(108,226,108);width:640px;font-size:14px;clear:both;border-top:0px;border-right:0px;border-bottom:0px;float:none;height:auto;vertical-align:baseline;font-family:Consolas, 'Bitstream Vera Sans Mono', 'Courier New', Courier, monospace;min-height:auto;color:rgb(0,130,0);">//名称正序（效果同上）</code> 
     </div> 
     <div style="line-height:15.4px;margin:0px;padding:0px 1em;background-image:none;border:0px;float:none;height:auto;vertical-align:baseline;width:auto;min-height:auto;white-space:pre;"> 
      <code style="margin:3px auto 0px;padding:0px 0px 0px 5px;background:rgb(255,255,255);border-left:3px solid rgb(108,226,108);width:640px;font-size:14px;clear:both;border-top:0px;border-right:0px;border-bottom:0px;float:none;height:auto;vertical-align:baseline;font-family:Consolas, 'Bitstream Vera Sans Mono', 'Courier New', Courier, monospace;min-height:auto;color:#000000;">List&lt;Cus&gt; findBySexOrderByNameDesc(String sex); </code> 
      <code style="margin:3px auto 0px;padding:0px 0px 0px 5px;background:rgb(255,255,255);border-left:3px solid rgb(108,226,108);width:640px;font-size:14px;clear:both;border-top:0px;border-right:0px;border-bottom:0px;float:none;height:auto;vertical-align:baseline;font-family:Consolas, 'Bitstream Vera Sans Mono', 'Courier New', Courier, monospace;min-height:auto;color:rgb(0,130,0);">//名称倒序</code> 
     </div> 
    </div></td> 
  </tr> 
 </tbody> 
</table>

以上这篇Spring Data JPA 简单查询--方法定义规则(详解)就是小编分享给大家的全部内容了，希望能给大家一个参考，也希望大家多多支持脚本之家。

[201704130928573.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/01/29/38a2b5fcc6e44436bc0796ff802360a6.png
[Link 1]: http://www.jb51.net/article/111056.htm#