CFSDN坚持开源创造价值，我们致力于搭建一个资源共享平台，让每一个IT人在这里找到属于你的精彩世界.

这篇CFSDN的博客文章详解Mybatis通用Mapper介绍与使用由作者收集整理，如果你对这篇文章有兴趣，记得点赞哟.

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

什么是通用mapper 。

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

如何使用 。

以mysql为例，假设存在这样一张表:

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

maven依赖 。

springmvc配置 。

注意这里使用 tk.mybatis.spring.mapper.mapperscannerconfigure 替换原来mybatis的 org.mybatis.spring.mapper.mapperscannerconfigurer .

可配参数介绍:

1. uuid ：设置生成uuid的方法，需要用ognl方式配置，不限制返回值，但是必须和字段类型匹配
2. identity ：取回主键的方式，可以配置的内容看下一篇如何使用中的介绍
3. order ： <seletkey> 中的order属性，可选值为before和after
4. catalog ：数据库的catalog，如果设置该值，查询的时候表名会带catalog设置的前缀
5. schema ：同catalog，catalog优先级高于schema
6. seqformat ：序列的获取规则,使用{num}格式化参数，默认值为{0}.nextval，针对oracle，可选参数一共4个，对应0,1,2,3分别为sequencename，columnname, propertyname，tablename
7. notempty ：insert和update中，是否判断字符串类型!=''，少数方法会用到
8. style ：实体和表转换时的规则，默认驼峰转下划线，可选值为normal用实体名和字段名;camelhump是默认值，驼峰转下划线;uppercase转换为大写;lowercase转换为小写
9. enablemethodannotation ：可以控制是否支持方法上的jpa注解，默认false。

大多数情况下不会用到这些参数，有特殊情况可以自行研究.

实体类的写法 。

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

说明:

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 只需要继承一个通用接口，即可拥有丰富的方法:

继承通用的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 ，即可使用.

下面演示大概的写法:

新增 。

修改 。

查询单个 。

条件查询 。

总结 。

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

附 spring boot 配置 。

maven 。

application.properties 配置 。

以上就是本文的全部内容，希望对大家的学习有所帮助，也希望大家多多支持我.

原文链接：http://www.ciphermagic.cn/mybatis-mapper.html 。

最后此篇关于详解Mybatis通用Mapper介绍与使用的文章就讲到这里了,如果你想了解更多关于详解Mybatis通用Mapper介绍与使用的内容请搜索CFSDN的文章或继续浏览相关文章，希望大家以后支持我的博客！ 。