ibatis Tips之parameterMap

parameterMap
属性parameterMap的值等于一个预先定义的<parameterMap>元素的名称。parameterMap属性很少使用，更多的是使用上面的parameterClass和inline parameter（接下来会讨论）。
注意！动态mapped statement只支持inline parameter，不支持parameter map。
parameterMap的基本思想是定义一系列有次序的参数系列，用于匹配JDBC PreparedStatement的值符号。例如：

<parameterMap class="com.ibatis.dataobject.Product" id="insert-product-param" >
		<parameter property="id"/>
		<parameter property="description"/>
		<parameter property="price"/>		
</parameterMap>
<statement id="insertProduct-useParaMap" parameterMap="insert-product-param">
		<![CDATA[insert into t_product(prd_id,prd_description,prd_price) values(?,?,?)]]>
</statement>

 上面的例子中，parameter map的两个参数按次序匹配SQL语句中的值符号（?）。因此，第一个“?”号将被“id”属性的值替换，而第二个“?”号将被“description”属性的值替换。

 

DAO实现类：

public boolean addProductUseParaMap(Product product) {
		init();
		Object obj = null;
		boolean flag = true;
		try {
			obj = sqlMapClient.insert("insertProduct-useParaMap", product);
		} catch (SQLException e) {
			flag = false;
			e.printStackTrace();
		}
		return flag;
}

 

测试类：

Product product = new Product();
product.setId(2);
product.setDescription("football");
product.setPrice(106.99D);
productDao.addProductUseParaMap(product);
product = (Product)productDao.getProduct(new Integer(2));
System.out.println(product);

 

 具体的parameterMap:

<parameterMap id=”parameterMapName”   [class=”com.domain.Product”]>
        <parameter property =”propertyName” 
                [jdbcType=”VARCHAR”]
                [javaType=”string”]
                [nullValue=”NUMERIC”] 
                [null=”-9999999”]
        />
       <parameter…… />
       <parameter …… />
</parameterMap>

Class属性是可选的，Class属性必须是JavaBean或Map实列，Class属 性虽是可选的，但推荐大家指定，
Class属性可以用来验证传入的参数的合法性及优化查询

<parameter>元素:

1.property

    属性property是传给statement的参数对象的Java Bean属性名称。该名称根据需要，可以在statement中多次出现（即在SQL语句SET子句中被更新的属性，也可以作为条件出现在WHERE子句中）。

 

2.jdbcType  

    属性jdbcType用于显式地指定给本属性（property）赋值的数据库字段的数据类型。

    注意！ 大多数JDBC Driver只有在字段可以为NULL时需要指定jdbcType属性。因此，对于这些Driver，只是在字段可以为NULL时才需要指定type属性。

    注意！ 当使用Oracle Driver时，如果没有给可以为NULL的字段指定jdbcType属性，当试图给这些字段赋值NULL时，会出现“Invalid column type”错误。

 

3.javaType
     属性javaType用于显式地指定被赋值参数Java属性的类名。

 

4.nullValue (要特别关注)

     属性nullValue的值可以是对于property类型来说任意的合法值，用于指定NULL的替换值。就是说，当Java Bean的属性值等于指定值时，相应的字段将赋值NULL。这个特性允许在应用中给不支持null的数据类型（即int，double，float等）赋值null。当这些数据类型的属性值匹配null值（即匹配-9999）时，NULL将代替null值写入数据库。

</parameter>元素

 

 

注意！ parameterMap并不自动地绑定到特定的Java类。因此在上面的例子中，任何拥有“id”和“description”属性的Java Bean对象，都可以作为parameterMap的输入。如果需要将输入绑定到特定的Java类，可以使用mapped-statement的resultClass属性。
注意！ Parameter Map的名称（name）局部的，只在定义它的SQL Map XML文件中有效。不过，加上SQL Map的名称（即在<sqlMap>根元素中的名称）作为前缀，您可以在另一个SQL Map XML文件中引用它。例如，要在另一个文件中引用以上的parameterMap，可以使用名称“Product.insert-product-param”。