目前正在维护的公司的一个项目是一个ssm架构的java项目,dao层的接口有大量数据库查询的方法,一个条件变化就要对应一个方法,再加上一些通用的curd方法,对应一张表的dao层方法有时候多达近20个,果断决定优化一下,经过一番探索,发现了一个mybatis的好伴侣,mybatis-plus,上手容易,简洁高效,这里有官方的文档入口,文档比较详细,本来不想在重复文档内容,但是关上文档,看着自己改过的项目,还是打算在脑海里过一下使用步骤及相关注意事项,顺便记录一下.
MyBatis-plus有什么特色
1.代码生成 2.条件构造器
对我而言,主要的目的是使用它强大的条件构建器.
快速使用步骤:
1.添加pom文件依赖
org.apache.velocity
velocity
1.7
com.baomidou
mybatis-plus
2.0.1
注意:mybatis-plus会自动维护mybatis以及mybatis-spring的依赖,所以不需要引入后两者,避免发生版本冲突.
2.修改配置文件
将mybatis的sqlSessionFactory替换成mybatis-plus的即可,mybatis-plus只做了一些功能的扩展:
在上面的配置中,除了mybatis的常规配置,多了一个分页插件的配置和全局配置,mybatis-plus提供了很方便的使用分页的插件,还有一个全局配置如下:
至此,配置工作就算大功告成了,接下来通过一个简单的例子来感受一下它的使用.
1.新建一个User表:
@TableName("user")
public class User implements Serializable {
/** 用户ID */
private Long id;
/** 用户名 */
private String name;
/** 用户年龄 */
private Integer age;
@TableField(exist = false)
private String state;
}
这里有两个注解需要注意,第一是@tableName("user"),它是指定与数据库表的关联,这里的注解意味着你的数据库里应该有一个名为user的表与之对应,并且数据表的列名应该就是User类的属性,对于User类中有而user表中没有的属性需要加第二个注解@TableField(exist = false),表示排除User类中的属性.
2.新建Dao层接口UserMapper:
/**
* User 表数据库控制层接口
*/
public interface UserMapper extends BaseMapper {
@Select("selectUserList")
List selectUserList(Pagination page,String state);
}
dao接口需要实现Basemapper,这样就能够使用封装好的很多通用方法,另外也可以自己编写方法,@select注解引用自第三步的UserMapper文件
3.新建UserMapper配置文件:
id, name, age
SELECT * FROM sys_user WHERE state=#{state}
4.新建service层类UserService:
/**
*
* User 表数据服务层接口实现类
*
*/
@Service
public class UserService extends ServiceImpl{
public Page selectUserPage(Page page, String state) {
page.setRecords(baseMapper.selectUserList(page,state));
return page;
}
}
UserService继承了ServiceImpl类,mybatis-plus通过这种方式为我们注入了UserMapper,这样可以使用service层默认为我们提供的很多方法,也可以调用我们自己在dao层编写的操作数据库的方法.Page类是mybatis-plus提供分页功能的一个model,继承了Pagination,这样我们也不需要自己再编写一个Page类,直接使用即可.
5,新建controller层UserController
@Controller
public class UserController extends BaseController {
@Autowired
private IUserService userService;
@ResponseBody
@RequestMapping("/page")
public Object selectPage(Model model){
Page page=new Page(1,10);
page = userService.selectUserPage(page, "NORMAL");
return page;
}
以上就完成了一个基本的功能,下面来看一下它的条件构建器.
mybatis-plus的条件构建器
首先看一个条件构建器实例的简单实用.
public void test(){
EntityWrapper ew=new EntityWrapper();
ew.setEntity(new User());
String name="wang";
Integer age=16;
ew.where("name = {0}",name).andNew("age > {0}",age).orderBy("age");
List list = userService.selectList(ew);
Page page2 = userService.selectPage(page, ew);
}
这里使用了一个条件包装类EntityWrapper,来进行对sql语句的拼装,原理也很好理解,上面的代码中,第一个list查询的结果就是查询数据库中name=wang并且age>16岁的所有记录并按照age排序.而第二个查询就是再多加一个分页的功能.
基本上来说,使用EntityWrapper可以简单地完成一些条件查询,但如果查询方法使用频率很高的话还是建议自己写在UserMapper里.
那么自定义的mapper方法能不能使用EntityWrapper呢,当然也是可以的.
文档中给了一个这样的例子.
1.在Mappper中定义:
List selectMyPage(RowBounds rowBounds, @Param("ew") Wrapper wrapper);
2.在mapper文件中定义:
SELECT * FROM user ${ew.sqlSegment}
对于EntityMapper的条件拼接,基本可以实现sql中常用的where,and,or,groupby,orderby等语法,具体构建方法可以灵活组合.
@Test
public void testTSQL11() {
/*
* 实体带查询使用方法 输出看结果
*/
ew.setEntity(new User(1));
ew.where("name={0}", "'zhangsan'").and("id=1")
.orNew("status={0}", "0").or("status=1")
.notLike("nlike", "notvalue")
.andNew("new=xx").like("hhh", "ddd")
.andNew("pwd=11").isNotNull("n1,n2").isNull("n3")
.groupBy("x1").groupBy("x2,x3")
.having("x1=11").having("x3=433")
.orderBy("dd").orderBy("d1,d2");
System.out.println(ew.getSqlSegment());
}
参考文档