/*
 * 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 org.opengion.fukurou.system.OgRuntimeException ;		// 6.4.2.0 (2016/01/29)
import org.opengion.hayabusa.common.HybsSystem;
import org.opengion.hayabusa.common.HybsSystemException;
import org.opengion.fukurou.util.FileUtil;
import org.opengion.fukurou.util.StringUtil ;
import org.opengion.fukurou.util.ToString;						// 6.1.1.0 (2015/01/17)
import org.opengion.fukurou.util.ZipArchive;					// 5.9.2.2 (2015/11/12)
import org.opengion.fukurou.util.ArraySet;						// 6.4.3.4 (2016/03/11)
import org.opengion.fukurou.model.POIUtil;						// 6.2.3.0 (2015/05/01)

import org.opengion.hayabusa.io.HybsFileOperationFactory;		// 8.0.0.1 (2021/10/08)
import org.opengion.fukurou.model.FileOperation;				// 8.0.0.1 (2021/10/08)

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

import java.io.File;
import java.io.IOException;
import java.util.List;											// 6.2.3.0 (2015/05/01)
import java.util.Set;											// 6.4.3.4 (2016/03/11)
import java.util.ArrayList;										// 6.2.3.0 (2015/05/01)
import java.util.Locale ;

import jakarta.servlet.ServletContext;							// 6.3.6.1 (2015/08/28)

/**
 * 各種ｱｸｼｮﾝを指定して､ﾌｧｲﾙ関連の操作をおこなうﾀｸﾞです｡
 *
 * 各種ｱｸｼｮﾝ に応じた振る舞いを行います｡
 * 結果については､false の場合は､body 要素を表示して､終了します｡
 * これは､BODYにｴﾗｰﾒｯｾｰｼﾞを書いておくことを想定した作りになっています｡

 * 判定結果を反転したい場合は､notEquals 属性を使用してください｡また､
 * 結果に応じて､処理を止めたくない場合は､useStop 属性を false に指定することで､
 * 後続処理を実行できます｡
 *
 * [各種ｱｸｼｮﾝ]
 *       canRead          読み込めるかどうかを判定｡
 *       canWrite         変更できるかどうか判定｡
 *       createNewFile    空の新しいﾌｧｲﾙを不可分 (atomic) に生成｡(そのﾌｧｲﾙがまだ存在しない場合だけ)
 *       delete           ﾌｧｲﾙまたはﾃﾞｨﾚｸﾄﾘを削除(ﾃﾞｨﾚｸﾄﾘ階層をすべて削除)｡
 *       renameTo         ﾌｧｲﾙまたはﾃﾞｨﾚｸﾄﾘ名を変更｡
 *       exists           ﾌｧｲﾙが存在するかどうか判定｡
 *       isDirectory      ﾌｧｲﾙがﾃﾞｨﾚｸﾄﾘであるかどうか判定｡
 *       isFile           ﾌｧｲﾙが普通のﾌｧｲﾙかどうか判定｡
 *       isHidden         ﾌｧｲﾙが隠しﾌｧｲﾙかどうか判定｡
 *       mkdir            ﾃﾞｨﾚｸﾄﾘを生成｡
 *       mkdirs           ﾃﾞｨﾚｸﾄﾘを複数生成｡
 *       read             ﾌｧｲﾙを読み込んで､ﾊﾟﾗﾒｰﾀにｾｯﾄします(6.2.3.0 (2015/05/01))｡
 *       existsLength     ﾌｧｲﾙｻｲｽﾞが０Byte以上のﾌｧｲﾙが存在するかどうか判定｡
 *       copy             ﾌｧｲﾙまたはﾃﾞｨﾚｸﾄﾘをｺﾋﾟｰ(file1 ⇒ file2 にｺﾋﾟｰ)｡
 *       copyST           ｽﾄﾘｰﾑﾌｧｲﾙをｺﾋﾟｰ(file1(ｱﾄﾞﾚｽ) ⇒ file2 にｺﾋﾟｰ)｡
 *       list             ﾌｧｲﾙﾘｽﾄをListｵﾌﾞｼﾞｪｸﾄにｺﾋﾟｰして､ﾊﾟﾗﾒｰﾀにｾｯﾄします(6.2.3.0 (2015/05/01))｡
 *       zip              ﾌｧｲﾙまたはﾃﾞｨﾚｸﾄﾘをZIPﾌｧｲﾙに圧縮します｡(file1⇒file2)
 *       timeStamp        ﾌｧｲﾙのﾀｲﾑｽﾀﾝﾌﾟを現在時刻に変更します｡(file1のみ)
 *
 * @og.formSample
 * ●形式：&lt;og:file action="…" fileURL="…" &gt;･･･&lt;/og:file&gt;
 * ●body：あり(EVAL_BODY_INCLUDE:BODYをｲﾝｸﾙｰﾄﾞし､{&#064;XXXX} は解析しません)
 *
 * ●Tag定義：
 *   &lt;og:file
 *       action           ○【TAG】ｱｸｼｮﾝ(canRead,canWrite,createNewFile,delete,renameTo,exists,isDirectory,isFile,isHidden,mkdir,mkdirs,read,existsLength,copy,copyST,list,zip,timeStamp)を指定します(必須)｡
 *       fileURL            【TAG】操作するﾌｧｲﾙのﾃﾞｨﾚｸﾄﾘを指定します (初期値:FILE_URL[=filetemp/])
 *       file1              【TAG】基準となるﾌｧｲﾙ名を指定します(ｺﾏﾝﾄﾞの左辺のﾌｧｲﾙ名です)
 *       file2              【TAG】処理結果となるﾌｧｲﾙ名を指定します(ｺﾏﾝﾄﾞの右辺のﾌｧｲﾙ名です)
 *       notEquals          【TAG】判定結果を反転させるかどうか[true/false]を指定します(初期値:false)
 *       useStop            【TAG】ｴﾗｰ時BODYを処理後に停止するかどうか[true/false]を指定します(初期値:true)
 *       encode             【TAG】ﾌｧｲﾙを読み込む(action="read")際のｴﾝｺｰﾄﾞを指定します(初期値:OS依存文字ｺｰﾄﾞ)
 * ×    fromStorage        【廃止】ﾃﾝﾌﾟﾚｰﾄﾌｧｲﾙの読み込み元ｽﾄﾚｰｼﾞﾀｲﾌﾟを指定します｡8.0.0.1 (2021/10/08)
 * ×    fromBucket         【廃止】ﾃﾝﾌﾟﾚｰﾄﾌｧｲﾙの読み込み元ﾊﾞｹｯﾄ名を指定します｡8.0.0.1 (2021/10/08)
 *       fromLocal          【TAG】強制的にﾛｰｶﾙﾌｧｲﾙを使用する場合､true にｾｯﾄします｡｡8.0.1.0 (2021/10/29)
 *       toStorage          【廃止】生成したﾌｧｲﾙの出力先ｽﾄﾚｰｼﾞﾀｲﾌﾟを指定します｡8.0.0.1 (2021/10/08)
 * ×    toBucket           【廃止】生成したﾌｧｲﾙの出力先ﾊﾞｹｯﾄ名を指定します｡8.0.0.1 (2021/10/08)
 * ×    toLocal            【TAG】強制的にﾛｰｶﾙﾌｧｲﾙを使用する場合､true にｾｯﾄします｡｡8.0.0.1 (2021/10/08)
 *       useLocal           【TAG】ｼｽﾃﾑ定数でｸﾗｳﾄﾞ設定されていても､ｸﾗｳﾄﾞ環境を使用しない場合､trueを指定します(初期値:false) 8.0.1.0 (2021/10/29)
 *       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:file&gt;
 *
 * ●使用例
 *    ･ﾌｧｲﾙの存在ﾁｪｯｸ→存在しなければｴﾗｰﾒｯｾｰｼﾞを表示｡
 *        &lt;og:file action="exists" fileURL="N:/CIR/" file1="{&#064;USER.LKISB}/{&#064;USER.LDNO1KAI}.cir/001.sht"&gt;
 *            &lt;og:message lbl="RKE_0157" comment="回路図が存在しません｡" /&gt;
 *        &lt;/og:file&gt;
 *
 *    ･N:/Filetemp/にﾕｰｻﾞｰﾃﾞｨﾚｸﾄﾘが存在しなければ作成｡→失敗した場合ｴﾗｰﾒｯｾｰｼﾞを表示｡
 *        &lt;og:file action="mkdir" fileURL="N:/Filetemp/{&#064;USER.ID}" &gt;
 *            &lt;og:message comment="ｴﾗｰが発生しました｡ｼｽﾃﾑ管理者に連絡してください｡" /&gt;
 *        &lt;/og:file&gt;
 *
 *    ･N:/Filetemp/test.txt ﾌｧｲﾙの削除｡ﾌｧｲﾙが存在しなくても処理を続ける｡
 *        &lt;og:file action="delete" fileURL="N:/Filetemp/" file1="test.txt" useStop="false" &gt;
 *            &lt;og:message comment="ﾌｧｲﾙは存在しませんでした｡" /&gt;
 *        &lt;/og:file&gt;
 *
 * @og.group その他部品
 *
 * @version  4.0
 * @author	 Kazuhiko Hasegawa
 * @since    JDK5.0,
 */
