ibatis（学习1）--sqlMapConfig sqlMap的配置，和sqlMap中的各种语法

 "1.0" encoding="UTF-8" ?>

     PUBLIC "-//iBATIS.com//DTD SQL Map Config 2.0//EN"
     "http://www.ibatis.com/dtd/sql-map-config-2.dtd">


         useStatementNamespaces="true"
         cacheModelsEnabled="true"
         enhancementEnabled="true"
         lazyLoadingEnabled="true"
         errorTracingEnabled="false"
         maxRequests="32"
         maxSessions="10"
         maxTransactions="5"
     />

     "JDBC">
         "SIMPLE">
             "JDBC.Driver" value="${jdbc.driverClassName}" />
             "JDBC.ConnectionURL" value="${jdbc.url}" />
             "JDBC.Username" value="${jdbc.username}" />
             "JDBC.Password" value="${jdbc.password}" />
             "JDBC.DefaultAutoCommit" value="true" />
             "Pool.MaximumActiveConnections" value="10" />
             "Pool.MaximumIdleConnections" value="5" />
             "Pool.MaximumCheckoutTime" value="120000" />
             "Pool.TimeToWait" value="500" />
             "Pool.PingQuery" value="select 1 from ACCOUNT" />
             "Pool.PingEnabled" value="false" />
             "Pool.PingConnectionsOlderThan" value="1" />
             "Pool.PingConnectionsNotUsedFor" value="1" />
             "Pool.QuietMode" value="true" />


      "com/sitech/wfrest/dao/engine/WorkflowEngine.xml" />
      "com/sitech/wfrest/dao/resworkflow/ResourceWorkflow.xml" />

 SqlMapConfig文件的配置参数学习：

 ------------------------------------------------------------
 Settings 节点：
 参数，描述

 cacheModelsEnabled="true"
 指定了SQL Map运行时实例的缓存Model是否开启

 enhancementEnabled="true"
 是否针对POJO启用字节码增强机制以提升getter/setter的调用效能，避免使用Java  Reflect所带来的性能开销。同时，这也为Lazy Loading带来了极大的性能提升。建议设为"true"


 errorTracingEnabled = "true"
 是否启用错误日志，在开发期间建议设为"true" 以方便调试


 lazyLoadingEnabled="true"
 指定了持久化数据是否延迟加载

 maxRequests="32"
 最大并发请求数（Statement并发数）

 maxSessions="10"
 最大Session 数。即当前最大允许的并发 SqlMapClient 数。 maxSessions设定必须介于maxTransactions和maxRequests之间，即 maxTransactions

 useStatementNamespaces
 是否使用Statement命名空间。这里的命名空间指的是映射文件中，sqlMap节点 的namespace属性，如在上例中针对t_user 表的映射文件sqlMap节点：（sqlMap namespace="User"）这里，指定了此sqlMap节点下定义的操作均从 属于"User"命名空间。在useStatementNamespaces="true"的情况下，Statement调用需追加命名空间，如：sqlMap.update("User.updateUser",user);否则直接通过Statement名称调用即可，如：sqlMap.update("updateUser",user);但请注意此时需要保证所有映射文件中，Statement定义无重名,在大型的项目中尽量启用statement的命名空间。

 maxTransactions="10"
 最大并发事务数

 transactionManager节点:
 参数，描述
 transactionManager 节点定义了ibatis 的事务管理器，目前提供了两种内置选择：
 Ø JDBC
 通过传统JDBC Connection.commit/rollback实现事务支持。
 Ø JTA
 使用容器提供的JTA服务实现全局事务管理。
 Ø EXTERNAL
 外部事务管理，如在EJB中使用ibatis，通过EJB的部署配置即可实现自动的事务管理机制。此时ibatis 将把所有事务委托给外部容器进行管理。此外，通过Spring 等轻量级容器实现事务的配置化管理也是一个不错的选择。关于结合容器实现事务管理，参见“高级特性”中的描述。


 dataSource从属于transactionManager节点，用于设定ibatis运行期使用的DataSource属性。
 type属性： dataSource节点的type属性指定了dataSource的实现类型。
 可选项目：
 Ø SIMPLE：
 SIMPLE是ibatis内置的dataSource实现，其中实现了一个简单的数据库连接池机制， 对应ibatis 实现类为
 com.ibatis.sqlmap.engine.datasource.SimpleDataSourceFactory。
 Ø DBCP:
 基于Apache DBCP 连接池组件实现的DataSource 封装，当无容器提供DataSource 服务时，建议使用该选项，对应ibatis 实现类为com.ibatis.sqlmap.engine.datasource.DbcpDataSourceFactory。
 Ø JNDI：
 使用J2EE 容器提供的DataSource 实现，DataSource 将通过指定的JNDI Name 从容器中获取。对应ibatis 实现类为com.ibatis.sqlmap.engine.datasource.JndiDataSourceFactory。

 dataSource的子节点说明（SIMPLE&DBCP）：
 参数 描述
 JDBC.Driver JDBC 驱动。
 如：org.gjt.mm.mysql.Driver
 JDBC.ConnectionURL 数据库URL。
 如：jdbc:mysql://localhost/sample
 如果用的是SQLServer JDBC Driver，需要在url后追加SelectMethod=Cursor以获得JDBC事务的多statement支持。
 JDBC.Username： 数据库用户名
 JDBC.Password： 数据库用户密码
 Pool.MaximumActiveConnections：数据库连接池可维持的最大容量。
 Pool.MaximumIdleConnections：数据库连接池中允许的挂起（idle）连接数。

 以上子节点适用于SIMPLE 和DBCP 模式，分别针对SIMPLE 和DBCP 模式的DataSource私有配置节点如下：

 SIMPLE:

 参数 描述

 Pool.MaximumCheckoutTime
 数据库联接池中，连接被某个任务所允许占用的最大时间，如果超过这个时间限定，连接将被强制收回。（毫秒）

 Pool.TimeToWait
 当线程试图从连接池中获取连接时，连接池中无可用连接可供使用，此时线程将进入等待状态，
 直到池中出现空闲连接。此参数设定了线程所允许等待的最长时间。（毫秒）

 Pool.PingQuery
 数据库连接状态检测语句，某些数据库在连接在某段时间持续处于空闲状态时会将其断开。而连接池管理器将通过此语句检测池中连接是否可用。
 检测语句应该是一个最简化的无逻辑SQL。
 如“select 1 from t_user”，如果执行此语句成功，连接池管理器将认为此连接处于可用状态。
 Pool.PingEnabled 是否允许检测连接状态。
 Pool.PingConnectionsOlderThan
 对持续连接时间超过设定值（毫秒）的连接进行检测。
 Pool.PingConnectionsNotUsedFor 对空闲超过设定值（毫秒）的连接进行检测。


 DBCP:
 参数 描述
 Pool.MaximumWait 当线程试图从连接池中获取连接时，连接池中无可用连接可供使用，此时线程将进入等待状态，直到池中出现空闲连接。此参数设定了线程所允许等待的最长时间。（毫秒）
 Pool.ValidationQuery 数据库连接状态检测语句。某些数据库在连接在某段时间持续处于空闲状态
 时会将其断开。而连接池管理器将通过此语句检测池中连接是否可用。检测语句应该是一个最简化的无逻辑SQL。
 如“select 1 from t_user”，如果执行此语句成功，连接池管理器将认为此连接处于可用状态。
 Pool.LogAbandoned 当数据库连接被废弃时，是否打印日志。
 Pool.RemoveAbandonedTimeout数据库连接被废弃的最大超时时间
 Pool.RemoveAbandoned 当连接空闲时间超过
 RemoveAbandonedTimeout时，是否将其废弃。
 JNDI由于大部分配置是在应用服务器中进行，因此ibatis中的配置相对简单，下面是分别使用JDBC和JTA事务管理的JDNI配置：
 使用JDBC事务管理的JNDI DataSource配置
 "JDBC" >
 "JNDI">
 "DataSource"
 value="java:comp/env/jdbc/myDataSource"/>


 "JTA" >
 "UserTransaction"
 value="java:/ctx/con/UserTransaction"/>
 "JNDI">
 "DataSource"
 value="java:comp/env/jdbc/myDataSource"/>

