Mybatis-Plus使用Wrapper執行自定義SQL

最近項目種引入了一個國產插件Mybatis-Plus，看名字就知道了mybatis的增強版，以下簡稱MP。
官方描述：

MyBatis-Plus (opens new window)（簡稱 MP）是一個 MyBatis (opens new window)的增強工具，在 MyBatis 的基礎上只做增強不做改變，為簡化開發、提高效率而生。

使用MP做單表的CRUD簡直不要太舒服，體驗跟JPA一樣，面向接口編程，集成基類就可以快速實現單表的操作。

但是實際業務場景肯定，也是復雜查詢居多，比如條件查詢，分頁查詢，條件分頁組合查詢等各種情況，這個時候如果再想使用Wrapper來做查詢要怎么做呢？之前的版本只滿足分頁，不滿足條件分頁查詢，這個問題現在已經完美解決。

注意事項:

需要mybatis-plus版本 >= 3.0.7 param 參數名要么叫ew,要么加上注解@Param(Constants.WRAPPER) 使用${ew.customSqlSegment} 不支持 Wrapper 內的entity生成where語句

這不在贅述，具體可以查看官方文檔：https://mybatis.plus/guide/wrapper.html#使用-wrapper-自定義sql

這里Wrapper泛型不僅可以使用與實體類對應的表，也可以使用自定義VO，如果使用XML形式，mybatis的resultType依然可以繼續使用。

例子：
Service

public IPage<UserVo> getUserPageList(Integer page, Integer limit,String userName, String userCode) {
	IPage<UserVo> usersPage = new Page<>(page, limit);
	QueryWrapper<UserVo> queryWrapper = new QueryWrapper<>();
	if (StringUtils.isNotBlank(userName)) {
		queryWrapper.like("user_name", userName);
	}
	if (StringUtils.isNotBlank(userCode)) {
		queryWrapper.like("user_no", userCode);
	}
	return userMapper.selectPageVo(usersPage, queryWrapper);
}

Mapper

public interface UserMapper extends BaseMapper<User> {

	IPage<UserVo> selectPageVo(IPage<UserVo> materialsPage, QueryWrapper<UserVo> ew);
}

XML

<select id="selectPageVo" resultMap="voMap">
        select t1.*, 省略... from user t1 省略... ${ew.customSqlSegment}
</select>

最后補充一句，有問題一定要看官方文檔