Java开源连接池c3p0的基本用法

前言：其实c3p0只是一个实现了javax.sql 接口 DataSource的一个工具集，使用c3p0可以帮我们管理宝贵的Connection资源，无须我们去创建连接（免去每次配置数据库驱动，url,用户名，密码的繁琐操作），而且，既然实现了DataSource接口，那么DataSource的方法都可以使用。

DataSource接口方法摘要
 Connection getConnection()
          尝试建立与此 DataSource 对象表示的数据源的连接。
 Connection getConnection(String username, String password)
          尝试建立与此 DataSource 对象表示的数据源的连接。
 int getLoginTimeout()
          获取此数据源尝试连接到某一数据库时可以等待的最长时间，以秒为单位。
 PrintWriter getLogWriter()
          检索此 DataSource 对象的日志 writer。
 void setLoginTimeout(int seconds)
          设置数据源尝试连接到某一数据库时将等待的最长时间，以秒为单位。
 void setLogWriter(PrintWriter out)
          将此 DataSource 对象的日志 writer 设置为给定的 java.io.PrintWriter 对象。 

—–值得注意的是，从c3p0获取的Connection对象，调用.close()方法并不是释放关闭连接，而是由c3p0自动的放入连接池。

C3P0是一个开源的JDBC连接池，它实现了数据源和JNDI绑定，支持JDBC3规范和JDBC2的标准扩展。

目前使用它的开源项目有Hibernate，Spring等。

c3p0与dbcp区别

(1)dbcp没有自动回收空闲连接的功能

(2)c3p0有自动回收空闲连接功能

c3p0连接池使用

导包c3p0-0.9.1.2.jar

使用

1）.手动

ComboPooledDataSource cpds = new ComboPooledDataSource();

cpds.setDriverClass(“com.mysql.jdbc.Driver”);

cpds.setJdbcUrl(“jdbc:mysql:///day18”);

cpds.setUser(“root”);

cpds.setPassword(“abc”);

     2).自动(使用配置文件)
                c3p0的配置文件可以是properties也可以是xml.
                c3p0的配置文件如果名称叫做 c3p0.properties or c3p0-config.xml 并且放置在classpath路径下(对于web应用就是classes目录)
                那么c3p0会自动查找。
                注意：我们其时只需要将配置文件放置在src下就可以。
                使用：
        ComboPooledDataSource cpds = new ComboPooledDataSource();
        它会在指定的目录下查找指定名称的配置文件，并将其中内容加载。
                    （一般使用xml文件配置比较方便）

<?xml version="1.0" encoding="UTF-8"?>
<c3p0-config>
    <default-config>
        <property name="driverClass">com.mysql.jdbc.Driver</property>
        <property name="jdbcUrl">jdbc:mysql:///dayTest</property>
        <property name="user">root</property>
        <property name="password">1234</property>
    </default-config>
</c3p0-config>

---

附上其他连接池的简介

1.tomcat内置连接池管理

tomcat内置连接池使用的是dbcp。

    问题1：tomcat怎样管理连接池？（配置）
        要想将一个dbcp连接池让 tomcat管理，只需要创建一个context.xml配置文件,在配置文件中
        配置相关信息，

<Context>
              <Resource name="jdbc/EmployeeDB" auth="Container"
                        type="javax.sql.DataSource" username="root" password="abc"
                        driverClassName="com.mysql.jdbc.Driver" url="jdbc:mysql:///day18"
                        maxActive="8" maxIdle="4"/>
            </Context>

        问题:context.xml文件位置:
            1.在tomcat/conf/context.xml     这时这个连接池是给整个服务器使用的。
            2.在tomcat/conf/Catalina/localhost 这时这个连接池只给localhost虚拟主机使用。
            3.将context.xml文件放置在web应用的META-INF下

            注意：如果是全局设置，那么我们需要将数据库驱动放置在tomcat/lib目录下

    问题2:怎样从tomcat中获取连接池?
        我们在servlet中获取连接池对象。

Context context = new InitialContext();
            Context envCtx = (Context)context.lookup("java:comp/env"); 固定路径
            DataSource datasource = (DataSource) envCtx.lookup("jdbc/EmployeeDB"); 

    JNDI----->  JNDI(Java Naming and Directory Interface,Java命名和目录接口)是SUN公司提供的一种标准的Java命名系统接口，
                JNDI提供统一的客户端API，通过不同的访问提供者接口JNDI SPI的实现，由管理者将JNDI API映射为特定的命名服务
                和目录系统，使得Java应用程序可以和这些命名服务和目录服务之间进行交互。目录服务是一种命名服务，
                在这种服务里，对象不但有名称，还有属性。

---

