ibatis ResultMap ParameterMap

在执行查询 Mapped Statement 时，resultMap 负责将结果集的列值映射成 Java Bean的属性值。resultMap 的结构如下：

<resultMap id="resultMapName" clss="some.domain.Class" [extends="parent-resultMap"]>
<result property="ropertyName" clumn="COLUMN_NAME"
[columnIndex=""] [jaaType="int"]jdbcType="NUMERIC"
[nullValue="-999999"] [elect="smeOtherStatement"]
/>
<result ....../>
<result ....../>
<result ....../>
</resultMap>

// extends 是可选的属性，可设定成另外一个 resultMap 的名字，并以它为基础。和在 Java 中继承一个类相似，父 resultMap 的属性将作为子 resutlMap 的一部分。父 resultMap 的属性总是加到子 resultMap 属性的前面，并且父 resultMap必须要在子 resultMap 之前定义。父 resultMap 和子 resultMap 的 class 属性不一定要一致，它们可以没有任何关系。
// columnIndex 是可选的，用于改善性能。属性 columnIndex的值是 ResultSet 中用于赋值 Java Bean 属性的字段次序号。在 99％的应用中，不太可能需要牺牲可读性来换取性能。使用 columnIndex，某些 JDBC Driver可以大幅提高性能，某些则没有任何效果。
// nullValue 指定数据库中 NULL 的替代值。因此，如果从 ResultSet 中读出 NULL
值，Java Bean 属性将被赋值属性 null指定的替代值


parameterMap 负责将 Java Bean 的属性映射成 statement 的参数

<parameterMap id="parameterMapName" class="com.omain.Product"]>
<parameter property ="proprtyName" [jdbcType="VARCHAR"] [jvaType="tring"]
[nullValue="NUMERIC"] [ull="-999999"] />
<parameter ...... />
<parameter ...... />
</parameterMap>

// 括号[]是可选的属性。parameterMap 元素只要求属性 id 作为唯一标识。属性 class 是可选的但强烈推荐使用。和 parameterClass 类似，class 属性可以框架检查输入参数的类型并优化性能。

//以下是一个完整的例子

<parameterMap id="insert-product-param" class"cm.domain.Product">
<parameter property="id" jdbcType="NUMERIC" jvaType="int" nullValue="-9999999"/>
<parameter property="dscription" dbcType="VARCHAR" nullVlue="NO_ENTRY"/>
</parameterMap>

<statement id="insertroduct" prameterMap="insert-product-param">
insert into PRODUCT (PRD_ID, PRD_DESCRIPTION) values (?,?);
</statement>

//上面的例子中，Java Bean 的属性“id”和“description”将按顺序地替换 Mapped Statement
“insertProduct”的值符号（?）

注意:parameterMap 并不自动地绑定到特定的 Java 类。因此在上面的例子中，任何拥有“id”和“description”属性的 Java Bean 对象，都可以作为 parameterMap 的输入。如果需要将输入绑定到特定的 Java 类，可以使用 mapped-statement 的 resultClass 属性。

注意:Parameter Map 的名称（id）局部的，只在定义它的 SQL Map XML文件中有效。不过，加上 SQL Map 的名称（即在<sqlMap>根元素中的名称）作为前缀，您可以在另一个 SQL Map XML文件中引用它。例如，要在另一个文件中引用以上的 parameterMap，可以使用名称“Product.insert-product-param”。