Domino連接池解決方案(一)
Domino連接池解決方案（一）
一． 前言
前篇文章簡單演示了一下Domino存取Oracle數據的操作方法及程序代碼。雖然Domino存取Oracle數據這個問題解決了，但還有一個麻煩隨之而來了。用代理調用Jdbc，有個問題，每次代理結束后都要釋放連接。久而久之，對Oracle伺服器的壓力也不小，要是用的人多的話，那就更糟糕了。有沒有解決辦法那？有！使用連接池。下面就具體的應用進行分析。
二． 準備工作
先說一下我的測試環境。
操作系統：WindowsXP SP2 ,1G內存，Intel雙核CPU
測試應用平台：Domino8.0
開發工具： Lotus Designer8.01 + Eclipse3.2.2
資料庫：Oracle9i
這裡我說一句，MySQL資料庫也可以。
我們知道使用代理連接Oracle資料庫，有這麼幾個步驟。Domino裝入代理，然後執行代理。代理註冊jdbc驅動，創建網路連接，然後就是存取數據，而後斷開連接，反註冊jdbc驅動，大致分這幾個步驟。每個代理每次被調用都要走這麼一個循環，效率低下是肯定的了。解決這個問題只有使用連接池。
我的java水平不高，自己寫連接池估計沒戲了。只好上網查找，網路真是個好東西，被我找到了。雖然版本挺多，但是幾乎都是一個版本派生出來的，因此都差不多。原創作者無法查證，咱先借花獻佛吧。不過有個小問題，有些版本的連接池有問題，大家注意一下。我會在附件一中給出我使用的連接池版本，那是沒問題的。將源文件編譯后達成jar包，拷貝到domino伺服器的jvm/lib/ext/目錄下，同時也要在你的客戶端的jvm/lib/ext下也拷貝一份，這樣在編譯代理時才不會出錯。
三．測試連接池
好了，萬事具備，只欠東風了。馬上寫代理驗證連接池的可靠性和可用性，代理源程序見附件二。
調用web代理，我是通過在瀏覽器中輸入代理的ＵＲＬ來進行訪問的。這個就不用我羅唆了吧。輸入URL後會在Domino伺服器的控制台上輸出資料庫的記錄信息。好了，到這裡連接池測試是成功的。如果要用到商業上去，那麼要注意幾點。首先，我沒有意見，大家隨便用。其次，連接池作者有沒有意見，我沒辦法確認。再次，一定要通過壓力測試才能正式上線。
(同時發佈於www.chinalotus.com ,www.csdn.net,www.chinaunix.net）
附件一：一個完備的連接池類
package com.pool.domino;
import java.io.*;
import java.sql.*;
import java.util.*;
import java.util.Date;
/**
* 管理類DBConnectionManager支持對一個或多個由屬性文件定義的資料庫連接
* 池的訪問.客戶程序可以調用getInstance()方法訪問本類的唯一實例.
*/
public class DBConnectionManager {
static private DBConnectionManager instance; // 唯一實例
static private int clients;
private Vector drivers = new Vector();
private PrintWriter log;
private Hashtable pools = new Hashtable();
/**
* 返回唯一實例.如果是第一次調用此方法,則創建實例
*
* @return DBConnectionManager 唯一實例
**/
static synchronized public DBConnectionManager getInstance() {
if (instance == null) {
instance = new DBConnectionManager();
}
clients++;
return instance;
}
/**
* 建構函數私有以防止其它對象創建本類實例
*/
private DBConnectionManager() {
init();
}
/**
* 將連接對象返回給由名字指定的連接池
*
* @param name 在屬性文件中定義的連接池名字
* @param con 連接對象
**/
public void freeConnection(String name, Connection con) {
DBConnectionPool pool = (DBConnectionPool) pools.get(name);
if (pool != null) {
pool.freeConnection(con);
}
}
/**
* 獲得一個可用的(空閑的)連接.如果沒有可用連接,且已有連接數小於最大連接數
* 限制,則創建並返回新連接
*
* @param name 在屬性文件中定義的連接池名字
* @return Connection 可用連接或null
*/
public Connection getConnection(String name) {
DBConnectionPool pool = (DBConnectionPool) pools.get(name);
if (pool != null) {
return pool.getConnection();
}
return null;
}
/**
* 獲得一個可用連接.若沒有可用連接,且已有連接數小於最大連接數限制,
* 則創建並返回新連接.否則,在指定的時間內等待其它線程釋放連接.
*
* @param name 連接池名字
* @param time 以毫秒計的等待時間
* @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;
}
/**
* 關閉所有連接,撤銷驅動程序的註冊
*/
public synchronized void release() {
// 等待直到最後一個客戶程序調用
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驅動程序 " + driver.getClass().getName() + "的註冊");
} catch (SQLException e) {
log(e, "無法撤銷下列JDBC驅動程序的註冊: " + driver.getClass().getName());
}
}
}
/**
* 根據指定屬性創建連接池實例.
*
* @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("錯誤的最大連接數限制: " + maxconn + " .連接池: " + poolName);
max = 0;
}
DBConnectionPool pool = new DBConnectionPool(poolName, url, user, password, max);
pools.put(poolName, pool);
log("成功創建連接池" + 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("不能讀取屬性文件. " + "請確保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);
}
/**
* 裝載和註冊所有JDBC驅動程序
*
* @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("成功註冊JDBC驅動程序" + driverClassName);
} catch (Exception e) {
log("無法註冊JDBC驅動程序: " + driverClassName + ", 錯誤: " + 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);
}
/**
* 此內部類定義了一個連接池.它能夠根據要求創建新連接,直到預定的最
* 大連接數為止.在返回連接給客戶程序之前,它能夠驗證連接的有效性.
*/
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;
/**
* 創建新的連接池
*
* @param name 連接池名字
* @param URL 資料庫的JDBC URL
* @param user 資料庫帳號,或 null
* @param password 密碼,或 null
* @param maxConn 此連接池允許建立的最大連接數
*/
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();
}
/**
* 從連接池獲得一個可用連接.如沒有空閑的連接且當前連接數小於最大連接
* 數限制,則創建新連接.如原來登記為可用的連接不再有效,則從向量刪除之,
* 然後遞歸調用自己以嘗試新的可用連接.
*/
public synchronized Connection getConnection() {
Connection con = null;
if (freeConnections.size() > 0) {
// 獲取向量中第一個可用連接
con = (Connection) freeConnections.firstElement();
freeConnections.removeElementAt(0);
try {
if (con.isClosed()) {
log("從連接池" + name + "刪除一個無效連接");
// 遞歸調用自己,嘗試再次獲取可用連接
con = getConnection();
}
} catch (SQLException e) {
log("從連接池" + name + "刪除一個無效連接");
// 遞歸調用自己,嘗試再次獲取可用連接
con = getConnection();
}
} else if (maxConn == 0 || checkedOut < maxConn) {
con = newConnection();
}
if (con != null) {
checkedOut++;
}
return con;
}
/**
* 從連接池獲取可用連接.可以指定客戶程序能夠等待的最長時間
* 參見前一個getConnection()方法.
*
* @param timeout 以毫秒計的等待時間限制
*/
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()返回的原因是超時
return null;
}
}
return con;
}
/**
* 關閉所有連接
*/
public synchronized void release() {
Enumeration allConnections = freeConnections.elements();
while (allConnections.hasMoreElements()) {
Connection con = (Connection) allConnections.nextElement();
try {
con.close();
log("關閉連接池" + name + "中的一個連接");
} catch (SQLException e) {
log(e, "無法關閉連接池" + name + "中的連接");
}
}
freeConnections.removeAllElements();
}
/**
* 創建新的連接
/**/
private Connection newConnection() {
Connection con = null;
try {
if (user == null) {
con = DriverManager.getConnection(URL);
} else {
con = DriverManager.getConnection(URL, user, password);
}
log("連接池" + name + "創建一個新的連接");
} catch (SQLException e) {
log("無法創建下列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();
}
}
}
附件二：測試用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){
}
}
}
}
《解決方案》
連接池是什麼概念啊？
