# Parameter Map以及属性

# Parameter Map

parameterMap负责将对象属性映射成statement的参数。

	<parameterMap  id="parameterMapName" class="commonj.sdo.DataObject">
	   <parameter property ="propertyName"
	             [jdbcType="VARCHAR"] [javaType="string"]
	            [nullValue="NUMERIC"]/>
	   <parameter ...... />
	   <parameter ...... />
	</parameterMap>

括号[ ]是可选的属性。一个parameterMap可包含任意多的parameter元素。下面讨论parameter的各个属性。

# Parameter的属性

# property

属性property是传给statement的参数对象的属性名称。该名称根据需要，可以在statement中多次出现。

# jdbcType

属性jdbcType用于显式地指定给本属性（property）赋值的数据库字段的数据类型。对于某些特定的操作，如果不指定字段的数据类型，某些JDBC Driver无法识别字段的数据类型。一个很好的例子是PreparedStatement.setNull(int parameterIndex, int sqlType)方法，要求指定数据类型。如果不指定数据类型，某些Driver可能指定为Types.Other或Types.Null。但是，不能保证所有的Driver都表现一致。对于这种情况，需要使用该属性来指定数据库字段的类型。

说明：当字段可以为NULL时最好设置jdbcType属性，否则某些Jdbc Driver会抛出异常，如db2的jcc驱动。

另一需要指定jdbcType属性的情况是字段类型为日期时间类型的情况。因为Java只有一个Date类型（java.util.Date），而大多数SQL数据库有多个（通常至少有3种）。因此，需要指定字段类型是DATE还是DATETIME。属性jdbcType可以是java.sql.Types类中定义的任意参数的字符串值。虽然如此，还是有某些类型不支持（即BLOB）。Parameter Map和Result Map支持的数据类型说明命名SQL支持的数据类型。

# javaType

属性javaType用于显式地指定被赋值参数的类型。如果没有提供类型将被假定为Object类型。

# nullValue

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

	<parameterMap id="insert-product-param" class="commonj.sdo.DataObject">
	  <parameter property="id" jdbcType="NUMERIC" javaType="int" nullValue="-9999999"/>
	  <parameter property="description" jdbcType="VARCHAR" nullValue="NO_ENTRY"/>
	</parameterMap>
	<insert id="insertProduct" parameterMap="insert-product-param">
	  insert into PRODUCT (PRD_ID, PRD_DESCRIPTION) values (?,?)
	</insert>

当id的属性值=-9999999的时候，会给PRD_ID设个null值。