MyBatis源码解析(四)——DataSource数据源模块

原创作品,可以转载,但是请标注出处地址:http://www.cnblogs.com/V1haoge/p/6634880.html

1、回顾

  上一文中解读了MyBatis中的事务模块,其实事务操作无非就是提交和回滚。整个事务模块采用了抽象工厂模式进行设计,将具体的事务实例的生成对使用方隐藏,使用工厂中提供的生产方法来获取。

  事务模块分为两类:JDBC类型和MANAGED类型,前者多用于单独使用MyBatis框架的情况下(比如测试学习MyBatis功能),后者则表示托管于其他框架,比如Spring来完成事务功能。

  这一回我们来看看环境设置中的另一项内容:数据源DataSource。

  (其实应该先解读DataSource,在解读Transaction的,但是...失误啊...)

2、数据源模块

  数据源模块位于org.apache.ibatis.datasource包下,其架构结构为:

org.apache.ibatis.datasource
----org.apache.ibatis.datasource.jndi
--------JndiDataSourceFactory.java
----org.apache.ibatis.datasource.pooled
--------PooledConnection.java
--------PooledDataSource.java
--------PooledDataSourceFactory.java
--------PoolState.java
----org.apache.ibatis.datasource.unpooled
--------UnpooledDataSource.java
--------UnpooledDataSourceFactory.java
----DataSourceException.java
----DataSourceFactory.java

  和事务模块类似,数据源模块同样采用了工厂模式。

2.1 数据源接口

  org.apache.ibatis.datasource包下的DataSourceFactory是数据源工厂接口,至于数据源接口沿用JDK中给出的javax.sql包下的数据源接口DataSource,下面给出JDK中DataSource接口的源码:

1 package javax.sql;
2 import java.sql.Connection;
3 import java.sql.SQLException;
4 import java.sql.Wrapper;
5 public interface DataSource  extends CommonDataSource,Wrapper {
6   Connection getConnection() throws SQLException;
7   Connection getConnection(String username, String password)
8     throws SQLException;
9 }

  从源码中可以看出,在数据源接口中定义了两个获取数据库连接Connection的方法,可见数据源的目的所在,不论其使用什么原理实现,其目的就是为了对外提供数据库连接的获取接口。我们千方百计创建数据源实例,就是为外方通过getConnection()方法来获取数据库连接做基础准备工作。下面看数据源工厂接口源码:

  数据源工厂接口源码:

 1 package org.apache.ibatis.datasource;
 2 import java.util.Properties;
 3 import javax.sql.DataSource;
 4 /**
 5  * 数据源工厂
 6  * 有三种内建的数据源类型 UNPOOLED POOLED JNDI
 7  */
 8 public interface DataSourceFactory {
 9   //设置属性,被XMLConfigBuilder所调用
10   void setProperties(Properties props);
11   //生产数据源,直接得到javax.sql.DataSource
12   DataSource getDataSource();
13 } 

  数据源工厂接口中定义了两个方法,一个是设置属性的方法,与事务模型中的设置属性方法类似,也是需要在构建Configuration配置类时由XMLConfigBuilder来进行调用的,调用的目的是为了将配置文件中配置的数据源属性信息填充到DataSource中(然后在填充到Environment中,在填充到Configuration中,这是后话)。

  这些Properties属性配置正是第二节列举过的Configuration配置文件中的一部分:

1 <dataSource type="POOLED">
2     <property name="driver" value="com.mysql.jdbc.Driver"/>
3     <property name="url" value="jdbc:mysql://localhost:3306/mbtest"/>
4     <property name="username" value="root"/>
5     <property name="password" value="123456"/>
6 </dataSource>

  这一段配置内容中<dataSource>标签表明这是数据源的配置信息,type属性表示这个数据源是POOLED(池型)类型的数据源,然后在其内部设置property子标签用于指定数据源的具体信息:驱动器、数据库URL、用户名、密码四项内容。

  另一个方法是DataSource实例的生产方法,这也是工厂的主要作用:用来生产对应类的实例。

  这里插播一条信息:Connection与DataSource的关系,Connection(连接)是包含在DataSource(数据源)之内的,我们可以通过DataSource来得到其中的Connection,反之不可能,所以我们需要先创建DataSource实例,以此来获取Connection数据库连接,所有DataSource是基础,Connection是目的。

2.2 Mybatis数据源类型

  MyBatis为我们提供了三种具体的数据源类型:

    unpooled:非池型数据源

    pooled:池型数据源

    jndi:托管型

  MyBatis提供的三种数据源类型各有作用,其中非池型数据源是作为基础存在的,一般也不会直接使用,常用的是池型数据源,而池型数据源是以非池型数据源为基础的,第三种托管型数据源的意思就是采用外部的数据源。

  有关这三种数据源的源码解析详见下一文。

  

原文地址:https://www.cnblogs.com/V1haoge/p/6634880.html