详细介绍MyBatis 3.4.0版本的功能

新增功能

1. Cursor 新增返回值类型为游标的方法

当查询大量(上百万)数据的时候,使用游标可以有效的减少内存使用,不需要一次性将所有数据得到,可以通过游标逐个或者分批(逐个获取一批后)处理。

SqlSession 中新增的 3 个游标方法:

/**
 * A Cursor offers the same results as a List, except it fetches data lazily using an Iterator.
 * @param <T> the returned cursor element type.
 * @param statement Unique identifier matching the statement to use.
 * @return Cursor of mapped objects
 */
<T> Cursor<T> selectCursor(String statement);

/**
 * A Cursor offers the same results as a List, except it fetches data lazily using an Iterator.
 * @param <T> the returned cursor element type.
 * @param statement Unique identifier matching the statement to use.
 * @param parameter A parameter object to pass to the statement.
 * @return Cursor of mapped objects
 */
<T> Cursor<T> selectCursor(String statement, Object parameter);

/**
 * A Cursor offers the same results as a List, except it fetches data lazily using an Iterator.
 * @param <T> the returned cursor element type.
 * @param statement Unique identifier matching the statement to use.
 * @param parameter A parameter object to pass to the statement.
 * @param rowBounds Bounds to limit object retrieval
 * @return Cursor of mapped objects
 */
<T> Cursor<T> selectCursor(String statement, Object parameter, RowBounds rowBounds);

注意: 3.4.0 版本的游标方法目前有个 bug,因此不支持 @Select 注解方式,在将来的 3.4.1 版本中会解决这个问题。

使用示例:

<select id="selectAll" resultType="tk.mybatis.springboot.model.City">
 select * from city
</select>

xml 里面没有任何改变,在获取值的地方有变化,例如使用接口:

Cursor<City> selectAll();

或者使用命名接口方式:

Cursor<City> cityList = sqlSession.selectCursor("selectAll");

得到结果后,使用方法如下:

Iterator<City> iterator = cityList.iterator();
while(iterator.hasNext()){
 City c2 = iterator.next();
 Assert.assertNotNull(c2);
 Assert.assertNotNull(c2.getName());
 Assert.assertNotNull(c2.getState());
}

嵌套查询的情况

当使用嵌套查询时,还需要设置resultOrdered="true"属性,使用方法如下:

<select id="selectAll" resultMap="xx.CityMap" resultOrdered="true">

只有设置这个属性才能得到当前对象 id 所对应的所有嵌套结果。

对某一个嵌套查询,设置 resultOrdered="true" 的结果:

不设置的结果:

以上图为例,判断是否为同一个结果下的对象,使用 id 判断的,这个 id 必须是 <resultMap> 中的 <id>,另外为了结果完整,你还需要按照 <id> 配置的列进行排序,如果结果不是 <id> 对应列的顺序,嵌套的结果数量会出错。

2. 增加对 Java 8 日期(JSR-310)的支持

添加以下依赖:

<dependency>
 <groupId>org.mybatis</groupId>
 <artifactId>mybatis-typehandlers-jsr310</artifactId>
 <version>1.0.0</version>
</dependency>

如果你使用的 3.4.0 版本,就不需要任何配置就可以直接用。

如果你使用的老版本,需要手动配置:

<typeHandlers>
 <typeHandler handler="org.apache.ibatis.type.InstantTypeHandler" />
 <typeHandler handler="org.apache.ibatis.type.LocalDateTimeTypeHandler" />
 <typeHandler handler="org.apache.ibatis.type.LocalDateTypeHandler" />
 <typeHandler handler="org.apache.ibatis.type.LocalTimeTypeHandler" />
 <typeHandler handler="org.apache.ibatis.type.OffsetDateTimeTypeHandler" />
 <typeHandler handler="org.apache.ibatis.type.OffsetTimeTypeHandler" />
 <typeHandler handler="org.apache.ibatis.type.ZonedDateTimeTypeHandler" />
