@Query註解的用法(Spring Data JPA)

1. 一個使用@Query註解的簡單例子

@Query(value = "select name,author,price from Book b where b.price>?1 and b.price<?2")
List<Book> findByPriceRange(long price1, long price2);

 

2.  Like表達式

@Query(value = "select name,author,price from Book b where b.name like %:name%")
List<Book> findByNameMatch(@Param("name") String name);

 

3. 使用Native SQL Query

所謂本地查詢，就是使用原生的sql語句（根據數據庫的不一樣，在sql的語法或結構方面可能有所區別）進行查詢數據庫的操做。

@Query(value = "select * from book b where b.name=?1", nativeQuery = true)
List<Book> findByName(String name);

 

4. 使用@Param註解注入參數

@Query(value = "select name,author,price from Book b where b.name = :name AND b.author=:author AND b.price=:price")
List<Book> findByNamedParam(@Param("name") String name, @Param("author") String author,
        @Param("price") long price);

 

5. SPEL表達式(使用時請參考最後的補充說明)

   '#{#entityName}'值爲'Book'對象對應的數據表名稱(book)。

public interface BookQueryRepositoryExample extends Repository<Book, Long>{

       @Query(value = "select * from #{#entityName} b where b.name=?1", nativeQuery = true)
       List<Book> findByName(String name);

}

 

6. 一個較完整的例子

public interface BookQueryRepositoryExample extends Repository<Book, Long> {
    @Query(value = "select * from Book b where b.name=?1", nativeQuery = true) 
    List<Book> findByName(String name);// 此方法sql將會報錯(java.lang.IllegalArgumentException)，看出緣由了嗎,若沒看出來，請看下一個例子

    @Query(value = "select name,author,price from Book b where b.price>?1 and b.price<?2")
    List<Book> findByPriceRange(long price1, long price2);

    @Query(value = "select name,author,price from Book b where b.name like %:name%")
    List<Book> findByNameMatch(@Param("name") String name);

    @Query(value = "select name,author,price from Book b where b.name = :name AND b.author=:author AND b.price=:price")
    List<Book> findByNamedParam(@Param("name") String name, @Param("author") String author,
            @Param("price") long price);

}

 

7.  解釋例6中錯誤的緣由：

     由於指定了nativeQuery = true，即便用原生的sql語句查詢。使用java對象'Book'做爲表名來查天然是不對的。只需將Book替換爲表名book。

@Query(value = "select * from book b where b.name=?1", nativeQuery = true)
List<Book> findByName(String name);

 

 

補充說明(2017-01-12)：

　　有同窗提出來了，例子5中用'#{#entityName}'爲啥取不到值啊？

　　先來講一說'#{#entityName}'究竟是個啥。從字面來看，'#{#entityName}'不就是實體類的名稱麼，對，他就是。

　　實體類Book,使用@Entity註解後，spring會將實體類Book歸入管理。默認'#{#entityName}'的值就是'Book'。

　　可是若是使用了@Entity(name = "book")來註解實體類Book,此時'#{#entityName}'的值就變成了'book'。

　　到此，事情就明瞭了，只須要在用@Entity來註解實體類時指定name爲此實體類對應的表名。在原生sql語句中，就能夠把'#{#entityName}'來做爲數據表名使用。