/*
 * Copyright (c) 2009 The openGion Project.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND,
 * either express or implied. See the License for the specific language
 * governing permissions and limitations under the License.
 */
package org.opengion.fukurou.db;

import java.io.File;
import java.net.URL;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.Comparator;
import java.util.LinkedHashMap;
import java.util.List;
import java.util.Locale;
import java.util.Map;

import org.opengion.fukurou.util.StringUtil;
import org.opengion.fukurou.util.FileUtil;
import org.opengion.fukurou.util.LogWriter;
import org.opengion.fukurou.xml.DomParser;
import org.w3c.dom.Document;
import org.w3c.dom.Element;
import org.w3c.dom.Node;
import org.w3c.dom.NodeList;

/**
 * DB設定XMLの内容をJAXBを利用してロードする
 * Driverをロードする
 * 上記２つの機能を備えたクラスです
 *
 * 外部からはgetDbidメソッドを利用してDB設定(ExpandedDbid型)を取得します。
 * DB設定情報が無い場合にXMLを読みにいきます。
 * このDBIDを決めるキーは、内部取り込み字に、大文字変換されますので、大文字・
 * 小文字の区別はありません。
 *
 * @og.rev 4.0.0.0 (2007/10/25) 新規作成
 * @og.rev 5.1.7.0 (2010/06/01) org.opengion.fukurou.xml.jaxb.dbid 関係 廃止
 * @og.group 初期化
 *
 * @version  4.0
 * @author 高橋正和
 * @since   JDK6.0,
 */
public class DatabaseConfig {

	// fukurou内で完結させるため、HybsDataからは読み込まずにここに書く
	private static final String DEFAULT_DRIVER	 = "oracle.jdbc.OracleDriver";

	// XMLファイル関連
//	private transient final String XmlFilename;
//	private final String XmlFilename;
	private final String xmlFilename;				// 5.7.2.2 (2014/01/24)
//	private static final String SCHEMA_FILENAME = "DBConfig.xsd";//xsdはfukurou.xml.jaxb.dbidパッケージに置く

//	private transient final Map<String, EDbid> dbidMap = new HashMap<String, EDbid>();
//	private transient List<String> driverList = new ArrayList<String>();
//	private Map<String, EDbid> dbidMap = new HashMap<String, EDbid>();
	private Map<String, EDbid> dbidMap = new LinkedHashMap<String, EDbid>();		// 5.6.7.0 (2013/07/27)
//	private List<String> driverList = new ArrayList<String>();
	private List<String> driverList = new ArrayList<String>();

	// 5.6.7.0 (2013/07/27) プルダウンメニュー用の情報の、キャッシュ用変数。
	private String codeKeyVal = null;		// 初めて要求されたときに、セットします。

//	private static final String CR = System.getProperty( "line.separator" );

	/* DBIDのキーの一覧を管理します。5.1.9.0 (2010/08/01) */
	// 5.5.2.0 (2012/05/01) property追加
//	private static final String[] DBID_INFO_KEYS
//				= { "dbidKey", "url", "user", "password", "readonly"
//					, "mincount", "maxcount", "pooltime", "applicationInfo" };
//	private static final String[] DBID_INFO_KEYS
//				= { "dbidKey", "url", "user", "password", "readonly"
//					, "mincount", "maxcount", "pooltime", "applicationInfo","property" };
	// 5.6.6.0 (2013/07/05) 表題(title)属性を追加
	private static final String[] DBID_INFO_KEYS
				= { "dbidKey", "title", "url", "user", "password", "readonly"
					, "mincount", "maxcount", "pooltime", "applicationInfo","property" };

	/* DBDRIVERのキーのを管理します。5.1.9.0 (2010/08/01) */
	private static final String DBDRIVER_CLASS_KEY = "class";

	/**
	 * 初期値を使ってXMLを読み込む
	 * xmlFilenameの初期値は../DBConfig.xml
	 *
	 * @og.rev 4.3.1.1 (2008/08/23) 自分のコンストラクターを呼ぶように修正
	 */
	public DatabaseConfig() {
		this( "../DBConfig.xml" );
	}

