Repository 接口概述

  1. Repository是一个空接口,即一个标记接口。

2.若我们继承了Repository接口,则该接口会被IOC容器识别为一个Repository bean,纳入到IOC容器中,进而可以在该接口中定义满足一定规范的方法。
使用注解的方式:RepositoryDefinition(domainClass = People.class, idClass = Integer.class)
3.纳入IOC容器需要满足 base-package扫描的repository的包名. 和 extends Repository.

Repository 的子接口

Repository 提供了最基本的数据访问功能,其几个子接口则扩展了一些功能。它们的继承关系如下:

Repository 的接口方法声明规范

简单条件查询: 查询某一个实体类或者集合
按照 Spring Data 的规范,查询方法以 find | read | get 开头
涉及条件查询时,条件的属性用条件关键字连接,要注意的是:条件属性以首字母大写。

  1. 例如:定义一个 Entity 实体类
  2. class User
  3. private String firstName;
  4. private String lastName;
  5. 使用And条件连接时,应这样写:
  6. findByLastNameAndFirstName(String lastName, String firstName);
  7. 条件的属性名称与个数要与参数的位置与个数一一对应

关键字

直接在接口中定义查询方法,如果是符合规范的,可以不用写实现,目前支持的关键字写法如下:
02 Repository 接口 - 图1
02 Repository 接口 - 图2

查询方法解析流程

假如创建如下的查询: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 findByName(String name, Pageable pageable);
List findByName(String name, Sort sort);