sqlMap节点: 

sqlMap 节点指定了映射文件的位置，配置中可出现多个sqlMap 节点，以指定项目内所包含的所有映射文件。 
---------------------------------------------------------------------------------------------------------------- 

SqlMap的配置是iBatis中应用的核心。这部分任务占据了iBatis开发的70的工作量。 

1、命名空间： 
  ，在此空间外要引用此空间的元素，则需要加上命名空间名。 

2、实体的别名： 
   
  如果有用到的全名的地方，可以用别名代替，受命名空间约束。 

3、插入操作 
    对于自增主键的表，插入可以不配置插入的主键列。否则是必须的。 

4、获取主键 
     插入语句之前配置：主要是针对Sequence主键而言，插入前必须指定一个主键值给要插入的记录。Oracle、DB2亦如此，方法是在插入语句标签之前配置上： 
     
         
            SELECT SEQ_TEST.NEXTVAL FROM DUAL 
          
        insert into .... ........ 
     
  
    插入语句之后配置：主要是针对自增主键的表而言，这类表在插入时不需要主键，而是在插入过程自动获取一个自增的主键。比如MySQL 
     
         
            SELECT LAST_INSERT_ID() 
         
        insert into .... ........ 
     

   当然，是否需要配置根据情况，只要能保证记录有主键即可。一旦配置了，就可以在执行插入操作时获取到新增记录的主键。 