public class FileTag extends CommonTagSupport {
	/** このﾌﾟﾛｸﾞﾗﾑのVERSION文字列を設定します｡	{@value} */
	private static final String VERSION = "8.0.1.0 (2021/10/29)" ;
	private static final long serialVersionUID = 801020211029L ;

	/** action 引数に渡す事の出来る ｱｸｼｮﾝｺﾏﾝﾄﾞ  読み込めるかどうか {@value} */
	public static final String ACT_CANREAD	= "canRead" ;
	/** action 引数に渡す事の出来る ｱｸｼｮﾝｺﾏﾝﾄﾞ  変更できるかどうか {@value} */
	public static final String ACT_CANWRITE    = "canWrite" ;
	/** action 引数に渡す事の出来る ｱｸｼｮﾝｺﾏﾝﾄﾞ  空の新しいﾌｧｲﾙを不可分 (atomic) に生成します (そのﾌｧｲﾙがまだ存在しない場合だけ {@value} */
	public static final String ACT_CREATENEWFILE	= "createNewFile" ;
	/** action 引数に渡す事の出来る ｱｸｼｮﾝｺﾏﾝﾄﾞ  ﾌｧｲﾙまたはﾃﾞｨﾚｸﾄﾘを削除{@value}	*/
	public static final String ACT_DELETE	 = "delete" ;
	/** action 引数に渡す事の出来る ｱｸｼｮﾝｺﾏﾝﾄﾞ  ﾌｧｲﾙが存在するかどうか {@value} */
	public static final String ACT_EXISTS	 = "exists" ;
	/** action 引数に渡す事の出来る ｱｸｼｮﾝｺﾏﾝﾄﾞ  ﾌｧｲﾙがﾃﾞｨﾚｸﾄﾘであるかどうか{@value}	*/
	public static final String ACT_ISDIRECTORY	  = "isDirectory" ;
	/** action 引数に渡す事の出来る ｱｸｼｮﾝｺﾏﾝﾄﾞ  ﾌｧｲﾙが普通のﾌｧｲﾙかどうか{@value}	*/
	public static final String ACT_ISFILE	 = "isFile" ;
	/** action 引数に渡す事の出来る ｱｸｼｮﾝｺﾏﾝﾄﾞ  ﾌｧｲﾙが隠しﾌｧｲﾙかどうか {@value} */
	public static final String ACT_ISHIDDEN    = "isHidden" ;
	/** action 引数に渡す事の出来る ｱｸｼｮﾝｺﾏﾝﾄﾞ  ﾃﾞｨﾚｸﾄﾘを生成します｡ {@value} */
	public static final String ACT_MKDIR	= "mkdir" ;
	/** action 引数に渡す事の出来る ｱｸｼｮﾝｺﾏﾝﾄﾞ  ﾃﾞｨﾚｸﾄﾘを生成します｡ {@value} */
	public static final String ACT_MKDIRS	= "mkdirs" ;
	/** action 引数に渡す事の出来る ｱｸｼｮﾝｺﾏﾝﾄﾞ  ﾌｧｲﾙ名を変更します｡ {@value} */
	public static final String ACT_RENAMETO	= "renameTo" ;		// 3.5.6.5 (2004/08/09)
	/** action 引数に渡す事の出来る ｱｸｼｮﾝｺﾏﾝﾄﾞ  ﾌｧｲﾙを読み込んで表示します｡ {@value} */
	public static final String ACT_READ	= "read" ;		// 3.6.0.0 (2004/09/25)
	/** action 引数に渡す事の出来る ｱｸｼｮﾝｺﾏﾝﾄﾞ  ﾌｧｲﾙｻｲｽﾞが０Byte以上のﾌｧｲﾙが存在するかどうか判定｡ {@value} */
	public static final String ACT_EXISTSLENGTH	 = "existsLength" ;		// 3.8.5.2 (2006/05/31)
	/** action 引数に渡す事の出来る ｱｸｼｮﾝｺﾏﾝﾄﾞ  ﾌｧｲﾙまたはﾃﾞｨﾚｸﾄﾘをｺﾋﾟｰします｡ {@value} */
	public static final String ACT_COPY	 = "copy" ;		// 5.3.6.0 (2011/06/01)
	/** action 引数に渡す事の出来る ｱｸｼｮﾝｺﾏﾝﾄﾞ  ｽﾄﾘｰﾑﾌｧｲﾙをｺﾋﾟｰします｡ {@value} */
	public static final String ACT_COPYST = "copyST" ;	// 6.3.6.1 (2015/08/28)
	/** action 引数に渡す事の出来る ｱｸｼｮﾝｺﾏﾝﾄﾞ  ﾃﾞｨﾚｸﾄﾘのﾌｧｲﾙﾘｽﾄをListｵﾌﾞｼﾞｪｸﾄにｺﾋﾟｰします｡ {@value} */
	public static final String ACT_LIST	 = "list" ;		// 6.2.3.0 (2015/05/01)
	/** action 引数に渡す事の出来る ｱｸｼｮﾝｺﾏﾝﾄﾞ  ZIP圧縮します｡ {@value} */
	public static final String ACT_ZIP	 = "zip" ;		// 5.9.2.2 (2015/11/20)
	/** action 引数に渡す事の出来る ｱｸｼｮﾝｺﾏﾝﾄﾞ  ﾀｲﾑｽﾀﾝﾌﾟを現在時刻に変更します｡ {@value} */
	public static final String ACT_TIMESTAMP	 = "timeStamp" ;		// 6.7.0.0 (2016/12/28)

