SpringData JPA的常用語法彙總

2022-06-08 22:01:19

前言

SpringData JPA常用有兩種寫法，一個是用Jpa自帶方法進行CRUD，適合簡單查詢場景、例如查詢全部資料、根據某個欄位查詢，根據某欄位排序等等。另一種是使用註解方式，@Query、@Modifying。

1.方法方式

方法說明

介面方法如下，方法作用見註釋：

public interface JpaRepository<T, ID> extends PagingAndSortingRepository<T, ID>, QueryByExampleExecutor<T> {
    // 無條件，查詢全部記錄
    List<T> findAll();
    // 排序查詢
    List<T> findAll(Sort var1);
    // 根據主鍵ID查詢
    List<T> findAllById(Iterable<ID> var1);
    // 批次儲存集合資料
    <S extends T> List<S> saveAll(Iterable<S> var1);

    void flush();
 
    <S extends T> S saveAndFlush(S var1);
    // 批次刪除
    void deleteInBatch(Iterable<T> var1);
    // all in 全部刪除
    void deleteAllInBatch();
    // 查詢一條記錄
    T getOne(ID var1);
    // 條件查詢
    <S extends T> List<S> findAll(Example<S> var1);
    // 條件查詢，帶排序
    <S extends T> List<S> findAll(Example<S> var1, Sort var2);
}

例子

一般dao實現JpaRepository介面，直接呼叫JpaRepository中的方法就可以實現了簡單查詢，例如查詢User範例列表：

// 構建user的Example物件
Example<User> example =Example.of(User);
List<User> users = userRepository.findAll(example);

2.註解方式

jpa實現CRUD的主要註解是@Query

註解說明

@Query註解主要有以下引數，引數作用如下：

value：SQL語句
countQuery: 分頁查詢時統計總數
nativeQuery: 使用執行這個方法的時候執行原生sql語句，直接寫資料庫中的實際表名和表的實際欄位名

@Query的程式碼如下：

@Retention(RetentionPolicy.RUNTIME)
@Target({ElementType.METHOD, ElementType.ANNOTATION_TYPE})
@QueryAnnotation
@Documented
public @interface Query {
    String value() default "";
    String countQuery() default "";
    String countProjection() default "";
    boolean nativeQuery() default false;
    String name() default "";
    String countName() default "";
}

例子

使用註解方式分組查詢

跟正常寫sql語句相同，將sql寫到value中，並且nativeQuery = true。下面例子是根據task_id進行分組查詢task集合

@Query(value = "select task_id from task group by task_id", nativeQuery = true)
List<Task> queryByGroup();

使用註解方式排序

根據task_id進行排序查詢task集合

@Query(value = "select task_id,task_date from task order by task_id", nativeQuery = true)
List<Task> queryOrder();

使用註解方式條件查詢

條件查詢時可以使用欄位名操作符 ?；例如：task_date >= ?，使用位置匹配?。也可以使用欄位名操作符 :屬性名；例如：task_date >= :startDate，使用屬性名匹配，推薦使用後者，如果欄位順序修改，不影響匹配結果。下面是根據任務時間（task_date）段內和未被刪除(deleted)的任務

@Query(value = "select task_id,task_date from task where task_date >=? and task_date <=? and deleted=0 ", nativeQuery = true)
List<ApptTask> queryDate(@Param("startDate") String startDate, @Param("endDate") String endDate);

使用註解方式修改

修改一條資料需要加上@Modifying用於標識是修改操作，預設事務等級是唯讀，所以還需要加上@Transactional，這樣覆蓋了預設的@Transactional才可以執行修改操作。下面是根據task_id更新task表的備註資訊

@Transactional(rollbackOn = Exception.class)
@Modifying
@Query(value = "update task set remark = ? where task_id=?", nativeQuery = true)
void updateRemark(@Param("remark") String remark, @Param("taskId") String taskId);

多表聯查，且多條件、分頁查詢怎麼寫？

複雜的查詢需要注意，以下使用一個Mysql的多表聯查的例子來說明覆雜的查詢要怎麼寫。下面是user表task表關聯查詢出任務名稱、任務ID、使用者名稱稱這些資訊，並且根據task_name、task_date進行過濾；根據task_date倒序。

共有幾點需要注意：

多表聯查使用正常的JOIN就可以
多條件是常見的情況，需要區別傳入的條件是否要去執行，這種情況需要使用where 1=1 and 這種方式來保證條件不傳時仍然正常查詢。
分頁查詢需要傳入分頁引數Pageable,並且寫countQuery來統計總數。
多條件查詢關鍵：if(:引數!='',k.欄位名 =:引數,1=1)，這裡是使用了if進行判斷，這個寫法類似Mybatis xml中的<if>標籤。if的含義是代表傳入的引數如果不為""（Spring型別空是""而不是null）將引數傳入，如果為空時顯示1=1 代表引數為真，對查詢結果不產生作用。

程式碼：

@Query(value =
      " select a.task_name, a.task_id,u.user_name" +
      " from task a " +
      " LEFT JOIN usert u" +
      " ON a.user_id = u.user_id" +
      " where  a.deleted=0  " +
      " AND if(:taskName!='',a.task_name =:taskName,1=1)" +
      " AND if(:startDate!='',a.task_date >=:startDate,1=1)" +
      " AND if(:endDate!='',a.task_date <=:endDate,1=1)" +
      " order by a.task_date desc"
      , 
      nativeQuery = true
      , 
      countQuery =
      " select count(*)" +
      " from task a " +
      " LEFT JOIN usert u" +
      " ON a.user_id = u.user_id" +
      " where  a.deleted=0  " +
      " AND if(:taskName!='',a.task_name =:taskName,1=1)" +
      " AND if(:startDate!='',a.task_date >=:startDate,1=1)" +
      " AND if(:endDate!='',a.task_date <=:endDate,1=1)" +
      " order by a.task_date desc")
Page<Map<String,Object>> queryUserTaskPage(@Param("taskName") String taskName, @Param("startDate") LocalDate startDate, @Param("endDate") LocalDate endDate, @Param("pageable") Pageable pageable);