前言

使用Mybatis的开发者,大多数都会遇到一个问题,就是要写大量的SQL在xml文件中,除了特殊的业务逻辑SQL之外,还有大量结构类似的增删改查SQL。而且,当数据库表结构改动时,对应的所有SQL以及实体类都需要更改。这工作量和效率的影响或许就是区别增删改查程序员和真正程序员的屏障。这时,通用Mapper便应运而生……

什么是通用Mapper

通用Mapper就是为了解决单表增删改查,基于Mybatis的插件。开发人员不需要编写SQL,不需要在DAO中增加方法,只要写好实体类,就能支持相应的增删改查方法

如何使用

以MySQL为例,假设存在这样一张表:

  1. CREATE TABLE `test_table` (
  2. `id` bigint(20) NOT NULL AUTO_INCREMENT,
  3. `name` varchar(255) DEFAULT '',
  4. `create_time` datetime DEFAULT NULL,
  5. `create_user_id` varchar(32) DEFAULT NULL,
  6. `update_time` datetime DEFAULT NULL,
  7. `update_user_id` varchar(32) DEFAULT NULL,
  8. `is_delete` int(8) DEFAULT NULL,
  9. PRIMARY KEY (`id`)
  10. ) ENGINE=InnoDB AUTO_INCREMENT=1 DEFAULT CHARSET=utf8;

主键是id,自增。下面以这张表为例介绍如何使用通用Mapper。

Maven依赖

  1. <!-- 通用Mapper -->
  2. <dependency>
  3. <groupId>tk.mybatis</groupId>
  4. <artifactId>mapper</artifactId>
  5. <version>3.3.9</version>
  6. </dependency>

SpringMVC配置

  1. <!-- 通用 Mapper -->
  2. <bean class="tk.mybatis.spring.mapper.MapperScannerConfigurer">
  3. <property name="basePackage" value="cn.com.bluemoon.bd.service.spider.dao"/>
  4. <property name="properties">
  5. <value>
  6. mappers=tk.mybatis.mapper.common.Mapper
  7. </value>
  8. </property>
  9. </bean>

注意这里使用tk.mybatis.spring.mapper.MapperScannerConfigure替换原来Mybatis的org.mybatis.spring.mapper.MapperScannerConfigurer。 

  1. 可配参数介绍:
  2. 1.UUID:设置生成UUID的方法,需要用OGNL方式配置,不限制返回值,但是必须和字段类型匹配
  3. 2.IDENTITY:取回主键的方式,可以配置的内容看下一篇如何使用中的介绍
  4. 3.ORDER:<seletKey>中的order属性,可选值为BEFOREAFTER
  5. 4.catalog:数据库的catalog,如果设置该值,查询的时候表名会带catalog设置的前缀
  6. 5.schema:同catalogcatalog优先级高于schema
  7. 6.seqFormat:序列的获取规则,使用{num}格式化参数,默认值为{0}.nextval,针对Oracle,可选参数一共4个,对应0,1,2,3分别为SequenceNameColumnName, PropertyNameTableName
  8. 7.notEmptyinsertupdate中,是否判断字符串类型!=’’,少数方法会用到
  9. 8style:实体和表转换时的规则,默认驼峰转下划线,可选值为normal用实体名和字段名;camelhump是默认值,驼峰转下划线;uppercase转换为大写;lowercase转换为小写
  10. 9.enableMethodAnnotation:可以控制是否支持方法上的JPA注解,默认false
  11. 大多数情况下不会用到这些参数,有特殊情况可以自行研究。

实体类的写法

