/**
 * 獲取自定義SQL 簡化自定義XML復雜情況
 * 使用方法：自定義sql + ${ew.customSqlSegment}
 * 1.邏輯刪除需要自己拼接條件 (之前自定義也同樣)
 * 2.不支持wrapper中附帶實體的情況 (wrapper自帶實體會更麻煩)
 * 3.用法 ${ew.customSqlSegment} (不需要where標簽包裹,切記!)
 * 4.ew是wrapper定義別名,可自行替換
 */
public abstract String getCustomSqlSegment();

@Override
public String getCustomSqlSegment() {
 // MergeSegments 為 返回 合并 SQL 片段
 MergeSegments expression = getExpression();
 if (Objects.nonNull(expression)) {
  NormalSegmentList normal = expression.getNormal();
  String sqlSegment = getSqlSegment();
  if (StringUtils.isNotEmpty(sqlSegment)) {
   if (normal.isEmpty()) {
    return sqlSegment;
   } else {
    return concatWhere(sqlSegment);
   }
  }
 }
 return StringUtils.EMPTY;
}
/**
  * 拼接`WHERE`至SQL前
  *
  * @param sql sql
  * @return 帶 where 的 sql
  */
private String concatWhere(String sql) {
 return Constants.WHERE + " " + sql;
}

@Mapper
public interface ReseDao extends BaseMapper<ReseEntity> {
 /**
  * 分頁查詢
  * @param page：mybatisPlus 原生分頁查詢，查詢SQL會自動拼接分頁
  * @param queryWrapper：QueryWrapper條件，注意，這里需要使用 @Param("ew") 指定mybatis參數(shù)
  * @return
  */
 IPage<ReseEntity> getReseList(IPage<T> page, @Param("ew") QueryWrapper<ReseEntity> queryWrapper);
}

<select id="getReseList" resultMap="reseMap">
 SELECT
  r.rese_id,
  r.rese_no,
  w.WORK_Name
 FROM
  t_s_db_rese r
  left join t_s_db_work w
  on r.WORK_id = w.WORK_id 
  ${ew.customSqlSegment}
</select>

/**
 * 分頁查詢
 * getPage(params, null, false)： 方法用來拼接mybatis plus 分頁組件的那個類
 * getWrapper(params)：方法用來拼接 QueryWrapper 條件構造器
 */
@Override
public PageData<ReseDTO> page(Map<String, Object> params) {
 IPage<ReseEntity> page = reseDao.getReseList(
  // 調用 分頁組件返回 IPage對象
   getPage(params, null, false),
  // 調用 條件構造器 返回 Wrapper
   getWrapper(params)
 );
 return getPageData(page, ReseDTO.class);
}

/**
* 查詢條件：調用構造器
* @param params 查詢條件，如果需要分頁，則這個里面有分頁參數(shù)
* @return
*/
private QueryWrapper<ReseEntity> getWrapper(Map<String, Object> params) {
 QueryWrapper<CarBrandEntity> wrapper = new QueryWrapper<>();
 /*
 eq 等于 =  參數(shù)說明：
 參數(shù)1、params.get("xxx") != null ：如果不為null，則將eq添加到wrapper中；為null不添加
 參數(shù)2、w.WORK_Name，數(shù)據(jù)中的字段，多表查詢指定要指定字段的表前綴
 參數(shù)3、params.get("xxx")，輸入的查詢添加
 若下面eq( )方法成立，添加在wrapper中，則查詢SQL如下：
 SELECT r.rese_id, r.rese_no, w.WORK_Name
  FROM t_s_db_rese r
   left join t_s_db_work w
   on r.WORK_id = w.WORK_id 
  where w.WORK_Name = "查詢條件"
 */
 wrapper.eq(params.get("xxx") != null, "w.WORK_Name", params.get("xxx"));

 return wrapper;
}

 /***
  * 分頁查詢
  * @param params 查詢條件，主要是分頁的（頁碼、顯示內容、排序規(guī)則）
  * @param defaultOrderField 默認排序規(guī)則
  * @param isAsc 是否排序
  * @return
  */
public IPage getPage(Map<String, Object> params, String defaultOrderField, boolean isAsc) {
 long curPage = 1L;
 long limit = 20L;
 if (params.get(Constant.PAGE) != null) {
  curPage = Long.parseLong((String) params.get(Constant.PAGE));
 }
 if (params.get(Constant.LIMIT) != null) {
  limit = Long.parseLong((String) params.get(Constant.LIMIT));
 }

 Page page = new Page(curPage, limit);
 
 if (isAsc) {
  page.setAsc(new String[]{defaultOrderField});
  } else {
   page.setDesc(new String[]{defaultOrderField});
  }

 return page;
}