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

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

 

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值，当在用如下程序

 

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值也必须要你累述一遍，好讨厌的事情。

 

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值。

 

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 时写成 INSERTINTOPERSON(ID,NAME,PASSWD)VALUES(#id#,#name#,#passwd:DATE:NULL#) 时，插入的日期字段值为 NULL 还是会报出无法转换类型的错误，解决办法是把后面那个 NULL 去掉：INSERTINTOPERSON(ID,NAME,PASSWD)VALUES(#id#,#name#,#passwd:DATE#)