ibatis介绍

 

ibatis基础代码包括：
1．    ibatis实例配置
一个典型的配置文件如下（具体配置项目的含义见后）：
<? xml version="1.0" encoding="UTF-8"    ?>  
<! DOCTYPE sqlMapConfig
      PUBLIC "-//iBATIS.com//DTD SQLMap Config 2.0/
      "http://www.ibatis.com/dtd/sql-map-config-2.dt

<sqlMapConfig >  

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

     < transactionManager    type ="JDBC" >  

     < dataSource    type ="SIMPLE" >  
         < property    name ="JDBC.Driver"    value ="com.p6spy.engine.spy.P6SpyDriver" />  
         < property    name ="JDBC.ConnectionURL"    value ="jdbc:mysql://localhost/sample" />  
         < property    name ="JDBC.Username"    value ="user" />  
         < property    name ="JDBC.Password"    value ="mypass" />  
         < property    name ="Pool.MaximumActiveConnections"    value ="10" />  
         < property    name ="Pool.MaximumIdleConnections"    value ="5" />  
         < property    name ="Pool.MaximumCheckoutTime"    value ="120000" />  
         < property    name ="Pool.TimeToWait"    value ="500" />  
         < property    name ="Pool.PingQuery"    value ="select 1 from ACCOUNT" />  
         < property    name ="Pool.PingEnabled"    value ="false" />  
         < property    name ="Pool.PingConnectionsOlderThan"    value ="1" />  
         < property    name ="Pool.PingConnectionsNotUsedFor"    value ="1" />  
       </ dataSource >  
     </ transactionManager >  

     < sqlMap    resource ="com/ibatis/sample/User.xml" />  

</ sqlMapConfig >   
  

⑴ Settings 节点

cacheModelsEnabled  
是否启用SqlMapClient上的缓存机制。 建议设为"true"

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

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

lazyLoadingEnabled
是否启用延迟加载机制，建议设为"true"

maxRequests
最大并发请求数（Statement并发数）

maxTransactions  
最大并发事务数

maxSessions    最大Session数。即当前最大允许的并发SqlMapClient数。

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

transactionManager节点
transactionManager节点定义了ibatis的事务管理器，目前提供了以下几种选择：
JDBC
通过传统JDBC Connection.commit/rollback实现事务支持。  
JTA
使用容器提供的JTA服务实现全局事务管理。
EXTERNAL
外部事务管理，如在EJB中使用ibatis，通过EJB的部署配置即可实现自
动的事务管理机制。此时ibatis将把所有事务委托给外部容器进行管理。

dataSource节点
    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）连接数。

JNDI由于大部分配置是在应用服务器中进行，因此ibatis中的配置相对简
分别使用JDBC和JTA事务管理的JDNI配置：
使用JDBC事务管理的JNDI DataSource配置

< transactionManager    type ="JDBC"     >  
< dataSource    type ="JNDI" >  
< property    name ="DataSource"     value ="java:comp/env/jdbc/myDataSource" />  
</ dataSource >  
</ transactionManager >  
< transactionManager    type ="JTA"     >  
< property    name ="UserTransaction"     value ="java:/ctx/con/UserTransaction" />  
< dataSource    type ="JNDI" >  
< property    name ="DataSource"     value ="java:comp/env/jdbc/myDataSource" />  
</ dataSource >   
sqlMap节点
sqlMap节点指定了映射文件的位置，配置中可出现多个sqlMap节点，以指定
项目内所包含的所有映射文件。

ibatis基础语义

XmlSqlMapClientBuilder
XmlSqlMapClientBuilder是ibatis 2.0之后版本新引入的组件，用以替代1.x
版本中的XmlSqlMapBuilder。其作用是根据配置文件创建SqlMapClient实例。

SqlMapClient
SqlMapClient是ibatis的核心组件，提供数据操作的基础平台。SqlMapClient
可通过XmlSqlMapClientBuilder创建:
  

String resource    = " com/ibatis/sample/SqlMapConfig.xml " ;
Reader reader;

