IBatis-学习-1

IBatis

概述

1、全自动的ORM关注的是POJO与数据表之间的映射，而IBatis关注的是POJO与SQL语句之间的映射。

2、IBatis以SQL开发的工作量和数据库移植性上的让步，为系统设计提供了更大的自由空间。

经典配置文件案例

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

<!DOCTYPE sqlMapConfig

PUBLIC "-//iBATIS.com//DTD SQL Map Config 2.0//EN"

"http://www.ibatis.com/dtd/sql-map-config-2.dtd">

<sqlMapConfig>

----------------<settings

----------------------cacheModelsEnabled="true"

----------------------enhancementEnabled="true"

----------------------lazyLoadingEnabled="true"

----------------------errorTracingEnabled="true"

----------------------maxRequests="32"

----------------------maxSessions="10"

----------------------maxTransactions="5"

----------------------useStatementNamespaces="false"/>

----------------<transactionManagertype="JDBC">

----------------------<dataSourcetype="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>

----------------------<sqlMapresource="com/ibatis/sample/User.xml"/>

</sqlMapConfig>

public class User implements Serializable {

private Integer id;

private String name;

private Integer sex;

private Set addresses = new HashSet();

/** default constructor */

public User() {}

public Integer getId() {

return this.id;

}

public voidsetId(Integer id) {

this.id = id;

}

publicString getName() {

return this.name;

}

public voidsetName(String name) {

this.name = name;

}

publicInteger getSex() {

return this.sex;

}

public voidsetSex(Integer sex) {

this.sex = sex;

}

}

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

<!DOCTYPE sqlMap

PUBLIC "-//iBATIS.com//DTD SQL Map 2.0//EN"

"http://www.ibatis.com/dtd/sql-map-2.dtd">

<sqlMap namespace="User">

---------------<typeAlias           alias="user"                type="com.ibatis.sample.User"/>

--------------<select   id="getUser"               parameterClass="java.lang.String"                    resultClass="user">

-----------------------<![CDATA[select  name,sex  from t_user  where name = #name#  ]]>

--------------</select>

--------------<update   id="updateUser"               parameterClass="user">

-------------------------<![CDATA[  UPDATE t_user   SET  name=#name#,  sex=#sex#  WHERE id = #id#  ]]>

--------------</update>

--------------<insert   id="insertUser"                  parameterClass="user">

---------------------------INSERT INTO t_user (  name,  sex) VALUES ( #name#, #sex# )

-----------------</insert>

---------------<deleteid="deleteUser"                    parameterClass="java.lang.String">

---------------------------delete from t_user  where id = #value#

----------------</delete>

</sqlMap>

经典配置说明

 

 

1、Id：指定了操作ID，之后我们可以在代码中通过指定操作id 来执行此节点所定义的操作，如：sqlMap.update("updateUser",user);ID设定使得在一个配置文件中定义两个同名节点成为可能（两个update节点，以不同id区分）。

2、parameterClass：指 定 了操作所需的参数类型， 此例中update 操作以com.ibatis.sample.User 类型的对象作为参数，目标是将提供的User实例更新到数据库。

parameterClass="user"中，user为“com.ibatis.sample.User”类的别名，别名可通过typeAlias节点指定，如示例配置文件中的：<typeAlias alias="user" type="com.ibatis.sample.User"/>

3、<![CDATA[……]]>通过<![CDATA[……]]>节点，可以避免SQL 中与XML 规范相冲突的字符对XML映射文件的合法性造成影响。

4、执行更新操作的SQL，这里的SQL 即实际数据库支持的SQL 语句，将由ibatis填入参数后交给数据库执行。

5、SQL中所需的用户名参数，“#name#”在运行期会由传入的user对象的name属性填充。

6、SQL 中所需的用户性别参数“#sex#”，将在运行期由传入的user 对象的sex属性填充。

7、SQL中所需的条件参数“#id#”，将在运行期由传入的user对象的id属性填充。

 

对于这个示例，ibatis在运行期会读取id 为“updateUser”的update节点的SQL定义，并调用指定的user对象的对应getter方法获取属性值，并用此属性值，对SQL中的参数进行填充后提交数据库执行。

配置详解

 

settings节点
cacheModelEnabled	是否启用SqlMapClient上的缓存机制。建议设为"true"
enhancementEnabled	是否针对POJO启用字节码增强机制以提升 getter/setter的调用效能，避免使用Java Reflect所带来的性能开销。同时，这也为Lazy Loading带来了极大的性能提升。建议设为"true"
errorTracingEnabled	是否启用错误日志，在开发期间建议设为"true"以方便调试
lazyLoadingEnabled	是否启用延迟加载机制，建议设为"true"
maxRequests	最大并发请求数（Statement并发数）
maxTransactions	最大并发事务数
maxSessions	最大Session 数。即当前最大允许的并发 SqlMapClient数。maxSessions设定必须介于maxTransactions和maxRequests之间，即maxTransactions<maxSessions=< maxRequests
useStatementNamespaces	是否使用Statement命名空间。 这里的命名空间指的是映射文件中，sqlMap节点的namespace属性，如在上例中针对t_user表的映射文件sqlMap节点： <sqlMapnamespace="User"> 这里，指定了此sqlMap节点下定义的操作均从属于"User"命名空间。在useStatementNamespaces="true"的情 况下，Statement调用需追加命名空间，如：sqlMap.update("User.updateUser",user); 否则直接通过Statement名称调用即可，如： sqlMap.update("updateUser",user); 但请注意此时需要保证所有映射文件中，Statement定义无重名。
transactionManager节点 该节点定义了ibatis的事物管理器
Type=”JDBC”	通过传统JDBC Connection.commit/rollback实现事务支持。
Type=”JTA”	使用容器提供的JTA服务实现全局事务管理。
Type=”EXTERNAL”	外部事务管理，如在EJB中使用ibatis，通过EJB的部署配置即可实现自动的事务管理机制。此时ibatis 将把所有事务委托给外部容器进行管理。此外，通过Spring 等轻量级容器实现事务的配置化管理也是一个不错的选择。
dataSource节点
type	指定dataSource的实现类型， 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。
JDBC.Driver	JDBC 驱动。
JDBC.ConnectionURL	数据库URL。如果用的是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