iBATIS配置文件详细说明
ibatis学习笔记(一)>>>>>>>sqlMapConfig.xml文件详解
1.sqlMapConfig.xml配置文件详解：
Xml代码
1. xml version="1.0" encoding="UTF-8" ?>
2.
3. PUBLIC "-//iBATIS.com//DTD SQL Map Config 2.0//EN"
4. "http://www.ibatis.com/dtd/sql-map-config-2.dtd" >
5. < sqlMapConfig >
6. < settings
7. cacheModelsEnabled ="true"
9. enhancementEnabled="true"
10. errorTracingEnabled="true"
11. maxRequests="32"
12. maxSessions="10"
13. maxTransactions="5"
14. useStatementNamespaces="true"/>
15. < transactionManager type ="JDBC" >
16. < dataSource type ="SIMPLE" >
17. < property name ="JDBC.Driver" value ="com.mysql.jdbc.Driver" />
18. < property name ="JDBC.ConnectionURL" value ="jdbc:mysql://localhost/test" />
19. < property name ="JDBC.Username" value ="root" />
20. < property name ="JDBC.Password" value ="wyq" />
21. < property name ="Pool.MaximumActiveConnections" value ="10" />
22. < property name ="Pool.MaximumIdleConnections" value ="5" />
23. < property name ="Pool.MaximumCheckoutTime" value ="120000" />
24. < property name ="TimeToWait" value ="500" />
25.
26. dataSource >
27. transactionManager >
28. < sqlMap resource ="com/wyq/map/userMap.xml" />
29. sqlMapConfig >
< sqlMapConfig > < settings cacheModelsEnabled ="true" enhancementEnabled="true" errorTracingEnabled="true" maxRequests="32" maxSessions="10" maxTransactions="5" useStatementNamespaces="true"/> < transactionManager type ="JDBC" > < dataSource type ="SIMPLE" > < property name ="JDBC.Driver" value ="com.mysql.jdbc.Driver" /> < property name ="JDBC.ConnectionURL" value ="jdbc:mysql://localhost/test" /> < property name ="JDBC.Username" value ="root" /> < property name ="JDBC.Password" value ="wyq" /> < property name ="Pool.MaximumActiveConnections" value ="10" /> < property name ="Pool.MaximumIdleConnections" value ="5" /> < property name ="Pool.MaximumCheckoutTime" value ="120000" /> < property name ="TimeToWait" value ="500" /> < sqlMap resource ="com/wyq/map/userMap.xml" />
一 transactionManager节点
transactionManagerab 定义了ibatis的事务管理器,目前提供了以下几种选择:
1) JDBC
通过传统JDBC Connection.commit/rollback实现事务支持.
2) JTA
使用容器提供的JTA服务实现全局事务管理.
3) EXTERNAL
外部事务管理,如在EJB中使用ibatis,通过EJB的部署配置即可实现自动的事务管理机制.此时ibatis将把所有事务委托给外部容器进行管理.此外,通过Spring等轻量级容量实现事务的配置化管理也是一个不错的选择.
二 dataSource 节点
dataSource 从属于 transactionManager, 用于设定ibatis运行期使用DataSource属性.
type 属性: dataSource 元素的 type 属性指定了 dataSource 的实现类型.可选项目:
1) SIMPLE:
SIMPLE 是 ibatis 内置的 dataSource 实现,其中实现了一个简单的数据库连接池机制,对应 ibatis 实现类为
com.ibatis.sqlmap.engine.datasource.SimpleDataSourceFactory.
JDBC 使用数据库自己的事务（局部事务），connect.beginTranstion(), connect.commit()等.
2) DBCP
基于Apache DBCP连接池组件实现的DataSource封装,当无容器提供DataSource服务时,建议使用该选项,对应ibatis实现类为
com.ibatis.sqlmap.engine.datasource.DbcpDataSourceFactory.
JTA ：使用jta 事务管理器管理事务（全局事务），使用userTranstion对象.
3) JNDI
使用J2EE容器提供的DataSource实现, DataSource将通过指定的JNDI Name从容器中获取.对应ibatis实现类为
com.ibatis.sqlmap.engine.datasource.JndiDataSourceFactory.
Ibatis 不控制事务，事务交由外部控制，一般在CTM,或spring托管事务中使用.
JNDI的配置大部分都在应用服务器中进行，所以在ibatis中的配置相对简单
(1)jdbc事务控制的JNDI配置
Xml代码
1. < transctionManager type ="JDBC" >
2. < dataSource type ="JNDI" >
3. < property name ="DataSource" value ="java:comp/env/jdbc/myDataSource" />
4. dataSource >
5. transctionManager >
< transctionManager type ="JDBC" > < dataSource type ="JNDI" > < property name ="DataSource" value ="java:comp/env/jdbc/myDataSource" />
(2)JTA事务控制的JNDI配置
Xml代码
1. < transctionManager type ="JTA" >
2. < property name ="UserTransaction" value ="java:/ctx/con/UserTransaction" />
3. < dataSource type ="JNDI" >
4. < property name ="DataSource" value ="java:comp/env/jdbc/myDataSource" />
5. dataSource >
6. transctionManager >
< transctionManager type ="JTA" > < property name ="UserTransaction" value ="java:/ctx/con/UserTransaction" /> < dataSource type ="JNDI" > < property name ="DataSource" value ="java:comp/env/jdbc/myDataSource" />
sqmMap节点指定了映射文件的位置，配置文件中可以定义多个sqlMap元素,以指定项目内所包含的所有映射文件.
ibatis学习笔记(二)>>>>>>>sqlMapConfig.xml文件详解
ibatis基础代码包括：
1． ibatis实例配置
一个典型的配置文件如下（具体配置项目的含义见后）：
PUBLIC "-//iBATIS.com//DTD SQL Map Config 2.0/
"[url]http://www.ibatis.com/dtd/[/url]sql-map-config-2.dt
< 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" />
< sqlMap resource ="com/ibatis/sample/User.xml" />
⑴ 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节点：
否则直接通过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" />
< transactionManager type ="JTA" >
< property name ="UserTransaction" value ="java:/ctx/con/UserTransaction" />
< dataSource type ="JNDI" >
< property name ="DataSource" value ="java:comp/env/jdbc/myDataSource" />
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学习笔记(三)>>>>>>>java实体跟表映射.xml文件详解
分类： ibatis 2011-03-25 10:46131人阅读评论(0) 收藏 举报
在项目中使用Ibatis难免会使用到java实体跟表映射.xml.
http://ibatis.apache.org/dtd/sql-map-2.dtd" >
(
$oredCriteria[].criteriaWithoutValue[]$
$oredCriteria[].criteriaWithSingleValue[].condition$
#oredCriteria[].criteriaWithSingleValue[].value#
$oredCriteria[].criteriaWithListValue[].condition$
#oredCriteria[].criteriaWithListValue[].values[]#
$oredCriteria[].criteriaWithBetweenValue[].condition$
#oredCriteria[].criteriaWithBetweenValue[].values[0]# and
#oredCriteria[].criteriaWithBetweenValue[].values[1]#
)
{? = call alarm.getSingleDetailRows(?)}
java实体跟数据库表的映射到此结束了。
ibatis学习笔记(四)>>>>>>>ibatis使用实例
分类： Java相关 2011-03-25 14:0536人阅读评论(0) 收藏 举报
Ibatis是apache基金会的一个开源项目，Ibatis实现了java实体类与Sql语句的映射，是对JDBC的轻量级的封装，与Hibernate不同的是，Ibatis允许开发人员自己编写高效的Sql语句，而不是用框架自动生成Sql语句，提高了Sql语句的执行效率。下面就给出一个ibatis使用实例。
1.去ibatis官网下载ibatis的相关包。 http://ibatis.apache.org/. 最后把ibatis.jar包导入到项目的中(假定我们这次实例的数据库是mysql。)。
2.项目相关配置文件database-config.properties(数据库配置属性文件)、SqlConfig.xml（ibatis配置文件）、 TEACHER_SqlMap.xml（java实体和数据库sql配置文件）
database-config.properties文件内容
1. java.mysql.server=127.0.0.1
2. java.mysql.port=3306
3. java.mysql.url=jdbc/:mysql/://${java.mysql.server}/:${java.mysql.port}/${java.mysql.database}
4. java.mysql.database=school
5. java.mysql.username=root
6. java.mysql.password=root
7. java.mysql.driver=com.mysql.jdbc.Driver
java.mysql.server=127.0.0.1java.mysql.port=3306java.mysql.url=jdbc/:mysql/://${java.mysql.server}/:${java.mysql.port}/${java.mysql.database}java.mysql.database=schooljava.mysql.username=rootjava.mysql.password=rootjava.mysql.driver=com.mysql.jdbc.Driver
TEACHER_SqlMap.xml文件内容
1. "1.0" encoding="UTF-8" ?>
2. "-//ibatis.apache.org//DTD SQL Map 2.0//EN" "http://ibatis.apache.org/dtd/sql-map-2.dtd" >
3.
4.
5.
6.
7.
8.
9.
10.
11. select * from teacher
12.
13.
SqlConfig.xml文件内容
1. "1.0" encoding="UTF-8" ?>
2. "-//iBATIS.com//DTD SQL Map Config 2.0//EN" "http://www.ibatis.com/dtd/sql-map-config-2.dtd" >
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
3.TeacherDAO.java(接口文件)、TeacherDAOImpl接口实现文件。
TeacherDAO.java文件内容
1. package com.yjpeng.ibatis.dao;
2.
3. import java.util.List;
4.
5. import com.yjpeng.ibatis.model.Teacher;
6.
7. public interface TeacherDAO {
8. List
9. }
package com.yjpeng.ibatis.dao;import java.util.List;import com.yjpeng.ibatis.model.Teacher;public interface TeacherDAO { List
TeacherDAOImpl.java文件内容
1. package com.yjpeng.ibatis.dao;
2.
3.
4. import java.io.Reader;
5. import java.sql.SQLException;
6. import java.util.List;
7.
8. import com.ibatis.common.resources.Resources;
9. import com.ibatis.sqlmap.client.SqlMapClient;
10. import com.ibatis.sqlmap.client.SqlMapClientBuilder;
11. import com.yjpeng.ibatis.model.Teacher;
12.
13. public class TeacherDAOImpl implements TeacherDAO {
14. private SqlMapClient sqlmap = null;
15.
16. public TeacherDAOImpl(SqlMapClient sqlmap){
17. this.sqlmap = sqlmap;
18. }
19. public List
20. List
21. try {
22. list = sqlmap.queryForList("teacher_getTeacherList", null);
23. return list;
24. } catch (SQLException e) {
25. e.printStackTrace();
26. }
27. return null;
28. }
29.
30. public static void main(String[] args) {
31. Reader reader = null;
32. try{
33. reader = Resources.getResourceAsReader("etc/SqlConfig.xml");
34. SqlMapClient sqlmap = SqlMapClientBuilder.buildSqlMapClient(reader);
35. TeacherDAO teacherDAO = new TeacherDAOImpl(sqlmap);
36. List
37. System.out.println(list.size());
38. }catch (Exception e) {
39. e.printStackTrace();
40. }
41. }
42. }
package com.yjpeng.ibatis.dao;import java.io.Reader;import java.sql.SQLException;import java.util.List;import com.ibatis.common.resources.Resources;import com.ibatis.sqlmap.client.SqlMapClient;import com.ibatis.sqlmap.client.SqlMapClientBuilder;import com.yjpeng.ibatis.model.Teacher;public class TeacherDAOImpl implements TeacherDAO { private SqlMapClient sqlmap = null; public TeacherDAOImpl(SqlMapClient sqlmap){ this.sqlmap = sqlmap; } public List
好了，一个简单的ibatis实例，已经讲解完了。由于是例子所以写的比较简单请见谅。