/*
 * 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.hayabusa.taglib;

import java.io.BufferedInputStream;
import java.io.ByteArrayInputStream;
import java.io.ByteArrayOutputStream;
import java.io.File;
import java.io.IOException;
import java.io.InputStream;
import java.io.StringReader;									// 6.9.0.0 (2018/01/31)
import java.io.Writer;
import java.util.Map;

import org.opengion.fukurou.system.LogWriter;
import org.opengion.fukurou.system.Closer;
import org.opengion.fukurou.system.HybsConst;					// 6.4.5.2 (2016/05/06)
import org.opengion.fukurou.util.FileUtil;
import org.opengion.fukurou.util.ToString;						// 6.1.1.0 (2015/01/17)
import org.opengion.fukurou.util.ArraySet;						// 5.10.10.0 (2019/03/29)
// import org.opengion.fukurou.util.SOAPConnect;				// 6.9.0.0 (2018/01/31) SOAPConnect 廃止に伴う修正
import org.opengion.fukurou.util.StringUtil;
// import org.opengion.fukurou.util.URLConnect;					// 6.9.0.0 (2018/01/31) URLConnect 廃止
import org.opengion.fukurou.util.HttpConnect;					// 6.9.0.0 (2018/01/31) 新規追加
// import org.opengion.fukurou.util.XHTMLTag;
import org.opengion.fukurou.xml.XML2TableParser;
import org.opengion.fukurou.xml.XSLT;
import org.opengion.hayabusa.common.HybsSystem;
import org.opengion.hayabusa.common.HybsSystemException;
import org.opengion.hayabusa.db.DBTableModel;
import org.opengion.hayabusa.db.DBTableModelUtil;

import static org.opengion.fukurou.util.StringUtil.nval;

import java.util.Set;											// 5.10.10.0 (2019/03/29)

/**
 * 指定のURLに接続します。
 *
 * エンジンでは、URL にアクセスすることで、デーモンを起動したり、
 * コマンドを実行(adminメニュー)することが出来ます。
 * もちろん、検索条件を指定して、結果を取得することも可能です。
 * このタグでは、URLにアクセスして、コマンドを実行したり結果を取得できます。
 * さらに、ファイルを POST で転送したり、処理結果を XSLT変換したり出来ます。
 *
 * @og.formSample
 * ●形式：
 *     &lt;og:urlConnect
 *         url           = "http://･･･ "    必須
 *         proxyHost     = "proxy.opengion.org"
 *         proxyPort     = "8080"
 *         timeout       = "1"
 *         keys          = "command,SYSTEM_ID"
 *         vals          = "NEW,GE"
 *         useSystemUser = "true/false"     初期値:true
 *         authUserPass  = "admin:******"   初期値:admin:******
 *         display       = "false/true"     初期値:false
 *         xslFile       = "filter.xsl"
 *         saveFile      = "outdata.xml"
 *    ×   soapNameSpace = "MyWebService"	6.9.0.0 (2018/01/31) 廃止
 *    ×   soapMethodName= "test"			6.9.0.0 (2018/01/31) 廃止
 *         tableId       = "DEFAULT"
 *         rowKey        = "item"
 *         colKeys       = "person_id,person_name"
 *         rtnKeys       = "version,summary"
 *         encode        = "UTF-8"
 *     /&gt;
 *
 * url           : 接続するURLを指定します。必須属性です。
 * proxyHost     : proxy が存在する場合は、そのホスト名(例：proxy.opengion.org)
 * proxyPort     : proxy が存在する場合は、そのポート番号(例：8080)
 * timeout       : 通信リンクのオープン時に、指定された秒単位のタイム・アウト値を使用(例：1)
 * keys,vals     : URLの指定時に、パラメータ(引数)を追加します。URLに含めても構いません。
 *               : SOAPによる呼び出しの場合の詳細については、keysの属性定義を参照して下さい。
 * postKey       : POST を使って、postFile属性のファイル内容を送信する時のキーです。
 * postFile      : POST を使って、postFile属性のファイル内容を送信します。
 *                 postFile を指定せず、postKey のみ指定して、BODY部に何か書き込めば、
 *                 そのBODY部の文字列を POSTの内容として送信します。
 * authUserPass  : Basic認証を使用する場合の接続ユーザー：パスワードを指定します。
 *                 接続時のユーザーとパスワードを、USER:PASSWD 形式 で指定します。
 *                 useSystemUser="false" で何も指定しない場合は、Basic認証を使用しません。
 * useSystemUser : Basic認証の接続ユーザー：パスワードに、システムユーザーを使用
 *                 するかどうかを指定します(初期値:true)。
 *                 true の場合は、SYSTEM:***** を使用します。
 * xslFile       : 接続先データを取得し、そのデータを XSLT変換する場合のXSLファイルを指定します。
 * display       : 接続した結果のレスポンスを画面に表示するかどうかを指定します(初期値:false)。
 *                 エンジンの場合、コマンドを投げるだけであれば、結果を取得する必要は
 *                 ありません。イメージ的には、取得データが、このタグの位置に置き換わります。
 *                 xslFile が指定されている場合、XSLT変換してセーブします。
 * saveFile      : 接続先データを取得した結果を、ファイル出力します。
 *                 display="true" と、saveFile を併用することはできません。
 *                 xslFile が指定されている場合、XSLT変換してセーブします。
 * X soapNameSpace : 廃止：SOAPによるWebサービスの呼び出しで、メソッド名及びパラメーターの名前空間を指定します。
 *                 この名前空間は、通常WSDLファイルのdescriptionsタグのtargetNamespace属性の値により
 *                 定義されます。  6.9.0.0 (2018/01/31) 廃止
 * X soapMethodName: 廃止：SOAPによるWebサービスの呼び出しで、メソッド名を指定します。
 *                 WSDLファイルで定義されるoperationタグのname属性の値に相当します。 6.9.0.0 (2018/01/31) 廃止
 * tableId       : 結果のXMLファイルをDBTableModelに変換した際に、登録するTableIdを指定します。
 * rowKey        : XMLをDBTableModelに変換する際の、行を表すタグキーを指定します。
 * colKeys       : XMLをDBTableModelに変換する際の、項目を表すタグキーの一覧を指定します。
 *                 キーにPARENT_TAG、PARENT_FULL_TAGを指定することで、rowKeyで指定されたタグの
 *                 直近の親タグ、及びフルの親タグ名(親タグの階層を"&gt;[タグA]&gt;[タグB]&gt;[タグC]&gt;"で表現)を
 *                 取得することができます。
 * rtnKeys       : XMLのタグキーを指定して値を取り出します。取り出した値は、{&#064;XX}形式で処理することが可能です。
 * encode        : データの入出力を行うエンコードを指定します。
 *
 * ●body：あり(EVAL_BODY_BUFFERED:BODYを評価し、{&#064;XXXX} を解析します)
 *         POSTデータを記述します。
 *
 * ●Tag定義：
 *   &lt;og:urlConnect
 *       url              ○【TAG】アクセスする ＵＲＬ を指定します(必須)(必須)。
 *       proxyHost          【TAG】プロキシ経由で接続する場合の、プロキシホスト名を指定します
 *       proxyPort          【TAG】プロキシ経由で接続する場合の、プロキシポート番号を指定します
 *       timeout            【TAG】通信リンクのオープン時に、指定された秒単位のタイム・アウト値を使用
 *                                  (初期値:URL_CONNECT_TIMEOUT[={@og.value SystemData#URL_CONNECT_TIMEOUT}])。)
 *       keys               【TAG】アクセスパラメータキーをCSV形式で複数指定します
 *       vals               【TAG】keys属性に対応する値をCSV形式で複数指定します
 *       useSystemUser      【TAG】Basic認証で接続するユーザーにSYSTEMユーザーを使用するかどうか[true/false]を指定します(初期値:true)
 *       authUserPass       【TAG】Basic認証を使用して接続する場合のユーザー:パスワードを指定します(初期値:null)
 *       display            【TAG】接続の結果を表示するかどうかを指定します(初期値:false)
 *       xslFile            【TAG】接続の結果を表示する場合にXSLT変換する場合のファイルを指定します
 *       saveFile           【TAG】接続の結果をファイルに保存します
 *       postKey            【TAG】POST を使って、postFile属性のファイル内容を送信する時のキーを指定します
 *       postFile           【TAG】POST を使って、postFile属性のファイル内容を送信します
 *       method             【TAG】送信メソッド[GET/POST/PUT/DELETE/SOAP]を指定します(初期値:GET)
 *       errNeglect         【TAG】(通常は使いません) 接続エラーを無視する場合にtrueとします(初期値false)
 *       tableId            【TAG】(通常は使いません)結果のDBTableModelを、sessionに登録するときのキーを指定します
 *       scope              【TAG】キャッシュする場合のスコープ[request/page/session/application]を指定します(初期値:session)
 *       rowKey             【TAG】結果のXMLをDBTableModelに変換する際に、行のキーとなるタグ名を指定します
 *       colKeys            【TAG】結果のXMLをDBTableModelに変換する際に、項目のキーとなるタグ名の一覧を指定します
 *       rtnKeys            【TAG】結果のXMLを変換する際に、パラメータ(Attributes)として取り込むキーの一覧を指定します
 *       encode             【TAG】データの入出力のエンコードを指定します(初期値:UTF-8)
 *       mainTrans          【TAG】(通常は使いません)タグで処理される処理がメインとなるトランザクション処理かどうかを指定します(初期値:false)
 *       storageType		【TAG】保存先ストレージタイプを指定します 5.10.9.0 (2019/03/01)
 *       bucketName			【TAG】保存先バケット名を指定します 5.10.9.0 (2019/03/01)
 *       propKeys           【TAG】コネクションのrequestParameterに渡すキーをCSV形式で複数指定します。 5.10.16.0 (2019/10/04)
 *       propVals           【TAG】コネクションのrequestParameterに渡す値をCSV形式で複数指定します。 5.10.16.0 (2019/10/04)
 *       postDataOnly       【TAG】trueの場合はキ-=値から、値のみ送信に変更します。(jsonを送信する場合等に利用) 5.10.19.0 (2019/12/27)
 *       caseKey            【TAG】このタグ自体を利用するかどうかの条件キーを指定します(初期値:null) 5.7.7.2 (2014/06/20)
 *       caseVal            【TAG】このタグ自体を利用するかどうかの条件値を指定します(初期値:null) 5.7.7.2 (2014/06/20)
 *       caseNN             【TAG】指定の値が、null/ゼロ文字列 でない場合(Not Null=NN)は、このタグは使用されます(初期値:判定しない) 5.7.7.2 (2014/06/20)
 *       caseNull           【TAG】指定の値が、null/ゼロ文字列 の場合は、このタグは使用されます(初期値:判定しない) 5.7.7.2 (2014/06/20)
 *       caseIf             【TAG】指定の値が、true/TRUE文字列の場合は、このタグは使用されます(初期値:判定しない)
 *       debug              【TAG】デバッグ情報を出力するかどうか[true/false]を指定します(初期値:false)
 *   &gt;   ... Body ...
 *   &lt;/og:urlConnect&gt;
 *
 * 【廃止】6.9.0.0 (2018/01/31) 物理削除
 *   //  soapNameSpace      【廃止】SOAPによるWebサービスの呼び出しで、メソッド名及びパラメーターの名前空間を指定します ( 6.9.0.0 (2018/01/31) SOAPConnect 廃止に伴う修正)
 *   //  soapMethodName     【廃止】SOAPによるWebサービスの呼び出しで、メソッド名を指定します ( 6.9.0.0 (2018/01/31) SOAPConnect 廃止に伴う修正)
 *
 * ●例：
 * アドミン関連
 * http://localhost:8823/gf/jsp/admin?COMMAND=infomation     [状況表示]
 * http://localhost:8823/gf/jsp/admin?COMMAND=close          [プール削除]
 * http://localhost:8823/gf/jsp/admin?COMMAND=loginUser      [ログインユーザー]
 * http://localhost:8823/gf/jsp/admin?COMMAND=システムパラメータ [システムパラメータ]
 *
 * 帳票デーモン
 * http://localhost:8823/gf/jsp/REP08/result.jsp?cmd=SET&amp;period=5000&amp;command=NEW&amp;timerTask=org.opengion.hayabusa.report.ReportDaemon&amp;name=ReportDaemon  デーモン起動
 * http://localhost:8823/gf/jsp/REP08/result.jsp?cmd=CANCEL&amp;period=5000&amp;command=NEW&amp;timerTask=org.opengion.hayabusa.report.ReportDaemon&amp;name=ReportDaemon  デーモン停止
 *
 *Tomcat Manager 画面
 * http://localhost:8823/manager/reload?path=/ver4 アプリケーションを再ロード
 *
 * ●その他:
 * DB.ERR_CODEに、実行結果のHTTPステータスコードを設定します。
 *
 * @og.rev 3.6.0.0 (2004/09/17) 新規作成
 * @og.rev 4.1.0.0 (2007/12/22) POSTメソッドで複数キーを登録できるように属性追加
 * @og.rev 5.1.5.0 (2010/04/01) SOAP対応
 * @og.rev 6.9.0.0 (2018/01/31) SOAPConnect 廃止に伴う修正
 * @og.group その他部品
 *
 * @version  4.0
 * @author   Kazuhiko Hasegawa
 * @since    JDK5.0,
 */