	// 6.4.3.4 (2016/03/11) String配列 から､Setに置き換えます｡
	private static final Set<String> ACTION_SET = new ArraySet<>(
													ACT_CANREAD , ACT_CANWRITE , ACT_CREATENEWFILE , ACT_DELETE , ACT_EXISTS , ACT_ISDIRECTORY ,
													ACT_ISFILE , ACT_ISHIDDEN , ACT_MKDIR , ACT_MKDIRS , ACT_RENAMETO , ACT_READ ,
													ACT_EXISTSLENGTH , ACT_COPY , ACT_COPYST , ACT_LIST , ACT_ZIP , ACT_TIMESTAMP );

	private String	fileURL 	= HybsSystem.sys( "FILE_URL" );
	private String	file1		= "";
	private String	file2		;
	private String	action		;
	private boolean rtnCode		;

	private boolean notEquals	;			// 3.8.5.2 (2006/05/31) 判定結果を反転させて処理します｡
	private boolean useStop		= true;		// 3.8.5.2 (2006/05/31) ｴﾗｰ時BODYを処理後に停止(true)するかどうか

	private String encode		;			// 5.1.9.0 (2010/08/01) READ時のｴﾝｺｰﾄﾞ指定

//	private String fromStorage	;			// 5.10.9.0 (2019/03/01) 8.0.0.1 (2021/10/08)
//	private String fromBucket	;			// 5.10.9.0 (2019/03/01) 8.0.0.1 (2021/10/08)
	private boolean fromLocal	;			// 8.0.1.0 (2021/10/29) ｸﾗｳﾄﾞ設定を使用しない場合は､true
//	private String toStorage	;			// 5.10.9.0 (2019/03/01) 8.0.0.1 (2021/10/08)
//	private String toBucket		;			// 5.10.9.0 (2019/03/01) 8.0.0.1 (2021/10/08)
	private boolean toLocal		;			// 8.0.1.0 (2021/10/29) ｸﾗｳﾄﾞ設定を使用しない場合は､true
	private boolean useLocal	;			// 8.0.1.0 (2021/10/29) ｸﾗｳﾄﾞ設定を使用しない場合は､true

	/**
	 * ﾃﾞﾌｫﾙﾄｺﾝｽﾄﾗｸﾀｰ
	 *
	 * @og.rev 6.4.2.0 (2016/01/29) PMD refactoring. Each class should declare at least one constructor.
	 */
	public FileTag() { super(); }		// これも､自動的に呼ばれるが､空のﾒｿｯﾄﾞを作成すると警告されるので､明示的にしておきます｡

	/**
	 * Taglibの開始ﾀｸﾞが見つかったときに処理する doStartTag() を ｵｰﾊﾞｰﾗｲﾄﾞします｡
	 *
	 * @og.rev 3.6.0.0 (2004/09/25) file ｵﾌﾞｼﾞｪｸﾄの作成を actionExec 移動
	 * @og.rev 3.8.5.2 (2006/05/31) notEquals追加｡ 判定結果を反転させて処理します｡
	 * @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() ) {
			if( useLocal ) {	// 8.0.1.0 (2021/10/29) ｸﾗｳﾄﾞ設定を使用しない場合は､true
//				fromBucket = FileOperation.LOCAL ;
//				toBucket   = FileOperation.LOCAL ;
				fromLocal = true ;
				toLocal   = true ;
			}

			try {
				rtnCode = notEquals ^ actionExec( action );		// 3.8.5.2 (2006/05/31) 排他的論理和(XOR)
			}
			catch( final IOException ex ) {
				final String errMsg = "指定のｱｸｼｮﾝは実行できません｡ｱｸｼｮﾝｴﾗｰ" + CR
								+ "\t  action=["	+ action	+ "]"	+ CR
								+ "\t  fileURL=["	+ fileURL	+ "]"	+ CR
								+ "\t  file1=["		+ file1		+ "]"	+ CR
								+ "\t  file2=["		+ file2		+ "]"	+ CR ;
				throw new HybsSystemException( errMsg,ex );		// 3.5.5.4 (2004/04/15) 引数の並び順変更
			}

			if( rtnCode ) { return SKIP_BODY ; }			// Body を評価しない
			else {			return EVAL_BODY_INCLUDE ; }	// Body ｲﾝｸﾙｰﾄﾞ( extends TagSupport 時)
		}

		return SKIP_BODY ;
	}

	/**
	 * Taglibの終了ﾀｸﾞが見つかったときに処理する doEndTag() を ｵｰﾊﾞｰﾗｲﾄﾞします｡
	 *
	 * @og.rev 3.1.1.2 (2003/04/04) Tomcat4.1 対応｡release2() を doEndTag()で呼ぶ｡
	 * @og.rev 3.8.5.2 (2006/05/31) useStop 追加｡ ｴﾗｰ時BODYを処理後に停止(true)するかどうか
	 * @og.rev 5.7.7.2 (2014/06/20) caseKey,caseVal,caseNN,caseNull 属性を追加
	 *
	 * @return	後続処理の指示
	 */
	@Override
	public int doEndTag() {
		debugPrint();		// 4.0.0 (2005/02/28)

		// 6.4.1.1 (2016/01/16) PMD refactoring. A method should have only one exit point, and that should be the last statement in the method
		return useTag() && useStop && !rtnCode  ? SKIP_PAGE : EVAL_PAGE ;
	}

