Ibatis中sqlmap参数map中还需要套list的情况如何写？

原始需求：

有若干个参数，需要作为ibatis拼装sql的参数传入，但是有个参数的值比较特殊，是若干种枚举值。具体到这个case，就是有有限个namespace。我每次需要通过传入多个namespace来查询DB记录。

准备需要传入sqlmap的参数的示例代码如下：

1. Map<String,Object> ibatisParam = new HashMap<String, Object>( );
2. ibatisParam.put( "keyA","valueA" );
3. List<String> list = new ArrayList<String>( );
4. list.add( "namespace1" );
5. list.add( "namespace2" );
6. ibatisParam.put( "namespaces",list );

使用的ibatis的sql语句如下：

1. <select id="listNodeByCriteria"  parameterClass="java.util.Map" resultMap="NodeWithPropertyResult">
2. select <include refid="NodeColumnsWithId"/> from node
3. <dynamic prepend=" where ">
4. <isNotNull property="namespaces">
5. namespace in
6. <iterate property="namespaces" open="(" conjunction="," close=")">
7. #value[]#
8. </iterate>
9. </isNotNull>
10. </dynamic>
11. order by id
12. limit #querySize# offset #startRow#
13. </select>

这里的基本需求是map中如果有namespaces这个key，则他的value一定是个list，并且要以这个list作为查询数据的条件。

开始这么写的，报了如下诡异的错误：

