/*
このファイルの中身は、NTT オープンソースライセンス　バージョン 1.0（「本
契約」という）の適用を受けます。
本契約を遵守しない限り、このファイルを使用してはなりません。
本契約のコピーは、次のＵＲＬから入手できます。
【配布サイトのURL】 http://www.oss.ecl.ntt.co.jp/lms/

本契約に基づき頒布されるソフトウェアは、現状のまま、明示又は黙示のあらゆ
る種類の保証なしで、頒布されます。本契約に基づく権利及び制限を律する特定
の文言については、本契約を参照してください。

「オリジナルコード」は、 NTT Cyber Space Laboratories Code です。 
「オリジナルコード」の「初期開発者」は、日本電信電話株式会社です。  
日本電信電話株式会社により創作された部分は、Copyright (C) 2004 
日本電信電話株式会社 です。
全ての権利が留保されます。 
「コントリビュータ」：_____________________________________ 


The contents of this file are subject to the NTT Opensource License
Version 1.0 (the License); you may not use this file except in
compliance with the License. You may obtain a copy of the License at
【配布サイトのURL】 http://www.oss.ecl.ntt.co.jp/lms/

Software distributed under the License is distributed on an AS IS
basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See the
License for the specific language governing rights and limitations
under the License.

The Original Code is NTT Cyber Space Laboratories Code .

The Initial Developer of the Original Code is NIPPON TELEGRAPH AND 
TELEPHONE CORPORATION.
Portions created by the NIPPON TELEGRAPH AND TELEPHONE CORPORATION 
are Copyright (C) 2004 NIPPON TELEGRAPH AND TELEPHONE CORPORATION. 
All Rights Reserved.

Contributor(s) ______________________________________.
*/

//
//	DB接続プール管理クラス
//			変更履歴
//				2004.01.08	新規作成	二條智文
//
package jp.co.ntt.lms.xmo;

import java.sql.*;
import java.util.Vector;
import jp.co.ntt.lms.xmo.util.*;

/**
 * DB接続プール管理クラス<BR>
 * DB接続をプールして管理します。
 * @author T.Nijou
 * @version 0.0.0.1 2004/01/08
 */
public class DBConnector {

	/** クラスを保持します */
	public static final Class THIS_CLASS = new DBConnector().getClass();

	/** 自分のインスタンスを保持します */
	private static DBConnector mobjDBConnector = null;

	/** DBコネクションを保持します */
	private ConnectionHandler[] mobjConHandlerList = null;

	/** DBコネクションを保持します */
	private Vector mvecConHandlerList = new Vector();

	/** 接続プール数を保持します */
	private int mintPoolCount;

	/** JDBCドライバーを保持します */
	private String mstrDBDriver;

	/** DB接続文字列を保持します */
	private String mstrConStr;

	/** DBユーザを保持します */
	private String mstrDBUser;

	/** DBパスワードを保持します */
	private String mstrDBPass;

	/**
	 * DBコネクション取得待ち時間(デフォルト3秒)
	 */
	private int mintWaitTime = 3000;

	/**
	 * DBコネクション取得リトライ回数(デフォルト10回)
	 */
	private int mintRetryCount = 10;

	/**
	 * コンストラクタです。
	 */
	private DBConnector() {
	}

	/**
	 * コンストラクタです。<BR>
	 * 引数で設定した情報を用いて、DBコネクションを確立します。<BR>
	 * 設定ファイルからDB接続プール数を取得しプール数分のコネクションを確立して、
	 * 配列に保持します。
	 * @param strDBDriver JDBCドライバー名称
	 * @param strConStr 接続文字列
	 * @param strDBUser DBユーザ
	 * @param strDBPass DBパスワード
	 * @param intPoolCount コネクションプール数
	 * @param intRetryCount リトライ回数
	 * @param intWaitTime 待ち時間(ms)
	 * @exceptin Exception DB接続に失敗した場合
	 */
	private DBConnector(	String strDBDriver,
							String strConStr,
							String strDBUser,
							String strDBPass,
							int intPoolCount,
							int intRetryCount,
							int intWaitTime
						)
		throws Exception
	{
		//DB接続に必要な情報を設定する
		mstrDBDriver = strDBDriver;
		mstrConStr = strConStr;
		mstrDBUser = strDBUser;
		mstrDBPass = strDBPass;
		mintPoolCount = intPoolCount;
		mintWaitTime = intWaitTime;
		mintRetryCount = intRetryCount;

		// DB接続処理を行います
		try {
			// プール数分の配列を確保します
			mobjConHandlerList = new ConnectionHandler[mintPoolCount];
			// プール数分ループしてコネクションを確立します
			for( int i = 0; i < mintPoolCount; i++ ) {
				// コネクション操作クラスをインスタンス化して、
				// コネクションを設定します
				mobjConHandlerList[i] = new ConnectionHandler(	strDBDriver,
																strConStr,
																strDBUser,
																strDBPass );
				mobjConHandlerList[i].setIndex( i );
				mvecConHandlerList.add( mobjConHandlerList[i] );
			}
		}
		catch( SQLException e ) {
			DebugLog.write( THIS_CLASS, "DB接続に失敗しました。", DebugLog.HIGHT );
			DebugLog.write( THIS_CLASS, e, DebugLog.HIGHT );
			// 切断処理
			try { close(); } catch( Exception ex ){};
			throw e;
		}
		catch( ClassNotFoundException ce ) {
			DebugLog.write( THIS_CLASS, "ドライバーが見つかりません。", DebugLog.HIGHT );
			DebugLog.write( THIS_CLASS, ce, DebugLog.HIGHT );
			// 切断処理
			try { close(); } catch( Exception ex ){};
			throw ce;
		}
	}

