proxool詳細配置

時間 2019-11-11

標籤 proxool 詳細配置简体版

原文原文鏈接

proxool一個數據庫鏈接池框架，提供了對你選擇的其它類型的驅動程序的鏈接池封裝。能夠很是簡單的移植到現存的代碼中。徹底可配置。快速，成熟，健壯。能夠透明地爲你現存的JDBC驅動程序增長鏈接池功能。到目前爲止最新版本是proxool 0.9.1,可從官網下載最新版本http://proxool.sourceforge.netjava

1、配置proxool.xml文件mysql

Xml代碼web

1.<?xml version="1.0" encoding="UTF-8"?>  
2.    <!--  
3.        the proxool configuration can be embedded within your own  
4.        application's. Anything outside the "proxool" tag is ignored.  
5.    -->  
6.<something-else-entirely>  
7.    <proxool>  
8.        <alias>dbname</alias> <!--數據源的別名-->  
9.        <driver-url>jdbc:oracle:thin:@127.0.0.1:1521:testdb</driver-url><!--url鏈接串-->  
10.        <driver-class>oracle.jdbc.driver.OracleDriver</driver-class> <!--驅動類-->  
11.        <driver-properties>  
12.            <property name="user" value="username" /> <!--用戶名-->  
13.            <property name="password" value="password" /><!--密碼-->  
14.        </driver-properties>   
15.        <!--最大鏈接數(默認5個),超過了這個鏈接數,再有請求時,就排在隊列中等候,最大的等待請求數由maximum-new-connections決定 -->  
16.        <maximum-connection-count>100</maximum-connection-count>   
17.        <!--最小鏈接數(默認2個)-->  
18.        <minimum-connection-count>10</minimum-connection-count>   
19.        <!--proxool自動偵察各個鏈接狀態的時間間隔(毫秒),偵察到空閒的鏈接就立刻回收,超時的銷燬 默認30秒-->  
20.        <house-keeping-sleep-time>90000</house-keeping-sleep-time>  
21.        <!--沒有空閒鏈接能夠分配而在隊列中等候的最大請求數,超過這個請求數的用戶鏈接就不會被接受-->  
22.        <maximum-new-connections>10</maximum-new-connections>   
23.        <!--最少保持的空閒鏈接數(默認2個)-->  
24.        <prototype-count>5</prototype-count>   
25.        <!--在使用以前測試-->  
26.        <test-before-use>true</test-before-use>  
27.        <!--用於保持鏈接的測試語句 -->  
28.        <house-keeping-test-sql>select sysdate from dual</house-keeping-test-sql>  
29.    </proxool>  
30.</something-else-entirely>

2、配置web.xmlsql

1.<?xml version="1.0" encoding="UTF-8"?>  
2.<web-app version="2.4" xmlns="http://java.sun.com/xml/ns/j2ee"  
3.    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"  
4.    xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee   
5.    http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd">  
6.<servlet>  
7.  <servlet-name>ServletConfigurator</servlet-name>  
8.  <servlet-class>  
9.    org.logicalcobwebs.proxool.configuration.ServletConfigurator  
10.  </servlet-class>  
11.  <init-param>  
12.    <param-name>xmlFile</param-name>  
13.    <param-value>WEB-INF/proxool.xml</param-value>  
14.  </init-param>  
15.  <load-on-startup>1</load-on-startup>  
16.</servlet>  
17.  
18.<servlet>  
19.  <servlet-name>Admin</servlet-name>  
20.  <servlet-class>  
21.    org.logicalcobwebs.proxool.admin.servlet.AdminServlet  
22.  </servlet-class>  
23.</servlet>  
24.<servlet-mapping>  
25.  <servlet-name>Admin</servlet-name>  
26.  <url-pattern>/admin</url-pattern>  
27.</servlet-mapping>  
28.<!-- 配置受保護域，只有Tomcat管理員才能察看鏈接池的信息 -->  
29.<security-constraint>  
30.  <web-resource-collection>  
31.      <web-resource-name>proxool</web-resource-name>   
32.      <url-pattern>/admin</url-pattern>  
33.  </web-resource-collection>  
34.  <auth-constraint>  
35.     <role-name>manager</role-name>   
36.     </auth-constraint>  
37.  </security-constraint>  
38. <login-config>  
39.     <auth-method>BASIC</auth-method>   
40.     <realm-name>proxool manager Application</realm-name>   
41.  </login-config>  
42.  <security-role>  
43.    <description>The role that is required to log in to the Manager Application</description>   
44.     <role-name>manager</role-name>   
45. </security-role>  
46.  <error-page>  
47.    <error-code>401</error-code>  
48.    <location>/401.jsp</location>  
49.  </error-page>  
50.</web-app>