	/**
	 * ﾀｸﾞﾘﾌﾞｵﾌﾞｼﾞｪｸﾄをﾘﾘｰｽします｡
	 * ｷｬｯｼｭされて再利用されるので､ﾌｨｰﾙﾄﾞの初期設定を行います｡
	 *
	 * @og.rev 2.0.0.4 (2002/09/27) ｶｽﾀﾑﾀｸﾞの release() ﾒｿｯﾄﾞを､追加
	 * @og.rev 3.1.1.2 (2003/04/04) Tomcat4.1 対応｡release2() を doEndTag()で呼ぶ｡
	 * @og.rev 3.6.0.0 (2004/09/24) columns ､tableId ､file 削除
	 * @og.rev 3.8.5.2 (2006/05/31) notEquals ､useStop 追加
	 * @og.rev 5.1.9.0 (2010/08/01) READ時のｴﾝｺｰﾄﾞ指定
	 * @og.rev 8.0.0.1 (2021/10/08) fromStorage,fromBucket,toStorage,toBucket 追加
	 * @og.rev 8.0.1.0 (2021/10/29) useLocal 属性を追加｡
	 */
	@Override
	protected void release2() {
		super.release2();
		fileURL 	= HybsSystem.sys( "FILE_URL" );
		file1		= "";
		file2		= null;
		action		= null;
		rtnCode		= false;
		notEquals	= false;	// 3.8.5.2 (2006/05/31) 判定結果を反転させて処理します｡
		useStop		= true;		// 3.8.5.2 (2006/05/31) ｴﾗｰ時BODYを処理後に停止(true)するかどうか
		encode		= null;		// 5.1.9.0 (2010/08/01) READ時のｴﾝｺｰﾄﾞ指定
//		fromStorage	= null;		// 5.10.9.0 (2019/03/01) 8.0.0.1 (2021/10/08)
//		fromBucket	= null;		// 5.10.9.0 (2019/03/01) 8.0.0.1 (2021/10/08)
		fromLocal	= false;	// 8.0.1.0 (2021/10/29) ｸﾗｳﾄﾞ設定を使用しない場合は､true
//		toStorage	= null;		// 5.10.9.0 (2019/03/01) 8.0.0.1 (2021/10/08)
//		toBucket	= null;		// 5.10.9.0 (2019/03/01) 8.0.0.1 (2021/10/08)
		useLocal	= false;	// 8.0.1.0 (2021/10/29) ｸﾗｳﾄﾞ設定を使用しない場合は､true
		toLocal		= false;	// 8.0.1.0 (2021/10/29) ｸﾗｳﾄﾞ設定を使用しない場合は､true
	}