6、SQL入参parameterClass 
  插入语句入参：parameterClass="类别名"  来设定。 
  查询语句入参：可以设定类别名，也可以设定为map，也可以设定为iBatis支持的原生类型（比如string、int、long等），当只有一个原生类型入参时，则在SQL中用value关键字来引用。比如： 
     
        select * from customer where id = #value# 
     
    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映射的结果的目的就是要将查询的结果集绑定到映射对象的属性上。 

   不管使用哪种返回值参数类型，其最终目的就是要把每条记录映射到一个类的对象或者对象集合上，如果有某个类属性映射不上，则在得到的这个对象或对象集合中这个属性为空。映射的属性可以是表与实体中的一部分。不要同时使用两种返回值参数类型，这样只会令人迷惑。 

8、查询结果集分组 
    查询结果集排序有两种方式：一是在结果集映射上定义，另一种就是在SQL语句中分组。建议在SQL语句中分组，以获得更大的可控制性。 

9、SQL中参数的引用 
     SQL中引用parameterClass的参数有三种方式： 
     iBatis内置支持的类型，比如int、string，使用#value#来引用，这个value是关键字，不可变。 
     map类型的参数，使用#keyName#来引用，keyName为键名。 
     复杂对象的参数，使用#propertyName#来引用，propertyName类属性的名字。 

10、模糊查询中参数的引用 
    模糊查询是针对字符串而言的，如果遇到两个单引号要包含一个参数，则不能再用#来引用变量了，而应该改为$，比如：'%$varName$%'，当然，也可以使用 '%' || #varname# || '%' 来绕过此问题。 

11、SQL片段 
       可以通过...定义SQL片段，然后来在各种语句中引用。达到服用目的， 

12、动态SQL 
      可以通过使用动态SQL来组织灵活性更大的更通过的SQL，这样极大减少了编码量，是iBatis应用的第二大亮点。 
     比如：一个动态的where条件 
                 
                         
                                $name like '%'|| #$name# ||'%' 
                         
                         
                                $code like '%'|| #$code# ||'%' 
                         
                 
     当然，prepend表示链接关键字，可以为任何字符串，当为sql关键字时，iBatis自动判断是否应该添加该关键字。该语法也很简单，关键是要会用心思考组织动态SQL。 
    这里面有一点要注意：区别和区别，当为空空串时返回true，当为空串时返回真。哈哈，自己体会吧，说了反而啰嗦。 

13、结果集映射继承 
结果集映射的继承的目的是为了映射定义的复用，比如下面定义了两个映射，AccountResult继承了base： 
     
         
         
         
     
     
         
     
这样，就很容易扩展了一个映射策略。 
       
14、查询注入 
查询注入是在一个查询中嵌入另外一个查询，这样做的目的是为了实现实体对象之间的关联关联关系（一对一、一对多、多对多）分单项双向。有关这些内容，是比较复杂的，笔者对此做了深入研究，并分别写了三篇来讲述。 

查询注入的实现就是在实体属性为另外一个实体或者实体集合的时候，引入一个相关的查询来实现，例如，客户和订单的映射关系： 
public class Customer { 
    private Long id; 
    private String name; 
    private String address; 
    private String postcode; 
    private String sex; 
    private List orderlist = new ArrayList(); 

     
         
         
         
         
         
         
     

在这个映射中，为了查询客户的时候，能查询到相关的订单，可以在映射orderlist属性的时候，将其指向另外一个查询orders.findByCustomerId，这个查询是以Customer的id为参数来查询的。 

select="orders.findByCustomerId"这个查询定义如下： 
     