ServletConfigurator:加載並初始化proxool.xml文件,由於它是鏈接數據庫的.其餘不少模塊都用到數據,因此必須首先加載它
load-on-startup:數值越小，就會先被加載初始化
Admin:監控數據庫鏈接池的鏈接狀況數據庫

//得到數據庫鏈接的語句服務器

Connection conn=DriverManager.getConnection("proxool.dbname");多線程

3、更詳細的proxool.xml的配置屬性說明:
併發

<?xml version="1.0" encoding="ISO-8859-1"?>  
1.<!--  
2.Properties for Proxool Configurator testing. Defines the same parameters as  
3.TestHelper.buildCompleteAlternativeProperties()  
4.-->  
5.<something-else-entirely xmlns="http://sumthin.else.entirely" xmlns:proxool="The latest version is available at http://proxool.sourceforge.net/xml-namespace">  
6.    <proxool:proxool>  
7.        <proxool:alias>xml-test-ns</proxool:alias>  
8.        <proxool:driver-url>jdbc:hsqldb:db/test</proxool:driver-url>  
9.        <proxool:driver-class>org.hsqldb.jdbcDriver</proxool:driver-class>  
10.        <proxool:driver-properties>  
11.            <proxool:property name="user" value="sa"/>  
12.            <proxool:property name="password" value=""/>  
13.        </proxool:driver-properties>  
14.        <proxool:house-keeping-sleep-time>40000</proxool:house-keeping-sleep-time>  
15.        <proxool:house-keeping-test-sql>select CURRENT_DATE</proxool:house-keeping-test-sql>  
16.        <proxool:maximum-connection-count>10</proxool:maximum-connection-count>  
17.        <proxool:minimum-connection-count>3</proxool:minimum-connection-count>  
18.        <proxool:maximum-connection-lifetime>18000000</proxool:maximum-connection-lifetime> <!-- 5 hours -->  
19.        <proxool:simultaneous-build-throttle>5</proxool:simultaneous-build-throttle>  
20.        <proxool:recently-started-threshold>40000</proxool:recently-started-threshold>  
21.        <proxool:overload-without-refusal-lifetime>50000</proxool:overload-without-refusal-lifetime>  
22.        <proxool:maximum-active-time>60000</proxool:maximum-active-time>  
23.        <proxool:verbose>true</proxool:verbose>  
24.        <proxool:trace>true</proxool:trace>  
25.        <proxool:fatal-sql-exception>Fatal error</proxool:fatal-sql-exception>  
26.        <proxool:prototype-count>2</proxool:prototype-count>  
27.    </proxool:proxool>  
28.    <nothing-to-do-with-proxool>  
29.        <proxool:proxool>  
30.            <proxool:alias>xml-test-ns-2</proxool:alias>  
31.            <proxool:driver-url>jdbc:hsqldb:db/test</proxool:driver-url>  
32.            <proxool:driver-class>org.hsqldb.jdbcDriver</proxool:driver-class>  
33.            <proxool:driver-properties>  
34.                <proxool:property name="user" value="sa"/>  
35.                <proxool:property name="password" value=""/>  
36.            </proxool:driver-properties>  
37.            <proxool:house-keeping-sleep-time>40000</proxool:house-keeping-sleep-time>  
38.            <proxool:house-keeping-test-sql>select CURRENT_DATE</proxool:house-keeping-test-sql>  
39.            <proxool:maximum-connection-count>10</proxool:maximum-connection-count>  
40.            <proxool:minimum-connection-count>3</proxool:minimum-connection-count>  
41.            <proxool:maximum-connection-lifetime>18000000</proxool:maximum-connection-lifetime> <!-- 5 hours -->  
42.            <proxool:simultaneous-build-throttle>5</proxool:simultaneous-build-throttle>  
43.            <proxool:recently-started-threshold>40000</proxool:recently-started-threshold>  
44.            <proxool:overload-without-refusal-lifetime>50000</proxool:overload-without-refusal-lifetime>  
45.            <proxool:maximum-active-time>60000</proxool:maximum-active-time>  
46.            <proxool:verbose>true</proxool:verbose>  
47.            <proxool:trace>true</proxool:trace>  
48.            <proxool:fatal-sql-exception>Fatal error</proxool:fatal-sql-exception>  
49.            <proxool:prototype-count>2</proxool:prototype-count>  
50.        </proxool:proxool>  
51.    </nothing-to-do-with-proxool>  
52.</something-else-entirely>

