ibatis配置祥解

ibatis基础代码包括： 1．     ibatis实例配置 一个典型的配置文件如下（具体配置项目的含义见后）： <? xml version="1.0" encoding="UTF-8"     ?>  <! DOCTYPE sqlMapConfig        PUBLIC "-//iBATIS.com//DTD SQL Map 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 ”);