Spring--Repository

Spring Data所解决的问题

• Spring Data :提供了一整套数据访问层(DAO)的解决方案，致力于减少数据访问层(DAO)的开发量。它使用一个叫作Repository的接口类为基础，它被定义为访问底层数据模型的超级接口。
• 此接口作为标识接口，里面没有规定任何方法，所有继承这个接口的interface都被spring所管理。
• 而对于某种具体的数据访问操作，则在其子接口中定义。

public interface Repository<T, ID extends Serializable> { 

} 

什么是Repository？

• Spring Data给我们提供几个Repository，基础的Repository提供了最基本的数据访问功能，其几个子接口则扩展了一些功能。它们的继承关系如下：
  • Repository： 仅仅是一个标识，表明任何继承它的均为仓库接口类，方便Spring自动扫描识别
  • CrudRepository： 继承Repository，实现了一组CRUD相关的方法 【save() saveAll() delete() deleteById() deleteAll() findById() findAllById() findAll() existsById() count(),以及其他也可能加all的】
  • PagingAndSortingRepository： 继承CrudRepository，实现了一组分页、排序相关的方法 【排序输入排序参数，返回Iterable对象；分页输入Pageable对象，返回Page对象】
  • JpaRepository： 继承PagingAndSortingRepository，实现一组JPA规范相关的方法【方法名类似Crud那个类，但是对于findxxx方法，如果结果是多个的，crud是返回一个iterable,而jpa直接返回一个list】
  • JpaSpecificationExecutor： 比较特殊，不属于Repository体系，实现一组JPA Criteria查询相关的方法
  • 我们自己定义的XxxxRepository需要继承JpaRepository，这样我们的XxxxRepository接口就具备了通用的数据访问控制层的能力。

注解方式代替继承Repository

@RepositoryDefinition(domainClass = Employee.class, idClass = Integer.class)

Spring Data可以让我们只定义接口，只要遵循spring data的规范，就无需写实现类。

那么，什么是规范?

1. 查询方法以find|read|get开头
2. 涉及条件查询时，条件的属性用条件关键字连接，要注意的是：条件属性以首字母大写其余字母与变量名相同。

解析过程

1. Spring Data JPA框架在进行方法名解析时，会先把方法名多余的前缀截取掉，比如 find、findBy、read、readBy、get、getBy，然后对剩下部分进行解析。
2. 假如创建如下的查询：findByUserDepUuid()，框架在解析该方法时，首先剔除 findBy，然后对剩下的属性进行解析，假设查询实体为Doc
3. 先判断 userDepUuid （根据 POJO 规范，首字母变为小写）是否为查询实体的一个属性，如果是，则表示根据该属性进行查询；如果没有该属性，继续下一步；
4. 从右往左截取第一个大写字母开头的字符串此处为Uuid），然后检查剩下的字符串是否为查询实体的一个属性，如果是，则表示根据该属性进行查询；如果没有该属性，则重复上一步，继续从右往左截取；最后假设user为查询实体的一个属性；
5. 接着处理剩下部分（DepUuid），先判断 user 所对应的类型是否有depUuid属性，如果有，则表示该方法最终是根据 “ Doc.user.depUuid” 的取值进行查询；否则继续按照步骤 3 的规则从右往左截取，最终表示根据 “Doc.user.dep.uuid” 的值进行查询。
6. 可能会存在一种特殊情况，比如 Doc包含一个 user 的属性，也有一个 userDep 属性，此时会存在混淆。可以明确在属性之间加上 "_" 以显式表达意图，比如 "findByUser_DepUuid()" 或者 "findByUserDep_uuid()"

@Query

• 直接在方法上添加@query注解，并写上完整的sql语句

// 查找id最大的员工
@Query("select o from Employee o where id=(select max(id) from Employee t1)")
public Employee getEmployeeByMaxId();   

【注意】这里的Employee不是表名，是在Java代码里声明的对应表的类名

• @Query里面带占位符，方法里传入参数

// 带占位符的sql语句
@Query("select o from Employee o where o.name=?1 and o.age=?2")
public List<Employee> queryParams1(String name, Integer age);

• 借用@Param注解，用（:具名变量）代替占位符，更好记和表示

@Query("select o from Employee o where o.name=:name and o.age=:age")
public List<Employee> queryParams2(@Param("name")String name, @Param("age")Integer age);

• like查询的占位符版本

@Query("select o from Employee o where o.name like %?1%")
public List<Employee> queryLike1(String name);

• like查询的(:具名变量)版本，不用占位符

@Query("select o from Employee o where o.name like %:name%")
public List<Employee> queryLike2(@Param("name")String name);

• 从数据库表中的原生查询

@Query(nativeQuery = true, value = "select count(1) from employee") // count(1)表示计数全部
public long getCount(); 

【注意】这里的employee是数据表，存在于数据库中

更新操作需要@query结合@Modifying、@Transactional，其中@Transactional要放在service里，在service里调用下面被注解的update方法，才是完整的操作过程。

@Modifying
@Query("update Employee o set o.age = :age where o.id = :id")
public void update(@Param("id")Integer id, @Param("age")Integer age);