public class URLConnectTag extends CommonTagSupport {
	/** このプログラムのVERSION文字列を設定します。	{@value} */
	private static final String VERSION = "6.9.0.1 (2018/02/05)" ;
	private static final long serialVersionUID = 690120180205L ;

//	private static final String DEFAULT_USER = "SYSTEM:MANAGER" ;
	private static final String DEFAULT_USER = "admin:admin" ;			// 6.9.0.1 (2018/02/05) この際、変更しておきます。

//	private static final String[] POST_LIST = new String[] { "POST","PUT","DELETE" };		// 5.10.10.0 (2019/03/29)
	private static final Set<String> POST_SET = new ArraySet<>( "POST","PUT","DELETE" );	// 5.10.10.0 (2019/03/29)

	private transient DBTableModel table;			// 5.1.5.0 (2010/04/01) DBTableModel出力対応

	private String		urlStr			;
	private String[]	keys			;
	private String[]	vals			;
	private String		xslFile			;
	private String		saveFile		;
	private String		postKey			;
	private String		postData		;			// postFile ファイルか、BODY部
	private int			timeout			= HybsSystem.sysInt( "URL_CONNECT_TIMEOUT" );	// 6.2.5.0 (2015/06/05) 新規追加
	private boolean 	useSystemUser	= true;
	private String		authUserPass	;
	private boolean 	display			;
	private String		proxyHost		;			// 4.0.0 (2007/07/25)
	private int 		proxyPort		= -1;		// 4.0.0 (2007/07/25)
	private String		method			= "GET";	// 4.1.0.0 (2007/12/22) POSTorGETorSOAP
	private boolean		errNglctFlag	;			// 4.1.1.0 (2008/01/22) エラー無視フラグ
//	private String		soapNameSpace	;			// 5.1.5.0 (2010/04/01) SOAP対応	// 6.9.0.0 (2018/01/31) SOAPConnect 廃止に伴う修正
//	private String		soapMethodName	;			// 5.1.5.0 (2010/04/01) SOAP対応	// 6.9.0.0 (2018/01/31) SOAPConnect 廃止に伴う修正
	private String		tableId			= HybsSystem.TBL_MDL_KEY; // 5.1.5.0 (2010/04/01) DBTableModel出力対応
	private String		rowKey			;			// 5.1.5.0 (2010/04/01) DBTableModel出力対応
	private String[]	colKeys			;			// 5.1.5.0 (2010/04/01) DBTableModel出力対応
	private String[]	rtnKeys			;			// 5.1.5.0 (2010/04/01) DBTableModel出力対応
	private String		encode			= "UTF-8";	// 5.1.6.0 (2010/05/01) エンコード指定対応

