Mybatis 通用 Mapper 4.0.0 发布

栏目: 软件资讯 · 发布时间: 6年前

内容简介：通用 Mapper4 是一个可以实现任意 MyBatis 通用方法的框架，项目提供了常规的增删改查操作以及Example相关的单表操作。通用 Mapper 是为了解决 MyBatis 使用中 90% 的基本操作，使用它可以很方便的进行开发，可以...

通用 Mapper4 是一个可以实现任意 MyBatis 通用方法的框架，项目提供了常规的增删改查操作以及Example相关的单表操作。通用 Mapper 是为了解决 MyBatis 使用中 90% 的基本操作，使用它可以很方便的进行开发，可以节省开发人员大量的时间。

4.0 更新日志

此次更新最大的变化是项目结构调整了，将原来的 mapper 拆分成了 core, base, extra, generator, spring 五个子模块，将独立的 mapper-weekend 和 spring-boot-starter 项目添加到 mapper 中作为两个子项目，拆分后的整个项目如下：

all - 为了方便开发人员使用，屏蔽模块细节，提供的整合，下面两个子模块是具体实现，具体包含了 core, base, extra, generator, spring, weekend 六个项目。

dependencies - 以依赖方式整合，包含 tk.mybatis:mapper 的完整功能。
mapper - 通过 maven-shade-plugin 打包整合，和原来的 tk.mybatis:mapper 完全一样，并且 Maven 坐标就是 tk.mybatis:mapper。

base - 所有 Mapper<T> 等接口的实现，独立出来后方便整体替换这部分实现。
core - 通用 Mapper 的核心，依赖 core 可以实现自己的通用方法，base 就是以此为依赖的一种实现。
extra - base 方法扩展，提供有局限性的通用接口。
generator - 代码生成器，包含了通用 Mapper 代码生成器和一个通用的全功能代码生成器插件。
spring - 通用 Mapper 和 Spring 集成需要的关键类，重写了 MyBatis 几个实现类。
spring-boot-starter - 通用 Mapper 和 Spring Boot 集成。
weekend - 基于 Java 8 方法引用的 Example 替代对象 Weekend，可以避免字符串形式的字段名。

除了上面的模块外，mapper 下面还有一个 wiki 目录，该目录是对 wiki 仓库的引用，wiki 的两个仓库分别如下：

此外，项目中各个模块的父依赖为 mapper-parent 项目：

https://github.com/abel533/mapper-parent

全新文档

Wiki 地址

Wiki 目录

集成通用 Mapper

代码生成器

其他配置和用法

新增功能和参数

增加 @RegisterMapper 自动注册 Mapper 接口标记
通用 Mapper 所有已有方法都增加了该注解，MapperHelper 中实现对该注解的检测和自动配置。
实现自己的基类接口时也可以自己添加，例如：
```
@RegisterMapper public interface MyMapper<T> extends Mapper<T> {  }
```
增加该注解后会自动注册该接口到通用 Mapper（不需要配置 mappers 参数指定该接口了）。
即使不增加该接口，如果只用到了通用 Mapper 提供的方法，也可以自动注册，通用 Mapper 会自动向上查找带有该注解的父接口。
如果是自己开发的通用方法，建议加上该注解，否则还需要自己配置 mappers 参数。
增加 @KeySql 注解，用于配置主键策略，替换 JPA 中的复杂用法，可以查看 2.3 主键策略了解详细用法。
增加 resolveClass 参数，可以配置 EntityResolve 接口的实现类，可以替换默认转换 entity 到 table 的过程，替换后原来支持的一些配置会失效。
当特殊类型的字段标记 @Column 或 @ColumnType 注解时，可以作为表字段进行使用（例如枚举，复杂类型，需要配合 TypeHandler）。
EntityColumn 增加 blob 属性，给 WithBLOBs 系列方法做准备。
增加参数 usePrimitiveType，配置为 true 后，简单类型会包含 8 种基本类型。
引入 MyBatis 中的 Log 接口，方便记录更多的操作信息。
增加 safeDelete 参数，配置为 true 后，delete 和 deleteByExample 都必须设置查询条件才能删除，否则会抛出异常（org.apache.ibatis.exceptions.PersistenceException）。
增加 safeUpdate 参数，配置为 true 后，updateByExample 和 updateByExampleSelective 都必须设置查询条件才能更新，否则会抛出异常（org.apache.ibatis.exceptions.PersistenceException）。常用的两个 updateByPrimaryKey和 updateByPrimaryKeySelective 由于要求必须使用主键，不存在这个问题。
增加 useJavaType 参数，设置 true 时如{id, javaType=java.lang.Long}，对于使用 User extends Pk<Long> 形式时，需要设置，否则 mybatis 低版本(<3.4.0) 无法识别类型。

新增的参数可以参考配置介绍。

完善和修复问题

解决使用 Config 对象配置通用 Mapper 时，部分参数不起作用的问题
添加完善 @ColumnType 注解的测试用例
添加完善 Id,Table,Column 三个注解的测试
增加全面的 TypeHandler 测试。
update 上面的 @Options 注解在 3.2.x 版本时会影响清空二级缓存，已经去掉该注解。
兼容 Spring Boot 2.0.0-RELEASE 版本。

移除的功能或参数

移除 UUID 参数，不再支持 OGNL 方式对主键设置 UUID，如果有需要请通过 SQL 方式。
移除对 @SequenceGenerator 注解的支持，IDENTITY 参数去掉了该注解提供的序列名，现在支持3个参数，顺序为列名({0})、属性名({1})、表名({2})。

项目升级

只需要升级版本号，例如通用 Mapper：

<dependency>
	<groupId>tk.mybatis</groupId>
	<artifactId>mapper</artifactId>
	<version>4.0.0</version>
</dependency>

使用 Spring Boot 时：

<dependency>
	<groupId>tk.mybatis</groupId>
	<artifactId>mapper-spring-boot-starter</artifactId>
	<version>2.0.0</version>
</dependency>

虽然项目拆分了，但是在项目打包发布上屏蔽了这些细节。

【声明】文章转载自：开源中国社区 [http://www.oschina.net]

以上就是本文的全部内容，希望本文的内容对大家的学习或者工作能带来一定的帮助，也希望大家多多支持码农网

查看所有标签

猜你喜欢:

本站部分资源来源于网络，本站转载出于传递更多信息之目的，版权归原作者或者来源机构所有，如转载稿涉及版权问题，请联系我们。

码农书籍

面向对象技术UML教程

王少峰 / 清华大学出版社 / 2004-2 / 24.00元

《面向对象技术UML教程》主要介绍统一建模语言UML及其应用。全书内容丰富，包括UML的用例图、顺序图、协作图、类图、对象图、状态图、活动图、构件图和部署图等9个图中所涉及的术语、规则和应用，以及数据建模、OCL、业务建模、Web建模、设计模式、OO实现语言、RUP等方面的内容，同时介绍了Rose开发工具中的一些用法。《面向对象技术UML教程》最后是一个课程注册系统的实例研究，以及一些思考题和设计......一起来看看《面向对象技术UML教程》这本书的介绍吧!

码农工具