	/**
	 * ｱｸｼｮﾝを実行します｡
	 * ｱｸｼｮﾝは,指定のｱｸｼｮﾝｺﾏﾝﾄﾞに対応する処理を入力ﾃﾞｰﾀに
	 * 対して行います｡
	 *
	 * @og.rev 3.0.0.0 (2002/12/25) ACTION_LIST のﾁｪｯｸを削除
	 * @og.rev 3.6.0.0 (2004/09/25) ACT_read を追加 , file ｵﾌﾞｼﾞｪｸﾄを移動
	 * @og.rev 3.8.5.2 (2006/05/31) existsLength 追加
	 * @og.rev 4.0.0.0 (2007/11/28) ﾒｿｯﾄﾞの戻り値をﾁｪｯｸします｡
	 * @og.rev 5.1.9.0 (2010/08/01) READ時のｴﾝｺｰﾄﾞ指定
	 * @og.rev 5.3.6.0 (2011/06/01) ACT_COPY 対応
	 * @og.rev 5.7.1.1 (2013/12/13) copy元(file1)のﾌｧｲﾙが存在しなければ､ｴﾗｰにします｡
	 * @og.rev 6.2.3.0 (2015/05/01) list ｱｸｼｮﾝ追加､delete 処理は､ﾌｫﾙﾀﾞ階層を丸ごと削除します｡
	 * @og.rev 6.3.6.1 (2015/08/28) ACT_COPYST 対応( copyST ｱｸｼｮﾝ時に､copy元に､ｱﾄﾞﾚｽ指定できるようにする)｡
	 * @og.rev 5.9.2.2 (2015/11/12) ACT_ZIP追加
	 * @og.rev 6.7.0.0 (2016/12/28) ACT_TIMESTAMP追加
	 * @og.rev 6.8.0.0 (2017/06/02) zipFile の親ﾃﾞｨﾚｸﾄﾘを作成します｡
	 * @og.rev 6.9.8.0 (2018/05/28) FindBugs:例外的戻り値を無視しているﾒｿｯﾄﾞ(mkdirs)
	 * @og.rev 7.2.6.3 (2020/08/07) mkdirs は､先に存在ﾁｪｯｸを入れて､存在していればtrueにする｡
	 * @og.rev 8.0.0.1 (2021/10/08) fromStorage,fromBucket,toStorage,toBucket 追加
	 * @og.rev 8.0.0.2 (2021/10/15) ﾛｰｶﾙﾌｧｲﾙとｸﾗｳﾄﾞﾌｧｲﾙ間の移動
	 *
	 * @param	action ｱｸｼｮﾝ (public static final 宣言されている文字列)
	 *
	 * @return	実行後のﾃﾞｰﾀ
	 */
	private boolean actionExec( final String action ) throws IOException {
		// 6.4.1.1 (2016/01/16) PMD refactoring. Avoid if (x != y) ..; else ..;
		if( action == null ) {
			final String errMsg = "ｱｸｼｮﾝが指定されていません｡ｱｸｼｮﾝ NULL ｴﾗｰ" + CR
							+ "\t  file=["		+ file1		+ "]" 	+ CR
							+ "\t  matches=["	+ file2		+ "]"	+ CR ;
			throw new HybsSystemException( errMsg );
		}

		final String directory = HybsSystem.url2dir( fileURL );
		// 8.0.0.1 (2021/10/08) fromStorage,fromBucket,toStorage,toBucket 追加
		// 8.0.1.0 (2021/10/29) storageType , bucketName 削除
//		final File file = new File( StringUtil.urlAppend( directory,file1 ) );
//		final File file = HybsFileOperationFactory.create(fromStorage, fromBucket, StringUtil.urlAppend(directory, file1));
		final File file = HybsFileOperationFactory.create(fromLocal, StringUtil.urlAppend(directory, file1));

		boolean rtnVal = false;
			if( 	 ACT_CANREAD.equalsIgnoreCase(		 action ) ) { rtnVal = file.canRead(); }
			else if( ACT_CANWRITE.equalsIgnoreCase( 	 action ) ) { rtnVal = file.canWrite(); }
			else if( ACT_CREATENEWFILE.equalsIgnoreCase( action ) ) { rtnVal = file.createNewFile(); }
			else if( ACT_DELETE.equalsIgnoreCase(		 action ) ) { rtnVal = FileUtil.deleteFiles( file ); }
			else if( ACT_EXISTS.equalsIgnoreCase(		 action ) ) { rtnVal = file.exists(); }
			else if( ACT_ISDIRECTORY.equalsIgnoreCase(	 action ) ) { rtnVal = file.isDirectory(); }
			else if( ACT_ISFILE.equalsIgnoreCase(		 action ) ) { rtnVal = file.isFile(); }
			else if( ACT_ISHIDDEN.equalsIgnoreCase( 	 action ) ) { rtnVal = file.isHidden(); }
			else if( ACT_MKDIR.equalsIgnoreCase(		 action ) ) {
				if( file.isDirectory() ) { rtnVal = true; }
				else { rtnVal = file.mkdir(); }
			}
			// 7.2.6.3 (2020/08/07) mkdirs は､先に存在ﾁｪｯｸを入れて､存在していればtrueにする｡
//			else if( ACT_MKDIRS.equalsIgnoreCase(		 action ) ) { rtnVal = file.mkdirs(); }
			else if( ACT_MKDIRS.equalsIgnoreCase(		 action ) ) {		// 7.2.6.3 (2020/08/07)
				if( file.isDirectory() ) { rtnVal = true; }
				else { rtnVal = file.mkdirs(); }
			}
			else if( ACT_RENAMETO.equalsIgnoreCase(		 action ) ) {
				if( file2 != null ) {
					// 8.0.0.1 (2021/10/08) fromStorage,fromBucket,toStorage,toBucket 追加
					// 8.0.1.0 (2021/10/29) storageType , bucketName 削除
//					final File newFile = new File( StringUtil.urlAppend( directory,file2 ) );
//					final File newFile = HybsFileOperationFactory.create(fromStorage, fromBucket, StringUtil.urlAppend(directory, file2));
					final File newFile = HybsFileOperationFactory.create(fromLocal, StringUtil.urlAppend(directory, file2));
					if( newFile.exists() && !newFile.delete() ) {
						final String errMsg = "所定のﾌｧｲﾙを削除できませんでした｡[" + newFile + "]" ;
						throw new OgRuntimeException( errMsg );
					}
					rtnVal = file.renameTo( newFile );
				}
			}
			// 3.6.0.0 (2004/09/25) ACT_read を追加
			else if( ACT_READ.equalsIgnoreCase(			 action ) ) {
				if( file.isFile() ) {
					// 6.2.3.0 (2015/05/01)
					String text ;
					if( POIUtil.isPOI( file ) ) {
						text = POIUtil.extractor( file );
					}
					else {
						final String enc = encode == null ? "UTF-8" : encode ;
						text = POIUtil.extractor( file,enc );
					}

					rtnVal = true;
					setRequestAttribute( "read",text );
				}
				else {
					final String errMsg = "ﾌｧｲﾙが存在しないか､ﾌｧｲﾙではありません｡" + CR
							+ "\t  action=["	+ action	+ "]"	+ CR
							+ "\t  fileURL=["	+ fileURL	+ "]"	+ CR
							+ "\t  directory=[" + directory + "]"	+ CR
							+ "\t  file1=["		+ file1		+ "]"	+ CR ;
					throw new HybsSystemException( errMsg );
				}
			}
			// 3.8.5.2 (2006/05/31) ﾌｧｲﾙｻｲｽﾞが０Byte以上のﾌｧｲﾙが存在するかどうか判定｡
			else if( ACT_EXISTSLENGTH.equalsIgnoreCase( action ) ) {
				rtnVal = file.exists() && file.length() > 0L ;
			}
			// 5.3.6.0 (2011/06/01) ﾌｧｲﾙｺﾋﾟｰ対応
			// 6.0.0.1 (2014/04/25) These nested if statements could be combined
			// 6.3.6.1 (2015/08/28) ﾌｫﾙﾀﾞとﾌｧｲﾙの自動判定(FileUtil.copy側で判断する)
			else if( ACT_COPY.equalsIgnoreCase( action ) && file2 != null ) {
				// 8.0.0.1 (2021/10/08) fromStorage,fromBucket,toStorage,toBucket 追加
				// 8.0.1.0 (2021/10/29) storageType , bucketName 削除
//				final File newFile = new File( StringUtil.urlAppend( directory,file2 ) );
//				final File newFile = HybsFileOperationFactory.create(toStorage, toBucket, StringUtil.urlAppend(directory, file2));
				final File newFile = HybsFileOperationFactory.create(toLocal, StringUtil.urlAppend(directory, file2));

				if( file.exists() ) {
					// FileUtil.copy 側で､toFile のﾌｫﾙﾀﾞを作成します｡
					// 6.3.6.1 (2015/08/28) で､fromFile がﾃﾞｨﾚｸﾄﾘでも処理できるように変更｡
					rtnVal = FileUtil.copy( file, newFile );
				}
				else {
					final String errMsg = "copy元(file1)のﾌｧｲﾙが存在しません｡" + CR
							+ "\t  action=["	+ action	+ "]"	+ CR
							+ "\t  fileURL=["	+ fileURL	+ "]"	+ CR
							+ "\t  directory=[" + directory + "]"	+ CR
							+ "\t  file1=["		+ file1		+ "]" 	+ CR
							+ "\t  file2=["		+ file2		+ "]"	+ CR ;
					throw new HybsSystemException( errMsg );
				}
			}
			// 6.3.6.1 (2015/08/28) copyST ｱｸｼｮﾝ時に､copy元に､ｱﾄﾞﾚｽ指定できるようにする｡
			else if( ACT_COPYST.equalsIgnoreCase( action ) && file2 != null ) {
				// 8.0.0.1 (2021/10/08) fromStorage,fromBucket,toStorage,toBucket 追加
				final String toFile = StringUtil.urlAppend( directory,file2 );
//				final File newFile = new File( StringUtil.urlAppend( directory,file2 ) );
				final File newFile = new File( toFile );

				// ※ getResourceAsStream は､/gf/jsp/･･･ ではなく､/jsp/･･･ でのｱﾄﾞﾚｽ指定で取得します｡
				final ServletContext application = pageContext.getServletContext();
				rtnVal = FileUtil.copy( application.getResourceAsStream( file1 ), newFile );

				if( !rtnVal ) {
					final String errMsg = action + " ｱｸｼｮﾝが実行できませんでした｡" + CR
							+ "\t  action=["	+ action	+ "]"	+ CR
							+ "\t  fileURL=["	+ fileURL	+ "]"	+ CR
							+ "\t  directory=[" + directory + "]"	+ CR
							+ "\t  file1=["		+ file1		+ "]" 	+ CR
							+ "\t  file2=["		+ file2		+ "]"	+ CR ;
					throw new HybsSystemException( errMsg );
				}

				// 8.0.0.1 (2021/10/08) ｽﾄﾘｰﾑからｸﾗｳﾄﾞﾌｧｲﾙへのｺﾋﾟｰが上手くいかない｡
				// 一旦､ﾛｰｶﾙに出力したﾌｧｲﾙをｸﾗｳﾄﾞへｺﾋﾟｰしています｡
				// 8.0.0.2 (2021/10/15) ﾛｰｶﾙﾌｧｲﾙとｸﾗｳﾄﾞﾌｧｲﾙ間の移動｡ toStorage, toBucket 有りなので､他と方法が異なる｡
				// 8.0.1.0 (2021/10/29) storageType , bucketName 削除
//				final FileOperation cloudFile = HybsFileOperationFactory.create( toStorage, toBucket, toFile );
				final FileOperation cloudFile = HybsFileOperationFactory.create( toLocal, toFile );
//				if(!cloudFile.isLocal()){
				if( cloudFile.isCloud() ){
					FileUtil.copy( newFile,cloudFile );
					newFile.delete();
				}
			}
			// 6.2.3.0 (2015/05/01)
			else if( ACT_LIST.equalsIgnoreCase( action ) ) {
				final String[] files = file.isDirectory() ? file.list() : new String[] { file.getName() };
				final List<String> list = new ArrayList<>();

				// 6.3.9.0 (2015/11/06) null になっている可能性がある(findbugs)
				if( files != null ) {
					final boolean use = file2 == null || file2.isEmpty();
					for( final String nm : files ) {
						if( use || nm.matches( file2 ) ) {
							list.add( nm );
						}
					}
				}

				setRequestAttribute( "list",list );
				rtnVal = true;
			}
			// 5.9.2.2 (2015/11/20) zip追加
			else if( ACT_ZIP.equalsIgnoreCase( action ) && file2 != null ) {
				//あるかないかだけ見る
				// 6.4.1.1 (2016/01/16) PMD refactoring. When doing a String.toLowerCase()/toUpperCase() call, use a Locale
				if( file2.toLowerCase(Locale.JAPAN).indexOf( ".zip" ) < 0 ){
					file2 = file2 + ".zip";
				}
				final File zipFile = new File( StringUtil.urlAppend( directory,file2 ) );
				// 6.9.8.0 (2018/05/28) FindBugs:例外的戻り値を無視しているﾒｿｯﾄﾞ
//				zipFile.getParentFile().mkdirs();										// 6.8.0.0 (2017/06/02) zipFile の親ﾃﾞｨﾚｸﾄﾘを作成します｡
				final File parent = zipFile.getParentFile();		// 親ﾌｫﾙﾀﾞを取得｡nullもありえる
				if( parent == null || !parent.exists() && !parent.mkdirs() ) {
					final String errMsg = "zipFileﾌｧｲﾙの親ﾌｫﾙﾀﾞを作成できませんでした｡"	+ CR
										+ " zipFile=[" + zipFile + "]"	+ CR ;
					throw new HybsSystemException( errMsg );
				}

				final List<File> ziplist = ZipArchive.compress( file , zipFile );		// 6.7.0.0 (2016/12/28) 返り値で､正誤判定します｡
				rtnVal = !ziplist.isEmpty();			// 6.7.0.0 (2016/12/28) true/false の判定を入れます｡
			}
			// 6.7.0.0 (2016/12/28) timeStamp追加｡ﾀｲﾑｽﾀﾝﾌﾟを現在時刻に変更します｡
			else if( ACT_TIMESTAMP.equalsIgnoreCase( action ) ) {
				rtnVal = file.setLastModified( System.currentTimeMillis() );
			}

		return rtnVal;
	}

