标签：
ibatis的包组成中从历史版本中我们能看到他是有：ibatis-dao.jar,ibatis-common.jar,ibatis-sqlmap.jar三个包组成，所以学习源码之前，我们先澄清一些东西，同时让大家弄清楚什么时候该引入什么包，一般情况下如果你的项目只是用到了ibatis，没有其他容器使用，那么你可以考虑使用ibatis-dao+ibatis-common+ibatis-sqlmap，如果你使用了spring做为容器，那么其实你将不需要引入ibatis-dao，同时有时候我们也会发现有ibatis-core的包，这个是在ibatis的2.2以后将ibatis-common.jar和ibatis-sqlmap.jar二合一之后的结果，所以看到ibatis-core之后基本就不需要引入common和sqlmap这两个包了，如果你引入了ibatis-dao.jar那么ibatis-core是必须引入的。
这里就需要弄明白为什么会有ibatis-dao.jar,为什么2.3.x的版本中不在引入。这都要从ibatis-dao.jar的功能及设计初衷谈起。
首先DAO是J2EE的一种设计模式即DAO设计模式，ibatis-dao.jar的存在是更面向应用层的，SQL Map组件相对要更底层一些，靠近数据源层，DAO组件可以通过调用SQL Map组件来实现业务处理，ibatis提供的DAO层不但可以继承Ibatis的SQLMap组件想成一个一个一体的解决方案，同时还可以融入其他多种ORM组件，如Hibernate、Apache Ojb、TopLink、甚至包括JDBC、JTA。
在我们检出的jpetstore项目中我们会看到一个类DaoConfig
1 public class DaoConfig {
2
3 private static final String resource = "com/ibatis/jpetstore/persistence/dao.xml";
4 private static final DaoManager daoManager;
5
6 static {
7 try {
8 daoManager = newDaoManager(null);
9 Properties props = Resources.getResourceAsProperties("properties/database.properties");
10 String url = props.getProperty("url");
11 String driver = props.getProperty("driver");
12 String username = props.getProperty("username");
13 String password = props.getProperty("password");
14 if (url.equals("jdbc:hsqldb:mem:jpetstore")) {
15 Class.forName(driver).newInstance();
16 Connection conn = DriverManager.getConnection(url, username, password);
17 try {
18 ScriptRunner runner = new ScriptRunner(conn, false, false);
19 runner.setErrorLogWriter(null);
20 runner.setLogWriter(null);
21 runner.runScript(Resources.getResourceAsReader("ddl/hsql/jpetstore-hsqldb-schema.sql"));
22 runner.runScript(Resources.getResourceAsReader("ddl/hsql/jpetstore-hsqldb-dataload.sql"));
23 } finally {
24 conn.close();
25 }
26 }
27 } catch (Exception e) {
28 throw new RuntimeException("Description. Cause: " + e, e);
29 }
30
31 }
32
33 public static DaoManager getDaoManager() {
34 return daoManager;
35 }
36
37 public static DaoManager newDaoManager(Properties props) {
38 try {
39 Reader reader = Resources.getResourceAsReader(resource);
40 return DaoManagerBuilder.buildDaoManager(reader, props);
41 } catch (Exception e) {
42 throw new RuntimeException("Could not initialize DaoConfig. Cause: " + e, e);
43 }
44 }
45
46 }
其中
1 public static DaoManager newDaoManager(Properties props) {
2 try {
3 Reader reader = Resources.getResourceAsReader(resource);
4 return DaoManagerBuilder.buildDaoManager(reader, props);
5 } catch (Exception e) {
6 throw new RuntimeException("Could not initialize DaoConfig. Cause: " + e, e);
7 }
8 }
上面的代码加载了一个resource，这个resource正是一个名字叫dao.xml的文件
文件内容大致如下：
1 <?xml version="1.0" encoding="UTF-8"?>
2
3 <!DOCTYPE daoConfig
4 PUBLIC "-//ibatis.apache.org//DTD DAO Configuration 2.0//EN"
5 "http://ibatis.apache.org/dtd/dao-2.dtd">
6
7 <daoConfig>
8
9 <context>
10
11 <transactionManager type="SQLMAP">
12 <property name="SqlMapConfigResource"
13 value="com/ibatis/jpetstore/persistence/sqlmapdao/sql/sql-map-config.xml"/>
14 </transactionManager>
15
16 <dao interface="com.ibatis.jpetstore.persistence.iface.ItemDao"
17 implementation="com.ibatis.jpetstore.persistence.sqlmapdao.ItemSqlMapDao"/>
18
19 <dao interface="com.ibatis.jpetstore.persistence.iface.SequenceDao"
20 implementation="com.ibatis.jpetstore.persistence.sqlmapdao.SequenceSqlMapDao"/>
21
22 <dao interface="com.ibatis.jpetstore.persistence.iface.AccountDao"
23 implementation="com.ibatis.jpetstore.persistence.sqlmapdao.AccountSqlMapDao"/>
24
25 <dao interface="com.ibatis.jpetstore.persistence.iface.CategoryDao"
26 implementation="com.ibatis.jpetstore.persistence.sqlmapdao.CategorySqlMapDao"/>
27
28 <dao interface="com.ibatis.jpetstore.persistence.iface.ProductDao"
29 implementation="com.ibatis.jpetstore.persistence.sqlmapdao.ProductSqlMapDao"/>
30
31 <dao interface="com.ibatis.jpetstore.persistence.iface.OrderDao"
32 implementation="com.ibatis.jpetstore.persistence.sqlmapdao.OrderSqlMapDao"/>
33
34 </context>
35
36 </daoConfig>
这个文件就是ibatis-dao.jar的入口文件，也是核心文件，后续的所有操作将依照这个文件进行。在此向置于文件头，后续会多次用到
在ibatis-dao.jar包中我们可以看到他有两个子包组成分别为：client、engine.共计34个类
1.client主要作为对外的接口部分。
2.engine主要是其内部实现。
client中包含：5个类（或接口）一个子包（包含6个类/接口）
Dao类：该类是一个接口，只是一个表示接口，没有任何约束，主要用来表述所有实现该接口的类都是操作数据的类，ibatis DAO中的所有业务dao类都要事先client中的Dao接口
DaoException类：该类继承RuntimeException类，用来统一异常输出
DaoManager类：核心接口，用来定义所有管理ibatis的dao对象实现必须遵守的规则，包括获取dao实现类，获取事务，以及事务的打开、提交、关闭
DaoManagerBuilder类：该类用来创建DaoManager类，但其本身不做处理，通过传入配置文件生成DaoManager，具体实现还是需要调用engine包下的XmlDaoManagerBuilder，XmlDaoManagerBuilder功能就是将dao.xml文件实例化成client中的的各个实例对象，是DaoManager类的工厂类。
DaoTransaction类：统一的事务操作接口
client包下还有一个template包，该包中的类都是根据模版原则，定义了不同orm的DAO操作规范
DaoTemplate，一个实现了Dao的抽象类
HibernateDaoTemplate.java ：针对Hibernate定义的Dao模板类
JdbcDaoTemplate.java：JDBC定义的Dao的简单封装
OjbBrokerDaoTemplate.java
SqlMapDaoTemplate.java
ToplinkDaoTemplate.java
engine下的文件包含三部分：build ，负责通过解析dao.xml（可以为别的名字，跟DaoManager最终加载的文件名同名即可）文件生成client中的实例对象；impl组件，为build组件提供支持，用来将build中解析的字符串封装成impl中的实例，impl是client的具体实现。transaction负责集中ORM的事务管理。
首先介绍build，build中包含两个类：
DaoClasspathEntityResolver.java：实现了org.xml.sax.EntityResolver，作为自定义的xml解析器，负责从ClassPath中加载DTD文件，同时将其作为流输出，后续再解析dao.xml中需要。
XmlDaoManagerBuilder.java：该类主要用来解析dao.xml生成impl中的对象，也是ibatis-dao.xml的核心类
下面介绍 impl部分：
impl部分主要包含：
DaoContext.java ：这个类是用来封装上面dao.xml中的context节点的实现类
DaoImpl.java:这个类是用来封装context节点下的所有dao节点的实现类
DaoProxy.java:负责创建Dao接口的代理对象。
DaoTransactionState.java:事务的状态信息，内部实现采用自关联
StandardDaoManager.java:ibatis-dao的管理类。idContextMap属性用来按照context的id存放所有的context实例，typeContextMap用来存放key为daoimpl的实现类接口，value为dao归属的context的实现类；daoImplMap包含两种key-value组合：key：负责存放有daoImpl的代理类，value：daoimpl，key：dao实现类的实例；
所有的操作都起始于DaoManagerBuilder的buildDaoManager的方法，最终调用new XmlDaoManagerBuilder().buildDaoManager(reader, props);加载dao.xml并解析，获取到创建imp下的所有实例并组装，在ibatis-dao中所有数据库操作都是源于transaction，其中包含6中事务类型，根据自己的实际需要使用，这个也决定了最终你的配置文件中<transactionManager type="JDBC">这个节点的type属性是什么目前ibatis-dao支持的类型有：见XmlDaoManagerBuilder类构造函数
1 public XmlDaoManagerBuilder() {
2 typeAliases.put("EXTERNAL", ExternalDaoTransactionManager.class.getName());
3 typeAliases.put("HIBERNATE", HibernateDaoTransactionManager.class.getName());
4 typeAliases.put("JDBC", JdbcDaoTransactionManager.class.getName());
5 typeAliases.put("JTA", JtaDaoTransactionManager.class.getName());
6 typeAliases.put("OJB", "com.ibatis.dao.engine.transaction.ojb.OjbBrokerTransactionManager");
7 typeAliases.put("SQLMAP", SqlMapDaoTransactionManager.class.getName());
8 typeAliases.put("TOPLINK", "com.ibatis.dao.engine.transaction.toplink.ToplinkDaoTransactionManager");
9 }
所以也就出现了上边dao.xml文件中的SQLMAP，这个最终是在该构造函数中匹配到了SqlMapDaoTransactionManager.class.getName()该类，所以如果你定义了这里没有的，那么可能就需你使用全限定名了
同时ibatis-dao中用到了很多ibatis-common.jar中的工具类，如Resource，这个是主要是获取文件转换为inputStream或者转为Reader，加载类，实例化类，ClassInfo，ibatis中很强大的一个类，后边在介绍common包的时候会单独介绍。
至此dao包就基本讲完了，没有大篇幅的介绍代码主要是我比较懒，同时内容太多容易让人生烦，而且也容易跑题，所以就不一一介绍了，但是34个类的功能基本清楚了，具体的实现进一步去看问题应该就不大了。之所以将这个包主要出于一下目的：
1.平时我们经常看到很多人用spring直接使用了sqlmapclient，却还要去加载dao包，这就是没有弄明白dao包的作用。
2.从dao的实现我们略微可以收获一下结论，简单容器的实现，如context的实现，该包后续没有发展，估计也有一部分原因是因为spring的强大（我意淫的），使作者放弃了继续搞的打算，不过我还是觉得对于业务调用来说，早期的dao还是很方便了，即便你有多个数据源，只需要配置多个context便可以了，对于业务调用他只要从DaoManager中get就好了，不用管底层到底调用了那个数据源，这一点我觉得还是很有必要的。
3.dao的包装类，daoimpl很有想法，通过代理来操作事务，隐藏了很多操作，简化了开发
4.xml文档的解析可以看看XmlDaoManagerBuilder这个类，虽然代码比较多，不过结构很清晰，而且从第一行看到最后一行也绝对不会混乱，因为代码就是从上到下实现的。
这里我们整理一下两个过程
1.文件解析及其加载的过程：
一、客户端调用XmlDaoManagerBuilderde.buildDaoManager方法
二、XmlDaoManagerBuilder对象创建一个StandardDaoManager对象
三、读取配置文件中的daoConfig节点下的context个数，XmlDaoManagerBuilder对象循环创建1个或者多个DaoContext对象
四、根据配置文件中的context节点下transactionManager的个数，XmlDaoManagerBuilder对象创建TransactionManager对象
五、把Transaction对象赋值给DaoContext对象，由于DaoContext对象只有一个Transaction属性，所以如果配置文件配置多个TransactionManager最后只能是最后一个有效
六、根据context节点下DAO的个数XmlDaoManagerBuilder对象实例化多个DaoImpl对象
七、每个DaoImpl实例化对象根据获得的dao节点中的implementation属性采用constructor.newInstance方法动态实例化dao的的实现类赋值给daoImpl.setDaoInstance(dao);
八、调用daoImpl的// 生成dao的代理 daoImpl.initProxy();赋值给impl的proxy属性最终作为DaoManager的get参数被使用，从而保证调用到的是代理后的daoimpl，可以达到隐藏调用transaction的效果
九、将所有的daoImpl加入到DaoContext的Map中
十、将所有的DaoContext遍历加入到StandardDaoManager对象的Map变量中，同时将所有的DaoImpl放入到StandardDaoManager的Map属性中，具体参加文章上部分标红内容
十一、XmlDaoManagerBuilder返回获取到的StandardDaoManager对象。
2.Dao的调用过程：
一、客户端调用某个实现了Dao的类
二、通过DaoManager获取到的是DaoImpl的代理类，所以调用其invoke方法
三、DaoProxy对象的invoke方法执行过程通过DaoImpl获取StandardDaoManager对象
四、判断是否启用了transaction，执行五、六、七，跳过后续，否则执行以下所有
五、如果启用了，则获取DaoImpl的DaoContext对象
六、通过DaoContext开启事务：context.startTransaction();
七、执行Impl中的方法，method.invoke(daoImpl.getDaoInstance(), args);
八、context.commitTransaction();
九、context.endTransaction();
关于xml文件的解析分为两种
SAX基于事件流的解析
DOM基于XML文档树结构的解析
在对dao.xml的解析中，采用了二者结合的方式。对于dao.xml的格式是否正确，这里采用的是DTD文件，它包括一些常用的xml语法规则，如：XML文档必须有根元素、XML文档必须关闭等等。这些校验规则需要通过SAX的EnityResolver接口的实现类来处理的，比如本包中的DaoClasspathEntityResolver。
转自：http://tzwzero-163-com.iteye.com/blog/1715024
iBATIS源码分析
标签：
原文地址：http://www.cnblogs.com/shaoke123/p/4846389.html