	private boolean		isTableOut		;			// 5.1.5.0 (2010/04/01) DBTableModel出力対応
	private boolean		isOutParse		;			// 5.1.5.0 (2010/04/01) DBTableModel出力対応
	private boolean		isMainTrans		= true;		// 5.1.6.0 (2010/05/01) DBLastSqlの処理の見直し

	private String		storageType		;			// 5.10.9.0 (2019/03/01) ADD
	private String		bucketName		;			// 5.10.9.0 (2019/03/01) ADD
	private String		contentType		;			// 5.10.10.2 (2019/04/12)

	private String		propKeys		;			// 5.10.16.0 (2019/10/04)
	private String		propVals		;			// 5.10.16.0 (2019/10/04)
	private boolean		postDataOnly	;			// 5.10.19.0 (2019/12/27) postDataOnly対応 ････ Ver7では未対応

	/**
	 * デフォルトコンストラクター
	 *
	 * @og.rev 6.4.2.0 (2016/01/29) PMD refactoring. Each class should declare at least one constructor.
	 */
	public URLConnectTag() { super(); }		// これも、自動的に呼ばれるが、空のメソッドを作成すると警告されるので、明示的にしておきます。

	/**
	 * Taglibの開始タグが見つかったときに処理する doStartTag() を オーバーライドします。
	 *
	 * @og.rev 5.1.5.0 (2010/04/01) SOAP・DBTableModel出力対応
	 * @og.rev 5.1.6.0 (2010/05/01) DBLastSqlの処理は、DBTableModelが新規作成された処理でのみ行う。
	 * @og.rev 5.7.7.2 (2014/06/20) caseKey,caseVal,caseNN,caseNull 属性を追加
	 *
	 * @return	後続処理の指示
	 */
	@Override
	public int doStartTag() {
		// 5.7.7.2 (2014/06/20) caseKey,caseVal,caseNN,caseNull 属性を追加
		if( !useTag() ) { return SKIP_BODY ; }

		// 5.1.5.0 (2010/04/01) DBTableModel出力対応
		if( rowKey != null || colKeys != null || rtnKeys != null ) {
			isOutParse = true;
			if( rowKey != null || colKeys != null ) {
				isTableOut = true;
				useMainTrans( isMainTrans );			// 5.1.6.0 (2010/05/01) DBLastSqlの処理の見直し
				startQueryTransaction( tableId );
			}
		}

		// 5.1.5.0 (2010/04/01) SOAPの場合は、postKeyが指定されない。
		// 6.4.1.1 (2016/01/16) PMD refactoring. Avoid if (x != y) ..; else ..;
		return postData == null ? EVAL_BODY_BUFFERED : SKIP_BODY ;
	}

	/**
	 * Taglibのタグ本体を処理する doAfterBody() を オーバーライドします。
	 *
	 * @return	後続処理の指示(SKIP_BODY)
	 */
	@Override
	public int doAfterBody() {
		postData = getBodyString();

		return SKIP_BODY ;
	}

	/**
	 * Taglibの終了タグが見つかったときに処理する doEndTag() を オーバーライドします。
	 *
	 * @og.rev 4.0.1.0 (2007/12/12) PostKeys,PostVals処理を追加
	 * @og.rev 5.1.5.0 (2010/04/01) SOAP・DBTableModel出力対応
	 * @og.rev 5.2.0.0 (2010/09/01) エラー処理でNullPointerExceptionが発生するバグを修正
	 * @og.rev 5.7.7.2 (2014/06/20) caseKey,caseVal,caseNN,caseNull 属性を追加
	 * @og.rev 6.3.8.0 (2015/09/11) FileUtil#getPrintWriter( OutputStream,String ) を使用。
	 * @og.rev 6.9.0.0 (2018/01/31) URLConnect 廃止、HttpConnect に置き換えます。
	 * @og.rev 6.9.0.1 (2018/02/05) IOException を、Throwable に変更して、すべてのｴﾗｰをキャッチするようにします。
	 * @og.rev 5.10.19.0 (2019/12/27) 結果コードをDB.ERR_CODEに設定
	 *
	 * @return	後続処理の指示
	 */
	@Override
	public int doEndTag() {
		debugPrint();		// 4.0.0 (2005/02/28)

		// 5.7.7.2 (2014/06/20) caseKey,caseVal,caseNN,caseNull 属性を追加
		if( !useTag() ) { return EVAL_PAGE ; }

//		URLConnect conn = null;
		HttpConnect conn = null;						// 6.9.0.0 (2018/01/31) URLConnect 廃止、HttpConnect に置き換えます。
		ByteArrayOutputStream pipeOut = null;
		Writer outWriter = null;						// 6.3.8.0 (2015/09/11) rty の外に移動
		try {
			conn = connect();

			// 5.10.19.0 (2019/12/27) ADD
			setRequestAttribute( "DB.ERR_CODE", String.valueOf( conn.getCode() ) );

			// 出力先が、画面かファイルかを判断します。
			// 5.1.5.0 (2010/04/01) DBTableModel出力対応
			if( isOutParse ) {
		        pipeOut = new ByteArrayOutputStream();
					// 6.3.8.0 (2015/09/11) FileUtil#getPrintWriter( OutputStream,String ) を使用。
					outWriter = FileUtil.getPrintWriter( pipeOut, "UTF-8" );		// 6.3.8.0 (2015/09/11)
			}
			else if( display ) {
				outWriter = FileUtil.getNonFlushPrintWriter( pageContext.getOut() ) ;	// JspWriter の取得
			}
			else if( saveFile != null ) {
				outWriter = FileUtil.getPrintWriter( new File( saveFile ),"UTF-8" );
			}

			final String rtnData = conn.readData();		// 6.9.0.1 (2018/02/05)

			// 出力先が存在する場合。
			if( outWriter != null ) {
				// 6.4.1.1 (2016/01/16) PMD refactoring. Avoid if (x != y) ..; else ..;
				if( xslFile == null ) {
					outWriter.write( rtnData );
				}
				else {
					final XSLT xslt = new XSLT();
					xslt.setXslFile( xslFile );
					xslt.setOutFile( outWriter );
//					xslt.transform( conn.getReader() );
					xslt.transform( new StringReader( rtnData ) );		// 6.9.0.0 (2018/01/31) ﾘｰﾀﾞｰが取り出せないので、文字列から作成します。
					xslt.close();
				}
			}
		}
//		catch( final IOException ex ) {
		catch( final Throwable th ) {							// 6.9.0.1 (2018/02/05)
			final String errMsg = "データ取得中にエラーが発生しました。" 	+ CR
						+ " url=[" + urlStr + "]"							+ CR
						// 5.2.0.0 (2010/09/01) エラー処理でNullPointerExceptionが発生するバグを修正
						+ " message=[" + ( conn == null ? "NO_CONNECTION" : conn.getMessage() ) + "]" + CR
						+ " Exception=[" + th.getMessage() + "]" ;
			if( errNglctFlag ) { // 4.1.1.0 (2008/01/22) エラーを無視(標準エラー出力のみ)
				LogWriter.log( errMsg );
			}
			else { // 通常は無視しない
				throw new HybsSystemException( errMsg,th );
			}
		}
		finally {
			Closer.ioClose( outWriter );						// 6.3.8.0 (2015/09/11) finally に移動
//			if( conn != null ) { conn.disconnect(); }
		}

		// 5.1.5.0 (2010/04/01) DBTableModel出力対応
		if( isOutParse ) {
			// 6.3.8.0 (2015/09/11) AutoCloseableを使用したtry-with-resources構築に対応
			try( InputStream strm = new BufferedInputStream( new ByteArrayInputStream( pipeOut.toByteArray() ) ) ) {
				parse( strm );
			}
			// 6.3.8.0 (2015/09/11) 今まで不要だった、IOException が発生。AutoCloseable のせい？。
			catch( final IOException ex ) {		// catch は、close() されてから呼ばれます。
				final String errMsg = "parse 処理中でエラーが発生しました。"	+ CR
							+ "\t close() エラーです。"							+ CR
							+ "\t " + ex.getMessage()							+ CR ;
				System.err.println( errMsg );
			}

			if( isTableOut && table != null && !commitTableObject( tableId, table ) ) {
				jspPrint( "URLConnectTag Query処理が割り込まれました。DBTableModel は登録しません。" );
				return SKIP_PAGE ;
			}
		}

		return EVAL_PAGE ;
	}