记住一个原则:实体类的字段数量 >= 数据库表中需要操作的字段数量。默认情况下,实体类中的所有字段都会作为表中的字段来操作,如果有额外的字段,必须加上@Transient注解。

  1. @Table(name = "test_table")
  2. public class TestTableVO implements Serializable {
  3.  
  4. private static final long serialVersionUID = 1L;
  5.  
  6. @Id
  7. @GeneratedValue(generator = "JDBC")
  8. private Long id;
  9.  
  10. @Transient
  11. private String userId;
  12.  
  13. private String name;
  14.  
  15. private Timestamp createTime;
  16.  
  17. private String createUserId;
  18.  
  19. private Timestamp updateTime;
  20.  
  21. private String updateUserId;
  22.  
  23. private Integer isDelete;
  24.  
  25. // 省略get、set...
  26. }

说明:

  1. 表名默认使用类名,驼峰转下划线(只对大写字母进行处理),如UserInfo默认对应的表名为user_info
  2. 表名可以使用@Table(name = "tableName")进行指定,对不符合第一条默认规则的可以通过这种方式指定表名.
  3. 字段默认和@Column一样,都会作为表字段,表字段默认为Java对象的Field名字驼峰转下划线形式.
  4. 可以使用@Column(name = "fieldName")指定不符合第3条规则的字段名
  5. 使用@Transient注解可以忽略字段,添加该注解的字段不会作为表字段使用.
  6. 建议一定是有一个@Id注解作为主键的字段,可以有多个@Id注解的字段作为联合主键.
  7. 如果是MySQL的自增字段,加上@GeneratedValue(generator = "JDBC")即可。如果是其他数据库,可以参考官网文档

DAO的写法

在传统的Mybatis写法中,DAO接口需要与Mapper文件关联,即需要编写SQL来实现DAO接口中的方法。而在通用Mapper中,DAO只需要继承一个通用接口,即可拥有丰富的方法:

  1. public interface TestTableDao extends Mapper<TestTableVO> {
  2. }

继承通用的Mapper,必须指定泛型

一旦继承了Mapper,继承的Mapper就拥有了Mapper所有的通用方法:

Select
方法:List<T> select(T record);
说明:根据实体中的属性值进行查询,查询条件使用等号  

方法:T selectByPrimaryKey(Object key);
说明:根据主键字段进行查询,方法参数必须包含完整的主键属性,查询条件使用等号

方法:List<T> selectAll();
说明:查询全部结果,select(null)方法能达到同样的效果

方法:T selectOne(T record);
说明:根据实体中的属性进行查询,只能有一个返回值,有多个结果是抛出异常,查询条件使用等号

方法:int selectCount(T record);
说明:根据实体中的属性查询总数,查询条件使用等号

Insert
方法:int insert(T record);
说明:保存一个实体,null的属性也会保存,不会使用数据库默认值

方法:int insertSelective(T record);
说明:保存一个实体,null的属性不会保存,会使用数据库默认值

Update
方法:int updateByPrimaryKey(T record);
说明:根据主键更新实体全部字段,null值会被更新

方法:int updateByPrimaryKeySelective(T record);
说明:根据主键更新属性不为null的值

Delete
方法:int delete(T record);
说明:根据实体属性作为条件进行删除,查询条件使用等号

方法:int deleteByPrimaryKey(Object key);
说明:根据主键字段进行删除,方法参数必须包含完整的主键属性

Example方法
方法:List<T> selectByExample(Object example);
说明:根据Example条件进行查询

重点:这个查询支持通过Example类指定查询列,通过selectProperties方法指定查询列

方法:int selectCountByExample(Object example);
说明:根据Example条件进行查询总数

方法:int updateByExample(@Param("record") T record, @Param("example") Object example);
说明:根据Example条件更新实体record包含的全部属性,null值会被更新

方法:int updateByExampleSelective(@Param("record") T record, @Param("example") Object example);
说明:根据Example条件更新实体record包含的不是null的属性值

方法:int deleteByExample(Object example);
说明:根据Example条件删除数据

代码中使用

service中注入dao,即可使用

  1. @Autowired
  2. private TestTableDao testTableDao;

新增

  1. TestTableVO vo = new TestTableVO();
  2. // 省略为vo设置属性...
  3. int row = testTableDao.insertSelective(vo);