1. java.lang.reflect.InvocationTargetException
2. at java.lang.reflect.Method.invoke(Method.java:597)
3. at org.springframework.test.ConditionalTestCase.runBare(ConditionalTestCase.java:76)
4. at org.springframework.test.annotation.AbstractAnnotationAwareTransactionalTests.access$001(AbstractAnnotationAwareTransactionalTests.java:71)
5. at org.springframework.test.annotation.AbstractAnnotationAwareTransactionalTests$1.run(AbstractAnnotationAwareTransactionalTests.java:175)
6. at org.springframework.test.annotation.AbstractAnnotationAwareTransactionalTests.runTest(AbstractAnnotationAwareTransactionalTests.java:283)
7. at org.springframework.test.annotation.AbstractAnnotationAwareTransactionalTests.runTestTimed(AbstractAnnotationAwareTransactionalTests.java:254)
8. at org.springframework.test.annotation.AbstractAnnotationAwareTransactionalTests.runBare(AbstractAnnotationAwareTransactionalTests.java:172)
9. at org.eclipse.jdt.internal.junit4.runner.JUnit4TestReference.run(JUnit4TestReference.java:49)
10. at org.eclipse.jdt.internal.junit.runner.TestExecution.run(TestExecution.java:38)
11. at org.eclipse.jdt.internal.junit.runner.RemoteTestRunner.runTests(RemoteTestRunner.java:467)
12. at org.eclipse.jdt.internal.junit.runner.RemoteTestRunner.runTests(RemoteTestRunner.java:683)
13. at org.eclipse.jdt.internal.junit.runner.RemoteTestRunner.run(RemoteTestRunner.java:390)
14. at org.eclipse.jdt.internal.junit.runner.RemoteTestRunner.main(RemoteTestRunner.java:197)
15. Caused by: java.lang.reflect.InvocationTargetException
16. at sun.reflect.GeneratedMethodAccessor11.invoke(Unknown Source)
17. at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:25)
18. at java.lang.reflect.Method.invoke(Method.java:597)
19. at mockit.integration.junit3.internal.JUnitTestCaseDecorator.runTest(JUnitTestCaseDecorator.java:146)
20. at junit.framework.TestCase.runTest(TestCase.java)
21. at sun.reflect.GeneratedMethodAccessor11.invoke(Unknown Source)
22. at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:25)
23. at java.lang.reflect.Method.invoke(Method.java:597)
24. at mockit.integration.junit3.internal.JUnitTestCaseDecorator.runTest(JUnitTestCaseDecorator.java:146)
25. at mockit.integration.junit3.internal.JUnitTestCaseDecorator.originalRunBare(JUnitTestCaseDecorator.java:105)
26. at mockit.integration.junit3.internal.JUnitTestCaseDecorator.runBare(JUnitTestCaseDecorator.java:90)
27. at junit.framework.TestCase.runBare(TestCase.java)
28. at org.springframework.test.ConditionalTestCase.runBare(ConditionalTestCase.java:76)
29. at org.springframework.test.annotation.AbstractAnnotationAwareTransactionalTests.access$001(AbstractAnnotationAwareTransactionalTests.java:71)
30. at org.springframework.test.annotation.AbstractAnnotationAwareTransactionalTests$1.run(AbstractAnnotationAwareTransactionalTests.java:175)
31. at org.springframework.test.annotation.AbstractAnnotationAwareTransactionalTests.runTest(AbstractAnnotationAwareTransactionalTests.java:283)
32. at org.springframework.test.annotation.AbstractAnnotationAwareTransactionalTests.runTestTimed(AbstractAnnotationAwareTransactionalTests.java:254)
33. at org.springframework.test.annotation.AbstractAnnotationAwareTransactionalTests.runBare(AbstractAnnotationAwareTransactionalTests.java:172)
34. at junit.framework.TestResult$1.protect(TestResult.java:110)
35. at junit.framework.TestResult.runProtected(TestResult.java:128)
36. at junit.framework.TestResult.run(TestResult.java:113)
37. at junit.framework.TestCase.run(TestCase.java:124)
38. at junit.framework.TestSuite.runTest(TestSuite.java:232)
39. at junit.framework.TestSuite.run(TestSuite.java:227)
40. at org.junit.internal.runners.JUnit38ClassRunner.run(JUnit38ClassRunner.java:81)
41. ... 6 more
42. Caused by: org.springframework.jdbc.UncategorizedSQLException: SqlMapClient operation; uncategorized SQLException for SQL []; SQL state [null]; error code [0];
43. --- The error occurred in META-INF/ibatis/mysql/Node.xml.
44. --- The error occurred while preparing the mapped statement for execution.
45. --- Check the Node.listNodeByCriteria.
46. --- Check the parameter map.
47. --- Cause: com.ibatis.common.beans.ProbeException: Error getting ordinal list from JavaBean. Cause java.lang.NumberFormatException: For input string: ""; nested exception is com.ibatis.common.jdbc.exception.NestedSQLException:
48. --- The error occurred in META-INF/ibatis/mysql/Node.xml.
49. --- The error occurred while preparing the mapped statement for execution.
50. --- Check the Node.listNodeByCriteria.
51. --- Check the parameter map.
52. --- Cause: com.ibatis.common.beans.ProbeException: Error getting ordinal list from JavaBean. Cause java.lang.NumberFormatException: For input string: ""
53. at org.springframework.jdbc.support.AbstractFallbackSQLExceptionTranslator.translate(AbstractFallbackSQLExceptionTranslator.java:83)
54. at org.springframework.jdbc.support.AbstractFallbackSQLExceptionTranslator.translate(AbstractFallbackSQLExceptionTranslator.java:80)
55. at org.springframework.jdbc.support.AbstractFallbackSQLExceptionTranslator.translate(AbstractFallbackSQLExceptionTranslator.java:80)
56. at org.springframework.orm.ibatis.SqlMapClientTemplate.execute(SqlMapClientTemplate.java:212)
57. at org.springframework.orm.ibatis.SqlMapClientTemplate.executeWithListResult(SqlMapClientTemplate.java:249)
58. at org.springframework.orm.ibatis.SqlMapClientTemplate.queryForList(SqlMapClientTemplate.java:296)
59. at com.alibaba.genova.dependency.common.dao.impl.NodeDaoImpl.listNodesByCriteria(NodeDaoImpl.java:116)
60. at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
61. at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:39)
62. at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:25)
63. at java.lang.reflect.Method.invoke(Method.java:597)
64. at org.springframework.aop.support.AopUtils.invokeJoinpointUsingReflection(AopUtils.java:307)
65. at org.springframework.aop.framework.JdkDynamicAopProxy.invoke(JdkDynamicAopProxy.java:198)
66. at $Proxy8.listNodesByCriteria(Unknown Source)
67. at com.alibaba.genova.dependency.common.dao.NodeDAOTest.testListNodeByCriteriaWithNameSpace(NodeDAOTest.java:295)
68. at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
69. at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:39)
70. at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:25)
71. at java.lang.reflect.Method.invoke(Method.java:597)
72. at junit.framework.TestCase.runTest(TestCase.java:168)
73. ... 31 more
74. Caused by: com.ibatis.common.jdbc.exception.NestedSQLException:
75. --- The error occurred in META-INF/ibatis/mysql/Node.xml.
76. --- The error occurred while preparing the mapped statement for execution.
77. --- Check the Node.listNodeByCriteria.
78. --- Check the parameter map.
79. --- Cause: com.ibatis.common.beans.ProbeException: Error getting ordinal list from JavaBean. Cause java.lang.NumberFormatException: For input string: ""
80. at com.ibatis.sqlmap.engine.mapping.statement.MappedStatement.executeQueryWithCallback(MappedStatement.java:204)
81. at com.ibatis.sqlmap.engine.mapping.statement.MappedStatement.executeQueryForList(MappedStatement.java:139)
82. at com.ibatis.sqlmap.engine.impl.SqlMapExecutorDelegate.queryForList(SqlMapExecutorDelegate.java:567)
83. at com.ibatis.sqlmap.engine.impl.SqlMapExecutorDelegate.queryForList(SqlMapExecutorDelegate.java:541)
84. at com.ibatis.sqlmap.engine.impl.SqlMapSessionImpl.queryForList(SqlMapSessionImpl.java:118)
85. at org.springframework.orm.ibatis.SqlMapClientTemplate$3.doInSqlMapClient(SqlMapClientTemplate.java:298)
86. at org.springframework.orm.ibatis.SqlMapClientTemplate.execute(SqlMapClientTemplate.java:209)
87. ... 47 more
88. Caused by: com.ibatis.common.beans.ProbeException: Error getting ordinal list from JavaBean. Cause java.lang.NumberFormatException: For input string: ""
89. at com.ibatis.common.beans.BaseProbe.getIndexedProperty(BaseProbe.java:86)
90. at com.ibatis.common.beans.ComplexBeanProbe.getProperty(ComplexBeanProbe.java:297)
91. at com.ibatis.common.beans.ComplexBeanProbe.getObject(ComplexBeanProbe.java:198)
92. at com.ibatis.common.beans.GenericProbe.getObject(GenericProbe.java:74)
93. at com.ibatis.sqlmap.engine.exchange.ComplexDataExchange.getData(ComplexDataExchange.java:65)
94. at com.ibatis.sqlmap.engine.mapping.parameter.ParameterMap.getParameterObjectValues(ParameterMap.java:133)
95. at com.ibatis.sqlmap.engine.mapping.statement.MappedStatement.executeQueryWithCallback(MappedStatement.java:181)
96. ... 53 more
97. Caused by: java.lang.NumberFormatException: For input string: ""
98. at java.lang.NumberFormatException.forInputString(NumberFormatException.java:48)
99. at java.lang.Integer.parseInt(Integer.java:470)
100. at java.lang.Integer.parseInt(Integer.java:499)
101. at com.ibatis.common.beans.BaseProbe.getIndexedProperty(BaseProbe.java:51)
102. ... 59 more