	/**
	 * 【TAG】ｱｸｼｮﾝ(canRead,canWrite,createNewFile,delete,renameTo,exists,isDirectory,isFile,isHidden,mkdir,mkdirs,read,existsLength,copy,copyST,list,zip,timeStamp)を指定します｡
	 *
	 * @og.tag
	 * ｱｸｼｮﾝは,HTMLから(get/post)指定されますので,ACT_xxx で設定される
	 * ﾌｨｰﾙﾄﾞ定数値のいづれかを､指定できます｡
	 * 処理の結果が､false の場合は､body 要素を表示して終了します｡
	 * useStop 属性と､notEquals 属性によって､上記の振る舞いをけることが可能です｡
	 *
	 *       canRead          読み込めるかどうかを判定｡
	 *       canWrite         変更できるかどうか判定｡
	 *       createNewFile    空の新しいﾌｧｲﾙを不可分 (atomic) に生成｡(そのﾌｧｲﾙがまだ存在しない場合だけ)
	 *       delete           ﾌｧｲﾙまたはﾃﾞｨﾚｸﾄﾘを削除(ﾃﾞｨﾚｸﾄﾘ階層をすべて削除)｡
	 *       renameTo         ﾌｧｲﾙまたはﾃﾞｨﾚｸﾄﾘ名を変更｡
	 *       exists           ﾌｧｲﾙが存在するかどうか判定｡
	 *       isDirectory      ﾌｧｲﾙがﾃﾞｨﾚｸﾄﾘであるかどうか判定｡
	 *       isFile           ﾌｧｲﾙが普通のﾌｧｲﾙかどうか判定｡
	 *       isHidden         ﾌｧｲﾙが隠しﾌｧｲﾙかどうか判定｡
	 *       mkdir            ﾃﾞｨﾚｸﾄﾘを生成｡
	 *       mkdirs           ﾃﾞｨﾚｸﾄﾘを複数生成｡
	 *       read             ﾌｧｲﾙを読み込んで､ﾊﾟﾗﾒｰﾀにｾｯﾄします(6.2.3.0 (2015/05/01))｡
	 *       existsLength     ﾌｧｲﾙｻｲｽﾞが０Byte以上のﾌｧｲﾙが存在するかどうか判定｡
	 *       copy             ﾌｧｲﾙまたはﾃﾞｨﾚｸﾄﾘをｺﾋﾟｰ(file1 ⇒ file2 にｺﾋﾟｰ)｡
	 *       copyST           ｽﾄﾘｰﾑﾌｧｲﾙをｺﾋﾟｰ(file1(ｱﾄﾞﾚｽ) ⇒ file2 にｺﾋﾟｰ)｡
	 *       list             ﾌｧｲﾙﾘｽﾄをListｵﾌﾞｼﾞｪｸﾄにｺﾋﾟｰして､ﾊﾟﾗﾒｰﾀにｾｯﾄします(6.2.3.0 (2015/05/01))｡
	 *       zip              ﾌｧｲﾙまたはﾃﾞｨﾚｸﾄﾘをZIPﾌｧｲﾙに圧縮します｡(file1⇒file2)
	 *       timeStamp        ﾌｧｲﾙのﾀｲﾑｽﾀﾝﾌﾟを現在時刻に変更します｡(file1のみ)
	 *
	 * ※1 copyST の file1 は､getResourceAsStream を使用の為､/gf/jsp/･･･ ではなく､/jsp/･･･ でのｱﾄﾞﾚｽ指定で取得します｡
	 *
	 * @og.rev 3.0.0.0 (2002/12/25) ACTION_LIST のﾁｪｯｸを導入
	 * @og.rev 3.5.6.2 (2004/07/05) 文字列の連結にStringBuilderを使用します｡
	 * @og.rev 6.3.4.0 (2015/08/01) ｴﾗｰﾒｯｾｰｼﾞを､変更｡
	 * @og.rev 6.3.6.1 (2015/08/28) copyST ｱｸｼｮﾝ追加
	 * @og.rev 6.4.3.4 (2016/03/11) String配列 から､Setに置き換えます｡
	 *
	 * @param	cmd ｱｸｼｮﾝ文字列
	 * @see		<a href="../../../../constant-values.html#org.opengion.hayabusa.taglib.FileTag.ACT_canRead">ｱｸｼｮﾝ定数</a>
	 */
	public void setAction( final String cmd ) {
		action = getRequestParameter( cmd );

		if( ! check( action, ACTION_SET ) ) {
			final String errMsg = "指定のｱｸｼｮﾝは実行できません｡ｱｸｼｮﾝｴﾗｰ"	+ CR
							+ "\t  action=["	+ action	+ "]"	+ CR
							+ "\t  actionList=" + String.join( ", " , ACTION_SET ) ;
			throw new HybsSystemException( errMsg );
		}
	}