修改

  1. TestTableVO vo = new TestTableVO();
  2. // 省略为vo设置属性...
  3. int row = testTableDao.updateByPrimaryKeySelective(vo);

查询单个

  1. TestTableVO vo = new TestTableVO();
  2. vo.setId(123L);
  3. TestTableVO result = testTableDao.selectOne(vo);

条件查询

  1. // 创建Example
  2. Example example = new Example(TestTableVO.class);
  3. // 创建Criteria
  4. Example.Criteria criteria = example.createCriteria();
  5. // 添加条件
  6. criteria.andEqualTo("isDelete", 0);
  7. criteria.andLike("name", "%abc123%");
  8. List<TestTableVO> list = testTableDao.selectByExample(example);

总结

通用Mapper的原理是通过反射获取实体类的信息,构造出相应的SQL,因此我们只需要维护好实体类即可,对于应付复杂多变的需求提供了很大的便利。上文叙述的只是通用Mapper的简单用法,在实际项目中,还是要根据业务,在通用Mapper的基础上封装出粒度更大、更通用、更好用的方法。

附 Spring Boot 配置

  1. <!--mybatis-->
  2. <dependency>
  3. <groupId>org.mybatis.spring.boot</groupId>
  4. <artifactId>mybatis-spring-boot-starter</artifactId>
  5. <version>1.3.1</version>
  6. </dependency>
  7. <!--mapper-->
  8. <dependency>
  9. <groupId>tk.mybatis</groupId>
  10. <artifactId>mapper-spring-boot-starter</artifactId>
  11. <version>1.1.4</version>
  12. </dependency>
  1. #mapper
  2. #mappers 多个接口时逗号隔开
  3. mapper.mappers=tk.mybatis.mapper.common.Mapper
  4. mapper.not-empty=false
  5. mapper.identity=MYSQL

Example举例:

  1. public List<TestTableVO> getByExample(String name) {
  2. //查询器
  3. Example example = new Example(TestTableVO.class);
  4. //获得criteria
  5. Example.Criteria criteria=example.createCriteria();
  6. //参数为 属性名+值
  7. criteria.andEqualTo("name",name);
  8. //排序
  9. example.orderBy("age").desc();
  10. return testTableDao.selectByExample(example);
  11. }

模糊查询:

  1. public List<TestTableVO> getByExampleAndKey(String key) {
  2. //查询器
  3. Example example = new Example(TestTableVO.class);
  4. Example.Criteria criteria=example.createCriteria();
  5. /**
  6. * 第一个参数是key:值得属性
  7. * 第二个是值:指匹配的值
  8. */
  9. criteria.andLike("name", "%"+ key +"%");
  10. return testTableDao.selectByExample(example);
  11. }

 

  

  

  

 