</typeHandlers>

有关 mybatis-typehandlers-jsr310 项目的详细信息看这里

3. 新增 autoMappingUnknownColumnBehavior 参数

新增了一个 settings 配置的参数 autoMappingUnknownColumnBehavior ,当检测出未知列(或未知属性)时,如何处理,默认情况下没有任何提示,这在测试的时候很不方便,不容易找到错误。

可选值:

  • NONE : 不做任何处理 (默认值)
  • WARNING : 警告日志形式的详细信息
  • FAILING : 映射失败,抛出异常和详细信息

配置时,在 <settings> 里面添加:

<setting name="autoMappingUnknownColumnBehavior" value="WARNING"/>

4. Sql Provider 注解方式支持多个参数

例如:

@SelectProvider(type = UserSqlBuilder.class, method = "buildGetUsersByName")
List<User> getUsersByName(
 @Param("name") String name,
 @Param("orderByColumn") String orderByColumn); // Multiple arguments

在写 UserSqlBuilder 的时候,同样需要使用注解来指定参数(或者按顺序):

public String buildGetUsersByName(
 @Param("name") final String name
 @Param("orderByColumn") final String orderByColumn) { // Allow multiple arguments
 return new SQL(){{
 SELECT("*");
 FROM("users");
 if (name != null) {
  WHERE("name like #{name} || '%'");
 }
 ORDER_BY(orderByColumn);
 }}.toString();
}

解决的 BUG

支持实体类中的泛型类型

例如 Entity 基类:

public abstract class Entity<K extends Serializable> {
 private static final long serialVersionUID = -1L;
 protected K id;

 public K getId() {
 return id;
 }

 public void setId(K id) {
 this.id = id;
 }

其中一个子类:

public class User extends Entity<String>

在先前的版本中,MyBatis 无法获取 id 的实际类型,导致找不到 TypeHandler 出错。

这里只列举部分重要的内容,详细内容看官方说明

总结

以上就是这篇文章的全部内容了,希望本文的内容对大家的学习或者工作能带来一定的帮助,如有疑问大家可以留言交流,谢谢大家对我们的支持。

(0)

相关推荐

  • 详细介绍MyBatis 3.4.0版本的功能