<c3p0-config>
    <default-config>
        <!--当连接池中的连接耗尽的时候c3p0一次同时获取的连接数。Default: 3 -->
        <property name="acquireIncrement">3</property>

        <!--定义在从数据库获取新连接失败后重复尝试的次数。Default: 30 -->
        <property name="acquireRetryAttempts">30</property>

        <!--两次连接中间隔时间，单位毫秒。Default: 1000 -->
        <property name="acquireRetryDelay">1000</property>

        <!--连接关闭时默认将所有未提交的操作回滚。Default: false -->
        <property name="autoCommitOnClose">false</property>

        <!--c3p0将建一张名为Test的空表，并使用其自带的查询语句进行测试。如果定义了这个参数那么 属性preferredTestQuery将被忽略。你不能在这张Test表上进行任何操作，它将只供c3p0测试
            使用。Default: null -->
        <property name="automaticTestTable">Test</property>

        <!--获取连接失败将会引起所有等待连接池来获取连接的线程抛出异常。但是数据源仍有效 保留，并在下次调用getConnection()的时候继续尝试获取连接。如果设为true，那么在尝试
            获取连接失败后该数据源将申明已断开并永久关闭。Default: false -->
        <property name="breakAfterAcquireFailure">false</property>

        <!--当连接池用完时客户端调用getConnection()后等待获取新连接的时间，超时后将抛出 SQLException,如设为0则无限期等待。单位毫秒。Default:
            0 -->
        <property name="checkoutTimeout">100</property>

        <!--通过实现ConnectionTester或QueryConnectionTester的类来测试连接。类名需制定全路径。 Default:
            com.mchange.v2.c3p0.impl.DefaultConnectionTester -->
        <property name="connectionTesterClassName"></property>

        <!--指定c3p0 libraries的路径，如果（通常都是这样）在本地即可获得那么无需设置，默认null即可 Default: null -->
        <property name="factoryClassLocation">null</property>

        <!--Strongly disrecommended. Setting this to true may lead to subtle and
            bizarre bugs. （文档原文）作者强烈建议不使用的一个属性 -->
        <property name="forceIgnoreUnresolvedTransactions">false</property>

        <!--每60秒检查所有连接池中的空闲连接。Default: 0 -->
        <property name="idleConnectionTestPeriod">60</property>

        <!--初始化时获取三个连接，取值应在minPoolSize与maxPoolSize之间。Default: 3 -->
        <property name="initialPoolSize">3</property>

        <!--最大空闲时间,60秒内未使用则连接被丢弃。若为0则永不丢弃。Default: 0 -->
        <property name="maxIdleTime">60</property>

        <!--连接池中保留的最大连接数。Default: 15 -->
        <property name="maxPoolSize">15</property>

        <!--JDBC的标准参数，用以控制数据源内加载的PreparedStatements数量。但由于预缓存的statements 属于单个connection而不是整个连接池。所以设置这个参数需要考虑到多方面的因素。
            如果maxStatements与maxStatementsPerConnection均为0，则缓存被关闭。Default: 0 -->
        <property name="maxStatements">100</property>

        <!--maxStatementsPerConnection定义了连接池内单个连接所拥有的最大缓存statements数。Default: 0 -->
        <property name="maxStatementsPerConnection"></property>

        <!--c3p0是异步操作的，缓慢的JDBC操作通过帮助进程完成。扩展这些操作可以有效的提升性能 通过多线程实现多个操作同时被执行。Default:
            3 -->
        <property name="numHelperThreads">3</property>

        <!--当用户调用getConnection()时使root用户成为去获取连接的用户。主要用于连接池连接非c3p0 的数据源时。Default:
            null -->
        <property name="overrideDefaultUser">root</property>

        <!--与overrideDefaultUser参数对应使用的一个参数。Default: null -->
        <property name="overrideDefaultPassword">password</property>

        <!--密码。Default: null -->
        <property name="password"></property>

        <!--定义所有连接测试都执行的测试语句。在使用连接测试的情况下这个一显著提高测试速度。注意： 测试的表必须在初始数据源的时候就存在。Default:
            null -->
        <property name="preferredTestQuery">select id from test where id=1</property>

        <!--用户修改系统配置参数执行前最多等待300秒。Default: 300 -->
        <property name="propertyCycle">300</property>

        <!--因性能消耗大请只在需要的时候使用它。如果设为true那么在每个connection提交的 时候都将校验其有效性。建议使用idleConnectionTestPeriod或automaticTestTable
            等方法来提升连接测试的性能。Default: false -->
        <property name="testConnectionOnCheckout">false</property>

        <!--如果设为true那么在取得连接的同时将校验连接的有效性。Default: false -->
        <property name="testConnectionOnCheckin">true</property>

        <!--用户名。Default: null -->
        <property name="user">root</property>

        <!--早期的c3p0版本对JDBC接口采用动态反射代理。在早期版本用途广泛的情况下这个参数 允许用户恢复到动态反射代理以解决不稳定的故障。最新的非反射代理更快并且已经开始
            广泛的被使用，所以这个参数未必有用。现在原先的动态反射与新的非反射代理同时受到 支持，但今后可能的版本可能不支持动态反射代理。Default: false -->
        <property name="usesTraditionalReflectiveProxies">false</property>

        <property name="automaticTestTable">con_test</property>
        <property name="checkoutTimeout">30000</property>
        <property name="idleConnectionTestPeriod">30</property>
        <property name="initialPoolSize">10</property>
        <property name="maxIdleTime">30</property>
        <property name="maxPoolSize">25</property>
        <property name="minPoolSize">10</property>
        <property name="maxStatements">0</property>
        <user-overrides user="swaldman">
        </user-overrides>
    </default-config>
    <named-config name="dumbTestConfig">
        <property name="maxStatements">200</property>
        <user-overrides user="poop">
            <property name="maxStatements">300</property>
        </user-overrides>
    </named-config>
</c3p0-config>