什么是通用Mapper？

它是一个可以方便的使用Mybatis进行单表的增删改查优秀开源产品。它使用拦截器来实现具体的执行Sql，完全使用原生的Mybatis进行操作。在Github上标星5.9K！

完整个人面经、笔记梳理和Java架构资料分享（200+页PDF），私信我就可以发给你哈~

为什么要用Mapper？

它提供了所有单表的基本增删改查方法，大大节省了我们书写基本mapper.xml的时间。尤其对于新工程和新表来说，极大的提高...

不客气的说，使用这个通用Mapper甚至能改变你对Mybatis单表基础操作不方便的想法，使用它你能简单的使用单表的增删改查，包含动态的增删改查。

同时，在代码结构合理的前提下，更换RDBMS也无须修改sql，只需修改部分配置即可实现。

如何使用Mapper？

先通过maven引入jar包：

<dependency>

    <groupId>tk.mybatis</groupId>

    <artifactId>mapper</artifactId>

    <version>x.x.x</version>

</dependency>

添加配置文件：

配置方式分为Java编码方式和spring集成方式。

Java编码方式

MapperHelper mapperHelper = new MapperHelper();

//特殊配置

Config config = new Config();//具体支持的参数看后面的文档

config.setXXX(XXX);//设置配置

mapperHelper.setConfig(config);//注册自己项目中使用的通用Mapper接口，这里没有默认值，必须手动注册

mapperHelper.registerMapper(Mapper.class);

//配置完成后，执行下面的操作

mapperHelper.processConfiguration(session.getConfiguration());

纯Spring配置方式

<bean >

    <property name="basePackage" value="com.isea533.mybatis.mapper"/>

    <property name="properties">

        <value>

            mappers=tk.mybatis.mapper.common.Mapper        </value>

    </property>

</bean>

你没看错，就是这么配置的，注意这里是tk.mybatis.xxx,和MyBatis的唯一区别就是org.改成了tk.，方便修改和记忆。

通用Mapper的各项属性通过properties属性进行配置，如果默认配置就是一行mappers=tk.mybatis.mapper.common.Mapper时，可以不写，就会变成：

<bean >

    <property name="basePackage" value="com.isea533.mybatis.mapper"/>

</bean>

继承通用Mapper接口（注意必须要加泛型<T>）：

@Repository

public interface MaterialDao extends Mapper<MaterialMeta>, InsertUseGeneratedKeysMapperr<MaterialMeta> {}

上图示例继承了Mapper和InsertUseGeneratedKeysMapper，则直接拥有了这2个接口的所有方法。

上图中实体类的写法示例：

@Table(name = "tb_helpcenter_material")

public class MaterialMeta {

    @Id

    @GeneratedValue(strategy = GenerationType.IDENTITY)

    private Long id;

    private String title;

    private String tags;

    private Long classificationId;

    private String platform;

    private String lecturerName;

    // Setters&Getters

}

实体类的规则：

1.表名默认使用类名,驼峰转下划线(只对大写字母进行处理),如UserInfo默认对应的表名为user_info。

2.表名可以使用@Table(name = "tableName")进行指定,对不符合第一条默认规则的可以通过这种方式指定表名.

3.字段默认和@Column一样,都会作为表字段,表字段默认为Java对象的Field名字驼峰转下划线形式.

4.可以使用@Column(name = "fieldName")指定不符合第3条规则的字段名

5.使用@Transient注解可以忽略字段,添加该注解的字段不会作为表字段使用.

6.建议一定是有一个@Id注解作为主键的字段,可以有多个@Id注解的字段作为联合主键.

7.默认情况下,实体类中如果不存在包含@Id注解的字段,所有的字段都会作为主键字段进行使用(这种效率极低).

8.实体类可以继承使用,可以参考测试代码中的tk.mybatis.mapper.model.UserLogin2类.

9.由于基本类型,如int作为实体类字段时会有默认值0,而且无法消除,所以实体类中建议不要使用基本类型.

10.@NameStyle注解，用来配置对象名/字段和表名/字段之间的转换方式，该注解优先于全局配置style，可选值：

