SqlMap配置
SqlMap配置（转）
SqlMap的配置是iBatis中应用的核心。这部分任务占据了iBatis开发的70%的工作量。
1、命名空间：
<sqlMap namespace="Account">，在此空间外要引用此空间的元素，则需要加上命名空间名。
2、实体的别名：
<typeAlias alias="Account" type="com.lavasoft.ibatissut.simple.domain.entity.Account"/>
如果有用到的全名的地方，可以用别名代替，受命名空间约束。
3、插入操作
??? 对于自增主键的表，插入可以不配置插入的主键列。否则是必须的。
4、获取主键
???? 插入语句之前配置：主要是针对Sequence主键而言，插入前必须指定一个主键值给要插入的记录。Oracle、
DB2亦如此，方法是在插入语句标签<insert....>之前配置上：
??? <insert id="insertAccount" parameterkeyProperty="sctId">
??????????? SELECT SEQ_TEST.NEXTVAL FROM DUAL
??????? </selectKey>??
??????? insert into .... ........
??? </insert>
??
??? 插入语句之后配置：主要是针对自增主键的表而言，这类表在插入时不需要主键，而是在插入过程自动获取
一个自增的主键。比如MySQL
??? <insert id="insertAccount" parameterkeyProperty="sctId">
??????????? SELECT LAST_INSERT_ID()
?????? </selectKey>??
??????? insert into .... ........
??? </insert>
?? 当然，是否需要配置<selectKey>根据情况，只要能保证记录有主键即可。一旦配置了<selectKey>，就可以在
执行插入操作时获取到新增记录的主键。
6、SQL入参parameterClass
插入语句入参：parameter来设定。
查询语句入参：可以设定类别名，也可以设定为map，也可以设定为iBatis支持的原生类型（比如string、int、
long等），当只有一个原生类型入参时，使用#value#来引用，这个value是不是关键字，可变。比如：
??? <select id="getById" parameterresultMap="result_base">
??????? select * from customer where id = #value#
??? </select>
??? map是最强大的入参方式，任何入参方式都可以转换为这种入参方式，因为iBatis仅接受一个入参，当几个参
数分布在不同对象中的时候，将这些对象的属性（或者对象本身put）到map中，然后一次传递给sql语句是非常有
效。可以自己写一个将对象或者对象集合转换为map的工具（我已经实现一个了）。
??? 另外，map的中的元素（比如pobj）是个复杂对象，则还可以在SQL中以#pobj.protyename#的格式来引用其中
内嵌的属性。当然不推荐这么干。
7、返回值参数类型
????? 返回值参数也同样有两种类型，一种是对象类型resultcolumn="ACC_ID"/>
??????? <result property="firstName" column="ACC_FIRST_NAME"/>
??????? <result property="lastName" column="ACC_LAST_NAME"/>
??????? <result property="emailAddress" column="ACC_EMAIL"/>
??? </resultMap>
??? resultMap映射的结果的目的就是要将查询的结果集绑定到映射对象的属性上。
?? 不管使用哪种返回值参数类型，其最终目的就是要把每条记录映射到一个类的对象或者对象集合上，如果有某
个类属性映射不上，则在得到的这个对象或对象集合中这个属性为空。映射的属性可以是表与实体中的一部分。
不要同时使用两种返回值参数类型，这样只会令人迷惑。
8、查询结果集分组
??? 查询结果集排序有两种方式：一是在结果集映射上定义<resultMap id="result"
groupBy="id">，另一种就是在SQL语句中分组。建议在SQL语句中分组，以获得更大的可控制性。
9、SQL中参数的引用
???? SQL中引用parameterClass的参数有三种方式：
???? iBatis内置支持的类型，比如int、string，使用#value#来引用，这个value是不是关键字，可变。
???? map类型的参数，使用#keyName#来引用，keyName为键名。
???? 复杂对象的参数，使用#propertyName#来引用，propertyName类属性的名字。
10、模糊查询中参数的引用
??? 模糊查询是针对字符串而言的，如果遇到两个单引号要包含一个参数，则不能再用#来引用变量了，而应该改
为$，比如：'%$varName$%'，当然，也可以使用 '%' || #varname# || '%' 来绕过此问题。
11、SQL片段
?????? 可以通过<sql id="sql_xxx">...</sql>定义SQL片段，然后<include refid="sql_xxx"/>来在各种语句中
引用，达到复用目的。
12、动态SQL
????? 可以通过使用动态SQL来组织灵活性更大的更通用的SQL，这样极大减少了编码量，是iBatis应用的第二大
亮点。
???? 比如：一个动态的where条件
??????????????? <dynamic prepend="where">
??????????????????????? <isNotEmpty prepend="and" property="$$$$$">
??????????????????????????????? $name like '%'|| #$name# ||'%'
??????????????????????? </isNotEmpty>
??????????????????????? <isGreaterThan prepend="and" property="$$$$$" compareValue="$$$number">
??????????????????????????????? $code like '%'|| #$code# ||'%'
??????????????????????? </isGreaterThan>
??????????????? </dynamic>
???? 当然，prepend表示链接关键字，可以为任何字符串，当为sql关键字时，iBatis自动判断是否应该添加该关
键字。该语法也很简单，关键是要会用心思考组织动态SQL。
??? 这里面有一点要注意：区别<isNotEmpty>和<isNotNull>区别，当为空空串时<isNotEmpty>返回true，当为空
串时<isNotNull>返回真。哈哈，自己体会吧，说了反而啰嗦。
13、结果集映射继承
结果集映射的继承的目的是为了映射定义的复用，比如下面定义了两个映射，AccountResult继承了base：
??? <resultMap id="base" column="ACC_ID"/>
??????? <result property="firstName" column="ACC_FIRST_NAME"/>
??????? <result property="lastName" column="ACC_LAST_NAME"/>
??? </resultMap>
??? <resultMap id="AccountResult" extends="Account.base">
??????? <result property="emailAddress" column="ACC_EMAIL"/>
??? </resultMap>
这样，就很容易扩展了一个映射策略。
???????
14、查询注入
查询注入是在一个查询中嵌入另外一个查询，这样做的目的是为了实现实体对象之间的关联关联关系（一对一、
一对多、多对多）分单项双向。有关这些内容，是比较复杂的，笔者对此做了深入研究，并分别写了三篇来讲述
。
查询注入的实现就是在实体属性为另外一个实体或者实体集合的时候，引入一个相关的查询来实现，例如，客户
和订单的映射关系：
public class Customer {
??? private Long id;
??? private String name;
??? private String address;
??? private String postcode;
??? private String sex;
??? private List<Orders> orderlist = new ArrayList<Orders>();
??? <resultMap id="result" column="id"/>
??????? <result property="name" column="name"/>
??????? <result property="address" column="address"/>
??????? <result property="postcode" column="postcode"/>
??????? <result property="sex" column="sex"/>
??????? <result property="orderlist" column="id" select="orders.findByCustomerId "/>
??? </resultMap>
在这个映射中，为了查询客户的时候，能查询到相关的订单，可以在映射orderlist 属性的时候，将其指向另外
一个查询orders.findByCustomerId ，这个查询是以Customer的id 为参数来查询的。
select="orders.findByCustomerId " 这个查询定义如下：
??? <select id="findByCustomerId" resultMap="result_base" parameterjdbcType="VARCHAR" javaType="java.lang.String" mode="INOUT"/>
??????? <parameter property="email2" jdbcType="VARCHAR" javaType="java.lang.String" mode="INOUT"/>
??? </parameterMap>
??? <procedure id="swapEmailAddresses" parameterMap="swapParameters">
??????? {call swap_email_address (?, ?)}
??? </procedure>
调用上面的存储过程将同时互换两个字段（数据库表）和参数对象（Map）中的两个 email地址。如果参数的
mode 属性设为 INOUT 或 OUT，则参数对象的值被修改。否则保持不变。
注意！要确保始终只使用 JDBC 标准的存储过程语法。参考 JDBC 的 CallableStatement
文档以获得更详细的信息。
16、就是iBatis中各种id的命名了，这个看起来小菜一碟，但是搞砸了会很痛苦。建议如果有DAO层的话，DAO接
口的名字和SQL语句 id的名字保持一致。同时，在DAO中将save和update封装为一个方法（从Hibernate中学来的
），这是非常好的。也可以直接在SQL层将插入和更新柔和在一块，太复杂，有点影响效率，这见机行事了。
?? 另外Spring提供了各种数据操作模板，通过模板，擦做数据也就是“一句话”的问题，写个DAO还有必要么，
尤其对iBatis来说，根本没有必要。这样，就需要在领域活动层的设计上下功夫了。
17 、iBatis的查询也可以配置缓存策略，缓存的配置很复杂，分很多中情况，可以参看附件中的iBATIS-
SqlMaps-2_cn.pdf 的39页内容，有详细介绍。
18、偷懒的最高境界，让程序去干哪里80%的体力活。自己仅仅把把关。任何重复的活动都有规律可循的，一旦发
现了其中的规律，你就可以想办法把自己从中解脱出来。
??? iBatis也不例外，每个表都有增删改查、分页等操作。对应在每个DAO方法上亦如此。可以通过数据库生成
sqlmap、entity、dao，然后将这些东西改吧改吧就完成大部分的工作量。本人已经实现过了，当然开发这个工具
的前提是你对iBatis有深入研究和理解。
-------------------------------------------------
下面是iBatis开发指南中内容：
附录：容易出错的地方
本附录是译者添加的，列出了初学者容易出错的地方，作为完成快速入门课程后的学习
笔记，可以让初学者少走些弯路。仅供参考。
1) 在 parameterMap 和 resultMap 中，字段数据类型是 java.sql.Types 类定义的常量名
称。常用的数据类型包括 BLOB，CHAR，CLOB，DATE，LONGVARBINARY，
INTEGER，NULL，NUMERIC，TIME，TIMESTAMP 和 VARCHAR 等。
2) 对于数据表中 NULLABLE 的字段，必须在 parameterMap 和 resultMap 中指定字段
的数据类型。
3) 对于数据类型是 DATE，CLOB 或 BLOB 的字段，最好在 parameterMap 和 resultMap中指定数据类型。
4) 对于二进制类型的数据，可以将 LONGVARBINARY 映射成 byte[]。
5) 对于文本类型较大的数据，可以将 CLOB 映射成 String。
6) Java Bean 必须拥有缺省的构造器（即无参数的构造器）。
7) Java Bean 最好实现 Serializable 接口，以备应用的进一步扩展。
?
