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>

最后补充一句，有问题一定要看官方文档