javaibatismybatis_java相关：ibatis迁移到mybatis3的注意事项

java相关&＃xff1a;ibatis迁移到mybatis3的注意事项

发布于 2020-8-14|

复制链接

摘记: DocUpgrade3 这一页提供了一些当你从ibatis迁移到mybatis3时非常有用的信息。不能保证100%的完整。这个项目现在的地址是 Github  ..

DocUpgrade3 这一页提供了一些当你从ibatis迁移到mybatis3时非常有用的信息。不能保证100%的完整。这个项目现在的地址是 Github https://github.com/mybatis/ibatis2mybatis转换工具在下载区有一个可用的工具&＃xff0c;可以帮你将iBATIS 2.x sqlmap文件转换为MyBatis 3.x xml mapper文件。从这里获取 http://mybatis.googlecode.com/files/ibatis2mybatis.zip该工具是一个封装在Ant任务围绕XSTL转换和一些文字替换&＃xff0c;并试图在复杂的工作开始之前提供一个良好的起点。新的DTDs新的sqlMapConfig.xml DTD:

&＃96;&＃96;&＃96;java

&＃96;&＃96;&＃96;

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

&＃96;&＃96;&＃96;java

&＃96;&＃96;&＃96;

Configuration配置配置根节点从  变成 Settings配置在配置的根节点:

&＃96;&＃96;&＃96;java

&＃96;&＃96;&＃96;

现在是:

&＃96;&＃96;&＃96;java

&＃96;&＃96;&＃96;

然后

&＃96;&＃96;&＃96;java

&＃96;&＃96;&＃96;

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

&＃96;&＃96;&＃96;java

别名

必须从 元素移动到 这里

...

和

&＃96;&＃96;&＃96;

变成:

&＃96;&＃96;&＃96;java

&＃96;&＃96;&＃96;

变成:

&＃96;&＃96;&＃96;java

&＃96;&＃96;&＃96;

Mapping根元素从  变成 parameterClass属性必须改成parameterTyperesultClass属性必须改成resultTypeclass属性必须改成typecolumnIndex不在 标签中使用groupBy属性已经被废弃。下面是一个 2.x sqlMap的groupBy 例子:

&＃96;&＃96;&＃96;java

&＃96;&＃96;&＃96;

新的:

&＃96;&＃96;&＃96;java

&＃96;&＃96;&＃96;

Nested resultMaps嵌套的resultMaps现在需要使用 标签指定.

&＃96;&＃96;&＃96;java

...

&＃96;&＃96;&＃96;

需要改成:

&＃96;&＃96;&＃96;java

...

&＃96;&＃96;&＃96;

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

There is no getter for property named &＃39;...&＃39; in &＃39;interface java.util.Map&＃39;

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

&＃96;&＃96;&＃96;bash

Inline parameters内联参数

#value#

&＃96;&＃96;&＃96;

需要改成:

&＃96;&＃96;&＃96;bash

#{value}

jdbcType changes jdbcType变化

jdbcType&＃61;"ORACLECURSOR"

&＃96;&＃96;&＃96;

需要改成:

jdbcType&＃61;"CURSOR"

还有

jdbcType&＃61;"NUMBER"

需要改成:

&＃96;&＃96;&＃96;bash

jdbcType&＃61;"NUMERIC"

Stored procedures存储过程

 存储过程的标签已经不存在了&＃xff0c;需要使用 , 或 标签。

{ ? &＃61; call pkgExample.getValues(p_id &＃61;> ?) }

&＃96;&＃96;&＃96;

需要改成:

&＃96;&＃96;&＃96;bash

{ ? &＃61; call pkgExample.getValues(p_id &＃61;> ?)}

&＃96;&＃96;&＃96;

如果你调用一个insert的带返回值的存储过程&＃xff0c;你可以使用标签代替,但是你需要设置specifyuseCache&＃61;"false" 和flushCache&＃61;"true"&＃xff0c;你还必须做一个强制提交(事务)。

对返回数据集的存储过程&＃xff0c;当使用嵌套的resultMap时&＃xff0c;这儿有一个bug  (例如&＃xff1a;出参resultMap包含一个 标签). 只要问题没有解决&＃xff0c;你必须自己将resultMap定义好&＃xff0c;或者嵌套的内容不会被填充。

Caching缓存

&＃96;&＃96;&＃96;bash

&＃96;&＃96;&＃96;

需要改为:

&＃96;&＃96;&＃96;bash

&＃96;&＃96;&＃96;

注意&＃xff1a;你可以忽略eviction&＃61;"LRU"&＃xff0c;因为他是默认值。.

 标签被flushCache属性所替代。缓存默认会被所有的查询语句使用。

Dynamic SQL动态SQL

在我的项目中最常用的的动态SQL是isNotNull. 下面是替换正则表达式的示例:

正则表达式:

&＃96;&＃96;&＃96;java

&＃96;&＃96;&＃96;

需要改为:

&＃96;&＃96;&＃96;bash

&＃96;&＃96;&＃96;

isEqual最常用,你可以使用类似的 标签替代.

SqlMapClient

这个类已经不存在了&＃xff0c;使用SqlSessionFactory替代 (详细内容看Mybatis文档).

Custom type handler

用 TypeHandler 替换接口 TypeHandlerCallback。它具有稍有不同,但方法类似。

Custom data source factory

旧的接口:

com.ibatis.sqlmap.engine.datasource.DataSourceFactory

新的接口:

org.apache.ibatis.datasource.DataSourceFactory

替换下面的方法

public void initialize(Map properties)

为&＃xff1a;