Spring Data 方法定义规范

梦里梦外; 2021-11-01 10:40 323阅读 0赞

### 方法定义规范 ###

*  简单条件查询
 *  支持的关键字
 *  查询方法流程解析

# 简单条件查询 #

按照 Spring Data 的规范，查询方法以 find read get 开头。涉及条件查询时，条件的属性用条件关键字连接，要注意的是：条件属性以首字母大写。  
  例如：定义一个 Entity 实体类：

class User｛ 
       private String firstName; 
       private String lastName; 
    ｝

使用And条件连接时，条件的属性名称与个数要与参数的位置与个数一一对应，如下：

findByLastNameAndFirstName(String lastName,String firstName);

支持属性的级联查询. 若当前类有符合条件的属性, 则优先使用, 而不使用级联属性. 若需要使用级联属性, 则属性之间使用 \_ 进行连接.  
**查询举例：**  
1.按照id查询

User getUserById(Long id);
    User getById(Long id);

2.查询所有年龄小于90岁的人

List<User> findByAgeLessThan(Long age);

3.查询所有姓赵的人

List<User> findByUsernameStartingWith(String u);

4.查询所有姓赵的、并且id大于50的人

List<User> findByUsernameStartingWithAndIdGreaterThan(String name, Long id);

5.查询所有姓名中包含”上”字的人

List<User> findByUsernameContaining(String name);

6.查询所有姓赵的或者年龄大于90岁的

List<User> findByUsernameStartingWithOrAgeGreaterThan(String name, Long age);

7.查询所有角色为1的用户

List<User> findByRole_Id(Long id);

# 支持的关键字 #

支持的查询关键字如下图：  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3lqbjE5OTU_size_16_color_FFFFFF_t_70]

# 查询方法流程解析 #

为什么写上方法名，JPA就知道你想干嘛了呢？假如创建如下的查询：findByUserDepUuid()，框架在解析该方法时，首先剔除 findBy，然后对剩下的属性进行解析，假设查询实体为Doc：  
  先判断 userDepUuid （根据 POJO 规范，首字母变为小写）是否为查询实体的一个属性，如果是，则表示根据该属性进行查询；如果没有该属性，继续第二步；  
  从右往左截取第一个大写字母开头的字符串(此处为Uuid)，然后检查剩下的字符串是否为查询实体的一个属性，如果是，则表示根据该属性进行查询；如果没有该属性，则重复第二步，继续从右往左截取；最后假设 user 为查询实体的一个属性；  
  接着处理剩下部分（DepUuid），先判断 user 所对应的类型是否有depUuid属性，如果有，则表示该方法最终是根据 “ Doc.user.depUuid” 的取值进行查询；否则继续按照步骤 2 的规则从右往左截取，最终表示根据 “Doc.user.dep.uuid” 的值进行查询。  
  可能会存在一种特殊情况，比如 Doc包含一个 user 的属性，也有一个 userDep 属性，此时会存在混淆。可以明确在属性之间加上 “\_” 以显式表达意图，比如 “findByUser\_DepUuid()” 或者 “findByUserDep\_uuid()”  
  还有一些特殊的参数：例如分页或排序的参数：

Page<UserModel> findByName(String name, Pageable pageable);  
    List<UserModel> findByName(String name, Sort sort);

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3lqbjE5OTU_size_16_color_FFFFFF_t_70]: /images/20211101/8e7acc090bfe4098950f8ed848ce4b4f.png