	/**
	 * URLに対して接続を行います。
	 *
	 * @og.rev 5.1.6.0 (2010/05/01) エンコード指定対応
	 * @og.rev 6.2.5.0 (2015/06/05) timeout属性追加
	 * @og.rev 6.9.0.0 (2018/01/31) SOAPConnect 廃止に伴う修正
	 * @og.rev 6.9.0.0 (2018/01/31) URLConnect 廃止、HttpConnect に置き換えます。
	 * @og.rev 5.10.10.0 (2019/03/19) PUT.DELETE対応
	 * @og.rev 5.10.10.2 (2019/04/12) contentType
	 * @og.rev 5.10.16.0 (2019/10/04) propKeys,propVals指定追加
	 * @og.rev 5.10.19.0 (2019/12/27) postDataOnly対応 ････ Ver7では未対応
	 *
	 * @return 接続オブジェクト
	 * @throws IOException 入出力エラーが発生したとき
	 */
//	private URLConnect connect() throws IOException {
	private HttpConnect connect() throws IOException {
		if( useSystemUser ) { authUserPass = DEFAULT_USER; }

		// 5.1.5.0 (2010/04/01) SOAP対応
		// SOAPの場合、PostDataは、SOAPConnectタグの中で生成します。
//		URLConnect conn = null;
		HttpConnect conn = null;									// 6.9.0.0 (2018/01/31)
		// 6.9.0.0 (2018/01/31) SOAPConnect 廃止に伴う修正
//		if( "SOAP".equalsIgnoreCase( method ) ) {
//			if( soapNameSpace == null || soapNameSpace.isEmpty()
//					|| soapMethodName == null || soapMethodName.isEmpty() ) {
//				final String errMsg = "SOAP接続の場合、soapNameSpace及びsoapMethodNameは必ず指定して下さい。";
//				throw new HybsSystemException( errMsg );
//			}
//
//			if( postData != null && postData.length() > 0 ) {
//				conn = new SOAPConnect( urlStr,authUserPass, soapNameSpace, soapMethodName, postData );
//			}
//			else {
//				conn = new SOAPConnect( urlStr,authUserPass, soapNameSpace, soapMethodName, keys, vals );
//			}
//		}
//		else {
			conn = new HttpConnect( urlStr,authUserPass );		// HttpConnect は、GET でも後付で引数を渡せます。

			conn.setDebug( isDebug() );

			if( keys != null ) {
				for( int i=0; i<keys.length; i++ ) {
					conn.addRequestProperty( keys[i] , vals[i] );
				}
			}

//			if( "POST".equalsIgnoreCase( method ) ) { conn.usePost( true ); }		// 6.9.0.1 (2018/02/05)
			if( check( method,POST_SET ) ) { conn.usePost( true ); }				// 5.10.10.0 (2019/03/29)

//			String urlEnc = XHTMLTag.urlEncode( keys,vals );
			if( postKey != null ) { // 4.1.0.0 (2007/12/22)
//				method = "POST";
//				urlEnc = urlEnc + "&" + postKey + "=" + postData;	// &連結
				conn.usePost( true );		// 6.9.0.1 (2018/02/05)
				conn.addRequestProperty( postKey , postData );
				if( check( method,POST_SET ) && !"POST".equalsIgnoreCase( method ) ) {
					conn.addHeaderProperty( "X-HTTP-Method-Override" , method );		// 5.10.10.0 (2019/03/29)
				}
			}

//			if( ! "POST".equals( method ) ) { // 4.1.0.0 (2007/12/22)
//				// String urlEnc = XHTMLTag.urlEncode( keys,vals );
//				urlStr = XHTMLTag.addUrlEncode( urlStr,urlEnc );
//			}
//			conn = new URLConnect( urlStr,authUserPass );

			// if( postKey != null ) {
			//	conn.setPostData( postKey,postData );
			// }
//			if( "POST".equals( method ) && keys != null && vals != null ) { // 4.1.0.0 (2007/12/22)
//				conn.setPostData( urlEnc );
//			}
//		}

		// 4.0.0 (2007/07/25) プロキシの設定追加
		if( proxyHost != null ) {
			conn.setProxy( proxyHost,proxyPort );
		}

		// 5.1.6.0 (2010/05/01) エンコード指定対応
		if( encode != null && encode.length() > 0 ) {
			conn.setCharset( encode );
		}

		// 6.2.5.0 (2015/06/05) timeout属性追加
		if( timeout >= 0 ) {
			conn.setTimeout( timeout );
		}

		// 5.10.10.2 (2019/04/12)
		if( contentType != null && contentType.length() > 0 ){
			conn.addRequestProperty( "Content-Type", contentType );
//			conn.setConentType( contentType );
		}

		// 5.10.16.0 (2019/10/04)
		if( propKeys != null && propVals != null ) {
			conn.setRequestProperty( propKeys,propVals );
		}

//		conn.connect();

		return conn;
	}

	/**
	 * 出力データをパースし、DBTableModel及び属性パラメーターに分解します。
	 * 現時点では、XMLデータのみパースすることが可能です。
	 *
	 * @og.rev 6.4.3.4 (2016/03/11) forループを、forEach メソッドに置き換えます。
	 *
	 * @param input インプットストリーム
	 */
	private void parse( final InputStream input ) {
		final XML2TableParser parser = new XML2TableParser( input );
		parser.setTableCols( rowKey, colKeys );
		parser.setReturnCols( rtnKeys );
		parser.parse();

		// DBTableModelを生成します。
		if( isTableOut ) {
			table = DBTableModelUtil.makeDBTable( parser.getCols(), parser.getData(), getResource() );
		}

		// 戻り値を取得し、Attributeに登録します。
		if( rtnKeys != null ) {
			final Map<String,String> rtn = parser.getRtn();
			// 6.4.3.4 (2016/03/11) forループを、forEach メソッドに置き換えます。
			rtn.forEach( (k,v) -> setRequestAttribute( k,v ) );
		}
	}