屬性列表說明:oracle

fatal-sql-exception: 它是一個逗號分割的信息片斷.當一個SQL異常發生時,他的異常信息將與這個信息片斷進行比較.若是在片斷中存在,那麼這個異常將被認爲是個致命錯誤(Fatal SQL Exception ).這種狀況下,數據庫鏈接將要被放棄.不管發生什麼,這個異常將會被重擲以提供給消費者.用戶最好本身配置一個不一樣的異常來拋出.app

fatal-sql-exception-wrapper-class:正如上面所說,你最好配置一個不一樣的異常來重擲.利用這個屬性,用戶能夠包裝SQLException,使他變成另一個異常.這個異常或者繼承SQLException或者繼承字RuntimeException.proxool自帶了2個實現:'org.logicalcobwebs.proxool.FatalSQLException' 和'org.logicalcobwebs.proxool.FatalRuntimeException' .後者更合適.

house-keeping-sleep-time: proxool自動偵察各個鏈接狀態的時間間隔(毫秒),偵察到空閒的鏈接就立刻回收,超時的銷燬默認30秒)
house keeper 保留線程處於睡眠狀態的最長時間,house keeper 的職責就是檢查各個鏈接的狀態,並判斷是否須要銷燬或者建立.

house-keeping-test-sql: 若是發現了空閒的數據庫鏈接.house keeper 將會用這個語句來測試.這個語句最好很是快的被執行.若是沒有定義,測試過程將會被忽略。通常mysql可用select SYSDATE ，Oracle可用 select sysdate from dual 或者 select 1 from dual

injectable-connection-interface: 容許proxool實現被代理的connection對象的方法.

injectable-statement-interface: 容許proxool實現被代理的Statement 對象方法.

injectable-prepared-statement-interface: 容許proxool實現被代理的PreparedStatement 對象方法.

injectable-callable-statement-interface: 容許proxool實現被代理的CallableStatement 對象方法.

jmx: 略

jmx-agent-id: 略

jndi-name: 數據源的名稱

maximum-active-time: 若是housekeeper 檢測到某個線程的活動時間大於這個數值.它將會殺掉這個線程.因此確認一下你的服務器的帶寬.而後定一個合適的值.默認是5分鐘.

maximum-connection-count: 最大的數據庫鏈接數.

maximum-connection-lifetime: 一個線程的最大壽命.

minimum-connection-count: 最小的數據庫鏈接數

overload-without-refusal-lifetime: 這個參數幫助咱們肯定鏈接池的狀態，若是在這個時間閥值內（單位爲毫秒）拒絕了一個鏈接，就認爲是過載了。默認值是60。

prototype-count: 鏈接池中可用的鏈接數量.若是當前的鏈接池中的鏈接少於這個數值.新的鏈接將被創建(假設沒有超過最大可用數).例如.咱們有3個活動鏈接2個可用鏈接,而咱們的prototype-count是4,那麼數據庫鏈接池將試圖創建另外2個鏈接.這和 minimum-connection-count不一樣. minimum-connection-count把活動的鏈接也計算在內.prototype-count 是spare connections 的數量.

recently-started-threshold: 略

simultaneous-build-throttle: 是指在任一時刻，能夠（同時）創建的最大鏈接數，也就是說，就是已經請求的、但還沒可用的新鏈接數量。由於鏈接能夠用多線程創建，從決定要創建鏈接到鏈接可用是須要必定時間的，因此咱們須要一些方式來避免大量的線程想同時創建鏈接。（咱們本應該找一個更聰明的方式來解決這個問題，總有一天咱們會找到的）默認值是10
當我使用140個用戶，進行壓力測試時，發現偶爾，會有多於10個要求同時創建鏈接的請求，當請求數量超過限定的數值時，會出現鏈接失敗的狀況。
所以結論就是，當數據庫併發鏈接可能會比較高的應用，這個值應該適當的設大一點。
若是併發請求很高，可能出現的bug爲

statistics: 鏈接池使用情況統計。參數「10s,1m,1d」

statistics-log-level: 日誌統計跟蹤類型。參數「ERROR」或「INFO」

test-before-use: 略

test-after-use: 略

trace: 若是爲true,那麼每一個被執行的SQL語句將會在執行期被log記錄(DEBUG LEVEL).你也能夠註冊一個ConnectionListener (參看ProxoolFacade)獲得這些信息.

verbose: 詳細信息設置。參數 bool 值