Spring Data JPA - 如何创建查询（5) @Query

作者简介

陈喆，现就职于中科院某研究所担任副研究员，专注于工业云平台、MES系统的设计与研发。

内容来源：https://docs.spring.io/spring-data/jpa/docs/2.0.9.RELEASE/reference/html/#jpa.query-methods.at-query

使用Named Query为实体创建查询适用于定义少量查询。Named Query需要声明在实体类上，但也可以使用Spring Data JPA 的@Query注解将查询绑定到repository的函数上。

注解到查询方法上的Query优先于Named Query。

下例演示使用@Query注解：

public interface UserRepository extends JpaRepository<User, Long> {

  @Query("select u from User u where u.emailAddress = ?1")
  User findByEmailAddress(String emailAddress);
}

使用LIKE表达式

在@Query中使用like表达式：

public interface UserRepository extends JpaRepository<User, Long> {

  @Query("select u from User u where u.firstname like %?1")
  List<User> findByFirstnameEndsWith(String firstname);
}

在上例中，算法会识别出LIKE的分隔符（%），然后将查询转换成有效的JPQL查询语句（移除%）.

本地查询

@Query注解通过设置nativeQuery标识支持执行本地查询语句：

public interface UserRepository extends JpaRepository<User, Long> {

  @Query(value = "SELECT * FROM USERS WHERE EMAIL_ADDRESS = ?1", nativeQuery = true)
  User findByEmailAddress(String emailAddress);
}

Spring Data JPA目前不支持在本地查询中进行动态排序，因为这需要操作实际的查询语句，而这对于原生SQL是不可靠的。但你可以通过指定count查询实现分页查询：

public interface UserRepository extends JpaRepository<User, Long> {

  @Query(value = "SELECT * FROM USERS WHERE LASTNAME = ?1",
    countQuery = "SELECT count(*) FROM USERS WHERE LASTNAME = ?1",
    nativeQuery = true)
  Page<User> findByLastname(String lastname, Pageable pageable);
}