	/**
	 * タグリブオブジェクトをリリースします。
	 * キャッシュされて再利用されるので、フィールドの初期設定を行います。
	 *
	 * @og.rev 5.1.6.0 (2010/05/01) DBLastSqlの処理は、DBTableModelが新規作成された処理でのみ行う。
	 * @og.rev 6.2.5.0 (2015/06/05) timeout属性追加
	 * @og.rev 6.9.0.0 (2018/01/31) SOAPConnect 廃止に伴う修正
	 * @og.rev 5.10.9.0 (2019/03/01) storageType,bucketNameの初期を追加
	 * @og.rev 5.10.10.2 (2019/04/12) contentTypeを追加
	 * @og.rev 5.10.16.0 (2019/10/04) propKeys,propVals指定追加
	 * @og.rev 5.10.19.0 (2019/12/27) postDataOnly対応 ････ Ver7では未対応
	 */
	@Override
	protected void release2() {
		super.release2();
		urlStr			= null;
		proxyHost		= null;		// 4.0.0 (2007/07/25)
		proxyPort		= -1;		// 4.0.0 (2007/07/25)
		keys			= null;
		vals			= null;
		xslFile			= null;
		saveFile		= null;
		postKey			= null;
		postData		= null;
		timeout			= HybsSystem.sysInt( "URL_CONNECT_TIMEOUT" );	// 6.2.5.0 (2015/06/05) 新規追加
		useSystemUser	= true;
		authUserPass	= null;
		display			= false;
		method			= "GET";	// 4.1.0.0 (2007/12/22)
		errNglctFlag	= false;	// 4.1.1.0 (2008/01/22)
//		soapNameSpace	= null;		// 5.1.5.0 (2010/04/01) SOAP対応	// 6.9.0.0 (2018/01/31) SOAPConnect 廃止に伴う修正
//		soapMethodName	= null;		// 5.1.5.0 (2010/04/01) SOAP対応	// 6.9.0.0 (2018/01/31) SOAPConnect 廃止に伴う修正
		table			= null;		// 5.1.5.0 (2010/04/01) DBTableModel出力対応
		tableId			= HybsSystem.TBL_MDL_KEY; // 5.1.5.0 (2010/04/01) DBTableModel出力対応
		rowKey			= null;		// 5.1.5.0 (2010/04/01) DBTableModel出力対応
		colKeys			= null;		// 5.1.5.0 (2010/04/01) DBTableModel出力対応
		rtnKeys			= null;		// 5.1.5.0 (2010/04/01) DBTableModel出力対応
		isTableOut		= false;	// 5.1.5.0 (2010/04/01) DBTableModel出力対応
		isOutParse		= false;	// 5.1.5.0 (2010/04/01) DBTableModel出力対応
		encode			= "UTF-8";	// 5.1.6.0 (2010/05/01) エンコード指定対応
		isMainTrans		= true;		// 5.1.6.0 (2010/05/01) DBLastSqlの処理の見直し
		storageType		= null;		// 5.10.9.0 (2019/03/01) ADD
		bucketName		= null;		// 5.10.9.0 (2019/03/01) ADD
		contentType		= null;		// 5.10.10.2 (2019/04/12)
		propKeys		= null;		// 5.10.16.0 (2019/10/04)
		propVals		= null; 	// 5.10.16.0 (2019/10/04)
		postDataOnly	= false;	// 5.10.19.0 (2019/12/27)
	}

	/**
	 * 【TAG】アクセスする接続先ＵＲＬを指定します。
	 *
	 * @og.tag
	 * 接続するＵＲＬを指定します。(例：http:// ･･････)
	 * ?以降のパラメータが含まれていても構いません。
	 * このURL に、keys,vals で指定されたパラメータも追加されます。
	 *
	 * @param	url	接続先
	 */
	public void setUrl( final String url ) {
		urlStr = nval( getRequestParameter( url ),urlStr );
	}

	/**
	 * 【TAG】プロキシ経由で接続する場合の、プロキシホスト名を指定します。
	 *
	 * @og.tag
	 * 接続先が、プロキシ経由の場合、プロキシのホスト名を指定します。
	 * 例：proxy.opengion.org
	 *
	 * @param	host	プロキシホスト名
	 */
	public void setProxyHost( final String host ) {
		proxyHost = nval( getRequestParameter( host ),proxyHost );
		useSystemUser = false;	// プロキシ接続時は、システムユーザーは使えません。
	}

	/**
	 * 【TAG】プロキシ経由で接続する場合の、プロキシポート番号を指定します。
	 *
	 * @og.tag
	 * 接続先が、プロキシ経由の場合、プロキシのポート番号を指定します。
	 * 例：8080
	 *
	 * @param	port	プロキシポート番号
	 */
	public void setProxyPort( final String port ) {
		proxyPort = nval( getRequestParameter( port ),proxyPort );
	}

	/**
	 * 【TAG】アクセスパラメータキーをCSV形式で複数指定します。
	 *
	 * @og.tag
	 * アクセスする ＵＲＬに追加するパラメータのキーを指定します。
	 * CSV形式で複数指定できます。
	 * vals 属性には、キーに対応する値を、設定してください。
	 * 例:<b>keys="command,SYSTEM_ID"</b> vals="NEW,GE"
	 * 分解方法は、CSV変数を先に分解してから、getRequestParameter で値を取得します。
	 * こうしないとデータ自身にカンマを持っている場合に分解をミスる為です。
	 *
	 * @og.rev 6.9.0.0 (2018/01/31) SOAPConnect 廃止に伴う修正
//	 * [SOAP対応]
//	 * SOAPによるWebサービスの呼び出しの場合、keys,valsに指定された値より、env:Envelopタグを
//	 * rootタグとするXMLデータを生成します。
//	 * (BODY部分に直接XMLデータを出力することも可能です。)
//	 * この際、項目名に'&gt;'を含めることで、階層的なXMLデータを表現することができます。
//	 * 例)
//	 *   [属性定義]
//	 *   keys="param0&gt;AAA,param0&gt;BBB,param1&gt;CCC,DDD"
//	 *   vals="v1,v2,v3,v4"
//	 *   [XMLデータ(※データ部のみ)]
//	 *   &lt;param0&gt;
//	 *     &lt;AAA&gt;v1&lt;/AAA&gt;
//	 *     &lt;BBB&gt;v2&lt;/BBB&gt;
//	 *   &lt;/param0&gt;
//	 *   &lt;param1&gt;
//	 *     &lt;CCC&gt;v3&lt;/CCC&gt;
//	 *   &lt;/param1&gt;
//	 *   &lt;DDD&gt;v4&lt;/DDD&gt;
//	 * 項目の値を"null"とすることで、XMLで言うところの「xsi:nil=\"true\"」のデータを表現すること
//	 * もできます。
//	 * また、キー名の先頭を'&#064;'にすることで、項目名に名前空間のPREFIXを付加することができます。
//	 * 一般的には、JavaやRubyで実装されたWebサービスを呼び出しする場合は、必要ありませんが、
//	 * .NETで実装されたWebサービスを呼び出しする場合は、各項目にPREFIXを付与しないと、正しく
/	 * パラメーターを渡すことができません。
//	 * ※現時点では、keysの階層定義は、2階層まで対応しています。
//	 *   3階層以上のXML構造を定義する場合は、postFile属性によるファイル指定又は、Body部分で直接
//	 *   XMLデータを記述して下さい。
	 *
	 * @param	key リンク先に渡すキー (CSV形式)
	 * @see		#setVals( String )
	 */
	public void setKeys( final String key ) {
		keys = getCSVParameter( key );
	}