	/**
	 * 【TAG】操作するﾌｧｲﾙのﾃﾞｨﾚｸﾄﾘを指定します
	 *		(初期値:FILE_URL[={@og.value SystemData#FILE_URL}])｡
	 *
	 * @og.tag
	 * この属性で指定されるﾃﾞｨﾚｸﾄﾘのﾌｧｲﾙを操作します｡
	 * 指定方法は､通常の fileURL 属性と同様に､先頭が､'/' (UNIX) または､２文字目が､
	 * ":" (Windows)の場合は､指定のURLそのままのﾃﾞｨﾚｸﾄﾘに､そうでない場合は､
	 * (初期値:ｼｽﾃﾑ定数のFILE_URL[={@og.value SystemData#FILE_URL}])｡
	 *
	 * @og.rev 4.0.0.0 (2005/01/31) urlAppend ﾒｿｯﾄﾞの利用
	 * @og.rev 4.0.0.0 (2007/11/20) 指定されたﾃﾞｨﾚｸﾄﾘ名の最後が"\"or"/"で終わっていない場合に､"/"を付加する｡
	 * @og.rev 6.4.2.1 (2016/02/05) URLの最後に､"/" を追加する処理を廃止｡
	 *
	 * @param	url ﾌｧｲﾙURL
	 * @see		org.opengion.hayabusa.common.SystemData#FILE_URL
	 */
	public void setFileURL( final String url ) {
		final String furl = nval( getRequestParameter( url ),null );
		if( furl != null ) {
			fileURL = StringUtil.urlAppend( fileURL,furl );
		}
	}

	/**
	 * 【TAG】基準となるﾌｧｲﾙ名を指定します(ｺﾏﾝﾄﾞの左辺のﾌｧｲﾙ名です)｡
	 *
	 * @og.tag
	 * ｺﾏﾝﾄﾞの左辺のﾌｧｲﾙ名です｡
	 *
	 * ※ 6.3.6.1 (2015/08/28)
	 *    copyST ｱｸｼｮﾝ時に､copy元に､ｱﾄﾞﾚｽ指定できるようにする｡
	 *
	 * @param	fname ﾌｧｲﾙ名１
	 */
	public void setFile1( final String fname ) {
		file1 = nval( getRequestParameter( fname ),file1 );
	}

	/**
	 * 【TAG】処理結果となるﾌｧｲﾙ名を指定します(ｺﾏﾝﾄﾞの右辺のﾌｧｲﾙ名です)｡
	 *
	 * @og.tag
	 * ｺﾏﾝﾄﾞの右辺のﾌｧｲﾙ名です｡
	 * ただし､action="list" の時は､file2 を､ﾌｨﾙﾀｰとして使用します｡
	 *
	 * @param	fname ﾌｧｲﾙ名２
	 */
	public void setFile2( final String fname ) {
		file2 = nval( getRequestParameter( fname ),file2 );
	}

	/**
	 * 【TAG】判定結果を反転させるかどうか[true/false]を指定します(初期値:false)｡
	 *
	 * @og.tag
	 * 通常の判定結果において､不成立(false)の場合に､BODY を実行します｡
	 * 通常の処理結果の正反対の処理を行います｡
	 * 初期値は､通常 (true 以外)です｡
	 *
	 * @og.rev 3.8.5.2 (2006/05/31) 新規追加
	 *
	 * @param   flag 判定結果反転 [true:反転する/それ以外:通常]
	 */
	public void setNotEquals( final String flag ) {
		notEquals = nval( getRequestParameter( flag ),notEquals );
	}

	/**
	 * 【TAG】ｴﾗｰ時BODYを処理後に停止するかどうか[true/false]を指定します(初期値:true)｡
	 *
	 * @og.tag
	 * 処理結果などに応じて､以下の処理を停止したい場合に､使用します｡
	 * 通常は､条件を判定後､false の場合に､BODY部を出力(処理)した後に､
	 * 処理を停止します｡(useStop="true")
	 * false を指定すると､判定結果に無関係に､以下の処理を実行します｡
	 * 処理は継続したいが､警告表示する場合に､useStop="false" を指定します｡
	 * 初期値は､停止する ("true")です｡
	 *
	 * @og.rev 3.8.5.2 (2006/05/31) 新規追加
	 *
	 * @param   flag 処理後停止 [true:する/それ以外:しない]
	 */
	public void setUseStop( final String flag ) {
		useStop = nval( getRequestParameter( flag ),useStop );
	}

	/**
	 * 【TAG】ﾌｧｲﾙを読み込む(action="read")際のｴﾝｺｰﾄﾞを指定します(初期値:OS依存文字ｺｰﾄﾞ)｡
	 *
	 * @og.tag
	 * ﾌｧｲﾙを読み込む(action="read")際のｴﾝｺｰﾄﾞを指定します｡
	 * action="read"以外場合には､この属性値は利用されません｡
	 * 指定しない場合は､OS依存文字ｺｰﾄﾞで読み込まれます｡
	 *
	 * @og.rev 5.1.9.0 (2010/08/01) 新規作成
	 *
	 * @param   enc ﾌｧｲﾙ読み込みのｴﾝｺｰﾄﾞ
	 */
	public void setEncode( final String enc ) {
		encode = nval( getRequestParameter( enc ),encode );
	}

//	/**
//	 * 【TAG】ﾃﾝﾌﾟﾚｰﾄﾌｧｲﾙの読み込み元ｽﾄﾚｰｼﾞﾀｲﾌﾟを指定します｡
//	 *
//	 * @og.tag
//	 * ﾌｸﾗｳﾄﾞ読み込み時の､from に当たるｽﾄﾚｰｼﾞﾀｲﾌﾟを指定します｡
//	 * 初期値は､ｼｽﾃﾑ定数の『CLOUD_TARGET』です｡(例：AWS)
//	 * 強制的に､ﾛｰｶﾙﾌｧｲﾙを指定する場合は､空文字列ではなく､"LOCAL" を指定します｡
//	 *
//	 * @og.rev 8.0.1.0 (2021/10/29) 新規作成
//	 * @og.rev 8.0.1.0 (2021/10/29) useLocal 属性を追加｡storageType , bucketName 削除
//	 *
//	 * @param   fromType 元ｽﾄﾚｰｼﾞﾀｲﾌﾟ
//	 */
//	public void setFromStorage( final String fromType ) {
//		fromStorage = nval( getRequestParameter( fromType ),fromStorage );
//	}

//	/**
//	 * 【TAG】ﾃﾝﾌﾟﾚｰﾄﾌｧｲﾙの読み込み元ﾊﾞｹｯﾄ名を指定します｡
//	 *
//	 * @og.tag
//	 * ﾌｸﾗｳﾄﾞ読み込み時の､from に当たるﾊﾞｹｯﾄ名を指定します｡
//	 * 初期値は､ｼｽﾃﾑ定数の『CLOUD_BUCKET』です｡
//	 * 強制的に､ﾛｰｶﾙﾌｧｲﾙを指定する場合は､空文字列ではなく､"LOCAL" を指定します｡
//	 *
//	 * @og.rev 8.0.1.0 (2021/10/29) 新規作成
//	 * @og.rev 8.0.1.0 (2021/10/29) useLocal 属性を追加｡storageType , bucketName 削除
//	 *
//	 * @param   fromBkt 元ﾊﾞｹｯﾄ名
//	 */
//	public void setFromBucket( final String fromBkt ) {
//		fromBucket = nval( getRequestParameter( fromBkt ),fromBucket );
//	}

//	/**
//	 * 【TAG】生成したﾌｧｲﾙの出力先ｽﾄﾚｰｼﾞﾀｲﾌﾟを指定します｡
//	 *
//	 * @og.tag
//	 * ﾌｸﾗｳﾄﾞ書き込み時の､to に当たるｽﾄﾚｰｼﾞﾀｲﾌﾟを指定します｡
//	 * 初期値は､ｼｽﾃﾑ定数の『CLOUD_TARGET』です｡
//	 * 強制的に､ﾛｰｶﾙﾌｧｲﾙを指定する場合は､空文字列ではなく､"LOCAL" を指定します｡
//	 *
//	 * @og.rev 8.0.1.0 (2021/10/29) 新規作成
//	 * @og.rev 8.0.1.0 (2021/10/29) useLocal 属性を追加｡storageType , bucketName 削除
//	 *
//	 * @param   toType 出力先ｽﾄﾚｰｼﾞﾀｲﾌﾟ
//	 */
//	public void setToStorage( final String toType ) {
//		toStorage = nval( getRequestParameter( toType ),toStorage );
//	}

//	/**
//	 * 【TAG】生成したﾌｧｲﾙの出力先ﾊﾞｹｯﾄ名を指定します｡
//	 *
//	 * @og.tag
//	 * ﾌｸﾗｳﾄﾞ書き込み時の､to に当たるﾊﾞｹｯﾄ名を指定します｡
//	 * 初期値は､ｼｽﾃﾑ定数の『CLOUD_TARGET』です｡
//	 * 強制的に､ﾛｰｶﾙﾌｧｲﾙを指定する場合は､空文字列ではなく､"LOCAL" を指定します｡
//	 *
//	 * @og.rev 8.0.1.0 (2021/10/29) 新規作成
//	 * @og.rev 8.0.1.0 (2021/10/29) useLocal 属性を追加｡storageType , bucketName 削除
//	 *
//	 * @param   toBkt 出力先ﾊﾞｹｯﾄ名
//	 */
//	public void setToBucket( final String toBkt ) {
//		toBucket = nval( getRequestParameter( toBkt ),toBucket );
//	}

