Spring dataSource

1.何为dataSource

DataSource 接口是 JDBC 2.0 API 中的新增内容，它提供了连接到数据源的另一种方法。 
作为 DriverManager 工具的替代项，DataSource 对象是获取连接的首选方法。 
实现 DataSource 接口的对象通常在基于JNDI API 的命名服务中注册。

不管通过何种持久化技术，都必须通过数据连接访问数据库，在传统的应用中数据连接可以通过DriverManager获的， 
在Spring中，数据连接一般是通过数据源获得的。在以往的应用中，数据源一般是 Web应用服务器提供的。 
在Spring中，你不但可以通过JNDI获取应用服务器的数据源，也可以直接在Spring容器中配置数据源， 
此外，你还可以 通过代码的方式创建一个数据源，以便进行无依赖的单元测试。

DataSource API定义：

 package javax.sql;

 import java.sql.Connection;
 import java.sql.SQLException;
 import java.sql.Wrapper;

 public interface DataSource  extends CommonDataSource,Wrapper {

   Connection getConnection() throws SQLException;

   Connection getConnection(String username, String password)
     throws SQLException;
 }

2.在Spring中配置Datasource

Spring本身也提供了一个简单的数据源实现类DriverManagerDataSource ， 
它位于org.springframework.jdbc.datasource包中。这个类实现了javax.sql.DataSource接口， 
但它并没有提供池化连接的机制，每次调用getConnection()获取新连接时，只是简单地创建一个新的连接。 
因此，这个数据源类比较适合在单元测试 或简单的独立应用中使用，因为它不需要额外的依赖类。

 <!-- 配置Spring DriverManagerDatasource数据源从中获取connection，引入数据库驱动 -->
     <bean
         class="org.springframework.beans.factory.config.PropertyPlaceholderConfigurer">
         <property name="locations">
             <value>classpath:jdbc.properties</value>
         </property>
     </bean>

     <bean id="dataSource" destroy-method="close"
         class="org.springframework.jdbc.datasource.DriverManagerDataSource">
         <property name="driverClassName" value="${jdbc.driverClassName}" />
         <property name="url" value="${jdbc.url}" />
         <property name="username" value="${jdbc.username}" />
         <property name="password" value="${jdbc.password}" />
     </bean

 package org.springframework.jdbc.datasource;

 import java.sql.Connection;
 import java.sql.DriverManager;
 import java.sql.SQLException;
 import java.util.Properties;

 import org.springframework.util.Assert;
 import org.springframework.util.ClassUtils;

 public class DriverManagerDataSource extends AbstractDriverBasedDataSource {

     public DriverManagerDataSource() {
     }

     public DriverManagerDataSource(String url) {
         setUrl(url);
     }

     public DriverManagerDataSource(String url, String username, String password) {
         setUrl(url);
         setUsername(username);
         setPassword(password);
     }

     public DriverManagerDataSource(String url, Properties conProps) {
         setUrl(url);
         setConnectionProperties(conProps);
     }

     public DriverManagerDataSource(String driverClassName, String url, String username, String password) {
         setDriverClassName(driverClassName);
         setUrl(url);
         setUsername(username);
         setPassword(password);
     }

     public void setDriverClassName(String driverClassName) {
         Assert.hasText(driverClassName, "Property 'driverClassName' must not be empty");
         String driverClassNameToUse = driverClassName.trim();
         try {
             Class.forName(driverClassNameToUse, true, ClassUtils.getDefaultClassLoader());
         }
         catch (ClassNotFoundException ex) {
             IllegalStateException ise =
                     new IllegalStateException("Could not load JDBC driver class [" + driverClassNameToUse + "]");
             ise.initCause(ex);
             throw ise;
         }
         if (logger.isInfoEnabled()) {
             logger.info("Loaded JDBC driver: " + driverClassNameToUse);
         }
     }

     protected Connection getConnectionFromDriver(Properties props) throws SQLException {
         String url = getUrl();
         if (logger.isDebugEnabled()) {
             logger.debug("Creating new JDBC DriverManager Connection to [" + url + "]");
         }
         return getConnectionFromDriverManager(url, props);
     }

     protected Connection getConnectionFromDriverManager(String url, Properties props) throws SQLException {
         return DriverManager.getConnection(url, props);
     }

 }

DriverManagerDataSource建立连接是只要有连接就新建一个connection,根本没有连接池的作用。

Spring在第三方依赖包中包含了两个数据源的实现类

包，其一是Apache的DBCP，其二是 C3P0。

2.1 Apache DBCP

在lib中引入commons-dbcp、commons-pool包

 <bean
         class="org.springframework.beans.factory.config.PropertyPlaceholderConfigurer">
         <property name="locations">
             <value>classpath:jdbc.properties</value>
         </property>
     </bean>

     <bean id="dataSource" destroy-method="close"
         class="org.apache.commons.dbcp.BasicDataSource">
         <property name="driverClassName" value="${jdbc.driverClassName}" />
         <property name="url" value="${jdbc.url}" />
         <property name="username" value="${jdbc.username}" />
         <property name="password" value="${jdbc.password}" />
     </bean>

 public class BasicDataSource implements DataSource {

     static {
         // Attempt to prevent deadlocks - see DBCP - 272
         DriverManager.getDrivers();
     }
     .
     .
     .
 }