        select * from orders where customerId = #value# 
     

原理就是这么简单，然后根据实际情况，可以自由实现实体间的关联关系。 

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 通过元素支持存储过程。下面的例子说明如何使用具有输出参数 
的存储过程。 
     
         
         
     
     
        {call swap_email_address (?, ?)} 
     
调用上面的存储过程将同时互换两个字段（数据库表）和参数对象（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 接口，以备应用的进一步扩展。 

本人认为：尽量避免在每个入参后面附加参数的类型。以保持配置简洁，并且本人在长期开发中，没有发现必须要那么做。 



ibatis动态sql 
--------------------------------------------------------------------------------------------------------------------------------------- 
直接使用JDBC一个非常普遍的问题就是动态SQL。使用参数值、参数本身和数据列都是动态SQL，通常是非常困难的。典型的解决办法就是用上一堆的IF-ELSE条件语句和一连串的字符串连接。对于这个问题，Ibatis提供了一套标准的相对比较清晰的方法来解决一个问题，这里有个简单的例子： 

      

         select * from user 

             

                   where user_id = #userId# 

             

             order by createTime desc 

     

     上面的例子中，根据参数bean“id”属性的不同情况，可创建两个可能的语句。如果参数“id”大于0，将创建下面的语句： 

      select * from user where user_id = ?  order by createTime desc 

     或者，如果“id”参数小于等于0，将创建下面的语句： 
      select * from user  order by createTime desc 

以上的这个例子是否可以看出Ibatis里提供的简单的写法来实现了复杂拖沓的动态SQL呢？我们在做查询的时候，对于同一个表，甚至可以用来定义一个动态SQL，做到重用的地步，还是上面那个例子： 

 

      

             

                   where user_id = #userId# 

             

    

 

 

         select * from user 

         

          

          order by createTime desc 

     

      这个使用的话是否更加的具有公用性能，这就是Ibatis带来的便利。 

      在Ibatis中，动态的条件元素包含一下几种：二元条件元素、一元条件元素和其他条件元素： 

      (1)、二元条件元素：将一个属性值和静态值或另一个属性值比较，如果条件为真，元素将被包容在查询SQL语句中。 

            二元条件元素的属性： 

             perpend——可被覆盖的SQL语句组成部分，添加在语句的前面(可选) 

             property——是比较的属性(必选) 

             compareProperty——另一个用于和前者比较的属性(必选或选择compareValue) 

             compareValue——用于比较的值(必选或选择compareProperty) 


 

举个小例子： 

      
          ADOLESCENT = ‘TRUE’ 
       

    如果大于等18岁时，则为成年人 

   (2)、一元条件元素：一元条件元素检查属性的状态是否符合特定的条件。 

     一元条件元素的属性： 

      prepend——可被覆盖的SQL语句组成部分，添加在语句前面(可选) 

      property——被比较的属性(必选) 




小例子： 

     
           FIRST_NAME=#firstName# 
    

   (3)、其他元素条件 

         (a).Parameter Present：这些元素检查参数对象是否存在 

         Parameter Present条件的属性 

        prepend － 可被覆盖的SQL语句组成部分，添加在语句的前面（可选） 

  检查是否存在参数对象（不为null） 

  例子： 

 
EMPLOYEE_TYPE = ‘DEFAULT’ 
 

(b)、Iterate：这属性遍历整个集合，并为List集合中的元素重复元素体的内容。 

          Iterate的属性： 

          prepend － 可被覆盖的SQL语句组成部分，添加在语句的前面（可选） 
          property － 类型为java.util.List的用于遍历的元素（必选） 
          open － 整个遍历内容体开始的字符串，用于定义括号（可选） 
          close －整个遍历内容体结束的字符串，用于定义括号（可选） 
          conjunction － 每次遍历内容之间的字符串，用于定义AND或OR（可选） 


遍历类型为java.util.List的元素。 
例子： 

open="(" close=")" conjunction="OR"> 
username=#userNameList[]# 
 

注意：使用时，在List元素名后面包括方括号[]非常重要，方括号[]将对象标记为List，以防解析器简单地将List输出成String。 

转自：http://shijincheng0223.iteye.com/blog/1582298