Mybatis通用Mapper介绍与使用的更多相关文章

  1. Mybatis通用Mapper介绍和使用

    Mybatis通用Mapper介绍与使用 前言 使用Mybatis的开发者,大多数都会遇到一个问题,就是要写大量的SQL在xml文件中,除了特殊的业务逻辑SQL之外,还有大量结构类似的增删改查SQL. ...

  2. 详解Mybatis通用Mapper介绍与使用

    使用Mybatis的开发者,大多数都会遇到一个问题,就是要写大量的SQL在xml文件中,除了特殊的业务逻辑SQL之外,还有大量结构类似的增删改查SQL.而且,当数据库表结构改动时,对应的所有SQL以及 ...

  3. 值得收藏的Mybatis通用Mapper使用大全。

    引言 由于小编的记性不太好,每次在写代码的时候总是把通用mapper的方法记错,所以今天把通用mapper的常用方法做一下总结,方便以后直接查看.好了,不废话啦. 引包 <!-- 通用Mappe ...

  4. SpringBoot 3.SpringBoot 整合 MyBatis 逆向工程以及 MyBatis 通用 Mapper

    一.添加所需依赖,当前完整的pom文件如下: <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi=&qu ...

  5. Spring boot集成 MyBatis 通用Mapper

    配置 POM文件 <parent> <groupId>org.springframework.boot</groupId> <artifactId>sp ...

  6. (一 、上)搭建简单的SpringBoot + java + maven + mysql + Mybatis+通用Mapper 《附项目源码》

    最近公司一直使用 springBoot 作为后端项目框架, 也负责搭建了几个新项目的后端框架.在使用了一段时间springBoot 后,感觉写代码 比spring 更加简洁了(是非常简洁),整合工具也 ...

  7. spring boot集成MyBatis 通用Mapper 使用总结

    spring boot集成MyBatis 通用Mapper 使用总结 2019年 参考资料: Spring boot集成 MyBatis 通用Mapper SpringBoot框架之通用mapper插 ...

  8. springboot学习笔记:8. springboot+druid+mysql+mybatis+通用mapper+pagehelper+mybatis-generator+freemarker+layui

    前言: 开发环境:IDEA+jdk1.8+windows10 目标:使用springboot整合druid数据源+mysql+mybatis+通用mapper插件+pagehelper插件+mybat ...

  9. springboot学习笔记:9.springboot+mybatis+通用mapper+多数据源

    本文承接上一篇文章:springboot学习笔记:8. springboot+druid+mysql+mybatis+通用mapper+pagehelper+mybatis-generator+fre ...

随机推荐

  1. [第二章]c++学习笔记1(类和对象的基础2)

    类的成员函数可和类的定义分开写 类成员的可访问范围(private,public,protected) 具体使用方法 使用例

  2. gorm框架表名自动加s问题

    查看日志会发现表名自动加了s 在model实现以下方法即可解决 type UsUser struct { ID int64 `gorm:"column:id" db:"c ...

  3. psutil模块详解

    import psutil#1.系统性能信息模块psutilmem = psutil.virtual_memory()print(mem)#svmem(total=8442675200, availa ...

  4. 关于linux系统密码策略的设置

    由于工作需要最近需要将公司的多台linux服务器进行密码策略的设置,主要内容是增加密码复杂度. 操作步骤如下,不会的同学可以参考: 操作前需要掌握如下几个简单的知识点:(其实不掌握也行,不过学学没坏处 ...

  5. Docker部署 Mysql .Net6等容器

    Centos8安装Docker 1.更新一下yum [root@VM-24-9-centos ~]# yum -y update 2.安装containerd.io # centos8默认使用podm ...

  6. 「3dmax」快速配置3DMax

    3DMax学习 1.0.认识3dmax 3dmax(3D Studio Max),版权Autodesk公司持有.是基于PC系统的三维动画渲染和制作软件,主要用于模型构建和骨骼动画制作.行业使用分布广泛 ...

  7. [loj3032]馕

    (直接贪心会导致分子和分母过大) 令$S_{i}=\sum_{j=1}^{L}V_{i,j}$(即其独吞整个馕的快乐度),对第$i$个人求出$n$个位置$x_{1},x_{2},...,x_{n-1} ...

  8. [atARC113F]Social Distance

    (由于是实数范围,端点足够小,因此区间都使用中括号,且符号取等号) 定义$P(X)$表示$\forall 2\le i\le n,a_{i}-a_{i-1}\ge X$的概率,那么我们所求的也就是$P ...

  9. [atARC105F]Lights Out on Connected Graph

    记$G[S]$表示图$G$在点集$S$上的导出子图,即$G[S]=(S,{(x,y)|x,y\in S且(x,y)\in E})$ 定义$g(S)$为所有$E'$(满足$E'\subseteq G[S ...

  10. SuperEdge再添国产智能加速卡支持,为边缘智能推理再提速10倍

    作者 寒武纪AE团队,腾讯云容器中心边缘计算团队,SuperEdge 开发者 SuperEdge 支持国产智能加速卡寒武纪 MLU220 SuperEdge 对应的商业产品 TKE Edge 也一直在 ...