标签详细说明带实例代码1

1.<setting>元素
<setting>元素用于配置和优化SqlMapClient实例的各选项。<setting>元素本身及其所有的属性都是可选的。下表列出了<setting>元素支持的属性及其功能：
<1>maxRequests：同时执行SQL语句的最大线程数。大于这个值的线程将阻塞直到另一个线程执行完成。不同的DBMS有不同的限制值，但任何数据库都有这些限制。通常这个值应该至少是maxTransactions（参见以下）的10倍，并且总是大于maxSessions和maxTranactions。减小这个参数值通常能提高性能。例如：maxRequests=“256”缺省值：512
<2>maxSessions:同一时间内活动的最大session数.

2.<typeAlias>元素
<typeAlias>元素让您为一个通常较长的、全限定类名指定一个较短的别名。例如：
<typeAlias alias="shortname" type="com.long.class.path.Class"/>

3.<transationManager>元素让您为SQL Map配置事务管理服务。属性type指定所使用的事务管理器类型。这个属性值可以是一个类名，也可以是一个别名。包含在框架的三个事务管理器分别是：JDBC，JTA和EXTERNAL。

4.<datasource>元素
<datasource>是<transactionManager>的一部分，为SQL Map数据源设置了一系列参数。目前SQL Map架构只提供三个DataSource Factory，但您也可以添加自己的实现。下面详细地讨论DataSourceFactory的三个实现及其例子。
5.<sqlMap>元素用于包括SQL Map映射文件和其他的SQL Map配置文件。每个SqlMapClient对象使用的所有SQL Map映射文件都要在此声明。映射文件作为stream resource从类路径或URL读入。

5.<resultMap>
resultMap是最常用和最重要的属性。ResultMap属性的值等于预先定义的resultMap元素的name属性值（参照下面的例子）。使用resultMap可以控制数据如何从结果集中取出，以及哪一个属性匹配哪一个字段。不象使用resultClass的自动映射方法，resultMap属性可以允许指定字段的数据类型，NULL的替代值复杂类型映射（包括其他Java Bean，集合类型和基本类型包装类）。
关于resultMap的详细讨论放在以后的章节，这里只给出一个相关statement的resultMap的例子。
<resultMap id=”get-product-result” class=”com.ibatis.example.Product”>
<result property=”id” column=”PRD_ID”/>
<result property=”description” column=”PRD_DESCRIPTION”/>
</resultMap>
<statement id=”getProduct” resultMap=”get-product-result”>
select * from PRODUCT
</statement>
上面的例子中，通过resultMap的定义，查询语句得到的ResultSet被映射成Product对象。resultMap定义的“id”属性值将赋予“PRO_ID”字段值，而“description”属性值将赋予“PRD_DESCRIPTION”字段值。注意resultMap支持“select *”，并不要求定义ResultSet所有返回字段的映射。
在SQL Map框架中，Result Map是极其重要的组件。在执行查询Mapped Statement时，resultMap负责将结果集的列值映射成Java Bean的属性值。resultMap的结构如下：
<resultMap id=”resultMapName” class=”some.domain.Class” [extends=”parent-resultMap”]>
<result property=”propertyName” column=”COLUMN_NAME”
[columnIndex=”1”] [javaType=”int”] [jdbcType=”NUMERIC”]
[nullValue=”-999999”] [select=”someOtherStatement”]
/>
<result ……/>
<result ……/>
<result ……/>
</resultMap>
括号[]中是可选的属性。resultMap的id属性是statement的唯一标识。ResultMap的class属性用于指定Java类的全限定名（即包括包的名称）。该Java类初始化并根据定义填充数据。extends是可选的属性，可设定成另外一个resultMap的名字，并以它为基础。和在Java中继承一个类相似，父resultMap的属性将作为子resutlMap的一部分。父resultMap的属性总是加到子resultMap属性的前面，并且父resultMap必须要在子resultMap之前定义。父resultMap和子resultMap的class属性不一定要一致，它们可以没有任何关系。resultMap可以包括任意多的属性映射，将查询结果集的列值映射成Java Bean的属性。属性的映射按它们在resultMap中定义的顺序进行。相关的Java Bean类必须符合Java Bean规范，每一属性都必须拥有get/set方法。
注意！ResultSet的列值按它们在resultMap中定义的顺序读取（这特性会在某些实现得不是很好的JDBC Driver中派上用场）。
下面几个小节讨论resultMap的result元素各个属性：