BasicDataSource提供了close()方法关闭数据源，所以必须设定destroy-method=”close”属性， 
以便Spring容器关闭时，数据源能够正常关闭。除以上必须的数据源属性外，还有一些常用的属性： 
defaultAutoCommit：设置从数据源中返回的连接是否采用自动提交机制，默认值为 true； 
defaultReadOnly：设置数据源是否仅能执行只读操作， 默认值为 false； 
maxActive：最大连接数据库连接数，设置为0时，表示没有限制； 
maxIdle：最大等待连接中的数量，设置为0时，表示没有限制； 
maxWait：最大等待秒数，单位为毫秒， 超过时间会报出错误信息； 
validationQuery：用于验证连接是否成功的查询SQL语句，SQL语句必须至少要返回一行数据； 
removeAbandoned：是否自我中断，默认是 false ； 
removeAbandonedTimeout：几秒后数据连接会自动断开，在removeAbandoned为true，提供该值； 
logAbandoned：是否记录中断事件， 默认为 false；

2.2 spring中的c3p0

引入c3p0-0.9.1.2.jar

     <bean id="dataSource"
         class="com.mchange.v2.c3p0.ComboPooledDataSource" destroy-method="close">
         <property name="driverClass" value="${driverClassName}"></property>
         <property name="jdbcUrl" value="${url}"></property>
         <property name="user" value="${userName}"></property>
         <property name="password" value="${password}"></property>
         <property name="maxPoolSize" value="${jdbc.maxPoolSize}"/>
         <!-- 指定连接池中保留的最小连接数-->
         <property name="minPoolSize" value="${jdbc.minPoolSize}"/>
         <!-- 指定连接池的初始化连接数  取值应在minPoolSize 与 maxPoolSize 之间.Default:3-->
         <property name="initialPoolSize" value="${jdbc.initialPoolSize}"/>
         <!-- 最大空闲时间,60秒内未使用则连接被丢弃。若为0则永不丢弃。 Default:0-->
         <property name="maxIdleTime" value="${jdbc.maxIdleTime}"/>
         <!-- 当连接池中的连接耗尽的时候c3p0一次同时获取的连接数. Default:3-->
         <property name="acquireIncrement" value="${jdbc.acquireIncrement}"/>
         <property name="maxStatements" value="${jdbc.maxStatements}"/>
         <!-- 每60秒检查所有连接池中的空闲连接.Default:0 -->
         <property name="idleConnectionTestPeriod" value="${jdbc.idleConnectionTestPeriod}"/>
         <!--#从数据库获取新连接失败后重复尝试次数 默认 30-->
         <property name="acquireRetryAttempts" value="${jdbc.acquireRetryAttempts}"/>
         <property name="breakAfterAcquireFailure" value="${jdbc.breakAfterAcquireFailure}"/>
     </bean>

destroy-method="close"的作用是当数据库连接不使用的时候,就把该连接重新放到数据池中,方便下次使用调用.

 #指定连接池的初始化连接数
 jdbc.initialPoolSize=10
 #指定连接池中保留的最大连接数
 jdbc.maxPoolSize=20
 #指定连接池中保留的最小连接数
 jdbc.minPoolSize=10
 #最大空闲时间,180秒内未使用则连接被丢弃。若为0则永不丢弃
 jdbc.maxIdleTime=1800
 #当连接池中的连接耗尽的时候c3p0一次同时获取的连接数
 jdbc.acquireIncrement=3
 #最多可以创建Statements对象的个数. . 就是可以执行SQL语句的对象的个数..
 jdbc.maxStatements=100
 #每60秒检查所有连接池中的空闲连接
 jdbc.idleConnectionTestPeriod=60
 #从数据库获取新连接失败后重复尝试次数 默认 30
 jdbc.acquireRetryAttempts=30
 #获取连接失败将会引起所有的等待连接池来获取连接的线程抛出异常，
 #但是数据源乃有效保留，
 #并在下次调用getConnection()的时候继续尝试获取连接
 #如果为true，那么在尝试获取连接失败后该数据源将申明已断开并永久关闭
 #默认 false
 jdbc.breakAfterAcquireFailure=true

2.3 JNDI（Java Naming and Directory Interface）

如果应用配置在高性能的应用服务器（如WebLogic或Websphere等）上或Jboss、Tomcat等，我们可能更希望使用应用服务器本身提供的数据源。 
应用服务器的数据源使用JNDI使用，Spring为此专门提供引用JNDI资源的org\springframework\jndi\JndiObjectFactoryBean类。

以tomcat6为例：
1、在tomcat目录下conf\context.xml中的<Context>标签中加入 

<Resource name="jndi"
        auth="Container"
        type="javax.sql.DataSource"
        password="mysql5"
        username="root"
        driverClassName="com.mysql.jdbc.Driver" url="jdbc:mysql://localhost:3306/spring"
        maxActive="5"
        maxIdle="2"
        maxWait="3000"
/>

2、修改项目的web.xml文件加入 

<resource-ref>
    <res-ref-name>jndi</res-ref-name>
    <res-type>javax.sql.DataSource</res-type>
    <res-auth>Container</res-auth>
</resource-ref>

3、在spring配置文件中配置Datasource 

<!-- 从Tomcat配置的JNDI服务获取数据源-->
    <bean id="dataSource"
        class="org.springframework.jndi.JndiObjectFactoryBean">
        <property name="jndiName" value="java:comp/env/jndi"/>
    </bean>

天天学习，天天进步。。。。。。