Domino連接池解決方案(一)

clockmaker

Domino連接池解決方案（一）
一．        前言
前篇文章簡(jiǎn)單演示了一下Domino存取Oracle數(shù)據(jù)的操作方法及程序代碼。雖然Domino存取Oracle數(shù)據(jù)這個(gè)問題解決了，但還有一個(gè)麻煩隨之而來了。用代理調(diào)用Jdbc，有個(gè)問題，每次代理結(jié)束后都要釋放連接。久而久之，對(duì)Oracle服務(wù)器的壓力也不小，要是用的人多的話，那就更糟糕了。有沒有解決辦法那？有！使用連接池。下面就具體的應(yīng)用進(jìn)行分析。
二．        準(zhǔn)備工作
先說一下我的測(cè)試環(huán)境。
操作系統(tǒng)：WindowsXP SP2 ,1G內(nèi)存，Intel雙核CPU
測(cè)試應(yīng)用平臺(tái)：Domino8.0
開發(fā)工具：        Lotus Designer8.01 + Eclipse3.2.2        
                數(shù)據(jù)庫(kù)：Oracle9i
        這里我說一句，MySQL數(shù)據(jù)庫(kù)也可以。
        我們知道使用代理連接Oracle數(shù)據(jù)庫(kù)，有這么幾個(gè)步驟。Domino裝入代理，然后執(zhí)行代理。代理注冊(cè)jdbc驅(qū)動(dòng)，創(chuàng)建網(wǎng)絡(luò)連接，然后就是存取數(shù)據(jù)，而后斷開連接，反注冊(cè)jdbc驅(qū)動(dòng)，大致分這幾個(gè)步驟。每個(gè)代理每次被調(diào)用都要走這么一個(gè)循環(huán)，效率低下是肯定的了。解決這個(gè)問題只有使用連接池。
        我的java水平不高，自己寫連接池估計(jì)沒戲了。只好上網(wǎng)查找，網(wǎng)絡(luò)真是個(gè)好東西，被我找到了。雖然版本挺多，但是幾乎都是一個(gè)版本派生出來的，因此都差不多。原創(chuàng)作者無法查證，咱先借花獻(xiàn)佛吧。不過有個(gè)小問題，有些版本的連接池有問題，大家注意一下。我會(huì)在附件一中給出我使用的連接池版本，那是沒問題的。將源文件編譯后達(dá)成jar包，拷貝到domino服務(wù)器的jvm/lib/ext/目錄下，同時(shí)也要在你的客戶端的jvm/lib/ext下也拷貝一份，這樣在編譯代理時(shí)才不會(huì)出錯(cuò)。