	/**
	 * XMLファイルの名前を指定して読み込む
	 *
	 * @og.rev 5.1.9.0 (2010/08/01) クラスローダー外からでもDBConfig.xmlを取得できるようにする
	 * @og.rev 5.6.7.0 (2013/07/27) オブジェクト作成時に初期化も行っておきます。
	 * @og.rev 5.6.8.2 (2013/09/20) Tomcat8で、クラスローダーが変更されているのでその対応
	 * @og.rev 5.7.2.2 (2014/01/24) WEB-INF/classes フォルダがないと、xmlURL がnull になる対応。
	 * @og.rev 5.7.2.3 (2014/01/31) ファイルの存在チェックを追加します。
	 *
	 * @param	xmlfile	XMLファイルの名前
	 */
	public DatabaseConfig( final String xmlfile ) {
//		xmlFilename = xmlfile;
		String fileName = null;

		ClassLoader clsl	= getClass().getClassLoader();
		URL xmlURL			= clsl.getResource( xmlfile );

		if( xmlURL != null ) {
			fileName = xmlURL.getFile();
			// 5.7.2.3 (2014/01/31) ファイルの存在チェックを追加します。
			if( ! new File( fileName ).exists() ) { fileName = null; }
		}
		// 5.6.8.2 (2013/09/20) Tomcat8で、xmlURL が取得できなくなっている・・・ようだ。
		else {
			xmlURL = clsl.getResource( "/" );		// クラスパスのベースURL
			// 5.7.2.2 (2014/01/24) Tomcat7で、WEB-INF/classes フォルダがないと、xmlURL がnull になる。
			if( xmlURL != null ) {
				File temp = new File( xmlURL.getPath() , xmlfile );
				if( temp.exists() ) { fileName = temp.getAbsolutePath(); }
			}
		}

		// 5.1.9.0 (2010/08/01)  クラスローダー外からでもDBConfig.xmlを取得できるようにする
		if( fileName == null && new File( xmlfile ).exists() ) {
			fileName = xmlfile;
		}

		if( fileName == null ) {
			// 5.5.7.2 (2012/10/09) コメント追加
			String errMsg = "DBConfig.xmlが見つかりません。File=[" + xmlfile + "]\n" 
								+ " WEB-INF/classes フォルダがないと、相対パスで見つけることができません。" ;
			throw new RuntimeException( errMsg );
//			throw new RuntimeException( "DBConfig.xmlが見つかりません。File=[" + xmlfile + "]" );
		}

		xmlFilename			= fileName;
//		System.out.println( xmlFilename );

		init();			// 5.6.7.0 (2013/07/27)
	}

	/**
	 * dbidKeyをキーにしてExpandedDbid型でマップの内容を返す。
	 * 存在しない場合はNULLを返します。
	 * キーが無い場合に初期化を行う。
	 *
	 * @og.rev 4.0.0.1 (2007/12/04) EDbid#clone() 廃止
	 * @og.rev 5.6.7.0 (2013/07/27) synchronized メソッドにします。
	 *
	 * @param key XMLで登録したdbidKey
	 *
	 * @return EDbid型オブジェクト
	 */
	public synchronized EDbid getDbid( final String key ) {
//		synchronized ( dbidMap ) {
//			if( dbidMap.isEmpty() ) {
//				init();
//			}

			return dbidMap.get( key.toUpperCase( Locale.JAPAN ) ) ;
//		}
	}

	/**
	 * マップをクリアします。
	 * XMLファイルを再読み込みする場合に使用します。
	 *
	 * @og.rev 5.1.9.0 (2010/08/01) ドライバーのリストもクリアする。
	 * @og.rev 5.6.7.0 (2013/07/27) synchronized メソッドにします。
	 */
	public synchronized void reload() {
//		synchronized ( dbidMap ) {
			dbidMap.clear();
//		}
//		synchronized ( driverList ) {
			driverList.clear();
//		}
		init();
	}