	/**
	 * 【TAG】ｼｽﾃﾑ定数でｸﾗｳﾄﾞ設定されていても､ｸﾗｳﾄﾞ環境を使用しない場合､trueを指定します(初期値:false)｡
	 *
	 * @og.tag
	 * ｸﾗｳﾄﾞ設定は､ｼｽﾃﾑ定数の『CLOUD_TARGET』と『CLOUD_BUCKET』の設定で自動的に使用しますが､
	 * どうしてもﾛｰｶﾙでのみ使いたい場合は､この属性を true に設定します｡
	 * 標準はfalse:設定どおりとなります｡
	 * fromStorage,fromBucket,toStorage,toBucket
	 * from や to だけを強制的に､ﾛｰｶﾙﾌｧｲﾙを指定する場合は､空文字列ではなく､
	 * fromStorage,fromBucket や､toStorage,toBucket に､"LOCAL" を指定します｡
	 * storegeとbucketは､どちらかが､LOCAL の場合は､ﾛｰｶﾙﾌｧｲﾙ を使用します｡
	 *
	 * true/false以外を指定した場合はfalse扱いとします｡
	 *
	 * @og.rev 8.0.1.0 (2021/10/29) useLocal 属性を追加｡
	 * @og.rev 8.0.1.0 (2021/10/29) useLocal 属性を追加｡storageType , bucketName 削除
	 *
	 * @param flag ﾛｰｶﾙ環境のみ [true:ﾛｰｶﾙのみ/false:設定どおり]
	 */
	public void setUseLocal( final String flag ) {
		useLocal = nval( getRequestParameter( flag ),useLocal );
	}

	/**
	 * 【TAG】ｼｽﾃﾑ定数でｸﾗｳﾄﾞ設定されていても､ｸﾗｳﾄﾞ環境を使用しない場合､trueを指定します(初期値:false)｡
	 *
	 * @og.tag
	 * ｸﾗｳﾄﾞ設定は､ｼｽﾃﾑ定数の『CLOUD_TARGET』と『CLOUD_BUCKET』の設定で自動的に使用しますが､
	 * どうしてもﾛｰｶﾙでのみ使いたい場合は､この属性を true に設定します｡
	 * 標準はfalse:設定どおりとなります｡
	 *
	 * true/false以外を指定した場合はfalse扱いとします｡
	 *
	 * @og.rev 8.0.1.0 (2021/10/29) useLocal 属性を追加｡
	 *
	 * @param flag ﾛｰｶﾙ環境のみ [true:ﾛｰｶﾙのみ/false:設定どおり]
	 */
	public void setFromLocal( final String flag ) {
		fromLocal = nval( getRequestParameter( flag ),fromLocal );
	}

	/**
	 * 【TAG】ｼｽﾃﾑ定数でｸﾗｳﾄﾞ設定されていても､ｸﾗｳﾄﾞ環境を使用しない場合､trueを指定します(初期値:false)｡
	 *
	 * @og.tag
	 * ｸﾗｳﾄﾞ設定は､ｼｽﾃﾑ定数の『CLOUD_TARGET』と『CLOUD_BUCKET』の設定で自動的に使用しますが､
	 * どうしてもﾛｰｶﾙでのみ使いたい場合は､この属性を true に設定します｡
	 * 標準はfalse:設定どおりとなります｡
	 *
	 * true/false以外を指定した場合はfalse扱いとします｡
	 *
	 * @og.rev 8.0.1.0 (2021/10/29) useLocal 属性を追加｡
	 *
	 * @param flag ﾛｰｶﾙ環境のみ [true:ﾛｰｶﾙのみ/false:設定どおり]
	 */
	public void setToLocal( final String flag ) {
		toLocal = nval( getRequestParameter( flag ),toLocal );
	}

	/**
	 * このｵﾌﾞｼﾞｪｸﾄの文字列表現を返します｡
	 * 基本的にﾃﾞﾊﾞｯｸﾞ目的に使用します｡
	 *
	 * @return このｸﾗｽの文字列表現
	 * @og.rtnNotNull
	 */
	@Override
	public String toString() {
		return ToString.title( this.getClass().getName() )
				.println( "VERSION"		,VERSION	)
				.println( "fileURL"		,fileURL	)
				.println( "file1"		,file1		)
				.println( "file2"		,file2		)
				.println( "action"		,action		)
				.println( "rtnCode"		,rtnCode	)
				.println( "notEquals"	,notEquals	)
				.println( "useStop"		,useStop	)
				.println( "Other..."	,getAttributes().getAttribute() )
				.fixForm().toString() ;
	}
}
