如何在 iBatis 应用程序向 Oralce 数据表字段插入 NULL 值

用 iBatis 应用程序连接的数据库是 Oracle, 映射文件中的插入语句写成如下形式

view sourceprint?

1.

<!-- 插入一条Person对应的记录到数据库中 -->

2.

<

insert

id

=

"insertPerson"

parameterClass

=

"com.unmi.Person"

>

3.

INSERT INTO PERSON(ID,NAME,PASSWD) VALUES(#id#,#name#,#passwd#)

4.

</

insert

>

Person表的三个字段都允许NULL值，当在用如下程序

view sourceprint?

1.

SqlMapClient sqlMap = SqlMapConfig.getSqlMapInstance();

// as coded above

2.

Person person =

new

Person(

1

);

3.

person.setName(

"Unmi"

);

4.

// person.setPasswd("123456"); // 注意该行被注释，让passwd属性为NULL

5.

sqlMap.insert(

"insertPerson"

, person);

执行后程序报错
Exception in thread "main" com.ibatis.common.jdbc.exception.NestedSQLException:
--- The error occurred in com/unmi/Person.xml.
--- The error occurred while applying a parameter map.
--- Check the insertPerson-InlineParameterMap.
--- Check the parameter mapping for the 'passwd' property.
--- Cause: java.sql.SQLException: 无效的列类型
Caused by:java.sql.SQLException: 无效的列类型
at com.ibatis.sqlmap.engine.mapping.statement.GeneralStatement.executeUpdate(GeneralStatement.java:91)
at com.ibatis.sqlmap.engine.impl.SqlMapExecutorDelegate.insert(SqlMapExecutorDelegate.java:442)
at com.ibatis.sqlmap.engine.impl.SqlMapSessionImpl.insert(SqlMapSessionImpl.java:81)
at com.ibatis.sqlmap.engine.impl.SqlMapClientImpl.insert(SqlMapClientImpl.java:58)
at com.unmi.Client.main(Client.java:33)
Caused by:java.sql.SQLException: 无效的列类型
at oracle.jdbc.dbaccess.DBError.throwSqlException(DBError.java:168)
at oracle.jdbc.dbaccess.DBError.throwSqlException(DBError.java:210)
at oracle.jdbc.dbaccess.DBError.throwSqlException(DBError.java:273)
at oracle.jdbc.driver.OracleStatement.get_internal_type(OracleStatement.java:4560)
at oracle.jdbc.driver.OraclePreparedStatement.setNull(OraclePreparedStatement.java:869)
at com.ibatis.sqlmap.engine.mapping.parameter.BasicParameterMap.setParameter(BasicParameterMap.java:171)

只要去掉 person.setPasswd("123456");前的注释，让Person的三个字段都不为NULL，才能成功向数据库中插入记录。其实Person表并没有任何约束，却是iBatis在此拦截下来，实是多此一举。那如果我确实让某个字段是NULL值，该怎么做呢？您只要修改一下映射文件中预置的SQL语句就行了，告诉iBatis当该字段出现NULL值该用什么值来替代，连接Oracle即使是要求某字段传入NULL值时就是插入NULL值也必须要你累述一遍，好讨厌的事情。

view sourceprint?

1.

<!-- 插入一条Person对应的记录到数据库中 -->

2.

<

insert

id

=

"insertPerson"

parameterClass

=

"com.unmi.Person"

>

3.

INSERT INTO PERSON(ID,NAME,PASSWD) VALUES(#id#,#name#,#passwd:VARCHAR:NULL#)

4.

</

insert

>

支持的类型在 java.sql.Types 中列示出来了，我一开始还把上面的 VARCHAR 错写成了 VARCHAR2。再比如果你想传入的 id 为NULL时替换为 0, 你就可以写成 #id:INTEGER:0#。

原因是 iBatis 是根据参数的当前值的类型(而不是类属性) 来决定对于这个 PrepairedStatement设置参数是应该调用哪一个版本的 setXxx() 方法(是 String 就调用，setString() ，是 int就调用 setInt() 等)。而如果参数值为 null，iBatis 便不知道调用哪个 setXxx() 方法，于是在 Oracle的驱动下就笼统的调用 setNull() 方法，然而 Oracle 在对字符串类型字段使用 setNull()却是有问题的。因为在配置中就必须指明当前字段的类型，如 #passwd:VARCHAR:NULL#，当 iBatis 在碰到参数为 null难以决断时，但见到这里的 VARCHAR 选项，它也知道应该用 setString() 方法来给 PrepairedStatement赋值。至于其中的 NULL，不过是指定参数为 null 时的默认值，显然，写成 #passwd:VARCHAR# 就行了，后面的 NULL是多余的。

不知你注意到没有，我们上面的insert标记配置了属性是 parameterClass,那如果配置的是 parameterMap 该如何解决因字段为NULL值的问题呢？这就要求我们在配置parameterMap标记中可能出现NULL值的参数一定要指定相应的jdbcType属性就行。只要不指定nullValue属性就表示在该表这段中直接记下NULL值。

view sourceprint?

01.

<

parameterMap

id

=

"insert-person-paraMap"

class

=

"com.unmi.Person"

>

02.

<

parameter

property

=

"id"

/>

03.

<

parameter

property

=

"name"

/>

04.

<

parameter

property

=

"passwd"

jdbcType

=

"VARCHAR"

/>

05.

</

parameterMap

>

06.

<!-- 插入一条Person对应的记录到数据库中 -->

07.

<

insert

id

=

"insertPerson"

parameterMap

=

"insert-person-paraMap"

>

08.

INSERT INTO PERSON(ID,NAME,PASSWD) VALUES(?,?,?)

09.

</

insert

>

最后我连接MySql数据库，根本不需要为插入NULL值而考虑设置JDBC类型，平常对待，看来这是iBatis处理Oracle数据库的一个Bug.
参考链接：
1. ibatis problem inserting null value for Date type
2. iBatis框架插入一条数据有些字段是空值没法插入
3. iBatis学习心得

补充：
2008-05-25，连接 Oracle 8.0.5 时写成INSERT INTO PERSON(ID,NAME,PASSWD) VALUES(#id#,#name#,#passwd:DATE:NULL#)时，插入的日期字段值为 NULL 还是会报出无法转换类型的错误，解决办法是把后面那个 NULL去掉：INSERT INTO PERSON(ID,NAME,PASSWD) VALUES(#id#,#name#,#passwd:DATE#)