SpringData系列五：@Query注解

1、@Query注解：
 这种查询可以声明在 Repository 方法中，摆脱像命名查询那样的约束，将查询直接在相应的接口方法中声明，结构更为清晰，这是 Spring data 的特有实现。

@Query("SELECT p FROM Person p WHERE p.id = (SELECT max(p2.id) FROM Person p2)")
Person getMaxIdPerson();

 索引参数如下所示，索引值从1开始，查询中 ”?X” 个数需要与方法定义的参数个数相一致，并且顺序也要一致。
 命名参数（推荐使用这种方式）：可以定义好参数名，赋值时采用@Param(“参数名”)，而不用管顺序。
 如果是 @Query 中有 LIKE 关键字，后面的参数需要前面或者后面加 %，这样在传递参数值的时候就可以不加 %：

@Query("select o from UserModel o where o.name like ?1%")
public List findByUuidOrAge(String name);

@Query("select o from UserModel o where o.name like %?1")
public List findByUuidOrAge(String name);

@Query("select o from UserModel o where o.name like %?1%")
public List findByUuidOrAge(String name);

 还可以使用@Query来指定本地查询，只要设置nativeQuery为true，比如：

@Query(value="select * from tbl_user where name like %?1" ,nativeQuery=true)
public List findByUuidOrAge(String name);

2、@Modifying注解：
 @Query 与 @Modifying 这两个 annotation一起声明，可定义个性化更新操作，例如只涉及某些字段更新时最为常用，示例如下：

@Modifying
@Query("UPDATE Person p SET p.email = :email WHERE id = :id")
void updatePersonEmail(@Param("id") Integer id, @Param("email") String email);

注意：
 方法的返回值应该是 int，表示更新语句所影响的行数。
 在调用的地方必须加事务，没有事务不能正常执行。
3、事务：
 Spring Data 提供了默认的事务处理方式，即所有的查询均声明为只读事务。
 对于自定义的方法，如需改变 Spring Data 提供的事务默认方式，可以在方法上注解 @Transactional 声明。
 进行多个 Repository 操作时，也应该使它们在同一个事务中处理，按照分层架构的思想，这部分属于业务逻辑层，因此，需要在 Service 层实现对多个 Repository 的调用，并在相应的方法上声明事务。

测试：
在PersonRepsotory定义方法

//查询 id 值最大的那个 Person
//使用 @Query 注解可以自定义 JPQL 语句以实现更灵活的查询
@Query("SELECT p FROM Person p WHERE p.id = (SELECT max(p2.id) FROM Person p2)")
Person getMaxIdPerson();

//为 @Query 注解传递参数的方式1: 使用占位符. 
@Query("SELECT p FROM Person p WHERE p.lastName = ?1 AND p.email = ?2")
List testQueryAnnotationParams1(String lastName, String email);

//为 @Query 注解传递参数的方式1: 命名参数的方式. 
@Query("SELECT p FROM Person p WHERE p.lastName = :lastName AND p.email = :email")
List testQueryAnnotationParams2(@Param("email") String email, @Param("lastName") String lastName);

//SpringData 允许在占位符上添加 %%. 
@Query("SELECT p FROM Person p WHERE p.lastName LIKE %?1% OR p.email LIKE %?2%")
List testQueryAnnotationLikeParam(String lastName, String email);

//SpringData 允许在占位符上添加 %%. 
@Query("SELECT p FROM Person p WHERE p.lastName LIKE %:lastName% OR p.email LIKE %:email%")
List testQueryAnnotationLikeParam2(@Param("email") String email, @Param("lastName") String lastName);

//设置 nativeQuery=true 即可以使用原生的 SQL 查询
@Query(value="SELECT count(id) FROM jpa_persons", nativeQuery=true)
long getTotalCount();

//可以通过自定义的 JPQL 完成 UPDATE 和 DELETE 操作. 注意: JPQL 不支持使用 INSERT
//在 @Query 注解中编写 JPQL 语句, 但必须使用 @Modifying 进行修饰. 以通知 SpringData, 这是一个 UPDATE 或 DELETE 操作
//UPDATE 或 DELETE 操作需要使用事务, 此时需要定义 Service 层. 在 Service 层的方法上添加事务操作. 
//默认情况下, SpringData 的每个方法上有事务, 但都是一个只读事务. 他们不能完成修改操作!
@Modifying
@Query("UPDATE Person p SET p.email = :email WHERE id = :id")
void updatePersonEmail(@Param("id") Integer id, @Param("email") String email);

编写测试方法

@Test
public void testQueryAnnotation(){
	Person person = personRepsotory.getMaxIdPerson();
	System.out.println(person);
}

@Test
public void testQueryAnnotationParams1(){
	List persons = personRepsotory.testQueryAnnotationParams1("AA", "[email protected]");
	System.out.println(persons);
}

@Test
public void testQueryAnnotationParams2(){
	List persons = personRepsotory.testQueryAnnotationParams2("[email protected]", "AA");
	System.out.println(persons);
}

@Test
public void testQueryAnnotationLikeParam(){
	List persons = personRepsotory.testQueryAnnotationLikeParam("%A%", "%bb%");
	System.out.println(persons.size());
	
	List persons1 = personRepsotory.testQueryAnnotationLikeParam2("bb", "A");
	System.out.println(persons1.size());
}

@Test
public void testNativeQuery(){
	long count = personRepsotory.getTotalCount();
	System.out.println(count);
}

@Test
public void testModifying(){
	personService.updatePersonEmail("[email protected]", 1);
}