本文是刚刚搜索到的，看完了觉得写得不错，偷偷转过来
，我有个好习惯，看到好文章就喜欢分享，当然只要是转载的我都会标记原文作者及出处，算是对作者的尊重。
这位作者的文章写得挺好~
iBatis2学习笔记：SqlMap的配置总结（18条）
本来我也不喜欢iBatis，那是因为我当时还不怎么会用它，现在我想说，iBatis是个好东西，不信你试试看。下面是我在项目实践中对iBatis的一个小总结，希望帮助众多在疲于iBatis编码而无暇思考的苦工们找到一些偷懒的机会。
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" parameterClass="Account">
<selectKey resultClass="long" keyProperty="sctId">
SELECT SEQ_TEST.NEXTVAL FROM DUAL
</selectKey>
insert into .... ........
</insert>
插入语句之后配置：蛀牙是针对自增主键的表而言，这类表在插入时不需要主键，而是在插入过程自动获取一个自增的主键。比如MySQL
<insert id="insertAccount" parameterClass="Account">
<selectKey resultClass="long" keyProperty="sctId">
SELECT LAST_INSERT_ID()
</selectKey>
insert into .... ........
</insert>
当然，是否需要配置<selectKey>根据情况，只要能保证记录有主键即可。一旦配置了<selectKey>，就可以在执行插入操作时获取到新增记录的主键。
6、SQL入参parameterClass
插入语句入参：parameterClass="类别名" 来设定。
查询语句入参：可以设定类别名，也可以设定为map，也可以设定为iBatis支持的原生类型（比如string、int、long等），当只有一个原生类型入参时，则在SQL中用value关键字来引用。比如：
<select id="getById" parameterClass="long" resultMap="result_base">
select * from customer where id = #value#
</select>
map是最强大的入参方式，任何入参方式都可以转换为这种入参方式，因为iBatis仅接受一个入参，当几个参数分布在不同对象中的时候，将这些对象的属性（或者对象本身put）到map中，然后一次传递给sql语句是非常有效。可以自己写一个将对象或者对象集合转换为map的工具（我已经实现一个了）。
另外，map的中的元素（比如pobj）是个复杂对象，则还可以在SQL中以#pobj.protyename#的格式来引用其中内嵌的属性。当然不推荐这么干。
7、返回值参数类型
返回值参数也同样有两种类型，一种是对象类型resultClass="Account"，一种是resultMap="AccountResult"。这两种类型的选择常常会令人迷惑不解，一言明其理：
当结果集列名和类属性名完全对应的时候，则应该使用resultClass来指定查询结果类型。当然有些列明不对应，可以在sql中使用as重命名达到一致的效果。
当查询结果列名和类属性名对应不上的时候，应该选择resultMap指定查询结果集类型。否则，则查询出来填充的对象属性为空（数字的为0，对象的为null）。
但是实际上resultMap是对一个Java Bean的映射，需要先定义xml的映射后，才可以引用，例如：
<resultMap id="AccountResult" class="Account">
<result property="id" column="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" class="bar" 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" class="Account">
<result property="id" column="ACC_ID"/>
<result property="firstName" column="ACC_FIRST_NAME"/>
<result property="lastName" column="ACC_LAST_NAME"/>
</resultMap>
<resultMap id="AccountResult" class="Account" 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" class="customer">
<result property="id" 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" parameterClass="long">
select * from orders where customerId = #value#
</select>
原理就是这么简单，然后根据实际情况，可以自由实现实体间的关联关系。
14、iBatis的分页查询
iBatis的分页有两种方式，一点都不神秘，不要被网上的流言所迷惑。
第一种方式：结果集筛选分页。先执行部分页的SQL查询语句，然后得到一个ResultSet，然后根据分页范围选择有效的记录填充到对象中，最终以集合的形式返回。对于10w条一下的记录的表，不存在性能问题，如果存在，你可以选择第二中方式。
第二种方式：SQL分页，通过组装分页类型的SQL来实现分页。这个关键在于分页参数的传递和分页SQL的构建。分页SQL构件每种数据库都不一样，不说了。分页参数的传递却可以通用。我主张用map分装入参，连同分页参数一块传递进来，就搞定了。如果原来没有考虑到分页，而用的是对象做参数，则可以通过apache 的 beanutils组件来实现一个object到map之间的转换工具，问题迎刃而解。
当然，这还不是分页查询应用的最高境界。思考，分页需要计算一个总记录数，记录数执行的sql返回值是count(?)，条件是除了分页以外的条件，因此应该将查询SQL静态分开，以MySQL为例，可以将查询分为查什么，和什么条件两部分，在条件部分对分页参数进行动态判断，如果分页参数就不分页，如果有则分页。这样最后只需要两个组装的sql就可以计算总数和分页查询了。大大简化了问题的难度。 Oracle的解决思路也一样，不一样的地方就是拼装分页SQL改变了。
15、执行存储过程的配置
SQL Map 通过<procedure>元素支持存储过程。下面的例子说明如何使用具有输出参数
的存储过程。
<parameterMap id="swapParameters" class="map">
<parameter property="email1" jdbcType="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来说，根本没有必要。这样，就需要在领域活动层的设计上下功夫了。
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 接口，以备应用的进一步扩展。
附件下载：
分享到：
相关推荐
这篇“ibatis学习笔记（一）”可能是博主对Ibatis基础概念、安装配置以及基本使用的介绍，让我们通过标签“源码”和“工具”来深入探讨Ibatis的相关知识。 首先，Ibatis是一个轻量级的Java ORM（对象关系映射）框架...
通过本篇学习笔记，我们深入了解了 ibatis 的配置文件结构、常用的操作方式以及一些高级特性如命名空间和缓存机制。这些知识点对于初学者来说至关重要，它们不仅有助于快速掌握 ibatis 的使用方法，还能够帮助开发者...
本篇学习笔记将深入探讨Ibatis的优点、与JDBC的对比以及如何准备Ibatis的开发环境。 **一、Ibatis 优点** 1. **SQL语句独立**：Ibatis允许开发者在XML配置文件中编写SQL语句，这使得源代码更加整洁，便于团队协作...
《深入理解iBatis：一个全面的学习指南》 iBatis，作为一个优秀的持久层框架，为Java开发者提供了灵活的数据访问接口，将SQL语句与Java代码...希望这篇学习笔记能帮助你更全面地掌握iBatis，并在实际工作中游刃有余。
在本篇“Spring3学习笔记（2）-集成ibatis3进行单元测试”中，我们将深入探讨如何在Spring3框架中整合Ibatis3，并利用它来进行单元测试。这个主题对于理解如何在实际项目中实现数据访问层的测试具有重要意义。在现代...
MyBatis 的精髓在于 SQL 映射文件（例如：iBatis学习笔记中的映射文件），其中定义了 SQL 语句、参数和结果集映射。这些映射可以包含动态 SQL，使得 SQL 语句更加灵活，可以根据传入的参数动态生成不同的 SQL。 4....
全书内容分为7篇，共23章,第一篇为“JSP应用开发基础”，主要讲述JSP技术背景情况、JSP技术的基本原理及开发环境的搭建；第二篇为“Servlet核心技术”，主要讲述Servlet的技术特点、请求和响应、数据共享、会话跟踪...
【标题】：“配置svn教会你ibatis的好个人笔记”是一篇针对初学者的教程，旨在帮助读者掌握如何配置Subversion（svn）以及使用iBATIS框架。这篇笔记以树形结构进行分层，确保逻辑清晰，便于理解。 【描述】：作者...
【标题】"ibaties学习笔记(一)"的解析与详解 在IT行业中，iBATIS（现更名为MyBatis）是一款广泛使用的持久层框架，它允许开发者将SQL语句直接映射到Java代码中，简化了数据访问层的开发工作。本篇学习笔记将深入...
文件名如 "iBatis2学习笔记：多对多映射(双向).htm" 暗示了文档可能深入讲解了如何配置和使用双向多对多映射，而 "iBatis2学习笔记：SqlMap的配置总结（18条）.htm" 可能提供了关于 iBatis 配置的全面概述。...
本篇学习笔记主要围绕JMesa的安装配置、基本使用方法以及常见问题解决策略进行详细介绍。在实际项目开发过程中，作者之前使用过其前身ExtremeTable，并在使用过程中遇到了一些bug，最终决定转向JMesa。 #### 二、...
描述中的博文链接指向了iteye博客上的一篇文章，可能包含了作者对于iBATIS使用、配置、优化或者源码分析的个人见解和经验分享。由于没有具体的内容，我们无法提供更多的细节，但通常这类文章会涵盖以下主题： 1. **...
第一篇的根据id查询学生的例子中，稍做修改： 建立StudentDAO接口 package cn.pf.ibatis.dao; import java.util.List; import cn.pf.ibatis.domain.Student; public interface StudentDAO { public Student ...
【淘宝实习笔记--webx学习之旅】这篇笔记主要记录了作者在淘宝实习期间关于Webx框架的学习和理解。Webx是一个用于构建企业级Web应用程序的框架，它在淘宝内部广泛使用。以下是一些核心知识点： 1. **iBATIS**：...