	/**
	 * 初期化処理を行います<BR>
	 * 引数で設定した情報を用いて、DBコネクションを確立します。<BR>
	 * 設定ファイルからDB接続プール数を取得しプール数分のコネクションを確立して、
	 * 配列に保持します。
	 * @param strDBDriver JDBCドライバー名称
	 * @param strConStr 接続文字列
	 * @param strDBUser DBユーザ
	 * @param strDBPass DBパスワード
	 * @param intPoolCount コネクションプール数
	 * @param intRetryCount リトライ回数
	 * @param intWaitTime 待ち時間(ms)
	 * @exceptin Exception DB接続に失敗した場合
	 */
	public static void init(	String strDBDriver,
								String strConStr,
								String strDBUser,
								String strDBPass,
								int intPoolCount,
								int intRetryCount,
								int intWaitTime
							)
		throws Exception
	{

		mobjDBConnector = new DBConnector(	strDBDriver,
											strConStr,
											strDBUser,
											strDBPass,
											intPoolCount,
											intRetryCount,
											intWaitTime );
	}

	/**
	 * インスタンスを取得します。
	 */
	public static DBConnector getInstance() {
		return mobjDBConnector;
	}

	/**
	 * コネクションを取得します<BR>
	 * 同じコネクションを取得しないように排他制御がかかります。
	 * @return ConnectionHandler コネクションを保持したコネクション操作クラス
	 */
	synchronized public ConnectionHandler getConnection()
		throws SQLException
	{
		ConnectionHandler objConHandler = null;
		for( int i = 0; i < mintRetryCount; i++ ) {
			if( mvecConHandlerList.size() > 0 ) {
				synchronized( mvecConHandlerList ) {
					objConHandler = (ConnectionHandler)mvecConHandlerList.get(0);
					mvecConHandlerList.remove(0);
					objConHandler.setUsed( true );
				}
DebugLog.write( THIS_CLASS, "DBコネクション配布完了: [" + objConHandler.getIndex() + "]", DebugLog.ROW );
				return objConHandler;
			}
			else {
DebugLog.write( THIS_CLASS, "DBコネクション使用中: リトライ[" + (i+1) + "]", DebugLog.ROW );
				try {
					wait( mintWaitTime );
				}
				catch( Exception e ) {
					throw new SQLException( "コネクション取得失敗" );
				}
			}
		}

		if( objConHandler == null ) {
			throw new SQLException( "コネクション取得失敗" );
		}
		return objConHandler;
	}

	/**
	 * コネクションを返却します
	 */
	public void returnConnection( ConnectionHandler handler ) {
DebugLog.write( THIS_CLASS, "DBコネクション返却: [" + handler.getIndex() + "]", DebugLog.ROW );
		synchronized( mvecConHandlerList ) {
			// 使用フラグをオフにします
			handler.setUsed( false );
			mvecConHandlerList.add( handler );
		}
	}


	/**
	 * 切断処理
	 */
	public void close()
		throws SQLException
	{
		for( int i = 0; i < mintPoolCount; i++ ) {
			if( mobjConHandlerList[i] != null &&
				mobjConHandlerList[i].getConnection() != null ) {
				mobjConHandlerList[i].getConnection().close();
			}
		}
		mvecConHandlerList.removeAllElements();
	}


}