	/**
	 * 初期化処理
	 *
	 * DB設定XMLファイル(DBConfig.xml)を読み込みます。
	 * このファイルから、ドライバーリストの取得、DBIDのオブジェクトマップの作成を
	 * 行います。
	 * EDbidオブジェクト は、環境変数で、共通の初期値を定義しておくことが可能です。
	 * 項目として、REALM_URL、REALM_NAME、REALM_PASSWORD が設定可能です。
	 *
	 * ドライバーリストの取得後、Class.forName で、ドライバの登録も行います。
	 *
	 * @og.rev 5.1.7.0 (2010/06/01) org.opengion.fukurou.xml.jaxb.dbid 関係 廃止
	 * @og.rev 5.6.7.0 (2013/07/27) dbidMap,driverList を書き込むのではなく、作成します。
	 */
	private void init() {
		Document doc = DomParser.read( new File(xmlFilename) ) ;
		Element firstRoot = doc.getDocumentElement();

//		List<String> driverList = getDriverList( firstRoot );
//		driverList = getDriverList( firstRoot );
		makeDriverList( firstRoot );				// 5.6.7.0 (2013/07/27)

		// 5.6.7.0 (2013/07/27) を、かけておきます。
		synchronized ( this ) {
			for( String dr : driverList ) {
				try {
					Class.forName( dr );
				} catch ( ClassNotFoundException ex ) {
					String errMsg = "ドライバクラスが見つかりません。[" + dr + "]" ;
					LogWriter.log( errMsg );
					LogWriter.log( ex );
				}
			}
		}

		EDbid defDdbid = new EDbid();		// 初期値
		defDdbid.setUrl(		System.getenv( "REALM_URL" ) );
		defDdbid.setUser(		System.getenv( "REALM_NAME" ) );
		defDdbid.setPassword(	System.getenv( "REALM_PASSWORD" ) );

//		dbidMap = getDbidMap( firstRoot,defDdbid );
		makeDbidMap( firstRoot,defDdbid );				// 5.6.7.0 (2013/07/27)
	}

	/**
	 * ドライバーリストを取得します。
	 *
	 * DB設定XMLファイル(DBConfig.xml)の、class タグを取り込みます。
	 * このファイルから、ドライバーリストを取得します。
	 *
	 * 内部的に３段階の処理が実行されます。
	 * 第１Step:DBConfig.xml から、ドライバーリストを取得
	 * 第２Step:ドライバーリストが存在しない場合、環境変数の REALM_DRIVER からドライバーを取得
	 * 第３Step:それでも存在しない場合、このクラスの DEFAULT_DRIVER 定数 からドライバーを取得
	 *
	 * @og.rev 5.1.7.0 (2010/06/01) org.opengion.fukurou.xml.jaxb.dbid 関係 廃止
	 * @og.rev 5.1.9.0 (2010/08/01) ドライバ一覧のListをオブジェクト変数化
	 * @og.rev 5.6.7.0 (2013/07/27) driverList を書き込むのではなく、作成します。
	 * @og.rev 5.6.7.0 (2013/07/27) synchronized メソッドにします。
	 *
	 * @param	element	DB設定XMLファイルのElementオブジェクト
	 */
//	private static List<String> getDriverList( final Element element ) {
	private void makeDriverList( final Element element ) {
//		List<String> dList = new ArrayList<String>();

		NodeList list = element.getElementsByTagName( "class" ) ;
		int num = list.getLength();
		for (int i = 0; i < num; i++) {
			Element cls = (Element)list.item(i);
//			dList.add( cls.getTextContent() );
			driverList.add( cls.getTextContent() );
		}

//		if( dList.isEmpty() ) {
		if( driverList.isEmpty() ) {
			String realmDriver = System.getenv( "REALM_DRIVER" );
			if( realmDriver != null && realmDriver.length() > 0 ) {
//				dList.add( realmDriver );
				driverList.add( realmDriver );
			}
		}

//		if( dList.isEmpty() ) { dList.add( DEFAULT_DRIVER ); }
		if( driverList.isEmpty() ) { driverList.add( DEFAULT_DRIVER ); }

//		return dList ;
	}