    新增功能 1. Cursor 新增返回值类型为游标的方法 当查询大量(上百万)数据的时候,使用游标可以有效的减少内存使用,不需要一次性将所有数据得到,可以通过游标逐个或者分批(逐个获取一批后)处理. SqlSession 中新增的 3 个游标方法: /** * A Cursor offers the same results as a List, except it fetches data lazily using an Iterator. * @param <T> the returned

  • 关于MyBatis连接MySql8.0版本的配置问题

    在学习mybatis时,遇到了一个错误,错误如下: Error querying database.  Cause: com.mysql.jdbc.exceptions.jdbc4.CommunicationsException: Communications link failure 错误原因: 本地使用的数据库版本为MySQL8.0 在pom.xml配置文件中导入MySQL的jar包版本为 因为本地数据库版本与导入MySQL的jar包版本不一致引起的错误 解决办法: [1] 本地安装相应版本

  • Mybatis中SqlMapper配置的扩展与应用详细介绍(1)

    奋斗了好几个晚上调试程序,写了好几篇博客,终于建立起了Mybatis配置的扩展机制.虽然扩展机制是重要的,然而如果没有真正实用的扩展功能,那也至少是不那么鼓舞人心的,这篇博客就来举几个扩展的例子. 这次研读源码的起因是Oracle和MySQL数据库的兼容性,比如在Oracle中使用双竖线作为连接符,而MySQL中使用CONCAT函数:比如Oracle中可以使用DECODE函数,而MySQL中只能使用标准的CASE WHEN:又比如Oracle中可以执行DELETE FORM TABLE WHER

  • webpack 4.0.0-beta.0版本新特性介绍

    近年来前端技术如雨后春笋般蓬勃发展,我们也在这个潮流下不断地学习.成长.前端技术的不断发展,给我们提供了许多的便利.例如:JSX的出现为我们提供了一个清晰.直观的方式来描述组件树,LESS/SASS的出现提高了我们书写css的能力,AMD/CommonJS/ES6 的出现为我们模块化开发提供了便利.然而,我们需要使用其它工具将这些工具转化成原生语言以运行在浏览器上.为了能够更好的将这些不同的资源整合到一起,我们就需要一个打包工具,webpack就是这个需求下的产物. webpack 可以看做是模

  • Vue插槽slot详细介绍(对比版本变化,避免踩坑)

    目录 插槽是什么? 怎么使用插槽? 基本用法 后备(默认)内容 具名插槽 作用域插槽 插槽版本变化 总结 Vue中的插槽(slot)在项目中用的也是比较多的,今天就来介绍一下插槽的基本使用以及Vue版本更新之后的插槽用法变化. 插槽是什么? 插槽就是子组件中的提供给父组件使用的一个占位符,用<slot></slot> 表示,父组件可以在这个占位符中填充任何模板代码,如 HTML.组件等,填充的内容会替换子组件的<slot></slot>标签.简单理解就是子组

  • Mybatis结果集映射与生命周期详细介绍

    目录 一.ResultMap结果集映射 1.设计思想 2.resultMap的应用场景 二.生命周期和作用域 一.ResultMap结果集映射 1.设计思想 对简单的语句做到零配置,对于复杂一点的语句,只需要描述语句之间的关系就行了 2.resultMap的应用场景 下面这个是我的数据库表 然后这是我们对应的Java实体类User2,除了有参构造外,它还定义了一个无参构造,而且用户id字段为userId,与数据库表中的id不一致 我们在执行查询方法后可以发现,实体类中的userId和数据库表中的

  • mysql zip archive 版本(5.7.19)安装教程详细介绍

    1.  从官网下载zip archive版本http://dev.mysql.com/downloads/mysql/ MySQL v5.7.19 官方正式版(32/64位 安装版与zip解压版) 2. 解压缩至相应目录,并配置环境变量(将*\bin添加进path中): 3. 理论上现在这样就可以直接安装服务了,但是因为是默认配置,我们使用的时候会出现很多问题.比如里面的汉字全是乱码之类的,所以建议先配置一下默认文件.在解压的mysql目录下,新建个my.ini,//在根目录新建my.ini文件

  • Mongodb3.0.5 副本集搭建及spring和java连接副本集配置详细介绍

    Mongodb3.0.5 副本集搭建及spring和java连接副本集配置详细介绍 一.基本环境: mongdb3.0.5数据库 spring-data-MongoDB-1.7.2.jar mongo-Java-driver-3.0.2.jar Linux-redhat6.3 tomcat7 二.搭建mongodb副本集: 1.  分别在三台linux系统机上安装mongodb,(为避免和机器上原有的mongodb端口冲突,这里设为57017): 192.168.0.160 192.168.0.

  • MyBatis框架中mybatis配置文件详细介绍

    一.注册DB连接四要素属性文件 <propertiesresource="jdbc.properties"/> 二.将指定包中所有类的简单类名当作其别名 <typeAliases> <packagename="com.bjpowernode.beans"/> </typeAliases> 三.配置运行环境 <environmentsdefault="testEM"> <enviro

  • 详解Mybatis逆向工程中使用Mysql8.0版本驱动遇到的问题

    前言 今天在使用 8.0.12 版的 mysql 驱动时遇到了各种各样的坑,在使用 JDBC 连接上遇到的问题可以参考我的上一篇博客.我在使用 mybatis 逆向工程生成各种 mapper , pojo , dao 时,遇到了一个困惑我好几个小时的错误,这个错误是 Result Maps collection already contains value for BaseResultMap 产生这个错误可能有各种原因.但是这里我只说我的原因及解决过程. 初步探索 我在网上查阅了大量的博客文章,

随机推荐