实在受不了iBatis的文档 - 关于莫名其妙的resultClass属性错误提示

reniaL

                昨晚，试用iBatis2.3.4，在SQL映射xml中的insert元素中写了resultClass属性，例如：

insert id="putUser" parameterClass="domain.User" resultClass="Object">
    INSERT INTO User (name, gender, age) values (#name#, #gender#, #age#)
/insert>
然后运行这条SQL的时候就会报错：
[color="#000000"]Caused by: org.xml.sax.SAXParseException: Attribute "resultClass" must be declared for element type "insert".
很奇怪，我明明有写resultClass属性啊，怎么出这个错呢？上网查，反复试，看JavaDoc，花了很多时间后才大概找到了真相：must be declared 应该是 must [color="#ff0000"]not be declared。。。

OK，我忍。今晚再看着iBatis3的User-Guide，试用iBatis3.0.0.190，照着文档写SQL Map：
select id="getUser" parameterType="Long" resultClass="domain.User">
  SELECT * FROM User WHERE id = #{id}
/select>
运行，又出错。。。
Caused by: [color="#ff0000"]org.xml.sax.SAXParseException: Attribute "resultClass" must be declared for element type "select".
靠，我可是照着文档写的啊！反复检查了几次，没错啊。但就是有错@_______@
搞来搞去，最后翻User-Guide看后面讲SQL Map的地方，才知道[color="#ff0000"]resultClass在iBatis3中已经被换成了resultType，但是部份文档还没更新。。。拜托啊大哥，你文档少是一回事，内容还存在这样的错误，再加上莫名其妙的运行时错误提示，新手不知道得浪费多少时间在这些低级错误上啊，哎。。。
               
               

本文来自ChinaUnix博客，如果查看原文请点：http://blog.chinaunix.net/u1/39889/showart_2039174.html