	/**
	 * EDbidオブジェクトのマップを取得します。
	 *
	 * DB設定XMLファイル(DBConfig.xml)の、dbid タグを取り込みます。
	 * このファイルから、EDbidオブジェクトの属性情報を取得し、オブジェクトを構築します。
	 *
	 * EDbidオブジェクト は、初期値をコピーして、作成していきます。
	 * EDbidオブジェクトをマップから取り出すキーとなる、dbidKey は、大文字化して設定します。
	 *
	 * @og.rev 5.1.7.0 (2010/06/01) org.opengion.fukurou.xml.jaxb.dbid 関係 廃止
	 * @og.rev 5.1.9.0 (2010/08/01) Mapを返すように変更
	 * @og.rev 5.5.2.0 (2012/05/01) property追加
	 * @og.rev 5.6.6.0 (2013/07/05) 表題(title)属性の取得
	 * @og.rev 5.6.7.0 (2013/07/27) 内部MapをDBConfig.xmlの読み込み順に変更。
	 * @og.rev 5.6.7.0 (2013/07/27) dbidMap を書き込むのではなく、作成します。
	 * @og.rev 5.6.7.0 (2013/07/27) synchronized メソッドにします。
	 * @og.rev 5.6.7.1 (2013/08/09) DEFAULT と、RESOURCE の DBIDキーがなければ、内部的に作成します。
	 * @og.rev 5.6.8.0 (2013/09/06) RESOURCE の DBIDキーを内部作成時に、title も設定します。
	 *
	 * @param  element DB設定XMLファイルのElementオブジェクト
	 * @param  defDdbid 初期情報の設定された、EDbidオブジェクト
	 */
//	private void makeDbidMap( final Element element , EDbid defDdbid ) {
//	private static Map<String,EDbid> getDbidMap( final Element element , EDbid defDdbid ) {
	private void makeDbidMap( final Element element , EDbid defDdbid ) {
//		Map<String,EDbid> dMap = new HashMap<String,EDbid>();		// 5.6.7.0 (2013/07/27)

		NodeList list = element.getElementsByTagName( "dbid" ) ;
		int num = list.getLength();
		for (int i = 0; i < num; i++) {
			Element ele = (Element)list.item(i);
			NodeList childs = ele.getChildNodes();
			int numChild = childs.getLength();
//			EDbid dbid = new EDbid();
			EDbid dbid = defDdbid.clone();		// 初期値をコピーして、作成
			for (int j = 0; j < numChild; j++) {
				Node nd = childs.item(j);
				if( nd.getNodeType() == Node.ELEMENT_NODE ) {
					Element el = (Element)nd;
					String tag = el.getTagName();
					// dbidKey は、toUpperCase して、大文字のみとする。
					if( "dbidKey".equals( tag ) )	{
						String dbidKey = el.getTextContent();
						if( dbidKey != null && dbidKey.length() > 0 ) {
							dbid.setDbidKey( dbidKey.toUpperCase( Locale.JAPAN ) );
						}
					}
					else if( "title".equals( tag ) )	{ dbid.setTitle(	el.getTextContent() ); }		// 5.6.6.0 (2013/07/05) 表題(title)属性の取得
					else if( "url".equals( tag ) )		{ dbid.setUrl(		el.getTextContent() ); }
					else if( "user".equals( tag ) )		{ dbid.setUser(		el.getTextContent() ); }
					else if( "password".equals( tag ) ) { dbid.setPassword( el.getTextContent() ); }
					else if( "readonly".equals( tag ) ) { dbid.setReadonly( el.getTextContent() ); }
					else if( "mincount".equals( tag ) ) { dbid.setMincount( el.getTextContent() ); }
					else if( "maxcount".equals( tag ) ) { dbid.setMaxcount( el.getTextContent() ); }
					else if( "pooltime".equals( tag ) ) { dbid.setPooltime( el.getTextContent() ); }
					else if( "applicationInfo".equals( tag ) ) { dbid.setApplicationInfo( el.getTextContent() ); }
					else if ("property".equals( tag ) ) { dbid.addProp( el.getTextContent() ); } // 5.5.2.0 (2012/05/01)
					else {
						System.err.println( "警告：dbid に新しい属性が、追加されています。" );
					}
				}
			}
//			dbidMap.put( dbid.getDbidKey(), dbid );
//			dMap.put( dbid.getDbidKey(), dbid );
			dbidMap.put( dbid.getDbidKey(), dbid );		// 5.6.7.0 (2013/07/27) 復活
		}

		// 5.6.7.1 (2013/08/09) DEFAULT と、RESOURCE の DBIDキーがなければ、内部的に作成します。
		EDbid dbid_D = dbidMap.get( "DEFAULT" );		// DEFAULT が存在するか確認する。
		if( dbid_D == null ) {
			dbid_D = defDdbid.clone();					// 初期値をコピー
			dbid_D.setDbidKey( "DEFAULT" );
			dbidMap.put( "DEFAULT", dbid_D );
		}

		EDbid dbid_R = dbidMap.get( "RESOURCE" );		// RESOURCE が存在するか確認する。
		if( dbid_R == null ) {
			dbid_R = dbid_D.clone();					// DEFAULT の DBIDをコピー(必ず存在するはず)
			dbid_R.setDbidKey( "RESOURCE" );
			dbid_R.setTitle( "RESOURCE" );				// 5.6.8.0 (2013/09/06) title も設定します。
			dbidMap.put( "RESOURCE", dbid_R );
		}

//		return dMap;
	}

