JAVA資料庫連線池

zhaosoft1982發表於2010-03-27

import java.sql.Connection;
import java.sql.DatabaseMetaData;
import java.sql.Driver;
import java.sql.DriverManager;
import java.sql.SQLException;
import java.sql.Statement;
import java.util.Enumeration;
import java.util.Vector;

public class ConnectionPool {

private String jdbcDriver = ""; // 資料庫驅動

private String dbUrl = ""; // 資料 URL

private String dbUsername = ""; // 資料庫使用者名稱

private String dbPassword = ""; // 資料庫使用者密碼

private String testTable = ""; // 測試連線是否可用的測試表名,預設沒有測試表

private int initialConnections = 10; // 連線池的初始大小

private int incrementalConnections = 5;// 連線池自動增加的大小

private int maxConnections = 50; // 連線池最大的大小

private Vector connections = null; // 存放連線池中資料庫連線的向量 , 初始時為 null

// 它中存放的物件為 PooledConnection 型

/**

* 建構函式

*

* @param jdbcDriver String JDBC 驅動類串

* @param dbUrl String 資料庫 URL

* @param dbUsername String 連線資料庫使用者名稱

* @param dbPassword String 連線資料庫使用者的密碼

*

*/

public ConnectionPool(String jdbcDriver,String dbUrl,String dbUsername,String dbPassword) {

          this.jdbcDriver = jdbcDriver;
  
          this.dbUrl = dbUrl;
  
          this.dbUsername = dbUsername;
  
          this.dbPassword = dbPassword;

}

/**

* 返回連線池的初始大小

*

* @return 初始連線池中可獲得的連線數量

*/

public int getInitialConnections() {

          return this.initialConnections;

}

/**

* 設定連線池的初始大小

*

* @param 用於設定初始連線池中連線的數量

*/

public void setInitialConnections(int initialConnections) {
this.initialConnections = initialConnections;

}

/**

* 返回連線池自動增加的大小 、

*

* @return 連線池自動增加的大小

*/

public int getIncrementalConnections() {

          return this.incrementalConnections;

}

/**

* 設定連線池自動增加的大小

* @param 連線池自動增加的大小

*/

public void setIncrementalConnections(int incrementalConnections) {

          this.incrementalConnections = incrementalConnections;

}

/**

* 返回連線池中最大的可用連線數量

* @return 連線池中最大的可用連線數量

*/

public int getMaxConnections() {

          return this.maxConnections;

}

/**

* 設定連線池中最大可用的連線數量

*

* @param 設定連線池中最大可用的連線數量值

*/

public void setMaxConnections(int maxConnections) {

          this.maxConnections = maxConnections;

}

/**

* 獲取測試資料庫表的名字

*

* @return 測試資料庫表的名字

*/

public String getTestTable() {

          return this.testTable;

}

/**

* 設定測試表的名字

* @param testTable String 測試表的名字

*/

public void setTestTable(String testTable) {

          this.testTable = testTable;

}

/**

*

* 建立一個資料庫連線池,連線池中的可用連線的數量採用類成員

* initialConnections 中設定的值

*/

public synchronized void createPool() throws Exception {

          // 確保連線池沒有建立
  
          // 如果連線池己經建立了,儲存連線的向量 connections 不會為空
  
          if (connections != null) {
  
           return; // 如果己經建立,則返回
  
          }
  
          // 例項化 JDBC Driver 中指定的驅動類例項
  
          Driver driver = (Driver) (Class.forName(this.jdbcDriver).newInstance());
  
          DriverManager.registerDriver(driver); // 註冊 JDBC 驅動程式
  
          // 建立儲存連線的向量 , 初始時有 0 個元素
  
          connections = new Vector();
  
          // 根據 initialConnections 中設定的值,建立連線。
  
          createConnections(this.initialConnections);
  
          System.out.println(" 資料庫連線池建立成功! ");

}

/**

* 建立由 numConnections 指定數目的資料庫連線 , 並把這些連線

* 放入 connections 向量中

*

* @param numConnections 要建立的資料庫連線的數目

*/

@SuppressWarnings("unchecked")
private void createConnections(int numConnections) throws SQLException {

          // 迴圈建立指定數目的資料庫連線
  
          for (int x = 0; x < numConnections; x++) {
  
           // 是否連線池中的資料庫連線的數量己經達到最大?最大值由類成員 maxConnections
   
           // 指出,如果 maxConnections 為 0 或負數,表示連線數量沒有限制。
   
           // 如果連線數己經達到最大,即退出。
   
           if (this.maxConnections > 0 && this.connections.size() >= this.maxConnections) {
   
            break;
   
           }
           //add a new PooledConnection object to connections vector
   
           // 增加一個連線到連線池中(向量 connections 中)
   
           try{
   
            connections.addElement(new PooledConnection(newConnection()));
   
           }catch(SQLException e){
   
            System.out.println(" 建立資料庫連線失敗! "+e.getMessage());
   
           throw new SQLException();
   
           }
   
           System.out.println(" 資料庫連線己建立 ......");
   
          }
  
}

/**

* 建立一個新的資料庫連線並返回它

*

* @return 返回一個新建立的資料庫連線

*/

private Connection newConnection() throws SQLException {

          // 建立一個資料庫連線
  
          Connection conn = DriverManager.getConnection(dbUrl, dbUsername, dbPassword);
  
          // 如果這是第一次建立資料庫連線,即檢查資料庫,獲得此資料庫允許支援的
  
          // 最大客戶連線數目
  
          //connections.size()==0 表示目前沒有連線己被建立
  
          if (connections.size() == 0) {
  
           DatabaseMetaData metaData = conn.getMetaData();

           int driverMaxConnections = metaData.getMaxConnections();
   
           // 資料庫返回的 driverMaxConnections 若為 0 ,表示此資料庫沒有最大
   
           // 連線限制,或資料庫的最大連線限制不知道
   
           //driverMaxConnections 為返回的一個整數,表示此資料庫允許客戶連線的數目
   
           // 如果連線池中設定的最大連線數量大於資料庫允許的連線數目 , 則置連線池的最大
   
           // 連線數目為資料庫允許的最大數目
   
           if (driverMaxConnections > 0 && this.maxConnections > driverMaxConnections) {
   
            this.maxConnections = driverMaxConnections;
   
           }
  
          }
  
          return conn; // 返回建立的新的資料庫連線

}

/**

* 通過呼叫 getFreeConnection() 函式返回一個可用的資料庫連線 ,

* 如果當前沒有可用的資料庫連線,並且更多的資料庫連線不能創

* 建(如連線池大小的限制),此函式等待一會再嘗試獲取。

*

* @return 返回一個可用的資料庫連線物件
*/

public synchronized Connection getConnection() throws SQLException {

          // 確保連線池己被建立
  
          if (connections == null) {
  
           return null; // 連線池還沒建立,則返回 null
  
          }
  
          Connection conn = getFreeConnection(); // 獲得一個可用的資料庫連線
  
          // 如果目前沒有可以使用的連線,即所有的連線都在使用中

while (conn == null){
  
           // 等一會再試
   
           wait(250);
   
           conn = getFreeConnection(); // 重新再試,直到獲得可用的連線,如果
   
           //getFreeConnection() 返回的為 null
   
           // 則表明建立一批連線後也不可獲得可用連線
  
          }
  
          return conn;// 返回獲得的可用的連線

}

/**

* 本函式從連線池向量 connections 中返回一個可用的的資料庫連線,如果

* 當前沒有可用的資料庫連線,本函式則根據 incrementalConnections 設定

* 的值建立幾個資料庫連線,並放入連線池中。

* 如果建立後,所有的連線仍都在使用中,則返回 null

* @return 返回一個可用的資料庫連線

*/

private Connection getFreeConnection() throws SQLException {

          // 從連線池中獲得一個可用的資料庫連線
  
          Connection conn = findFreeConnection();
  
          if (conn == null) {
  
           // 如果目前連線池中沒有可用的連線
   
           // 建立一些連線
   
           createConnections(incrementalConnections);
   
           // 重新從池中查詢是否有可用連線
   
           conn = findFreeConnection();
   
           if (conn == null) {
   
            // 如果建立連線後仍獲得不到可用的連線,則返回 null
    
      return null;
   
           }
  
          }
  
          return conn;

}

/**

* 查詢連線池中所有的連線,查詢一個可用的資料庫連線,

* 如果沒有可用的連線,返回 null

*

* @return 返回一個可用的資料庫連線

*/

private Connection findFreeConnection() throws SQLException {

          Connection conn = null;
  
          PooledConnection pConn = null;
  
          // 獲得連線池向量中所有的物件
  
          Enumeration enumerate = connections.elements();
  
          // 遍歷所有的物件,看是否有可用的連線
  
          while (enumerate.hasMoreElements()) {
  
           pConn = (PooledConnection) enumerate.nextElement();
   
           if (!pConn.isBusy()) {
   
            // 如果此物件不忙,則獲得它的資料庫連線並把它設為忙
    
            conn = pConn.getConnection();
    
            pConn.setBusy(true);
    
            // 測試此連線是否可用
    
            if (!testConnection(conn)) {
    
             // 如果此連線不可再用了,則建立一個新的連線,
     
             // 並替換此不可用的連線物件,如果建立失敗

返回 null
     
             try{
     
              conn = newConnection();
     
             }catch(SQLException e){
     
              System.out.println(" 建立資料庫連線失敗! "+e.getMessage());
     
              return null;
     
             }
    
             pConn.setConnection(conn);
    
            }
    
            break; // 己經找到一個可用的連線,退出
   
           }
  
          }
  
          return conn;// 返回找到到的可用連線

}

/**

* 測試一個連線是否可用,如果不可用,關掉它並返回 false

* 否則可用返回 true

*

* @param conn 需要測試的資料庫連線

* @return 返回 true 表示此連線可用, false 表示不可用

*/

private boolean testConnection(Connection conn) {

          try {
  
           // 判斷測試表是否存在
   
           if (testTable.equals("")) {
   
            // 如果測試表為空,試著使用此連線的 setAutoCommit() 方法
    
            // 來判斷連線否可用(此方法只在部分資料庫可用,
如果不可用 ,
    
            // 丟擲異常)。注意:使用測試表的方法更可靠
    
            conn.setAutoCommit(true);
   
           } else {// 有測試表的時候使用測試表測試
   
            //check if this connection is valid
    
            Statement stmt = conn.createStatement();
    
            stmt.execute("select count(*) from " + testTable);
   
           }
  
          } catch (SQLException e) {
  
           // 上面丟擲異常,此連線己不可用,關閉它,並返回 false;
  
           closeConnection(conn);
  
           return false;
  
          }
  
          // 連線可用,返回 true
  
          return true;

}

/**

* 此函式返回一個資料庫連線到連線池中,並把此連線置為空閒。

* 所有使用連線池獲得的資料庫連線均應在不使用此連線時返回它。

*

* @param 需返回到連線池中的連線物件

*/

public void returnConnection(Connection conn) {

          // 確保連線池存在,如果連線沒有建立(不存在),直接返回
  
          if (connections == null) {
  
           System.out.println(" 連線池不存在,無法返回此連線到連線池中 !");
   
           return;
}

          PooledConnection pConn = null;
  
          Enumeration enumerate = connections.elements();
  
          // 遍歷連線池中的所有連線,找到這個要返回的連線物件
  
          while (enumerate.hasMoreElements()) {

           pConn = (PooledConnection) enumerate.nextElement();
   
           // 先找到連線池中的要返回的連線物件
   
           if (conn == pConn.getConnection()) {
   
            // 找到了 , 設定此連線為空閒狀態
    
            pConn.setBusy(false);
    
            break;
   
           }

          }

}

/**

* 重新整理連線池中所有的連線物件

*

*/

public synchronized void refreshConnections() throws SQLException {

          // 確保連線池己創新存在
  
          if (connections == null) {
  
           System.out.println(" 連線池不存在,無法重新整理 !");
  
           return;
  
          }
  
          PooledConnection pConn = null;
  
          Enumeration enumerate = connections.elements();
while (enumerate.hasMoreElements()) {

           // 獲得一個連線物件
   
           pConn = (PooledConnection) enumerate.nextElement();
   
           // 如果物件忙則等 5 秒 ,5 秒後直接重新整理
   
           if (pConn.isBusy()) {
   
            wait(5000); // 等 5 秒
   
           }
   
           // 關閉此連線,用一個新的連線代替它。
   
           closeConnection(pConn.getConnection());
   
           pConn.setConnection(newConnection());
   
           pConn.setBusy(false);
   
          }

}

/**

* 關閉連線池中所有的連線,並清空連線池。

*/

public synchronized void closeConnectionPool() throws SQLException {

          // 確保連線池存在,如果不存在,返回
  
          if (connections == null) {
  
           System.out.println(" 連線池不存在,無法關閉 !");
  
           return;
  
          }
  
          PooledConnection pConn = null;
  
          Enumeration enumerate = connections.elements();
  
          while (enumerate.hasMoreElements()) 

 pConn = (PooledConnection) enumerate.nextElement();
  
           // 如果忙,等 5 秒
  
           if (pConn.isBusy()) {
  
            wait(5000); // 等 5 秒
  
           }
  
          //5 秒後直接關閉它
  
          closeConnection(pConn.getConnection());
  
          // 從連線池向量中刪除它
  
          connections.removeElement(pConn);
  
          }
  
