用 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 )
只要去掉 person.setPasswd("123456"); 前的注释,让Person的三个字段都不为NULL,才能成功向数据库中插入记录。其实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#。
不知你注意到没有,我们上面的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>
1.String为NULL的处理:拿SQL Server 来说,其中与String对应的类型有很多种,如VARCHAR,NVARCHAR,TEXT...如果存入数据库中的值有可能为NULL的时候,我们只要在插入或者更新的时候指定它的类型为VARCHAR,或者LONGVARCHAR,对应TEXT类型,(注意不能为NVARCHAR,和LONGNVARCHAR):如下
<update id="update">
UPDATE [ArtT_user]
SET [ArtT_sUserName] = #userName#
,[ArtT_sUserPwd] = #password#
,[ArtT_sUserEmail] = #userEmail:VARCHAR#
,[ArtT_sUserDescription] = #description:LONGVARCHAR#
WHERE [ArtT_iUserId] = #userId#
</update>
如果属性userEmail,description为空时,Ibatis把NULL存入数据库.
数据库取出值为NULL,对应的属性为String类型的时候,无需作特别处理,Ibatis会把相应属性设置为空.
2.date ,datetime的处理:与String的处理相类似,插入或者更新数据时,应该指定日期的类型,DATE 或者TIMESTAMP,如下:
<update id="update">
UPDATE [ArtT_user]
SET [ArtT_sUserName] = #userName#
,[ArtT_sUserPwd] = #password#
,[ArtT_dLastLoginTime] = #lastLoginTime:TIMESTAMP#
,[ArtT_sCreateDate] = #createDate:DATE#
WHERE [ArtT_iUserId] = #userId#
</update>
同时,从数据库中取出值时,在resultMap中也应该指定明确的类型,DATE 或者DATETIME,如下:
<result property="lastLoginTime"column="ArtT_dLastLoginTime" columnIndex="12"jdbcType="TIMESTAMP"/>
<result property="createDate" column="ArtT_sCreateDate" columnIndex="13" jdbcType="DATE"/>
3.int,double,float的处理:根据Ibatis 官方文档介绍,因为在javaBean中如果属性为int ,double, float 时,不允许设置为NULL,可以采用一个"神奇数字"来代替属性中的NULL,如-9999.
数据存入数据库时,当检测到属性值为-9999时,Ibatis把空值存入数据库中.
数据从数据库中取出时,当数据库中该字段为NULL时,Ibatis给javaBean中的属性赋值为-9999.
因此,在XML映射文件中,应该同时在存入与取出处指定nullValue='-9999',否则容易导致数据库的不一致.
这种做法虽然保证了数据库的一致性,但对程序来说并不雅观,在程序中如果要判断该属性是否为空,只要判断它是否等于"神奇数字",不得已而为之.
insert into invoice (invoiceid,invoicecode,CUSTOMER,AMOUNT,INVOICEDATE,USERINFONAME,DESCRIPTION,INPUTDATE,STATUS) values (#invoiceId#,#invoiceCode:VARCHAR:NO_ENTEY#,#customer:VARCHAR:NO_ENTEY#,#amount#,#invoiceDate:DATE#,#userInfoName:VARCHAR:NO_ENTEY#,#description:VARCHAR:NO_ENTEY#,sysdate,0)