	/* ------------------------------------------------------------------------------------
	 *
	 * 以下は、DBConfig.xml編集用のメソッドです。
	 * 編集用のメソッドでは、オブジェクト化されたDBID及びDBDRIVERの情報は使用せずに、
	 * DBConfig.xmlからその情報を再度読み出して、SET/GETしています。
	 * (オブジェクトとして依存しているのは、DBConfig.xmlのファイル名のみです)
	 *
	 * -------------------------------------------------------------------------------------
	 */
	/**
	 * DBIDとして管理している項目のキーの一覧を配列形式で返します。
	 *
	 * @og.rev 5.1.9.0 (2010/08/01) 新規作成
	 *
	 * @return 項目のキー一覧
	 */
	public static String[] getDbidInfoKeys() {
//		return DBID_INFO_KEYS;
		return DBID_INFO_KEYS.clone();
	}

	/**
	 * 全てのDBIDの属性情報のリスト(配列)で返します。
	 *
	 * 値の順番については、{@link #getDbidInfoKeys()}で返されるキーの一覧と同じです。
	 *
	 * @og.rev 5.1.9.0 (2010/08/01) 新規作成
	 * @og.rev 5.5.2.1 (2012/05/07) propertiesを出力
	 * @og.rev 5.6.6.0 (2013/07/05) 表題(title)属性を追加
	 * @og.rev 5.6.7.0 (2013/07/27) 内部MapをDBConfig.xmlの読み込み順に変更。
	 *
	 * @return 全てのDBIDの属性情報のリスト(配列)
	 * @see #getDbidInfoKeys()
	 */
	public synchronized String[][] getDbidInfo() {
//		Element ele = DomParser.read( new File(xmlFilename) ).getDocumentElement();
//		Map<String,EDbid> dMap = getDbidMap( ele , new EDbid() );
//		String[][] dbidInfo = new String[dMap.size()][DBID_INFO_KEYS.length];

		String[][] dbidInfo = new String[dbidMap.size()][DBID_INFO_KEYS.length];
		int idx = 0;
//		for( EDbid dbid : dMap.values() ) {
		for( EDbid dbid : dbidMap.values() ) {
			dbidInfo[idx][0] = dbid.getDbidKey();
			dbidInfo[idx][1] = dbid.getTitle();				// 5.6.6.0 (2013/07/05) 表題(title)属性を追加
			dbidInfo[idx][2] = dbid.getUrl();
			dbidInfo[idx][3] = dbid.getUser();
			dbidInfo[idx][4] = dbid.getPassword();
			dbidInfo[idx][5] = String.valueOf( dbid.isReadonly() );
			dbidInfo[idx][6] = String.valueOf( dbid.getMincount() );
			dbidInfo[idx][7] = String.valueOf( dbid.getMaxcount() );
			dbidInfo[idx][8] = String.valueOf( dbid.getPooltime() );
			dbidInfo[idx][9] = String.valueOf( dbid.isApplicationInfo() );
			dbidInfo[idx][10]= String.valueOf( dbid.getProps().toString() ); // 5.5.2.1 (2012/05/07)
			idx++;
		}
	 	// 5.6.7.0 (2013/07/27) 内部MapをDBConfig.xmlの読み込み順に変更(なので、廃止)。
//		dbidSort( dbidInfo );
		return dbidInfo;
	}

