ibatis迁移到mybatis3的注意事项

这篇文章主要介绍了ibatis迁移到mybatis3的注意事项的相关资料,需要的朋友可以参考下

DocUpgrade3 

这一页提供了一些当你从ibatis迁移到mybatis3时非常有用的信息。不能保证100%的完整。

这个项目现在的地址是 Github https://github.com/mybatis/ibatis2mybatis

转换工具

在下载区有一个可用的工具,可以帮你将iBATIS 2.x sqlmap文件转换为MyBatis 3.x xml mapper文件。

从这里获取 http://mybatis.googlecode.com/files/ibatis2mybatis.zip

该工具是一个封装在Ant任务围绕XSTL转换和一些文字替换,并试图在复杂的工作开始之前提供一个良好的起点。

新的DTDs

新的sqlMapConfig.xml DTD:

 

新的sqlMap (*.map.xml) DTD:

 

Configuration配置

配置根节点从  变成 

Settings配置

在配置的根节点:

 

现在是:

  

然后

 

这个配置可以删除掉,因为使用命名空间已经是一个强制的特性。

 别名  必须从  元素移动到 这里  ...    

变成:

     

变成:

  

Mapping

根元素从  变成 

parameterClass属性必须改成parameterType

resultClass属性必须改成resultType

class属性必须改成type

columnIndex不在 标签中使用

groupBy属性已经被废弃。下面是一个 2.x sqlMap的groupBy 例子:

  

新的:

  

Nested resultMaps嵌套的resultMaps

现在需要使用 标签指定.

   ... 

需要改成:

   ... 

虽然这个标签被废弃了,但是他仍然可以在iBatis 2中使用。但是对3.0.3以上版本当使用type="map"时有一个bug,并不指定 javaType 参数。这将导致:

There is no getter for property named '...' in 'interface java.util.Map'    

这将会在MyBatis 3.0.4中解决,对3.0.3版本或更早的版本解决的方法是显示的指定javaType

 Inline parameters内联参数 #value#

需要改成:

 #{value} jdbcType changes jdbcType变化 jdbcType="ORACLECURSOR"

需要改成:

jdbcType="CURSOR"

还有

jdbcType="NUMBER"

需要改成:

 jdbcType="NUMERIC" Stored procedures存储过程  存储过程的标签已经不存在了,需要使用  { ? = call pkgExample.getValues(p_id => ?)} 

如果你调用一个insert的带返回值的存储过程,你可以使用