	/**
	 * 【TAG】keys属性に対応する値をCSV形式で複数指定します。
	 *
	 * @og.tag
	 * キーに設定した値を、CSV形式で複数して出来ます。
	 * 指定順序は、キーと同じにしておいて下さい。
	 * 例:<b>keys="command,SYSTEM_ID"</b> vals="NEW,GE"
	 * 分解方法は、CSV変数を先に分解してから、getRequestParameter で値を取得します。
	 * こうしないとデータ自身にカンマを持っている場合に分解をミスる為です。
	 *
	 * @param	val 設定値 keys属性に対応する値(CSV形式)
	 * @see		#setKeys( String )
	 */
	public void setVals( final String val ) {
		vals = getCSVParameter( val );
	}

	/**
	 * 【TAG】送信メソッド[GET/POST]を指定します(初期値:GET)。
//	 * 【TAG】送信メソッド[GET/POST/SOAP]を指定します(初期値:GET)。
	 *
	 * @og.tag
	 * URLConnectTagのメソッドの初期設定はGETです。
	 * ここで"POST"(大文字)を指定するとkyes,valsの値セットをPOSTで送信します。
	 * (postKeyが設定されている場合はこの値に関係なくPOSTです)
	 *
	 * @og.rev 4.1.0.0 (2007/12/22) 新規作成
	 * @og.rev 6.9.0.0 (2018/01/31) SOAPConnect 廃止に伴う修正
	 *
	 * @param	post_get	送信メソッド [GET/POST]
//	 * @param	post_get	送信メソッド [GET/POST/SOAP]
	 */
	public void setMethod ( final String post_get ) {
		method = nval( getRequestParameter( post_get ), method );
	}

	/**
	 * 【TAG】Basic認証で接続するユーザーにSYSTEMユーザーを使用するかどうか[true/false]を指定します(初期値:true)。
	 *
	 * @og.tag
	 * useSystemUser="true"(初期値) の場合、URL接続時のコネクションに、Basic認証を
	 * 使用しますが、その時のユーザーにシステムユーザー(SYSTEM)を使用します。
	 * useSystemUser="false"の場合は、authUserPass で指定したユーザー：パスワードを
	 * 使用します。authUserPass で、何も指定されなかった場合は、Basic認証を使用しません。
	 * 初期値は、true(SYSTEMユーザー認証する) です。
	 *
	 * @param   flag SYSTEMユーザー認証 [true:SYSTEMユーザー認証する/false:この接続のユーザーで認証する]
	 * @see #setAuthUserPass( String )
	 */
	public void setUseSystemUser( final String flag ) {
		useSystemUser = nval( getRequestParameter( flag ),useSystemUser );
	}

	/**
	 * 【TAG】Basic認証を使用して接続する場合のユーザー:パスワードを指定します(初期値:null)。
	 *
	 * @og.tag
	 * 接続時のユーザーとパスワードを、USER:PASSWD 形式で指定します。
	 * useSystemUser="false"の場合は、ここで指定したユーザーとパスワードを使用します。
	 * その場合に、何も指定しない場合は、Basic認証を使用しません。
	 *
	 * @param	userPass	ユーザーとパスワード (USER:PASSWD形式)
	 * @see #setUseSystemUser( String )
	 */
	public void setAuthUserPass( final String userPass ) {
		authUserPass = nval( getRequestParameter( userPass ),authUserPass );
	}

	/**
	 * 【TAG】接続の結果を表示する場合にXSLT変換する場合のファイルを指定します。
	 *
	 * @og.tag
	 *
	 * 接続先のデータが、XML形式の場合、そのままでは、画面出力できない場合が
	 * あります。通常は、HTML形式に変換しますが、その変換に、 XSL ファイルを
	 * 指定することが可能です。
	 * display="true" の場合や、saveFile を指定した場合に、適用されます。
	 *
	 * @param	file	XSLTファイル
	 * @see #setSaveFile( String )
	 * @see #setDisplay( String )
	 */
	public void setXslFile( final String file ) {
		xslFile = HybsSystem.url2dir( nval( getRequestParameter( file ),xslFile ) );
	}

	/**
	 * 【TAG】接続の結果を表示するかどうかを指定します(初期値:false)。
	 *
	 * @og.tag
	 * true で、接続結果を表示します。 false では、何も表示しません(初期値:false)
	 * 接続結果を表示する使い方より、admin 画面に接続して、キャッシュクリアするような
	 * 使い方が多いと考え、初期値は、false になっています。
	 * xslFile が指定されている場合、XSLT変換して画面表示します。
	 * display="true" と、saveFile を併用することはできません。
	 *
	 * @param	flag	結果表示 [true:する/false:しない]
	 * @see #setSaveFile( String )
	 * @see #setXslFile( String )
	 */
	public void setDisplay( final String flag ) {
		display = nval( getRequestParameter( flag ),display );

		if( display && saveFile != null ) {
			final String errMsg = "display=\"true\" と、saveFile を併用することはできません。";
			throw new HybsSystemException( errMsg );
		}
	}

	/**
	 * 【TAG】接続の結果をファイルに保存します。
	 *
	 * @og.tag
	 * 接続先のデータを受け取って、ファイルに保存します。その場合、
	 * xslFile が指定されている場合、XSLT変換してセーブします。
	 * display="true" と、saveFile を併用することはできません。
	 *
	 * @param	file	保存先ファイル
	 * @see #setXslFile( String )
	 * @see #setDisplay( String )
	 */
	public void setSaveFile( final String file ) {
		saveFile = HybsSystem.url2dir( nval( getRequestParameter( file ),saveFile ) );

		if( display ) {
			final String errMsg = "display=\"true\" と、saveFile を併用することはできません。";
			throw new HybsSystemException( errMsg );
		}
	}

	/**
	 * 【TAG】POST を使って、postFile属性のファイル内容を送信する時のキーを指定します。
	 *
	 * @og.tag
	 * 接続先にパラメータ(引数)を投げる場合に、POST を使用できます。
	 * そのときの キーをここで指定します。
	 * POSTするデータは、postFileで指定されたファイルか、BODY部に記述された文字列です。
	 *
	 * @param	key	ファイル内容送信キー
	 * @see  #setPostFile( String )
	 */
	public void setPostKey( final String key ) {
		postKey = nval( getRequestParameter( key ),postKey );
	}

	/**
	 * 【TAG】接続タイムアウト時間を(秒)で指定します
	 *		(初期値:URL_CONNECT_TIMEOUT[={@og.value SystemData#URL_CONNECT_TIMEOUT}])。
	 *
	 * @og.tag
	 * 実際には、java.net.URLConnection#setConnectTimeout(int) に 1000倍して設定されます。
	 * 0 は、無限のタイムアウト、マイナスは、設定しません。(つまりJavaの初期値のまま)
	 * (初期値:システム定数のURL_CONNECT_TIMEOUT[={@og.value SystemData#URL_CONNECT_TIMEOUT}])。
	 *
	 * @og.rev 6.2.5.0 (2015/06/05) timeout属性追加
	 *
	 * @param	tout	タイムアウト時間(秒) (ゼロは、無制限)
	 * @see		org.opengion.fukurou.util.HttpConnect#setTimeout(int)
	 * @see		java.net.URLConnection#setConnectTimeout(int)
	 */
	public void setTimeout( final String tout ) {
		timeout = nval( getRequestParameter( tout ),timeout );
	}