	/**
	 * 全てのDBIDの属性情報のリスト(配列)をセットします。
	 *
	 * このメソッドを呼び出すと、DBConfig.xmlで定義されているDBID情報一覧を"一旦削除し"、
	 * その上で、引数のDBID情報一覧をDBConfig.xmlに書き込みます。
	 *
	 * 値の順番については、{@link #getDbidInfoKeys()}で返されるキーの一覧と同じです。
	 *
	 * 書き込みの直前に、同じフォルダにタイムスタンプを付加したバックアップファイルを作成します。
	 *
	 * @og.rev 5.1.9.0 (2010/08/01) 新規作成
	 * @og.rev 5.6.7.0 (2013/07/27) 内部MapをDBConfig.xmlの読み込み順に変更。
	 *
	 * @param dbidVals 全てのDBIDの属性情報のリスト(配列)
	 * @see #getDbidInfoKeys()
	 */
	public void setDbidInfo( final String[][] dbidVals ) {
		FileUtil.copy( xmlFilename, xmlFilename + "_" + System.currentTimeMillis() );

		Document doc = DomParser.read( new File(xmlFilename) ) ;
		Element firstRoot = doc.getDocumentElement();
		deleteChildElements( firstRoot, "dbid" );

		if( dbidVals != null && dbidVals.length > 0 ) {
		 	// 5.6.7.0 (2013/07/27) 内部MapをDBConfig.xmlの読み込み順に変更(なので、廃止)。
//			dbidSort( dbidVals );
			for( int i=0; i<dbidVals.length; i++ ) {
				Element newEle = doc.createElement( "dbid" );
				for( int j=0; j<dbidVals[i].length; j++ ) {
					Element newChEle = doc.createElement( DBID_INFO_KEYS[j] );
					newChEle.setTextContent( dbidVals[i][j] );
					newEle.appendChild( newChEle );
				}
				firstRoot.appendChild( newEle );
				firstRoot.appendChild( doc.createTextNode( "\n\n" ) );
			}
		}

		DomParser.write( new File(xmlFilename), doc );

		reload();		// 5.6.7.0 (2013/07/27) DBIDの属性情報のリストを更新後、初期化します。
	}

	/**
	 * DBIDの配列をソートします。
	 * ソートの方法としては、
	 *  ①DEFAULTのDBIDは一番初め
	 *  ②DEFAULT以外は、DBID順
	 * となります。
	 *
	 * @og.rev 5.6.7.0 (2013/07/27) 内部MapをDBConfig.xmlの読み込み順に変更(なので、廃止)。
	 *
	 * @param dbidVals 全てのDBIDの属性情報のリスト(配列)
	 */
//	private static void dbidSort( final String[][] dbidVals ) {
//		Arrays.sort( dbidVals, new Comparator<String[]>() {
//			 public int compare( String[] s1, String[] s2 ) {
//				 if( "DEFAULT".equals( s1[0] ) ) {
//					 return -1;
//				 }
//				 else if( "DEFAULT".equals( s2[0] ) ) {
//					 return 1;
//				 }
//				 return s1[0].compareTo( s2[0] );
//			 }
//		}
//		);
//	}

	/**
	 * DBドライバーの属性キーを返します。
	 *
	 * @og.rev 5.1.9.0 (2010/08/01) 新規作成
	 *
	 * @return	DBドライバーの属性キー
	 */
	public static String getDriverKey() {
		return DBDRIVER_CLASS_KEY;
	}

	/**
	 * DBドライバーのリスト(配列)を返します。
	 *
	 * @og.rev 5.1.9.0 (2010/08/01) 新規作成
	 * @og.rev 5.6.7.0 (2013/07/27) driverList を書き込むのではなく、作成します。
	 *
	 * @return	DBドライバーリスト(配列)
	 */
	public synchronized String[] getDriverList() {
//		Element ele = DomParser.read( new File(xmlFilename) ).getDocumentElement();
//		String [] rtn = getDriverList( ele ).toArray( new String[0] );

		String [] rtn = driverList.toArray( new String[driverList.size()] );
//		driverSort( rtn );
		return rtn;
	}

	/**
	 * DBドライバーのリスト(配列)をセットします。
	 *
	 * このメソッドを呼び出すと、DBConfig.xmlで定義されているclass一覧を"一旦削除し"、
	 * その上で、引数のDBドライバー一覧をDBConfig.xmlに書き込みます。
	 *
	 * 書き込みの直前に、同じフォルダにタイムスタンプを付加したバックアップファイルを作成します。
	 *
	 * @og.rev 5.1.9.0 (2010/08/01) 新規作成
	 * @og.rev 5.6.7.0 (2013/07/27) DBドライバーのリストを更新後、初期化します。
	 *
	 * @param drivers DBドライバーのリスト(配列)
	 */
	public void setDriverList( final String[] drivers ) {
		FileUtil.copy( xmlFilename, xmlFilename + "_" + System.currentTimeMillis() );

		Document doc = DomParser.read( new File(xmlFilename) );
		Element firstRoot = doc.getDocumentElement();

		Element parent = (Element)firstRoot.getElementsByTagName( "dbDriver" ).item( 0 );
		deleteChildElements( parent, "class" );

		if( drivers != null && drivers.length > 0 ) {
//			driverSort( drivers );
			for( int i=0; i<drivers.length; i++ ) {
				Element newEle = doc.createElement( "class" );
				newEle.setTextContent( drivers[i] );
				parent.appendChild( newEle );
			}
		}

		DomParser.write( new File(xmlFilename), doc );

		reload();		// 5.6.7.0 (2013/07/27) DBドライバーのリストを更新後、初期化します。
	}