这个错误提示真的好烂。被NumberFormatException搞迷糊了好一阵。

后来请教同事，把上面的sqlmap中的语句改成下面这样就Ok了：

1. <select id="listNodeByCriteria"  parameterClass="java.util.Map" resultMap="NodeWithPropertyResult">
2. select <include refid="NodeColumnsWithId"/> from node
3. <dynamic prepend=" where ">
4. <isNotNull property="namespaces">
5. namespace in
6. <iterate property="namespaces" open="(" conjunction="," close=")">
7. #namespaces[]#
8. </iterate>
9. </isNotNull>
10. </dynamic>
11. order by id
12. limit #querySize# offset #startRow#
13. </select>

注意，这里只有iterate标签内部的value改成了namespaces，其他完全一样。

原来在这种定位JavaBean（这里是map）内部的list属性的时候，iterate标签内部的变量名就要与标签上的property属性的值保持一致了。

问题原因：

参考上面的准备Map的Java代码，可以看到，namespaces作为Map的一个key，ibatis在解析的时候，也只能根据这个key来找到他需要遍历的list（就是我们put进去的那个跟namespaces对应的value）。所以这里不能使用namespaces以外的字符串来用在iterate标签内部，必须使用namespaces，这个是由Map在put时使用的key的名字决定的。只是上面的写法确实不太常见，看上去感觉有点像namespaces本身像个集合，这点是需要注意的。

问题升级：

上面问题中，Map里面namespaces对应的list里面的元素还是简单的String，所以在上面直接遍历里面的内容即可。但是如果这个list的内容不是String，而是一个对象，比如叫NameSpace，即List<String> --> List<NameSpace>，这里NameSpace的示例代码如下：

1. class NameSpace{
2. String name;
3. public String getName() {
4. return name;
5. }
6. public void setName(String name) {
7. this.name = name;
8. }
9. }

如果上面的sql中的namespace需要从NameSpace中的name属性取出，这种该怎么写呢？

这里只列出关键有区别的代码，其他地方省略。。。

1. <!--namespace是DB中的字段名-->
2. namespace in
3. <!--namespaces是Java代码中Map里面List对应的Key-->
4. <iterate property="namespaces" open="(" conjunction="," close=")">
5. <!--每一个NameSpace实例的name属性通过namespaces[].name获取-->
6. #namespaces[].name#
7. </iterate>

这里，回想一下上面列出的简单场景的情况，这种写法也不难理解。

参考：http://hittyt.iteye.com/blog/1518665