解决ibatis传入参数为NULL的异常

异常示例

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

<!-- 插入一条Person对应的记录到数据库中 -->
<insert id="insertPerson" parameterClass="com.unmi.Person">
    INSERT INTO PERSON(ID,NAME,PASSWD) VALUES(#id#,#name#,#passwd#)
</insert>

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

SqlMapClient sqlMap = SqlMapConfig.getSqlMapInstance(); // as coded above
Person person = new Person(1);
person.setName("Unmi");
// person.setPasswd("123456"); // 注意该行被注释，让passwd属性为NULL
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)

解决办法

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

<!-- 插入一条Person对应的记录到数据库中 -->
<insert id="insertPerson" parameterClass="com.unmi.Person">
   INSERT INTO PERSON(ID,NAME,PASSWD) VALUES(#id#,#name#,#passwd:VARCHAR:NULL#)
</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值。

<parameterMap id="insert-person-paraMap" class="com.unmi.Person">
<parameter property="id"/>
<parameter property="name"/>
<parameter property="passwd" jdbcType="VARCHAR"/>
</parameterMap>
<!-- 插入一条Person对应的记录到数据库中 -->
<insert id ="insertPerson" parameterMap="insert-person-paraMap">
    INSERT INTO PERSON(ID,NAME,PASSWD) VALUES(?,?,?)
</insert>

最后我连接MySql数据库，根本不需要为插入NULL值而考虑设置JDBC类型，平常对待，看来这是iBatis处理Oracle数据库的一个Bug.