	/**
	 * DBID情報のキーとタイトルから、プルダウンメニューを作成するための情報を取得します。
	 *
	 * このメソッドを呼び出すと、DBConfig.xmlで定義されている dbidKey と、 title 属性から、
	 * 「key1:val1 key2:val2 ・・・」という文字列を作成します。
	 * これを利用すれば、プルダウンメニューが簡単に作成できます。
	 *
	 * @og.rev 5.6.7.0 (2013/07/27) プルダウンメニュー用の情報を作成します。
	 * @og.rev 5.6.7.1 (2013/08/09) 表題(title)属性のスペース対策
	 *
	 * @return プルダウンメニューを作成するための情報
	 */
	public synchronized String getCodeKeyVal() {
		if( codeKeyVal == null ) {
			StringBuilder buf = new StringBuilder();
			for( EDbid dbid : dbidMap.values() ) {
				String key = dbid.getDbidKey();
				String lbl = StringUtil.nval( dbid.getTitle() , key );
//				buf.append( " " ).append( key ).append( ":" ).append( lbl );
				if( lbl.indexOf( ' ' ) >= 0 ) {									// 5.6.7.1 (2013/08/09) スペース対策
					buf.append( " " ).append( key ).append( ":\"" ).append( lbl ).append( "\"" );
				}
				else {
					buf.append( " " ).append( key ).append( ":" ).append( lbl );
				}
			}

			codeKeyVal = buf.substring( 1 );		// 先頭のスペースを削除
		}

		return codeKeyVal;
	}

	/**
	 * DBドライバーの配列をソートします。
	 * ソートの方法としては、
	 *  ①DEFAULT_DRIVERのDBは一番初め
	 *  ②DEFAULT以外は、DBID順
	 * となります。
	 *
	 * @og.rev 5.6.7.0 (2013/07/27) 内部ListをDBConfig.xmlの読み込み順に変更(なので、廃止)。
	 *
	 * @param drivers 全てのDBIDの属性情報のリスト(配列)
	 */
//	private static void driverSort( final String[] drivers ) {
//		Arrays.sort( drivers, new Comparator<String>() {
//			 public int compare( String s1, String s2 ) {
//				 if( DEFAULT_DRIVER.equals( s1 ) ) {
//					 return -1;
//				 }
//				 else if( DEFAULT_DRIVER.equals( s2 ) ) {
//					 return 1;
//				 }
//				 return s1.compareTo( s2 );
//			 }
//		}
//		);
//	}

	/**
	 * 親要素を基点として、引数で指定されたタグ名を持つ子要素を削除します。
	 *
	 * @og.rev 5.6.7.0 (2013/07/27) staticメソッド を イスタンスメソッドに変更
	 *
	 * @param parent 親要素
	 * @param childTagName 削除する子要素のタグ名
	 */
//	private static void deleteChildElements( final Element parent, final String childTagName ) {
	private void deleteChildElements( final Element parent, final String childTagName ) {
		Node child = parent.getFirstChild();
		boolean isDel = false;
		while ( child != null ) {
			// エレメント間の改行Cも削除するため、次の異なる要素が来るまでは削除し続けます。
			if( child.getNodeType() == Node.ELEMENT_NODE ) {
//				if( ((Element)child).getTagName().equals( childTagName ) ) {
				if( ((Element)child).getTagName().equalsIgnoreCase( childTagName ) ) {
					isDel = true;
				}
				else {
					isDel = false;
				}
			}

			Node next = child.getNextSibling();
			if( isDel ) {
				parent.removeChild( child );
			}
			child = next;
		}
	}
}
