Hibernate c3p0 数据库链接池

From ：http://www.codeweblog.com/hibernate-using-c3p0-connection-pooling/

c3p0是开源JDBC链接池，Hibernate的发布版也有此功能。这篇文章描述怎样使用Hibernate来配置从c3p0。C3p0链接池配置很简单，只须要添加以下内容到 hibernate.cfg.xml文件：（原文：c3p0 for open source's JDBC connection pool, with the release hibernate. This article describes how to use the hibernate configuration in c3p0. c3p0 connection pool configuration is very simple, only needs to increase in hibernate.cfg.xml: ）

<property name="hibernate.c3p0.max_size"> 20 </ property> 

<! - The smallest number of connections -> 
<property name="hibernate.c3p0.min_size"> 5 </ property> 

<! - Get connection timeout, if more than this time will be thrown, unit ms -> 
<property name="hibernate.c3p0.timeout"> 120 </ property> 

<! - The largest number of PreparedStatement -> 
<property name="hibernate.c3p0.max_statements"> 100 </ property> 

<! - Every 120 seconds to connect the pond to check the idle connection, units are seconds ->
<property name="hibernate.c3p0.idle_test_period"> 120 </ property> 

<! - When the connection inside the connection pool run out of time, C3P0 click access to the new connections -> 
<property name="hibernate.c3p0.acquire_increment"> 2 </ property> 

<! - Every time, verify the connection is available -> 
<property name="hibernate.c3p0.validate"> true </ property>

       此外，须要在CLASS_PATH中添加c3p0-xxx.jar文件，c3p0-xxx.jar的文档发布在Hibernate的conjunction下，你能够在它的lib目录下找到文件。（原文：In addition, where necessary in CLASS_PATH add c3p0-xxxjar file (xxx is version number), c3p0-xxxjar document released in conjunction with hibernate, you may, in its lib directory to find the file. ）

       配置完成以后，Hibernate将能够动态地使用c3p0链接池： C3P0ConnectionProvider（原文：After configuration, hibernate will automatically use the c3p0 connection pool: C3P0ConnectionProvider）

另附Hibernate c3p0的详细配置，摘自其余网站内容：

<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>