mybatis写mapper xml文件注意事项

1、在xml的sql语句中，不能直接用大于号、小于号要用转义字符

如果用小于号会报错误如下：

org.apache.ibatis.builder.BuilderException: Error creating document instance.  Cause: org.xml.sax.SAXParseException: The content of elements must consist of well-formed character data or markup.

转义字符

&lt;	<	小于号
&gt;	>	大于号
&amp;	&	和
&apos;	’	单引号
&quot;	"	双引号

2、使用
<![CDATA[ ]]>标记的sql语句中的<where> <if>等标签不会被解析

在mapper文件中写sql语句时,为避免不必要的麻烦(如<等),建议使用<![CDATA[ ]]>来标记不应由xml解析器进行解析的文本数据,由<![CDATA[  ]]>包裹的所有的内容都会被解析器忽略 <![CDATA[ sql语句 ]]> 

 

Xml代码  

1. <select id="getAccountsByBranch" resultType="Account" parameterType="string">  
2.     <![CDATA[SELECT * FROM t_acctreg_accounts where acctno < #{acctno}]]>  
3. </select>  

 将整个sql语句用<![CDATA[   ]]>标记来避免冲突，在一般情况下都是可行的,但是如果这样写

 

Xml代码  

1. <select id="getAccountErrorCount" resultType="int" parameterType="map">  
2.     <![CDATA[ 
3.     select count(*) from t_acctreg_accounterror 
4.     <where> 
5.         <if test="enddate != null and enddate != ''"> 
6.             createdate <= #{enddate} 
7.         </if> 
8.         <if test="acctno != null and acctno != ''"> 
9.             AND acctno LIKE '%'||#{acctno}||'%' 
10.         </if> 
11.     </where> 
12.     ]]>  
13. </select>  

 就会收到错误信息:

    org.springframework.jdbc.UncategorizedSQLException: Error setting null parameter. Most JDBC drivers require that the JdbcType must be specified for all nullable parameters. Cause: java.sql.SQLException: 无效的列类型: 1111 ; uncategorized SQLException for SQL []; SQL state [99999]; error code [17004]; 无效的列类型: 1111; nested exception is java.sql.SQLException: 无效的列类型: 1111

    这是由于该sql配置中有动态语句(where,if),where,if 条件不能放在<![CDATA[ ]]>中,否则将导致无法识别动态判断部分,导致整个sql语句非法.应该缩小范围，只对有字符冲突部分进行合法性调整

 

Xml代码  

1. <select id="getAccountErrorCount" resultType="int" parameterType="map">  
2.     select count(*) from t_acctreg_accounterror  
3.     <where>  
4.         <if test="enddate != null and enddate != ''">  
5.             <![CDATA[createdate <= #{enddate}]]>  
6.         </if>  
7.         <if test="acctno != null and acctno != ''">  
8.             <![CDATA[AND acctno LIKE '%'||#{acctno}||'%']]>  
9.         </if>  
10.     </where>  
11. </select>