详细介绍MyBatis 3.4.0版本的功能

 更新时间:2017年06月15日 08:57:34   作者:isea533  
这篇文章主要给大家介绍了关于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 出错。

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

总结

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

相关文章

  • Java线程间协作wait、notify和notifyAll详解

    Java线程间协作wait、notify和notifyAll详解

    这篇文章主要介绍了Java线程间协作wait、notify和notifyAll详解,在 Java 中可以用 wait、notify 和 notifyAll 来实现线程间的通信,尽管关于wait和notify的概念很基础,它们也都是Object类的函数,但用它们来写代码却并不简单,,需要的朋友可以参考下
    2023-10-10
  • 一篇超详细的Spring Boot整合Mybatis文章

    一篇超详细的Spring Boot整合Mybatis文章

    大家都知道springboot搭建一个spring框架只需要秒秒钟。下面通过实例代码给大家介绍一下springboot与mybatis的完美融合,非常不错,具有参考借鉴价值,感兴趣的朋友一起看看吧
    2021-07-07
  • elasticsearch的zenDiscovery和master选举机制原理分析

    elasticsearch的zenDiscovery和master选举机制原理分析

    这篇文章主要介绍了elasticsearch的zenDiscovery和master选举机制原理分析,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
    2022-04-04
  • javaWEB中前后台乱码问题的解决方法总结

    javaWEB中前后台乱码问题的解决方法总结

    下面小编就为大家带来一篇javaWEB中前后台乱码问题的解决方法总结。小编觉得挺不错的,现在就分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2017-08-08
  • 详解IntelliJ IDEA中TortoiseSVN修改服务器地址的方法

    详解IntelliJ IDEA中TortoiseSVN修改服务器地址的方法

    这篇文章主要介绍了详解IntelliJ IDEA中TortoiseSVN修改服务器地址的方法,小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2017-12-12
  • Dubbo服务无法注册到ZK上问题

    Dubbo服务无法注册到ZK上问题

    这篇文章主要介绍了Dubbo服务无法注册到ZK上问题,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
    2024-05-05
  • Java数组看这篇就够了

    Java数组看这篇就够了

    这篇文章主要介绍了Java数组的详细解释,是Java入门学习中的基础知识,需要的朋友可以参考下,希望能够给你带来帮助
    2021-09-09
  • 如何把idea中的项目导入github仓库中(图文详解)

    如何把idea中的项目导入github仓库中(图文详解)

    这篇文章主要介绍了如何把idea中的项目导入github仓库中,本文通过图文并茂的形式给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2020-07-07
  • Java详细分析讲解HashMap

    Java详细分析讲解HashMap

    在java开发中,HashMap是最常用、最常见的集合容器类之一,下面一起温故一下,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2022-06-06
  • springboot的war和jar包的使用详解

    springboot的war和jar包的使用详解

    这篇文章主要介绍了springboot的war和jar包的使用详解,非常不错,具有一定的参考借鉴价值 ,需要的朋友可以参考下
    2018-11-11

最新评论