	/**
	 * 【TAG】POST を使って、postFile属性のファイル内容を送信します。
	 *
	 * @og.tag
	 * 接続先にパラメータ(引数)を投げる場合に、POST を使用できます。
	 * そのときの 送信データのファイルをここで指定します。
	 * postKey のみ指定されて、postFile が指定されない場合は、BODY部を送信します。
//	 * SOAPによる呼び出しの場合は、ここ(BODY部での定義を含む)で、送信するXMLデータを
//	 * 定義することができます。
	 *
	 * @og.rev 6.4.5.1 (2016/04/28) FileStringのコンストラクター変更
	 * @og.rev 6.4.5.2 (2016/05/06) fukurou.util.FileString から、fukurou.util.FileUtil に移動。
	 * @og.rev 6.9.0.0 (2018/01/31) SOAPConnect 廃止に伴う修正
	 *
	 * @param	file	送信ファイル
	 * @see  #setPostKey( String )
	 */
	public void setPostFile( final String file ) {
		final String postFile = nval( getRequestParameter( file ),null );

		if( postFile != null ) {
			// 6.4.5.1 (2016/04/28) FileStringのコンストラクター変更
			postData = FileUtil.getValue( HybsSystem.url2dir( postFile ) , HybsConst.UTF_8 );
		}
	}

	/**
	 * 【TAG】(通常は使いません) 接続エラーを無視する場合にtrueとします(初期値false)。
	 *
	 * @og.tag
	 * trueにするとConnectで発生したエラーを投げずに処理を続行します。
	 * (標準エラー出力にエラー内容は出力されます)
	 * 接続エラーが発生しても処理を中断したくない場合に設定します。
	 *
	 * @og.rev 4.1.1.0 (2008/01/22) 新規追加
	 *
	 * @param	flag	エラーを無視するか [true:する/false:しない]
	 */
	public void setErrNeglect( final String flag ) {
		errNglctFlag = nval( getRequestParameter( flag ), errNglctFlag );
	}

//	/**
//	 * 【TAG】SOAPによるWebサービスの呼び出しで、メソッド名及びパラメーターの名前空間を指定します。
//	 *
//	 * @og.tag
//	 * SOAPによるWebサービスの呼び出しで、メソッド名及びパラメーターの名前空間を指定します。
//	 * この名前空間は、通常WSDLファイルのdescriptionsタグのtargetNamespace属性の値により
//	 * 定義されます。
//	 *
//	 * @og.rev 5.1.5.0 (2010/04/01) 新規追加
//	 * @og.rev 6.9.0.0 (2018/01/31) SOAPConnect 廃止に伴う修正
//	 *
//	 * @param	ns	名前空間
//	 */
//	public void setSoapNameSpace( final String ns ) {
//		soapNameSpace = nval( getRequestParameter( ns ), soapNameSpace );
//	}
//
//	/**
//	 * 【TAG】SOAPによるWebサービスの呼び出しで、メソッド名を指定します。
//	 *
//	 * @og.tag
//	 * SOAPによるWebサービスの呼び出しで、メソッド名を指定します。
//	 * WSDLファイルで定義されるoperationタグのname属性の値に相当します。
//	 *
//	 * @og.rev 5.1.5.0 (2010/04/01) 新規追加
//	 * @og.rev 6.9.0.0 (2018/01/31) SOAPConnect 廃止に伴う修正
//	 *
//	 * @param	method	メソッド名
//	 */
//	public void setSoapMethodName( final String method ) {
//		soapMethodName = nval( getRequestParameter( method ), soapMethodName );
//	}

	/**
	 * 【TAG】(通常は使いません)結果のDBTableModelを、sessionに登録するときのキーを指定します
	 *		(初期値:HybsSystem#TBL_MDL_KEY[={@og.value HybsSystem#TBL_MDL_KEY}])。
	 *
	 * @og.tag
	 * 検索結果より、DBTableModelオブジェクトを作成します。これを、下流のviewタグ等に
	 * 渡す場合に、通常は、session を利用します。その場合の登録キーです。
	 * query タグを同時に実行して、結果を求める場合、同一メモリに配置される為、
	 * この tableId 属性を利用して、メモリ空間を分けます。
	 *		(初期値:HybsSystem#TBL_MDL_KEY[={@og.value HybsSystem#TBL_MDL_KEY}])。
	 *
	 * @param	id テーブルID (sessionに登録する時のID)
	 */
	public void setTableId( final String id ) {
		tableId   = nval( getRequestParameter( id ),tableId );
	}

	/**
	 * 【TAG】結果のXMLをDBTableModelに変換する際に、行のキーとなるタグ名を指定します。
	 *
	 * @og.tag
	 * 結果のXMLを表形式に変換する際に、行のキーとなるタグ名を指定します。
	 * このキーのタグを基点として、colKeysで指定されたタグの値を各項目の値として取り込みます。
	 * (詳細は、colKeysのタグリブ属性マニュアルを参照して下さい。)
	 *
	 * @param	key 行のキーとなるタグ名
	 * @see #setColKeys( String )
	 */
	public void setRowKey( final String key ) {
		rowKey = nval( getRequestParameter( key ),rowKey );
	}

	/**
	 * 【TAG】結果のXMLをDBTableModelに変換する際に、項目のキーとなるタグ名の一覧を指定します。
	 *
	 * @og.tag
	 * 結果のXMLをDBTableModelに変換する際に、項目のキーとなるタグ名の一覧を指定します。
	 * rowKeyで行を、colKeysで項目を表現し、rowKeyのタグで囲われた固まりを1つの行とみなします。
	 * このため、colKeysに指定されたキーのタグでも、rowKeyの外にある場合は、取り込み対象となりません。
	 *
	 * また、キーにPARENT_TAG、PARENT_FULL_TAGを指定することで、rowKeyで指定されたタグの
	 * 直近の親タグ、及びフルの親タグ名(親タグの階層を"&gt;[タグA]&gt;[タグB]&gt;[タグC]&gt;"で表現)を
	 * 取得することができます。
	 *
	 * @param	keys 項目キー タグ名の一覧(CSV形式)
	 */
	public void setColKeys( final String keys ) {
		colKeys = StringUtil.csv2Array( getRequestParameter( keys ) );
	}

	/**
	 * 【TAG】結果のXMLを変換する際に、パラメータ(Attributes)として取り込むキーの一覧を指定します。
	 *
	 * @og.tag
	 * 結果のXMLを変換する際に、パラメータ(Attributes)として取り込むキーの一覧を指定します。
	 * ここで指定されたキーのタグの値を取り出し、{&#064;XX}形式(Attributes)として処理できるようにします。
	 *
	 * @param	keys 戻り値キー パラメーター(Attributes)のキーとなるタグ名の一覧(CSV形式)
	 */
	public void setRtnKeys( final String keys ) {
		rtnKeys = StringUtil.csv2Array( getRequestParameter( keys ) );
	}

