`
xulongfa
  • 浏览: 69888 次
  • 性别: Icon_minigender_1
  • 来自: 杭州
社区版块
存档分类
最新评论

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”。

分享到:
评论

相关推荐

Global site tag (gtag.js) - Google Analytics