MyBatis通用Mapper介绍与使用——帮你写好通用sql

2021-08-11 11:14:10

前言

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

什么是通用Mapper

开发人员不需要编写SQL，不需要在DAO中增加方法，只要写好实体类，就能支持相应的增删改查方法。

如何使用

以MySQL为例，假设存在这样一张表：

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

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

Maven依赖

    <!-- 通用Mapper -->
    <dependency>
        <groupId>tk.mybatis</groupId>
        <artifactId>mapper</artifactId>
        <version>3.3.9</version>
    </dependency>

SpringMVC配置

<!-- 通用 Mapper -->
<bean class="tk.mybatis.spring.mapper.MapperScannerConfigurer">
    <property name="basePackage" value="cn.com.bluemoon.bd.service.spider.dao"/>
    <property name="properties">
        <value>
            mappers=tk.mybatis.mapper.common.Mapper
        </value>
    </property>
</bean>

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

可配参数介绍：

UUID：设置生成UUID的方法，需要使用OGNL方式配置，不限制返回值，但是必须和分段类型匹配
IDENTITY：取回主键的方式，可以配置的内容看下一篇如何使用中的介绍
ORDER：中的订单属性，可选数量BEFORE和AFTER
catalog：数据库的目录，如果设置该值，查询的时候表名会带目录设置的前缀
schema：同目录，目录优先级高于模式
seqFormat：序列的获取规则，使用{num}格式化参数，至少更改{0} .nextval，针对Oracle，可选参数一共4个，对应0,1,2,3分别为序列名称，列名称，属性名称，表名称
notEmpty：insert和update中，是否判断字符串类型！=‘‘，少数方法会用到
style：实体和表转换时的规则，交替驼峰转下划线，可选改变普通用实体名和分段名； camelhump是替换值，驼峰转下划线；大写转换为大写；小写转换为小写
enableMethodAnnotation：可以控制是否支持方法上的JPA注解，默认为false。
大多数情况下不会用到这些参数，有特殊情况可以自行研究。

实体类的写法

记住一个原则：实体类的细分数量> =数据库表中需要操作的细分数量。有时，下，实体类中的所有细分都会作为表中的区分来操作，如果有额外的分配，必须附加@Transient注解。

@Table(name = "test_table")
public class TestTableVO implements Serializable {
    private static final long serialVersionUID = 1L;

    @Id
    @GeneratedValue(generator = "JDBC")
    private Long id;

    @Transient
    private String userId;

    private String name;

    private Timestamp createTime;

    private String createUserId;

    private Timestamp updateTime;

    private String updateUserId;

    private Integer isDelete;
    // 省略get、set...
}

说明：

表名替代使用类名，驼峰转下划线（只对大写字母进行处理），如UserInfo替换对应的表称为user_info。
表名可以使用@Table(name = "tableName")进行指定，对不符合第一条替换规则的可以通过这种方式指定表名。
在@ColumnJava对象的字段名称驼峰转下划线形式上。
可以使用@Column(name = "fieldName")指定不符合第3条规则的细分名
使用@Transient注解可以忽略长度，添加该注解的分段不会作为表分区使用。
建议一定是有一个@Id注解作为主键的分区，可以有多个@Id注解的细分作为联合主键。
如果是MySQL的自增级，加上@GeneratedValue(generator = "JDBC")即可。如果是其他数据库，可以参考官网文档。

DAO的写法

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

继承通用的Mapper，必须指定泛型
public interface TestTableDao extends Mapper<TestTableVO> { }
一旦继承了Mapper，继承的Mapper就拥有了Mapper 所有的通用方法：

选择
方法：List select(T record);
说明：根据实体中的属性值进行查询，查询条件使用等号

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

方法：List selectAll();
说明：查询全部结果，select（null）方法能达到同样的效果

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

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

插入
方法：int insert(T record);
说明：保存一个实体，null的属性也会保存，不会使用数据库替换值

方法：int insertSelective(T record);
说明：保存一个实体，null的属性不会保存，会使用数据库替换值

更新
方法：int updateByPrimaryKey(T record);
说明：根据主键更新实体全部串联，null值会被更新

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

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

方法：int deleteByPrimaryKey(Object key);
说明：根据主键中断进行删除，方法参数必须包含完整的主键属性

示例方法

方法：List selectByExample(Object example);
说明：根据示例条件进行查询
重点：这个查询支持通过Example类指定查询列，通过selectProperties方法指定查询列

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

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

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

方法：int deleteByExample(Object example);
说明：根据示例条件删除数据

代码中使用
在service中注入dao，即可使用。

@Autowired
private TestTableDao testTableDao;
下面演示大概的写法：

//新增
TestTableVO vo = new TestTableVO();
// 省略为vo设置属性...
int row = testTableDao.insertSelective(vo);
//修改
TestTableVO vo = new TestTableVO();
// 省略为vo设置属性...
int row = testTableDao.updateByPrimaryKeySelective(vo);
//查询类别
TestTableVO vo = new TestTableVO();
vo.setId(123L);
TestTableVO result = testTableDao.selectOne(vo);
//条件查询
// 创建Example
Example example = new Example(TestTableVO.class);
// 创建Criteria
Example.Criteria criteria = example.createCriteria();
// 添加条件
criteria.andEqualTo("isDelete", 0);
criteria.andLike("name", "%abc123%");
List<TestTableVO> list = testTableDao.selectByExample(example);

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

附Spring Boot配置
maven

<!--mybatis-->
<dependency>
    <groupId>org.mybatis.spring.boot</groupId>
    <artifactId>mybatis-spring-boot-starter</artifactId>
    <version>1.3.1</version>
</dependency>
<!--mapper-->
<dependency>
    <groupId>tk.mybatis</groupId>
    <artifactId>mapper-spring-boot-starter</artifactId>
    <version>1.1.4</version>
</dependency>

application.properties配置

#mapper
#mappers 多个接口时逗号隔开
mapper.mappers=tk.mybatis.mapper.common.Mapper
mapper.not-empty=false
mapper.identity=MYSQL

转自：博文

MyBatis通用Mapper介绍与使用——帮你写好通用sql

上一篇：Device Mapper Multipath（DM-Multipath）


下一篇：iOS开发- 文件共享(利用iTunes导入文件, 并且显示已有文件)