	/**
	 * 【TAG】データの入出力のエンコードを指定します(初期値:UTF-8)。
	 *
	 * @og.tag
	 * データの入出力のエンコードを指定します。
	 * 初期値は、"UTF-8"です。
	 *
	 * @og.rev 5.1.6.0 (2010/05/01) 新規作成
	 * @param	enc	エンコード
	 */
	public void setEncode( final String enc ) {
		encode = nval( getRequestParameter( enc ), encode );
	}

	/**
	 * タグの名称を、返します。
	 * 自分自身のクラス名より、自動的に取り出せないため、このメソッドをオーバーライドします。
	 *
	 * @og.rev 4.0.0.0 (2005/01/31) 新規追加
	 *
	 * @return  タグの名称
	 * @og.rtnNotNull
	 */
	@Override
	protected String getTagName() {
		return "urlConnect" ;
	}

	/**
	 * 【TAG】(通常は使いません)タグで処理される処理がメインとなるトランザクション処理かどうかを指定します(初期値:true)。
	 *
	 * @og.tag
	 * この値は、ファイルダウンロード処理に影響します。この値がtrueに指定された時にcommitされたDBTableModelが
	 * ファイルダウンロードの対象の表になります。
	 *
	 * このパラメーターは、通常、各タグにより実装され、ユーザーが指定する必要はありません。
	 * 但し、1つのJSP内でDBTableModelが複数生成される場合に、前に処理したDBTableModelについてファイルダウンロードをさせたい
	 * 場合は、後ろでDBTableModelを生成するタグで、明示的にこの値をfalseに指定することで、ファイルダウンロード処理の対象から
	 * 除外することができます。
	 *
	 * @og.rev 5.1.6.0 (2010/05/01) 新規作成
	 *
	 * @param  flag メイントランザクションかどうか [true:メイン/false:その他]
	 */
	public void setMainTrans( final String flag ) {
		isMainTrans = nval( getRequestParameter( flag ),isMainTrans );
	}

	/**
	 * 【TAG】保存先ストレージタイプを設定します。
	 *
	 * @og.tag
	 * ファイルを読み取り元の、ストレージタイプを設定します。
	 * 未設定の場合は、システムリソースの「CLOUD_TARGET」が参照されます。
	 * 自身のサーバを指定する場合は、「default」を設定してください。
	 *
	 * @og.rev 5.10.9.0 (2019/03/01) 新規追加
	 *
	 * @param storage 保存先ストレージタイプ
	 */
	public void setStorageType( final String storage ) {
		storageType = nval( getRequestParameter( storage ), storageType );
	}

	/**
	 * 【TAG】保存先バケット名を設定します。
	 *
	 * @og.tag
	 * ファイルを読み取り元の、バケット名を指定します。
	 * クラウドストレージ利用時のみ有効です。
	 * 未設定の場合は、システムリソースの「CLOUD_BUKET」が参照されます。
	 *
	 * @og.rev 5.10.9.0 (2019/03/01) 新規追加
	 *
	 * @param bucket 保存先バケット名
	 */
	public void setBucketName( final String bucket ) {
		bucketName = nval( getRequestParameter( bucket ), bucketName );
	}

	/**
	 * 【TAG】送信ヘッダのコンテントタイプを指定します。
	 *
	 * @og.tag
	 * 通常は指定不要です。
	 * API等でapplication/json等を指定された場合に設定してください。
	 *
	 * @og.rev 5.10.10.2 (2019/04/12) 追加
	 *
	 * @param ctype コンテントタイプ
	 */
	public void setContentType( final String ctype ) {
		contentType = nval( getRequestParameter( ctype ), contentType );
	}

	/**
	 * 【TAG】コネクションのrequestParameterに渡すキーをCSV形式で複数指定します。
	 *
	 * @og.tag
	 * 分解方法は、CSV変数を先に分解してから、getRequestParameter で値を取得します。
	 *
	 * @og.rev 5.10.16.0 (2019/10/04) propKeys,propVals指定追加
	 *
	 * @param	key キー(CSV形式)
	 */
	public void setPropKeys( final String key ) {
		propKeys = nval( getRequestParameter( key ), propKeys );
	}

	/**
	 * 【TAG】コネクションのrequestParameterに渡す値をCSV形式で複数指定します。
	 *
	 * @og.tag
	 * 分解方法は、CSV変数を先に分解してから、getRequestParameter で値を取得します。
	 *
	 * @og.rev 5.10.16.0 (2019/10/04) propKeys,propVals指定追加
	 *
	 * @param	val 値(CSV形式) 新規追加
	 */
	public void setPropVals( final String val ) {
		propVals = nval( getRequestParameter( val ), propVals );
	}

	/**
	 * 【TAG】postDataのみ送信フラグ。
	 *
	 * @og.tag
	 * trueを設定時、keyなしでpostDataをそのまま送信します。
	 * 主にapplication/json形式で送信時に利用します。
	 *
	 * @og.rev 5.10.19.0 (2019/12/27) postDataOnly対応 ････ Ver7では未対応
	 * @param flg postDataのみ送信フラグ
	 */
	public void setPostDataOnly( final String flg ) {
		postDataOnly = nval( getRequestParameter( flg ), postDataOnly);
	}

	/**
	 * このオブジェクトの文字列表現を返します。
	 * 基本的にデバッグ目的に使用します。
	 *
	 * @og.rev 5.10.16.0 (2019/10/04) propKeys,propVals指定追加
	 *
	 * @return このクラスの文字列表現
	 * @og.rtnNotNull
	 */
	@Override
	public String toString() {
		return ToString.title( this.getClass().getName() )
				.println( "VERSION"			,VERSION		)
				.println( "method"			,method			)
				.println( "urlStr"			,urlStr			)
				.println( "keys"			,StringUtil.array2csv( keys ) )
				.println( "vals"			,StringUtil.array2csv( vals ) )
				.println( "proxyHost"		,proxyHost		)
				.println( "proxyPort"		,proxyPort		)
				.println( "timeout"			,timeout		)		// 6.2.5.0 (2015/06/05) 新規追加
				.println( "useSystemUser"	,useSystemUser	)
				.println( "authUserPass"	,authUserPass	)
				.println( "display"			,display		)
				.println( "postKey"			,postKey		)
				.println( "postData"		,postData		)
				.println( "xslFile"			,xslFile		)
				.println( "saveFile"		,saveFile		)
				.println( "errNglctFlag"	,errNglctFlag	)
//				.println( "soapNameSpace"	,soapNameSpace	)		// 6.9.0.0 (2018/01/31) SOAPConnect 廃止に伴う修正
//				.println( "soapMethodName"	,soapMethodName	)		// 6.9.0.0 (2018/01/31) SOAPConnect 廃止に伴う修正
				.println( "tableId"			,tableId		)
				.println( "rowKey"			,rowKey			)
				.println( "colKeys"			,StringUtil.array2csv( colKeys ) )
				.println( "rtnKeys"			,StringUtil.array2csv( rtnKeys ) )
				.println( "storageType"		,storageType	)		// 5.10.10.2 (2019/04/12) 追加
				.println( "bucketName"		,bucketName		)		// 5.10.10.2 (2019/04/12) 追加
				.println( "contentType"		,contentType	)		// 5.10.10.2 (2019/04/12) 追加
				.println( "propKeys"		,propKeys		)		// 5.10.16.0 (2019/10/04) 追加
				.println( "propVals"		,propVals		)		// 5.10.16.0 (2019/10/04) 追加
				.println( "Other..."		,getAttributes().getAttribute() )
				.fixForm().toString() ;
	}
}