三．測(cè)試連接池
好了，萬事具備，只欠東風(fēng)了。馬上寫代理驗(yàn)證連接池的可靠性和可用性，代理源程序見附件二。
調(diào)用web代理，我是通過在瀏覽器中輸入代理的ＵＲＬ來進(jìn)行訪問的。這個(gè)就不用我羅唆了吧。輸入U(xiǎn)RL后會(huì)在Domino服務(wù)器的控制臺(tái)上輸出數(shù)據(jù)庫(kù)的記錄信息。好了，到這里連接池測(cè)試是成功的。如果要用到商業(yè)上去，那么要注意幾點(diǎn)。首先，我沒有意見，大家隨便用。其次，連接池作者有沒有意見，我沒辦法確認(rèn)。再次，一定要通過壓力測(cè)試才能正式上線。
(同時(shí)發(fā)布于www.chinalotus.com ,www.csdn.net,www.chinaunix.net）

附件一：一個(gè)完備的連接池類
package com.pool.domino;
import java.io.*;
import java.sql.*;
import java.util.*;
import java.util.Date;

/**
* 管理類DBConnectionManager支持對(duì)一個(gè)或多個(gè)由屬性文件定義的數(shù)據(jù)庫(kù)連接
* 池的訪問.客戶程序可以調(diào)用getInstance()方法訪問本類的唯一實(shí)例.
*/

public class DBConnectionManager {
        static private DBConnectionManager instance; // 唯一實(shí)例

        static private int clients;

        private Vector drivers = new Vector();

        private PrintWriter log;

        private Hashtable pools = new Hashtable();

        /**
         * 返回唯一實(shí)例.如果是第一次調(diào)用此方法,則創(chuàng)建實(shí)例
         *
         * @return DBConnectionManager 唯一實(shí)例
         **/
        static synchronized public DBConnectionManager getInstance() {
                if (instance == null) {
                        instance = new DBConnectionManager();
                }
                clients++;
                return instance;
        }

        /**
         * 建構(gòu)函數(shù)私有以防止其它對(duì)象創(chuàng)建本類實(shí)例
         */
        private DBConnectionManager() {
                init();
        }

        /**
         * 將連接對(duì)象返回給由名字指定的連接池
         *
         * @param name 在屬性文件中定義的連接池名字
         * @param con 連接對(duì)象
         **/
        public void freeConnection(String name, Connection con) {
                DBConnectionPool pool = (DBConnectionPool) pools.get(name);
                if (pool != null) {
                        pool.freeConnection(con);
                }
        }

        /**
         * 獲得一個(gè)可用的(空閑的)連接.如果沒有可用連接,且已有連接數(shù)小于最大連接數(shù)
         * 限制,則創(chuàng)建并返回新連接
         *
         * @param name 在屬性文件中定義的連接池名字
         * @return Connection 可用連接或null
         */
        public Connection getConnection(String name) {
                DBConnectionPool pool = (DBConnectionPool) pools.get(name);
                if (pool != null) {
                        return pool.getConnection();
                }
                return null;
        }

        /**
         * 獲得一個(gè)可用連接.若沒有可用連接,且已有連接數(shù)小于最大連接數(shù)限制,
         * 則創(chuàng)建并返回新連接.否則,在指定的時(shí)間內(nèi)等待其它線程釋放連接.
         *
         * @param name 連接池名字
         * @param time 以毫秒計(jì)的等待時(shí)間
         * @return Connection 可用連接或null
         */
        public Connection getConnection(String name, long time) {
                DBConnectionPool pool = (DBConnectionPool) pools.get(name);
                if (pool != null) {
                        return pool.getConnection(time);
                }
                return null;
        }

        /**
         * 關(guān)閉所有連接,撤銷驅(qū)動(dòng)程序的注冊(cè)
         */
        public synchronized void release() {
                // 等待直到最后一個(gè)客戶程序調(diào)用
                if (--clients != 0) {
                        return;
                }

                Enumeration allPools = pools.elements();
                while (allPools.hasMoreElements()) {
                        DBConnectionPool pool = (DBConnectionPool) allPools.nextElement();
                        pool.release();
                }
                Enumeration allDrivers = drivers.elements();
                while (allDrivers.hasMoreElements()) {
                        Driver driver = (Driver) allDrivers.nextElement();
                        try {
                                DriverManager.deregisterDriver(driver);
                                log("撤銷JDBC驅(qū)動(dòng)程序 " + driver.getClass().getName() + "的注冊(cè)");
                        } catch (SQLException e) {
                                log(e, "無法撤銷下列JDBC驅(qū)動(dòng)程序的注冊(cè): " + driver.getClass().getName());
                        }
                }
        }

        /**
         * 根據(jù)指定屬性創(chuàng)建連接池實(shí)例.
         *
         * @param props 連接池屬性
         * @throws FileNotFoundException
         */
        private void createPools(Properties props) {

                Enumeration propNames = props.propertyNames();
                while (propNames.hasMoreElements()) {
                        String name = (String) propNames.nextElement();
                        if (name.endsWith(".url")) {
                                String poolName = name.substring(0, name.lastIndexOf("."));
                                String url = props.getProperty(poolName + ".url");
                                if (url == null) {
                                        log("沒有為連接池" + poolName + "指定URL");
                                        continue;
                                }
                                String user = props.getProperty(poolName + ".user");
                                String password = props.getProperty(poolName + ".password");
                                String maxconn = props.getProperty(poolName + ".maxconn", "0");
                                int max;
                                try {
                                        max = Integer.valueOf(maxconn).intValue();
                                } catch (NumberFormatException e) {
                                        log("錯(cuò)誤的最大連接數(shù)限制: " + maxconn + " .連接池: " + poolName);
                                        max = 0;
                                }
                                DBConnectionPool pool = new DBConnectionPool(poolName, url, user, password, max);
                                pools.put(poolName, pool);
                                log("成功創(chuàng)建連接池" + poolName);
                        }
                }
        }

        /**
         * 讀取屬性完成初始化
         */
        private void init() {
                InputStream is = getClass().getResourceAsStream("/db.properties");
                Properties dbProps = new Properties();
                try {
                        dbProps.load(is);
                } catch (Exception e) {
                        e.printStackTrace();
                        System.err.println("不能讀取屬性文件. " + "請(qǐng)確保db.properties在CLASSPATH指定的路徑中");
                        return;
                }
                String logFile = dbProps.getProperty("logfile", "DBConnectionManager.log");
                try {
                        log = new PrintWriter(new FileWriter(logFile, true), true);
                } catch (IOException e) {
                        System.err.println("無法打開日志文件: " + logFile);
                        log = new PrintWriter(System.err);
                }
                loadDrivers(dbProps);
                createPools(dbProps);
        }

        /**
         * 裝載和注冊(cè)所有JDBC驅(qū)動(dòng)程序
         *
         * @param props 屬性
         */
        private void loadDrivers(Properties props) {
                String driverClasses = props.getProperty("drivers");
                StringTokenizer st = new StringTokenizer(driverClasses);
                while (st.hasMoreElements()) {
                        String driverClassName = st.nextToken().trim();
                        try {
                                Driver driver = (Driver) Class.forName(driverClassName).newInstance();
                                DriverManager.registerDriver(driver);
                                drivers.addElement(driver);
                                log("成功注冊(cè)JDBC驅(qū)動(dòng)程序" + driverClassName);
                        } catch (Exception e) {
                                log("無法注冊(cè)JDBC驅(qū)動(dòng)程序: " + driverClassName + ", 錯(cuò)誤: " + e);
                        }
                }
        }

        /**
         * 將文本信息寫入日志文件
         */
        private void log(String msg) {
                log.println(new Date() + ": " + msg);
        }

        /**
         * 將文本信息與異常寫入日志文件
         */
        private void log(Throwable e, String msg) {
                log.println(new Date() + ": " + msg);
                e.printStackTrace(log);
        }

        /**
         * 此內(nèi)部類定義了一個(gè)連接池.它能夠根據(jù)要求創(chuàng)建新連接,直到預(yù)定的最
         * 大連接數(shù)為止.在返回連接給客戶程序之前,它能夠驗(yàn)證連接的有效性.
         */
        class DBConnectionPool {
                private int checkedOut;

                private Vector freeConnections = new Vector();

                private int maxConn;

                private String name;

                private String password;

                private String URL;

                private String user;

                /**
                 * 創(chuàng)建新的連接池
                 *
                 * @param name 連接池名字
                 * @param URL 數(shù)據(jù)庫(kù)的JDBC URL
                 * @param user 數(shù)據(jù)庫(kù)帳號(hào),或 null
                 * @param password 密碼,或 null
                 * @param maxConn 此連接池允許建立的最大連接數(shù)
                 */
                public DBConnectionPool(String name, String URL, String user, String password, int maxConn) {
                        this.name = name;
                        this.URL = URL;
                        this.user = user;
                        this.password = password;
                        this.maxConn = maxConn;
                }

                /**
                 * 將不再使用的連接返回給連接池
                 *
                 * @param con 客戶程序釋放的連接
                 */
                public synchronized void freeConnection(Connection con) {
                        // 將指定連接加入到向量末尾
                        freeConnections.addElement(con);
                        checkedOut--;
                        notifyAll();
                }

                /**
                 * 從連接池獲得一個(gè)可用連接.如沒有空閑的連接且當(dāng)前連接數(shù)小于最大連接
                 * 數(shù)限制,則創(chuàng)建新連接.如原來登記為可用的連接不再有效,則從向量刪除之,
                 * 然后遞歸調(diào)用自己以嘗試新的可用連接.
                 */
                public synchronized Connection getConnection() {
                        Connection con = null;
                        if (freeConnections.size() > 0) {
                                // 獲取向量中第一個(gè)可用連接
                                con = (Connection) freeConnections.firstElement();
                                freeConnections.removeElementAt(0);
                                try {
                                        if (con.isClosed()) {
                                                log("從連接池" + name + "刪除一個(gè)無效連接");
                                                // 遞歸調(diào)用自己,嘗試再次獲取可用連接
                                                con = getConnection();
                                        }
                                } catch (SQLException e) {
                                        log("從連接池" + name + "刪除一個(gè)無效連接");
                                        // 遞歸調(diào)用自己,嘗試再次獲取可用連接
                                        con = getConnection();
                                }
                        } else if (maxConn == 0 || checkedOut < maxConn) {
                                con = newConnection();
                        }
                        if (con != null) {
                                checkedOut++;
                        }
                        return con;
                }

                /**
                 * 從連接池獲取可用連接.可以指定客戶程序能夠等待的最長(zhǎng)時(shí)間
                 * 參見前一個(gè)getConnection()方法.
                 *
                 * @param timeout 以毫秒計(jì)的等待時(shí)間限制
                 */
                public synchronized Connection getConnection(long timeout) {
                        long startTime = new Date().getTime();
                        Connection con;
                        while ((con = getConnection()) == null) {
                                try {
                                        wait(timeout);
                                } catch (InterruptedException e) {
                                }
                                if ((new Date().getTime() - startTime) >= timeout) {
                                        // wait()返回的原因是超時(shí)
                                        return null;
                                }
                        }
                        return con;
                }

                /**
                 * 關(guān)閉所有連接
                 */
                public synchronized void release() {
                        Enumeration allConnections = freeConnections.elements();
                        while (allConnections.hasMoreElements()) {
                                Connection con = (Connection) allConnections.nextElement();
                                try {
                                        con.close();
                                        log("關(guān)閉連接池" + name + "中的一個(gè)連接");
                                } catch (SQLException e) {
                                        log(e, "無法關(guān)閉連接池" + name + "中的連接");
                                }
                        }
                        freeConnections.removeAllElements();
                }

                /**
                 * 創(chuàng)建新的連接
                 /**/
                private Connection newConnection() {
                        Connection con = null;
                        try {
                                if (user == null) {
                                        con = DriverManager.getConnection(URL);
                                } else {
                                        con = DriverManager.getConnection(URL, user, password);
                                }
                                log("連接池" + name + "創(chuàng)建一個(gè)新的連接");
                        } catch (SQLException e) {
                                log("無法創(chuàng)建下列URL的連接: " + URL + "\n\t" + e.getNextException());
                                return null;
                        }
                        return con;
                }
        }

        public static void main(String args[]) {
                DBConnectionManager dm = DBConnectionManager.getInstance();
                Connection conn = dm.getConnection("jtds_root");
                if (conn != null) {
                        System.out.println("OK");
                } else {
                        System.out.println("NUll");
                }

                String strSQL = null;
                try {
                        strSQL = "SELECT * from tb_maincontrol";

                        Statement stmt = conn.createStatement(ResultSet.TYPE_SCROLL_INSENSITIVE, ResultSet.CONCUR_READ_ONLY);
                        ResultSet rs = stmt.executeQuery(strSQL);
                        if (rs.next()) {
                                System.out.println(rs.getString(1));
                        }
                } catch (Exception sqe) {
                        sqe.printStackTrace();
                }
        }

}


附件二：測(cè)試用java代理。
import java.sql.Connection;
import java.sql.ResultSet;
import java.sql.Statement;
import lotus.domino.*;
import com.pool.domino.*;

public class testpool extends AgentBase {

        public void NotesMain() {
                Session session = null;
                AgentContext agentContext = null;
                try {
                        session = getSession();
                        agentContext = session.getAgentContext();

                        // (Your code goes here)
                        DBConnectionManager dm = DBConnectionManager.getInstance();
                        Connection conn = dm.getConnection("jtds_root");

                        String strSQL = null;
                        try {
                                strSQL = "SELECT * from JDBCTEST";

                                Statement stmt = conn.createStatement(ResultSet.TYPE_SCROLL_INSENSITIVE, ResultSet.CONCUR_READ_ONLY);
                                ResultSet rs = stmt.executeQuery(strSQL);
                                if (rs.next()) {
                                        System.out.println(rs.getString(1));
                                }
                                rs.close();
                                stmt.close();
                                conn.close();
                        } catch (Exception sqe) {
                                sqe.printStackTrace();
                        }
                        

                } catch(Exception e) {
                        e.printStackTrace();
                }finally{
                        try{
                                agentContext.recycle();
                                session.recycle();
                        }catch(Exception e){
                                
                        }
                }
        }
}

flb_2001

連接池是什么概念�。