reader    =    Resources.getResourceAsReader(resource);

XmlSqlMapClientBuilder xmlBuilder    =   
new    XmlSqlMapClientBuilder();

SqlMapClient sqlMap    =    xmlBuilder.buildSqlMap(reader);  
"com/ibatis/sample/SqlMapConfig.xml"指明了配置文件在CLASSPATH
中的相对路径。XmlSqlMapClientBuilder通过接受一个Reader类型的配置文
件句柄，根据配置参数，创建SqlMapClient实例。

SqlMapClient提供了众多数据操作方法，下面是一些常用方法的示例，具体说明
文档请参见ibatis java doc，或者ibatis官方开发手册。

SqlMapClient基本操作示例

以下示例摘自ibatis官方开发手册，笔者对其进行了重新排版以获得更好的阅读效果。
例1: 数据写入操作(insert, update, delete):

sqlMap.startTransaction();
Product product    =     new    Product();
product.setId ( 1 );
product.setDescription (“Shih Tzu”);
int    rows    =    sqlMap.insert (“insertProduct”, product);
sqlMap.commitTransaction();  
例2: 数据查询 (select)

sqlMap.startTransaction();
Integer key    =     new    Integer ( 1 );
Product product    =    (Product)sqlMap.queryForObject (“getProduct”, key);
sqlMap.commitTransaction();  
例3: 在指定对象中存放查询结果(select)  

sqlMap.startTransaction();
Customer customer    =     new    Customer();
sqlMap.queryForObject(“getCust”, parameterObject, customer);
sqlMap.queryForObject(“getAddr”, parameterObject, customer);
sqlMap.commitTransaction();  
例4: 执行批量查询 (select)

sqlMap.startTransaction();
List list    =    sqlMap.queryForList (“getProductList”,    null )
sqlMap.commitTransaction();  
例5: 关于AutoCommit

// 没有预先执行startTransaction时，默认为auto_commit模式  
int    rows    =    sqlMap.insert (“insertProduct”, product);  
例6:查询指定范围内的数据

sqlMap.startTransaction();
List list    =    sqlMap.queryForList (“getProductList”,    null ,    0 ,    40 );
sqlMap.commitTransaction();  
例7: 结合RowHandler进行查询(select)

    public     class    MyRowHandler    implements    RowHandler     {
      public     void    handleRow (Object object, List list)    throws  
      SQLException     {
        Product product    =    (Product) object;
        product.setQuantity ( 10000 );
        sqlMap.update (“updateProduct”, product);
      }  
}  
sqlMap.startTransaction();
RowHandler rowHandler    =     new    MyRowHandler();
List list    =    sqlMap.queryForList (“getProductList”,    null ,
rowHandler);
sqlMap.commitTransaction();  
  

// 例8: 分页查询 (select)  
PaginatedList list    =  
sqlMap.queryForPaginatedList (“getProductList”,    null ,    10 );
list.nextPage();
list.previousPage();


// 例9: 基于Map的批量查询 (select)  
sqlMap.startTransaction();
Map map    =    sqlMap.queryForMap (“getProductList”,    null , “productCode”);
sqlMap.commitTransaction();
Product p    =    (Product) map.get(“EST - 93 ”);  

////////////////////////////

一、搭建ibatis环境

(1)在ibatis官方网站下载ibatis的jar包。

(2)准备项目中所使用的数据库的JDBC的链接jar包。

(3)将上述两个jar包考到工程中的lib目录下或在工程属性中导入两个jar包。

至此，环境搭建完成。

二、ibatis配置文件(sqlMapping.properties)

(1)JDBC连接配置文件

<1>连接驱动类名(SQL Server 2000为例)

    driver = com.microsoft.sqlserver.jdbc.SQLServerDriver;

<2>连接字符串(Oracle为例)

    url = jdbc:sqlserver://localhost:1433;databaseName=Test;

<3>数据库登陆用户名

    username = sa;