          // 置連線池為空
  
          connections = null;

}

/**

* 關閉一個資料庫連線

*

* @param 需要關閉的資料庫連線

*/

private void closeConnection(Connection conn) {

          try {
  
           conn.close();
  
          }catch (SQLException e) {
  
           System.out.println(" 關閉資料庫連線出錯: "+e.getMessage());
  
          }

}

/**

* 使程式等待給定的毫秒數

*

* @param 給定的毫秒數

*/

private void wait(int mSeconds) {

          try {
  
           Thread.sleep(mSeconds);
  
          }
    
              catch (InterruptedException e) {
  
          }

}

/**

*

* 內部使用的用於儲存連線池中連線物件的類

* 此類中有兩個成員,一個是資料庫的連線,另一個是指示此連線是否

* 正在使用的標誌。

*/

class PooledConnection {

          Connection connection = null;// 資料庫連線
  
          boolean busy = false; // 此連線是否正在使用的標誌,預設沒有正在使用
  
          // 建構函式,根據一個 Connection 構告一個 PooledConnection 物件
  
          public PooledConnection(Connection connection) {
  
           this.connection = connection;
  
          }
  
          // 返回此物件中的連線
  
          public Connection getConnection() {
  
           return connection;

          }

          // 設定此物件的,連線
  
          public void setConnection(Connection connection) {
  
           this.connection = connection;
   
          }
   
          // 獲得物件連線是否忙
   
          public boolean isBusy() {
   
           return busy;
   
          }
   
          // 設定物件的連線正在忙
   
public void setBusy(boolean busy) {
   
           this.busy = busy;
   
          }

}

}

 

=======================================

這個例子是根據POSTGRESQL資料庫寫的,
請用的時候根據實際的資料庫調整。

呼叫方法如下:

① ConnectionPool connPool
                                      = new ConnectionPool("org.postgresql.Driver"
                                                                          ,"jdbc:postgresql://dbURI:5432/DBName"
                                                                          ,"postgre"
                                                                          ,"postgre");

② connPool .createPool();
  Connection conn = connPool .getConnection();

相關文章