ibatis中的parameterMap和parameterClass的应用详解

属性parameterMap的值等于一个预先定义的元素的名称。parameterMap属性很少使用，更多的是使用的parameterClass
但是使用parameterMap可以提高数据库的访问效率，具体使用如下：
Xml代码  

     <parameterMap class="com.fenxiao.domain.CooperationDo" id="insertCooperationDoByMap" > 
            <parameter property="id"/> 
            <parameter property="supplierId"/> 
            <parameter property="supplierName"/>      
            <parameter property="distributorId"/>      
            <parameter property="distributorName"/>      
            <parameter property="status"/>      
            <parameter property="checkTime" />      
            <parameter property="applyTime" />      
    </parameterMap>
   
    <!-- 使用了map -->
    <insert id="Cooperation.insertCooperationByMap" parameterMap="insertCooperationDoByMap">
       insert into cooperation values(?,?,?,?,?,?,?,?);
       <selectKey resultClass="java.lang.Integer"  keyProperty="id">
        select max(id) from cooperation
    </selectKey>
    </insert>
    
    

domain层
public class CooperationDo {
    
    private int id ;
    private int supplierId ;
    private String supplierName ;
    private int distributorId ;
    private String distributorName ;
    private byte status ;
    private Date checkTime ;
    private Date applyTime ;
    ...........getter setter方法
    }
    
    
DAO类：


    public int insertByMap(CooperationDo cooperationDo);

DAO实现类

public int insertByMap(CooperationDo cooperationDo) {
        return (Integer)getSqlMapClientTemplate().insert("Cooperation.insertCooperationByMap", cooperationDo);
    }
    

    


测试类：
@Test
    public void insertByMap(){
        CooperationDo cooperationDo = new CooperationDo();
        cooperationDo.setDistributorId(4);
        cooperationDo.setDistributorName("aaa4");
        cooperationDo.setSupplierName("bbb4");
        cooperationDo.setSupplierId(44);
       cooperationDo.setStatus((byte)1);
      cooperationDo.setApplyTime(new Date());
      cooperationDo.setCheckTime(new Date());
       int i = cooperationDao.insertByMap(cooperationDo);
       System.out.println(i);
    }

 
现在来具体分析下：
 具体的parameterMap:
Xml代码  

    <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属性可以用来验证传入的参数的合法性及优化查询

元素:

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值写入数据库。

元素


最后总结列出几点ParameterMap需要特别注意的几个细节：

1.在配置ParameterMap的时候，如果传入的参数对像是元数据类型（int,string etc），那么在配置Parameter元素的时候，property的属性名使用value。通过这种情况主要使用在为存储指定参数的情况下。

2.如果ParameterMap中配置的parameter元素不包含在传入参数对象中（属性或IDictionary对象的一个key,value项），将会产生异常，而不管在statement中有没有用到。

3.在使用parameterMap的extends属性时，它将会继承extends值对应的parameterMap配置，并且会继承它的所有的参数映射，并且顺序是从继承的那配置为基准开始计算。这个在需要用到extends属性的时候要特别注意。

4.在为存储过程传参过程要特别注意，参数映射与存储过程的参数之间的顺序对应要正确。而且必须为提供与存储过程足够的参数(parameter配置足够多)，即使存储过程的部分参数已经有默认值了。否则将抛出System.ArgumentOutOfRangeException异常。

5．正常情况下，应该尽量使用内联参数。