<4>数据库登陆密码

    password = sa

 

(2)ibatis总配置文件(sqlmapconfig.xml)

该文件记录下列信息

<1> JDBC连接配置文件的路径。

<2>数据库的连接信息(连接驱动，连接字符串，用户名，密码)，所有信息都从上面文件properties中读取，键名与上面properties文件中的键名相同。

<3>实体映射。记录每个实体以及对应的数据库表所对应的XML配置文件的路径。

附:

一个ibatis 2配置文件如下：

 <?xml version="1.0" encoding="UTF-8" ?>

 

<!DOCTYPE sqlMapConfig PUBLIC "-//ibatis.apache.org//DTD SQL Map Config 2.0//EN"

"http://ibatis.apache.org/dtd/sql-map-config-2.dtd">

 

<sqlMapConfig>

   <!-- 导入SQL连接配置文件 -->

   <properties resource="com/microserver/data/MSSQLConfig.properties" />

  

   <!--

      SQL Server配置文件

      property属性的value的值从上面文件中读出

    -->

    <transactionManager type="JDBC">

       <dataSource type="SIMPLE">

        <property value="${driver}" name="JDBC.Driver"/>

        <property value="${url}" name="JDBC.ConnectionURL"/>

        <property value="${username}" name="JDBC.Username"/>

        <property value="${password}" name="JDBC.Password"/>

       </dataSource>

    </transactionManager>

  

   <!-- 设置实体映射配置文件路径 -->

   <sqlMap resource="com/microserver/data/pojodata/emp.xml"/>

  

</sqlMapConfig>

 

(3)实体对应XML配置文件

一个实体映射配置文件示例：

<?xml version="1.0" encoding="UTF-8" ?>

 

<!DOCTYPE sqlMap     

    PUBLIC "-//ibatis.apache.org//DTD SQL Map 2.0//EN"     

    "http://ibatis.apache.org/dtd/sql-map-2.dtd">

   

<!-- SQL语句中的#之间的参数必须和PoJo类中属性名称的大小写保持一致 -->  

<sqlMap>

   <!-- 查询所有员工 -->

    <select id="selectAllEmp" resultClass="hashmap">

      SELECT * FROM EMP

    </select>

   

    <!-- 按工号查询员工 -->

    <select id="selectEmpByNo" resultClass="com.microserver.pojo.Emp" parameterClass="string">

      SELECT * FROM EMP WHERE EMPNO = #empnNo#

    </select>

    <!-- 添加新员工 -->

    <insert id="addEmp" parameterClass="com.microserver.pojo.Emp">

      INSERT INTO EMP(EMPNO,ENAME,JOB,MGR,HIREDATE,SAL,COMM,DEPTNO) VALUES(#empNo#,#ename#,#job#,#mgr#,#hiredate#,#sal#,#comm#,#deptno#)

    </insert>

    <!-- 修改员工信息 -->

    <update id="updateEmp" parameterClass="com.microserver.pojo.Emp">

      UPDATE EMP SET ENAME = #ename#,JOB = #job#,MGR = #mgr#,HIREDATE = #hiredate#,SAL = #sal#,COMM = #comm#,DEPTNO = #deptno# WHERE EMPNO = #empNo#

    </update>

    <!-- 删除员工信息 -->

    <delete id="delEmp" parameterClass="string">

      DELETE FROM EMP WHERE EMPNO = #empNo#

    </delete>

</sqlMap>

三、一个基于ibatis框架Web工程的结构截图

 

http://yaotoo.taobao.comhttp://yaotoo.taobao.comhttp://yaotoo.taobao.comhttp://yaotoo.taobao.comhttp://yaotoo.taobao.comhttp://yaotoo.taobao.comhttp://yaotoo.taobao.comhttp://yaotoo.taobao.comhttp://yaotoo.taobao.comhttp://yaotoo.taobao.comhttp://yaotoo.taobao.comhttp://yaotoo.taobao.comhttp://yaotoo.taobao.comhttp://yaotoo.taobao.com