另外，建议实体类的所有Field全部使用装箱类，不要使用基本类型。

id字段上的@GeneratedValue注解用来表示该表使用的主键策略类型。

使用Mybatis-Generator来生成实体类：

使用方法参见：http://ks.netease.com/blog?id=8920

关于主键策略

主键策略主要用于insert场景。通常情况下，可以不用设置表对象的主键策略。不设置时，默认会使用JDBC 的 getGeneratedKeys 方法来取出由数据库内部生成的主键。

你也可以以@GeneratedValue(generator = “”)的形式来指定主键策略命令。如：@GeneratedValue(strategy = GenerationType.IDENTITY

,generator = “select last_insert_id()”)等。

同时，可以根据实际需要，在全局配置中指定主键策略的执行ORDER。

用Mybatis-Generator生成实体类，并创建一个继承了Mapper接口的dao以后，还要写什么呢？

答案是不用了，可以直接用了

就像这样：

MaterialMeta materialMeta = ReflectUtil.convertObj(MaterialMeta.class, material, false);

materialMeta.setPlatform(platformStr);

materialDao.insertSelective(materialMeta);

还有这样：

Example example = new Example(MaterialMeta.class);

example.createCriteria().andEqualTo("classificationId", material.getClassificationId()).andEqualTo("deleted",

                false);

example.orderBy("sort").desc();

PageHelper.startPage(1, 1);

List<MaterialMeta> materialMetas = materialDao.selectByExample(example);

或者这样：

materialMeta.setStatus(MaterialStatus.online);

materialMeta.setPublishDate(new Date());

materialDao.updateByPrimaryKeySelective(materialMeta);

如此一来，一行sql都不需要写，mapper.xml文件也不需要了（特殊sql仍然需要手写）。

更多更全的使用手册，请参看作者的git： https://github.com/abel533/Mapper

只是引入了原生的Mapper吗？有没有什么缺陷？我们做了什么改动？

fork的Mapper版本是3.4.2的，最新3.4.3还没有release。

像这样的通用框架，几乎支持了市面上所有主流的rdbms，但是大网易的DDB就呵呵哒了。

肿么办呢，当然是改啦。主要的问题是主键策略不支持。于是题主就给她新增了一种逐渐策略，名字就叫“DDB”。同样是通过拦截器修改mybatis的Configuration实现的。

同时新增了一个支持DDB批量Insert的Mapper，使用全局替换符的形式实现。

在对原生的Mapper做了这2个增强以后，就可以愉快的支持DDB的增删改查了。

使用时，请引入以下jar包：

<dependency>

<groupId>com.netease.pop.mybatis</groupId>

<artifactId>mapper</artifactId>

<version>4.0.0</version>

</dependency>

同时，在配置文件中增加如下2行：

INDENTITY=DDB表示使用名称为DDB的主键策略(或者也可以在实体类的GeneratedValue注解中指定generator命令)

ORDER=BEFORE表示在insert命令前执行该主键策略(这是为了在insert前获取主键id值来使用)

其他

除了节省书写sql的时间外，配合另一个分页的开源插件PageHelper使用，可以事半功倍。使用上简单到可怕。

用法示例如下：

PageHelper.offsetPage(offset, limit);

Page<MaterialMeta> metas = (Page<MaterialMeta>) materialDao.selectByExample(example);

没错，就只有这么一行。。。

具体的接入方式可以参看以下文档：

https://github.com/pagehelper/Mybatis-PageHelper/blob/master/README_zh.md

来源：网易工程师-倪骏

关于通用Mapper的介绍到此为止，欢迎大家一起探讨学习！有任何问题欢迎留言交流~

整理总结不易，如果觉得这篇文章有意思的话，欢迎转发、收藏，给我一些鼓励~

有想看的内容或者建议，敬请留言！

最近利用空余时间整理了一些精选Java架构学习视频和大厂项目底层知识点，需要的同学欢迎私信我发给你~一起学习进步！有任何问题也欢迎交流~

Java日记本，每日存档超实用的技术干货学习笔记，每天陪你前进一点点~