    001/*
    002 * Copyright (c) 2009 The openGion Project.
    003 *
    004 * Licensed under the Apache License, Version 2.0 (the "License");
    005 * you may not use this file except in compliance with the License.
    006 * You may obtain a copy of the License at
    007 *
    008 *     http://www.apache.org/licenses/LICENSE-2.0
    009 *
    010 * Unless required by applicable law or agreed to in writing, software
    011 * distributed under the License is distributed on an "AS IS" BASIS,
    012 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND,
    013 * either express or implied. See the License for the specific language
    014 * governing permissions and limitations under the License.
    015 */
    016package org.opengion.hayabusa.taglib;
    017
    018import java.io.File;                                                                                                                    // 8.1.2.0 (2022/03/10)
    019import java.io.IOException;
    020import java.util.List;
    021import java.util.ArrayList;
    022import java.util.Locale;                                                                                                                // 6.0.2.4 (2014/10/17)
    023
    024import jakarta.servlet.http.HttpServletRequest;
    025
    026// import org.opengion.fukurou.model.FileOperation;                                                             // 8.0.1.0 (2021/10/29)
    027import org.opengion.fukurou.security.HybsCryptography;                                                  // 8.1.2.0 (2022/03/10)
    028import org.opengion.fukurou.util.StringUtil;
    029import org.opengion.fukurou.util.ToString;                                                                              // 6.1.1.0 (2015/01/17)
    030import org.opengion.hayabusa.common.HybsSystem;
    031import org.opengion.hayabusa.common.HybsSystemException;
    032import org.opengion.hayabusa.db.DBColumn;
    033import org.opengion.hayabusa.db.DBTableModel;
    034import org.opengion.hayabusa.db.DBTableModelUtil;
    035import org.opengion.hayabusa.servlet.MultipartRequest;
    036import org.opengion.hayabusa.servlet.UploadedFile;
    037
    038import static org.opengion.fukurou.util.StringUtil.nval;
    039
    040/**
    041 * ｸﾗｲｱﾝﾄのﾌｧｲﾙをｻｰﾊﾞｰにｱｯﾌﾟﾛｰﾄﾞするﾀｸﾞです。
    042 *
    043 * ｱｯﾌﾟﾛｰﾄﾞ後の属性は、DBTableModel に格納することにより、通常のﾃﾞｰﾀと
    044 * 同様の取り出し方が可能です。
    045 * また、通常のﾌｧｲﾙｱｯﾌﾟﾛｰﾄﾞ時の、form で使用する、enctype="multipart/form-data"
    046 * を指定した場合の、他のﾘｸｴｽﾄ情報も、{&#064;XXXX} 変数で取り出すことが可能です。
    047 *
    048 * この upload ﾀｸﾞでは、ｱｯﾌﾟﾛｰﾄﾞ後に、指定のﾌｧｲﾙ名に変更する機能があります。
    049 * file 登録ﾀﾞｲｱﾛｸﾞで指定した name に、"_NEW" という名称を付けたﾘｸｴｽﾄ値を
    050 * ﾌｧｲﾙのｱｯﾌﾟﾛｰﾄﾞと同時に送信することで、この名前にﾌｧｲﾙを付け替えます。
    051 * また、ｱｯﾌﾟﾛｰﾄﾞ後のﾌｧｲﾙ名は、name 指定の名称で、取り出せます。
    052 * ｸﾗｲｱﾝﾄから登録したｵﾘｼﾞﾅﾙのﾌｧｲﾙ名は、name に、"_ORG" という名称
    053 * で取り出すことが可能です。
    054 *
    055 * 通常では、これらのﾊﾟﾗﾒｰﾀを、RequestAttribute 変数にｾｯﾄしますので、{&#064;XXXX}で
    056 * 取り出すことが可能になります。さらに、"KEY","VALUE","ISFILE" のｶﾗﾑを持った、
    057 * DBTableModel にｾｯﾄします。
    058 *
    059 * 新機能として、columns を指定する事で、columns のｶﾗﾑを持つ DBTableModel にｾｯﾄします。
    060 * その場合は、ｶﾗﾑ名_01 ～ ｶﾗﾑ名_99 のように、ｱﾝﾀﾞｰﾊﾞｰで列ﾃﾞｰﾀとなるｷｰを定義してください。
    061 * ｱﾝﾀﾞｰﾊﾞｰがない場合は、ｶﾗﾑだけ作成されます。ｶﾗﾑ名と同じﾘｸｴｽﾄがあれば、
    062 * すべてのﾚｺｰﾄﾞに同じ値がｾｯﾄされます。
    063 *
    064 * 新ﾌｧｲﾙ名に拡張子が設定されていない場合は、ｵﾘｼﾞﾅﾙﾌｧｲﾙ名の拡張子をｾｯﾄします。
    065 *
    066 * HTML5 の type="file" 時の multiple 属性（ｱｯﾌﾟﾛｰﾄﾞﾌｧｲﾙの複数選択機能）に対応します。(5.7.1.1 (2013/12/13))
    067 * その場合は、新しいﾌｧｲﾙ名への変更はできません。ｵﾘｼﾞﾅﾙのﾌｧｲﾙ名でｱｯﾌﾟﾛｰﾄﾞされます
    068 *
    069 * 6.0.2.4 (2014/10/17)
    070 * ① name + _NEW と同じ考え方で、_PFX(接頭辞) , _SFX(接尾辞) 機能を追加します。
    071 * ② 上記機能は、_NEW との併用可能。_NEW がない場合は、ｵﾘｼﾞﾅﾙ(ｱｯﾌﾟﾛｰﾄﾞされた元のﾌｧｲﾙ名)に付与
    072 * ③ useBackup="rename" で、すでに同名のﾌｧｲﾙが存在した場合に、"_001" のような文字列を追加したﾌｧｲﾙにﾘﾈｰﾑします。
    073 *    Windowsの " - ｺﾋﾟｰ (2)" に近いですが、桁数を抑えるのと、useBackup="true" と異なり、過去の同一ﾌｧｲﾙ名は
    074 *    そのまま、有効になります。同一ﾌｧｲﾙが同一ﾌｫﾙﾀﾞに存在する場合のみ連番が付与されます。
    075 * ④ name + _NEW の指定に、ﾌｫﾙﾀﾞを含めることが可能。ただし、接続文字列は、"/" とする。
    076 *    同時にｱｯﾌﾟﾛｰﾄﾞを行う場合に、個別にﾌｫﾙﾀﾞを振り分けたり、_PFX(接頭辞) に、ﾌｫﾙﾀﾞを指定
    077 *    することも可能です。
    078 * ⑤ 最大転送ｻｲｽﾞ(Byte)を 10M → 30M に変更
    079 *
    080 * 8.1.2.0 (2022/03/10)
    081 * name + _NEW と同じ考え方で、_HASH(ﾌｧｲﾙのﾊｯｼｭ値) 機能を追加します。
    082 * ｼｽﾃﾑ定数のFILE_HASH_CODEで計算されたﾊｯｼｭ値を DBTableModel に格納します。
    083 *
    084 * @og.formSample
    085 * ●形式：&lt;og:upload fileURL="…" maxPostSize="…" /&gt;
    086 * ●body：なし
    087 *
    088 * ●Tag定義：
    089 *       &lt;og:upload
    090 *               fileURL                        【TAG】ﾌｧｲﾙをｱｯﾌﾟﾛｰﾄﾞするﾃﾞｨﾚｸﾄﾘを指定します (初期値:FILE_URL[=filetemp/])
    091 *               filename                       【TAG】(通常は使いません)ﾌｧｲﾙを作成するときのﾌｧｲﾙ名をｾｯﾄします(初期値:null)
    092 *               maxPostSize            【TAG】最大転送ｻｲｽﾞ(Byte)を指定します(初期値:31457280=30M) 0,またはﾏｲﾅｽで無制限です。
    093 *               scope                          【TAG】ｷｬｯｼｭする場合のｽｺｰﾌﾟ[request/page/session/application]を指定します(初期値:session)
    094 *               tableId                        【TAG】(通常は使いません)sessionから所得する DBTableModelｵﾌﾞｼﾞｪｸﾄの ID
    095 *               columns                        【TAG】DBTableModel作成時に、指定のｶﾗﾑの"_01"～"_99"の添え字をﾚｺｰﾄﾞとして作成します。
    096 *               useBackup                      【TAG】すでに同名のﾌｧｲﾙが存在した場合に、ﾊﾞｯｸｱｯﾌﾟ処理するかどうか[true/false/rename]を指定します(初期値:null=false)
    097 *                                                                      useBackup="rename" で、"_001" のような文字列を追加します。
    098 * ×     storage                        【廃止】保存先ｽﾄﾚｰｼﾞﾀｲﾌﾟを指定します   5.10.9.0 (2019/03/01) ADD
    099 * ×     bucket                         【廃止】保存先ﾊﾞｹｯﾄ名を指定します 5.10.9.0 (2019/03/01) ADD
    100 *               useLocal                       【TAG】ｼｽﾃﾑ定数でｸﾗｳﾄﾞ設定されていても、ｸﾗｳﾄﾞ環境を使用しない場合、trueを指定します(初期値:false) 8.0.1.0 (2021/10/29)
    101 *               language                       【TAG】ﾀｸﾞ内部で使用する言語ｺｰﾄﾞ[ja/en/zh/…]を指定します
    102 *               debug                          【TAG】ﾃﾞﾊﾞｯｸﾞ情報を出力するかどうか[true/false]を指定します(初期値:false)
    103 *       /&gt;
    104 *
    105 * ●使用例 :
    106 * 【query.jsp】
    107 *               &lt;form method="POST" action="result.jsp" enctype="multipart/form-data" target="RESULT"&gt;
    108 *               &lt;table&gt;
    109 *               &lt;tr&gt;&lt;og:input type="text" name="submitter" value="{&#064;USER.JNAME}" size="20" lbl="MSG0014" /&gt;&lt;/tr&gt;
    110 *               &lt;tr&gt;
    111 *                       &lt;og:input type="file"       name="file_01"          size="30" lbl="MSG0015" /&gt;
    112 *                       &lt;og:input                           name="file_01_NEW"      size="10" lbl="FILENAME" /&gt;
    113 *               &lt;/tr&gt;&lt;tr&gt;
    114 *                       &lt;og:input type="file"       name="file_02"          size="30" lbl="MSG0015" /&gt;
    115 *                       &lt;og:input                           name="file_02_NEW"      size="10" lbl="FILENAME" /&gt;
    116 *               &lt;/tr&gt;&lt;tr&gt;
    117 *                       &lt;og:input type="file"       name="file_03"          size="30" lbl="MSG0015" /&gt;
    118 *                       &lt;og:input                           name="file_03_NEW"      size="10" lbl="FILENAME" /&gt;
    119 *               &lt;/tr&gt;&lt;tr&gt;
    120 *                       &lt;og:column name="writable"  value="false"   /&gt;
    121 *               &lt;/tr&gt;
    122 *               &lt;/table&gt;
    123 *
    124 * 【result.jsp】
    125 *               &lt;og:upload
    126 *                       fileURL        = "{&#064;USER.ID}"
    127 *               /&gt;
    128 *               &lt;br /&gt;
    129 *               &lt;og:message lbl="MSG0003" comment="ﾌｧｲﾙの登録が完了しました。" /&gt;
    130 *
    131 *               &lt;og:view
    132 *                       command                = "NEW"
    133 *                       viewFormType   = "HTMLTable"
    134 *                       writable               = "{&#064;writable}"
    135 *               /&gt;
    136 *
    137 *               &lt;table&gt;
    138 *               &lt;tr&gt;&lt;og:input name="submitter"        value="{&#064;submitter}"       /&gt;&lt;/tr&gt;
    139 *               &lt;tr&gt;&lt;og:input name="writable"         value="{&#064;writable}"        /&gt;&lt;/tr&gt;
    140 *               &lt;tr&gt;&lt;og:input name="directory"        value="{&#064;directory}"       /&gt;&lt;/tr&gt;
    141 *               &lt;tr&gt;&lt;og:input name="file_01"          value="{&#064;file_01}"         /&gt;&lt;/tr&gt;
    142 *               &lt;tr&gt;&lt;og:input name="file_01_NEW"      value="{&#064;file_01_NEW}"     /&gt;&lt;/tr&gt;
    143 *               &lt;tr&gt;&lt;og:input name="file_01_ORG"      value="{&#064;file_01_ORG}"     /&gt;&lt;/tr&gt;
    144 *               &lt;tr&gt;&lt;og:input name="file_02"          value="{&#064;file_02}"         /&gt;&lt;/tr&gt;
    145 *               &lt;tr&gt;&lt;og:input name="file_02_NEW"      value="{&#064;file_02_NEW}"     /&gt;&lt;/tr&gt;
    146 *               &lt;tr&gt;&lt;og:input name="file_02_ORG"      value="{&#064;file_02_ORG}"     /&gt;&lt;/tr&gt;
    147 *               &lt;tr&gt;&lt;og:input name="file_03"          value="{&#064;file_03}"         /&gt;&lt;/tr&gt;
    148 *               &lt;tr&gt;&lt;og:input name="file_03_NEW"      value="{&#064;file_03_NEW}"     /&gt;&lt;/tr&gt;
    149 *               &lt;tr&gt;&lt;og:input name="file_03_ORG"      value="{&#064;file_03_ORG}"     /&gt;&lt;/tr&gt;
    150 *               &lt;/table&gt;
    151 *
    152 * 【result.jsp】
    153 *               &lt;og:upload
    154 *                       fileURL         = "{&#064;USER.ID}"
    155 *                       columns         = "submitter,file"
    156 *               /&gt;
    157 *               &lt;br /&gt;
    158 *               &lt;og:message lbl="MSG0003" comment="ﾌｧｲﾙの登録が完了しました。" /&gt;
    159 *
    160 *               &lt;og:view
    161 *                       command          = "NEW"
    162 *                       viewFormType = "HTMLTable"
    163 *                       writable         = "{&#064;writable}"
    164 *               /&gt;
    165 *
    166 * @og.group ﾌｧｲﾙ入力
    167 *
    168 * @version  4.0
    169 * @author       Kazuhiko Hasegawa
    170 * @since    JDK5.0,
    171 */
    172public class FileUploadTag extends CommonTagSupport {
    173        /** このﾌﾟﾛｸﾞﾗﾑのVERSION文字列を設定します。 {@value} */
    174        private static final String VERSION = "8.2.0.2 (2022/06/24)" ;
    175        private static final long serialVersionUID = 820220220624L ;
    176
    177        /** 5.7.6.3 (2014/05/23) ｱｯﾌﾟﾛｰﾄﾞﾌｧｲﾙのCSVｾｯﾄのｷｰ */
    178        public static final String UPLOAD_FILES = "UPLOAD_FILES" ;
    179
    180        // 3.5.2.0 (2003/10/20) ｶﾗﾑ名に、ISFILEを追加。
    181        private static final String[] NAMES = { "KEY","VALUE","ISFILE" };                       // 6.4.1.1 (2016/01/16) names → NAMES  refactoring
    182        private static final String   ENCODE = "UTF-8";                                                         // 3.5.2.0 (2003/10/20) 廃止
    183        private static final String   HASH_CODE = HybsSystem.sys( "FILE_HASH_CODE" );// 8.1.2.0 (2022/03/10)
    184
    185        private String  fileURL         = HybsSystem.sys( "FILE_URL" );
    186        private String  filename        ;                                                                                               // 3.5.4.2 (2003/12/15)
    187
    188        private int             maxPostSize = 30*1024*1024;                                                                     // 6.0.2.4 (2014/10/17) 最大ﾌｧｲﾙ容量  30MB
    189        private String  tableId         = HybsSystem.TBL_MDL_KEY ;
    190
    191        // 5.6.5.2 (2013/06/21) DBTableModel作成時に、指定のｶﾗﾑの"_01"～"_99"の添え字をﾚｺｰﾄﾞとして作成します。
    192        private String          columns         ;
    193        // 5.6.5.3 (2013/06/28) すでに同名のﾌｧｲﾙが存在した場合に、ﾊﾞｯｸｱｯﾌﾟ処理(renameTo)するかどうか[true/false]を指定します(初期値:false)
    194        // 6.0.2.4 (2014/10/17) useBackup は、true/false/rename が指定可能
    195        private String  useBackup       ;
    196//      private String  storage         ;               // 5.10.9.0 (2019/03/01) ADD 8.0.1.0 (2021/10/29) DEL
    197//      private String  bucket          ;               // 5.10.9.0 (2019/03/01) ADD 8.0.1.0 (2021/10/29) DEL
    198        private boolean useLocal        ;               // 8.0.1.0 (2021/10/29) ｸﾗｳﾄﾞ設定を使用しない場合は、true
    199
    200        /**
    201         * ﾃﾞﾌｫﾙﾄｺﾝｽﾄﾗｸﾀｰ
    202         *
    203         * @og.rev 6.4.2.0 (2016/01/29) PMD refactoring. Each class should declare at least one constructor.
    204         */
    205        public FileUploadTag() { super(); }             // これも、自動的に呼ばれるが、空のﾒｿｯﾄﾞを作成すると警告されるので、明示的にしておきます。
    206
    207        /**
    208         * Taglibの終了ﾀｸﾞが見つかったときに処理する doEndTag() を ｵｰﾊﾞｰﾗｲﾄﾞします。
    209         *
    210         * @og.rev 2.2.0.0 (2002/12/17) 中国語(国際化)対応 ｴﾝｺｰﾄﾞの取得方法変更
    211         * @og.rev 3.1.1.2 (2003/04/04) Tomcat4.1 対応。release2() を doEndTag()で呼ぶ。
    212         * @og.rev 3.1.3.0 (2003/04/10) UTF-8 決め打ちのｴﾝｺｰﾄﾞ情報を取得する。
    213         * @og.rev 3.5.2.0 (2003/10/20) scope 属性を追加。
    214         * @og.rev 3.5.4.2 (2003/12/15) ﾌｧｲﾙ名を指定できるようにします。
    215         * @og.rev 3.6.0.8 (2004/11/19) DBTableModel をｾｰﾌﾞする時に、ﾄﾗﾝｻﾞｸｼｮﾝﾁｪｯｸを行います。
    216         * @og.rev 3.7.1.1 (2005/05/23) ﾌｫﾙﾀﾞがない場合は、複数階層分のﾌｫﾙﾀﾞを自動で作成します。
    217         * @og.rev 3.8.1.3A (2006/01/30) 新ﾌｧｲﾙ名にｵﾘｼﾞﾅﾙﾌｧｲﾙ名の拡張子をｾｯﾄします
    218         * @og.rev 5.3.7.0 (2011/07/01) ｴﾗｰﾒｯｾｰｼﾞ内容変更
    219         * @og.rev 5.6.5.2 (2013/06/21) columns 属性の追加
    220         * @og.rev 5.6.5.3 (2013/06/28) useBackup 属性の追加
    221         * @og.rev 5.8.8.0 (2015/06/05) ｴﾗｰ文の日本語化
    222         * @og.rev 5.9.25.0 (2017/10/06) ｸﾗｳﾄﾞｽﾄﾚｰｼﾞの利用追加対応
    223         * @og.rev 6.9.0.1 (2018/02/05) ﾌｧｲﾙをｾｰﾌﾞするﾃﾞｨﾚｸﾄﾘは、必要な場合のみ、作成します。
    224         * @og.rev 8.0.1.0 (2021/10/29) storageType , bucketName 削除
    225         *
    226         * @return      後続処理の指示
    227         */
    228        @Override
    229        public int doEndTag() {
    230                debugPrint();           // 4.0.0 (2005/02/28)
    231                startQueryTransaction( tableId );               // 3.6.0.8 (2004/11/19)
    232                final HttpServletRequest request = (HttpServletRequest)getRequest();
    233
    234//              if( useLocal ) {        // 8.0.1.0 (2021/10/29) ｸﾗｳﾄﾞ設定を使用しない場合は、true
    235//                      bucket = FileOperation.LOCAL ;
    236//              }
    237
    238                try {
    239                        final String directory = HybsSystem.url2dir( fileURL );
    240                        // 6.9.0.1 (2018/02/05) ﾌｧｲﾙをｾｰﾌﾞするﾃﾞｨﾚｸﾄﾘは、必要な場合のみ、作成します。
    241//                      final File dir = new File(directory);
    242//                      if( ! dir.exists() && ! dir.mkdirs() ) {
    243//                              // ERR0043:ﾃﾞｨﾚｸﾄﾘの作成に失敗しました。
    244//                              final String errMsg = getResource().getLabel( "ERR0043" ) + "[" + directory + "]"; // 5.8.8.0 (2015/06/05)
    245//                              throw new HybsSystemException( errMsg );
    246//                      }
    247
    248                        // 3.8.1.3A (2006/01/30) 新ﾌｧｲﾙ名にｵﾘｼﾞﾅﾙﾌｧｲﾙ名の拡張子をｾｯﾄします
    249                        // 5.6.5.3 (2013/06/28) useBackup 属性の追加
    250                        // 5.9.25.0 (2017/10/06) fileURL 属性の追加
    251                        // 5.10.9.0 (2019/03/01) storage, bucket を追加。
    252//                      final MultipartRequest multi = new MultipartRequest( request,directory,maxPostSize,ENCODE,filename,useBackup,fileURL );
    253                        // 8.0.1.0 (2021/10/29) storageType , bucketName 削除
    254//                      final MultipartRequest multi = new MultipartRequest( request,directory,maxPostSize,ENCODE,filename,useBackup,fileURL,storage,bucket );
    255                        final MultipartRequest multi = new MultipartRequest( request,directory,maxPostSize,ENCODE,filename,useBackup,fileURL,useLocal );
    256//                      // 5.6.5.2 (2013/06/21) columns 属性の追加
    257//                      DBTableModel table = null;
    258//                      if( columns == null ) {                                         // 5.6.5.2 (2013/06/21) columns 属性の追加
    259//                              table = makeDBTable( multi );
    260//                      }
    261//                      else {
    262//                              table = makeDBTableFromClms( multi );
    263//                      }
    264
    265                        // 6.9.0.1 (2018/02/05) ついでに修正
    266                        final DBTableModel table = columns == null ? makeDBTable( multi ) : makeDBTableFromClms( multi );
    267
    268                        // 3.5.2.0 (2003/10/20) scope 属性を追加。
    269                        // 3.6.0.8 (2004/11/19) ﾄﾗﾝｻﾞｸｼｮﾝﾁｪｯｸを行います。
    270                        if( ! commitTableObject( tableId, table ) ) {
    271                                // ERR0041:検索処理中に割り込みの検索要求がありました。処理されません。
    272                                jspPrint( "FileUploadTag " + getResource().getLabel( "ERR0041" ) ); // 5.8.8.0 (2015/06/05)
    273                                return SKIP_PAGE;
    274                        }
    275                }
    276                // 6.9.0.1 (2018/02/05) ｾｰﾌﾞﾃﾞｨﾚｸﾄﾘ に関係するｴﾗｰを、IllegalArgumentException で返します。(無理から)
    277                catch( final IllegalArgumentException ex ) {
    278                                // ERR0043:ﾃﾞｨﾚｸﾄﾘの作成に失敗しました。
    279                                final String errMsg = getResource().getLabel( "ERR0043" ) + "[" + fileURL + "]" // 5.8.8.0 (2015/06/05)
    280                                                                + CR + ex.getMessage() ;
    281                                throw new HybsSystemException( errMsg , ex );
    282                }
    283                catch( final IOException ex ) {
    284                        // ERR0044:ﾌｧｲﾙ登録ｴﾗｰ！
    285                        final String errMsg = getResource().getLabel( "ERR0044" ) // 5.8.8.0 (2015/06/05)
    286                                + ex.getMessage() + CR  // 5.3.7.0 (2011/07/01) errMsg 修正
    287                                + "(" + toString() + CR
    288                                + "FileURL=" + fileURL + ")";
    289                        throw new HybsSystemException( errMsg , ex );           // 3.5.5.4 (2004/04/15) 引数の並び順変更
    290                }
    291
    292                return EVAL_PAGE ;
    293        }
    294
    295        /**
    296         * ﾀｸﾞﾘﾌﾞｵﾌﾞｼﾞｪｸﾄをﾘﾘｰｽします。
    297         * ｷｬｯｼｭされて再利用されるので、ﾌｨｰﾙﾄﾞの初期設定を行います。
    298         *
    299         * @og.rev 2.0.0.4 (2002/09/27) ｶｽﾀﾑﾀｸﾞの release() ﾒｿｯﾄﾞを、追加
    300         * @og.rev 3.0.1.1 (2003/03/06) columns を廃止
    301         * @og.rev 3.1.1.2 (2003/04/04) Tomcat4.1 対応。release2() を doEndTag()で呼ぶ。
    302         * @og.rev 3.5.4.2 (2003/12/15) ﾌｧｲﾙ名を指定できるようにします。
    303         * @og.rev 5.6.5.2 (2013/06/21) columns 属性の追加
    304         * @og.rev 5.6.5.2 (2013/06/21) useBackup 属性の追加
    305         * @og.rev 6.0.2.4 (2014/10/17) useBackup 修正、最大ﾌｧｲﾙ容量 変更
    306         * @og.rev 8.0.1.0 (2021/10/29) useLocal 属性を追加。
    307         * @og.rev 8.0.1.0 (2021/10/29) storageType , bucketName 削除
    308         */
    309        @Override
    310        protected void release2() {
    311                super.release2();
    312                fileURL                 = HybsSystem.sys( "FILE_URL" );
    313                maxPostSize             = 30*1024*1024;                         // 6.0.2.4 (2014/10/17) 最大ﾌｧｲﾙ容量  30MB
    314                tableId                 = HybsSystem.TBL_MDL_KEY ;
    315                filename                = null;                 // 3.5.4.2 (2003/12/15)
    316                columns                 = null;                 // 5.6.5.2 (2013/06/21)
    317                useBackup               = null;                 // 6.0.2.4 (2014/10/17)
    318//              storage                 = null;                 // 5.10.9.0 (2019/03/01) ADD
    319//              bucket                  = null;                 // 5.10.9.0 (2019/03/01) ADD
    320                useLocal                = false;                // 8.0.1.0 (2021/10/29) ｸﾗｳﾄﾞ設定を使用しない場合は、true
    321        }
    322
    323        /**
    324         * ﾌｧｲﾙｱｯﾌﾟﾛｰﾄﾞの実行結果を DBTableModel に記述します。
    325         *
    326         * ここでは、"KEY","VALUE","ISFILE" のｶﾗﾑに対して、値を設定していきます。
    327         * 同時に、RequestAttribute 変数に、これらの値をｾｯﾄすることで、
    328         * {&#064;XXXX} で値が取り出せる様にしています。
    329         *
    330         * @og.rev 2.2.0.0 (2002/12/17) 中国語(国際化)対応 ｴﾝｺｰﾄﾞの取得方法変更
    331         * @og.rev 3.0.1.1 (2003/03/06) request 情報から{&#064;XXXX} で値が取り出せる様に修正。
    332         * @og.rev 3.5.2.0 (2003/10/20) ｶﾗﾑ名(KEY,VALUE)に ISFILE を追加
    333         * @og.rev 3.5.6.5 (2004/08/09) MultipartRequest 変更に伴なう修正(Enum変更、元ﾌｧｲﾙ名取得)
    334         * @og.rev 3.5.6.6 (2004/08/23) 上記変更時のﾊﾞｸﾞ修正。
    335         * @og.rev 3.5.6.6 (2004/08/23) 元ﾌｧｲﾙのｷｰを、XXXX_ORG にします。
    336         * @og.rev 4.0.0.0 (2007/10/12) ﾃｰﾌﾞﾙﾓﾃﾞﾙの登録方法を変更
    337         * @og.rev 5.3.2.0 (2011/02/01) ﾁｪｯｸ行のﾊﾟﾗﾒｰﾀｰはint配列側に変換して復元する。ﾊﾟﾗﾒｰﾀｰ名を保存する。
    338         * @og.rev 5.4.4.2 (2012/02/03) CommonTagSupportと同様のﾁｪｯｸﾎﾞｯｸｽ判定を行う
    339         * @og.rev 5.7.1.1 (2013/12/13) HTML5 ﾌｧｲﾙｱｯﾌﾟﾛｰﾄﾞの複数選択（multiple）対応
    340         * @og.rev 5.7.1.2 (2013/12/20) 5.7.1.2 (2013/12/20) zip対応で、UploadedFile のﾒｿｯﾄﾞ変更
    341         * @og.rev 5.7.3.0 (2014/02/07) zip対応の修正で、取得ﾌｧｲﾙ名が異なっていた。
    342         * @og.rev 5.7.6.3 (2014/05/23) ｱｯﾌﾟﾛｰﾄﾞﾌｧｲﾙのCSVｾｯﾄ
    343         * @og.rev 6.2.3.0 (2015/05/01) ｱｯﾌﾟﾛｰﾄﾞﾌｧｲﾙを、UPLOAD_FILESｷｰに、Listｵﾌﾞｼﾞｪｸﾄに格納します。
    344         * @og.rev 5.9.25.0 (2017/10/06) ｸﾗｳﾄﾞ対応
    345         * @og.rev 8.2.0.2 (2022/06/24) must と mustAny の複数選択対応
    346         *
    347         * @param       multi   MultipartRequestｵﾌﾞｼﾞｪｸﾄ
    348         * @return      ﾃｰﾌﾞﾙﾓﾃﾞﾙ
    349         */
    350        private DBTableModel makeDBTable( final MultipartRequest multi ) {
    351
    352                final DBTableModel table = DBTableModelUtil.newDBTable();
    353
    354                table.init( NAMES.length );
    355
    356                for( int i=0; i<NAMES.length; i++ ) {
    357                        final DBColumn dbColumn = getDBColumn( NAMES[i] );
    358                        table.setDBColumn( i,dbColumn );
    359                }
    360
    361                String[] values ;               // 4.0.0.0 (2007/10/12)
    362                final List<String> prmNames = new ArrayList<>();
    363
    364                // 5.7.1.1 (2013/12/13) HTML5 ﾌｧｲﾙｱｯﾌﾟﾛｰﾄﾞの複数選択（multiple）対応
    365                // 6.2.3.0 (2015/05/01) ｱｯﾌﾟﾛｰﾄﾞﾌｧｲﾙを、UPLOAD_FILESｷｰに、Listｵﾌﾞｼﾞｪｸﾄに格納します。
    366                final List<String> list = new ArrayList<>();
    367                final UploadedFile[] files = multi.getUploadedFile();
    368                for( int i=0; i<files.length; i++ ) {
    369                        final String name = files[i].getName();                                 // multiple対応では、ｷｰがかぶることがある。
    370                        String val  = files[i].getUploadFile();                         // 5.9.25.0 (2017/10/06) MODIFY getUploadFileで取得される値をFileからStringに変更対応
    371
    372                        // 6.2.3.0 (2015/05/01) ｱｯﾌﾟﾛｰﾄﾞﾌｧｲﾙを、UPLOAD_FILESｷｰに、Listｵﾌﾞｼﾞｪｸﾄに格納します。
    373                        list.add( val );
    374
    375                        // "KEY","VALUE","ISFILE" の順にﾃﾞｰﾀを作成します。
    376                        values = new String[] { name, val, "1" };
    377                        table.addColumnValues( values );
    378                        setRequestAttribute( name,val );
    379                        prmNames.add( name );                           // 5.7.1.1 (2013/12/13) List に設定する。
    380
    381                        final String orgName = name + "_ORG" ;
    382                        val  = files[i].getOriginalFileName();  // 注意：取得は、送信名
    383
    384                        // "KEY","VALUE","ISFILE" の順にﾃﾞｰﾀを作成します。
    385                        values = new String[] { orgName, val, "2" };
    386                        table.addColumnValues( values );
    387                        setRequestAttribute( orgName,val );
    388                }
    389
    390                // 6.2.3.0 (2015/05/01) ｱｯﾌﾟﾛｰﾄﾞﾌｧｲﾙを、UPLOAD_FILESｷｰに、Listｵﾌﾞｼﾞｪｸﾄに格納します。
    391                setRequestAttribute( UPLOAD_FILES,list );
    392
    393                // "KEY","VALUE","ISFILE" の順にﾃﾞｰﾀを作成します。
    394                values = new String[] { "directory", fileURL, "0" };
    395                table.addColumnValues( values );
    396                setRequestAttribute( "directory",fileURL );
    397
    398                final String[] params = multi.getParameterNames();
    399                for( int i=0; i<params.length; i++ ) {
    400                        final String name = params[i];
    401                        // 5.3.2.0 (2011/02/01) ﾁｪｯｸ行のﾊﾟﾗﾒｰﾀｰはint配列側に変換
    402                        if( HybsSystem.ROW_SEL_KEY.equals( name ) ) {
    403                                setRequestAttribute( name,multi.getIntParameters(name) );
    404                        }
    405                        // 8.2.0.2 (2022/06/24) must と mustAny の複数選択対応
    406                        else if( name.startsWith( HybsSystem.MUST_KEY ) ) {
    407                                setRequestAttribute( name,multi.getParameters(name) );          // MUST_KEY+"must" or MUST_KEY+"mustAny"
    408                        }
    409                        else {
    410                                // 5.6.5.2 (2013/06/21) ﾁｪｯｸﾎﾞｯｸｽ配列の値取得を考慮した、MultipartRequest のﾊﾟﾗﾒｰﾀ値取得
    411                                final String val = getParamVal( name,multi );
    412
    413                                values = new String[] { name, val, "0" };
    414                                table.addColumnValues( values );
    415                                setRequestAttribute( name,val );
    416                                prmNames.add( name );                           // 5.7.1.1 (2013/12/13) List に設定する。
    417                        }
    418                }
    419
    420                // 5.3.2.0 (2011/02/01) ﾊﾟﾗﾒｰﾀｰ名を保存する。
    421                // 5.7.1.1 (2013/12/13) List に設定する。
    422                setParameterNames( prmNames.toArray( new String[prmNames.size()] ) );
    423
    424                return table ;
    425        }
    426
    427        /**
    428         * ﾌｧｲﾙｱｯﾌﾟﾛｰﾄﾞの実行結果を 横持の DBTableModel に記述します。
    429         *
    430         * この処理は、columns 属性を設定した場合のみとします。
    431         *
    432         * DBTableModel作成時に、指定のｶﾗﾑの"_01"～"_99"の添え字をﾚｺｰﾄﾞとして作成します。
    433         * 現状は、"KEY","VALUE","ISFILE" のｶﾗﾑに、ﾃﾞｰﾀを縦持ちで作成しています。
    434         * これを、横持で作成しますが、ｶﾗﾑの末尾に、"_01"～"_99" までの添え字を
    435         * 持つ場合は、これをﾚｺｰﾄﾞと認識させます。
    436         * 添え字がない場合は、ｶﾗﾑだけ作成されます。ｶﾗﾑ名と同じﾘｸｴｽﾄがあれば、
    437         * すべてのﾚｺｰﾄﾞに同じ値がｾｯﾄされます。
    438         *
    439         * @og.rev 5.6.5.2 (2013/06/21) 新規作成
    440         * @og.rev 5.6.6.1 (2013/07/12) 添え字がない場合の処理の見直し
    441         * @og.rev 5.7.1.2 (2013/12/20) zip対応で、UploadedFile のﾒｿｯﾄﾞ変更
    442         * @og.rev 5.7.3.0 (2014/02/07) zip対応の修正で、取得ﾌｧｲﾙ名が異なっていた。
    443         * @og.rev 5.7.6.3 (2014/05/23) ｱｯﾌﾟﾛｰﾄﾞﾌｧｲﾙのCSVｾｯﾄ
    444         * @og.rev 6.0.2.4 (2014/10/17) _PFX , _SFX 対応
    445         * @og.rev 6.2.3.0 (2015/05/01) ｱｯﾌﾟﾛｰﾄﾞﾌｧｲﾙを、UPLOAD_FILESｷｰに、Listｵﾌﾞｼﾞｪｸﾄに格納します。
    446         * @og.rev 5.9.25.0 (2017/10/06) ｸﾗｳﾄﾞ対応
    447         * @og.rev 8.1.2.0 (2022/03/10) _HASH(ﾌｧｲﾙのﾊｯｼｭ値) 対応
    448         * @og.rev 8.2.0.2 (2022/06/24) must と mustAny の複数選択対応
    449         *
    450         * @param       multi   MultipartRequestｵﾌﾞｼﾞｪｸﾄ
    451         * @return      ﾃｰﾌﾞﾙﾓﾃﾞﾙ
    452         */
    453        private DBTableModel makeDBTableFromClms( final MultipartRequest multi ) {
    454
    455                final DBTableModel table = DBTableModelUtil.newDBTable();
    456
    457                final String[] clmNames = columns.split( "," );
    458
    459                table.init( clmNames.length );
    460
    461                // 値配列（１行分）
    462                String[] rowVal = new String[clmNames.length];
    463
    464                // 5.7.1.1 (2013/12/13) HTML5 ﾌｧｲﾙｱｯﾌﾟﾛｰﾄﾞの複数選択（multiple）対応
    465                final UploadedFile[] files = multi.getUploadedFile();
    466
    467                final List<String> prmNames = new ArrayList<>();
    468
    469                for( int i=0; i<clmNames.length; i++ ) {
    470                        final String clm = clmNames[i] ;
    471                        final DBColumn dbColumn = getDBColumn( clm );
    472                        table.setDBColumn( i,dbColumn );
    473
    474                        // 先に、ｶﾗﾑ名と一致するﾊﾟﾗﾒｰﾀを初期値としてｾｯﾄしておきます。
    475                        String val = getParamVal( clm,multi );
    476
    477                        // 5.6.6.1 (2013/07/12) ﾌｧｲﾙ名も同様に、あれば初期値ｾｯﾄしておきます。
    478                        if( val == null ) {
    479                                // 5.7.1.1 (2013/12/13) HTML5 ﾌｧｲﾙｱｯﾌﾟﾛｰﾄﾞの複数選択（multiple）対応
    480                                for( int j=0; j<files.length; j++ ) {
    481                                        final String nm = files[j].getName();
    482                                        if( clm.equalsIgnoreCase( nm ) ) {
    483                                                val = files[i].getUploadFile();                         // 5.9.25.0 (2017/10/06) getUploadFileの型をFileからStringに変更対応
    484                                                break;                                                                          // 5.7.6.3 (2014/05/23) たぶん有ったほうが良い。
    485                                        }
    486                                }
    487                        }
    488                        // 5.7.1.1 (2013/12/13) getFilesystemName() の中に、newFile が null の場合は、original を返す処理がある。
    489                        rowVal[i] = ( val == null ) ? "" : val ;
    490                }
    491
    492                // 6.2.3.0 (2015/05/01) ｱｯﾌﾟﾛｰﾄﾞﾌｧｲﾙを、UPLOAD_FILESｷｰに、Listｵﾌﾞｼﾞｪｸﾄに格納します。
    493                final List<String> list = new ArrayList<>();
    494
    495                for( int i=0; i<files.length; i++ ) {
    496                        final String name = files[i].getName();
    497                        // 5.6.6.1 (2013/07/12) 添え字がない場合の処理の見直し。先にﾚｺｰﾄﾞを作成
    498                        String[] values = new String[clmNames.length];
    499                        System.arraycopy( rowVal,0,values,0,values.length );            // 行にｾｯﾄするに当たり、rowVal を values にｺﾋﾟｰしておく。
    500
    501                        // ﾌｧｲﾙ名を Attribute で使えるようにｾｯﾄしておく。
    502                        final String fval = files[i].getUploadFile();                           // 5.9.25.0 (2017/10/06) getUploadで取得される値をFileからStringに変更
    503                        setRequestAttribute( name,fval );
    504                        prmNames.add( name );                                                                           // 5.7.1.1 (2013/12/13) List に設定する。
    505
    506                        // 6.2.3.0 (2015/05/01) ｱｯﾌﾟﾛｰﾄﾞﾌｧｲﾙを、UPLOAD_FILESｷｰに、Listｵﾌﾞｼﾞｪｸﾄに格納します。
    507                        list.add( fval );
    508
    509                        final String orgName = name + "_ORG" ;
    510                        final String oval  = files[i].getOriginalFileName();    // 注意：取得は、送信名
    511                        setRequestAttribute( orgName,oval );
    512
    513                        // ﾌｧｲﾙのｷｰを元に、添え字を検索します。
    514                        final int adrs = name.lastIndexOf( '_' );               // 添え字は、'_' で区切られます。
    515                        // 5.6.6.1 (2013/07/12) 添え字がない場合の処理の見直し。後続処理を行う。
    516                        if( adrs > 0 ) {
    517                                final String fnm = name.substring( 0,adrs );    // ﾌｧｲﾙ名(分割後)
    518                                final String sub = name.substring( adrs );      // 添え字(ｱﾝﾀﾞｰﾊﾞｰ含む)
    519
    520                                // ｶﾗﾑ名で検索しながら、ﾚｺｰﾄﾞ単位になるようにｾｯﾄしていきます。
    521                                for( int j=0; j<clmNames.length; j++ ) {
    522                                        final String clm = clmNames[j] ;
    523                                        String nm  = null;
    524                                        String val = null;
    525
    526                                        if( fnm.equalsIgnoreCase( clm ) ) {             // ﾌｧｲﾙ名ｶﾗﾑ(_NEWﾌｧｲﾙ名も、この値にすでに変わっている）
    527                                                val = fval;
    528                                        }
    529                                        else if( ( fnm + "_ORG" ).equalsIgnoreCase( clm ) ) {           // 元ﾌｧｲﾙ名ｶﾗﾑ
    530                                                val  = oval;
    531                                        }
    532                                        else if( ( fnm + "_NEW" ).equalsIgnoreCase( clm ) ) {           // 新ﾌｧｲﾙ名ｶﾗﾑ
    533                                                nm   = name + "_NEW" ;
    534                                                val  = multi.getParameter( nm );
    535                                        }
    536                                        // 6.0.2.4 (2014/10/17) _PFX , _SFX 対応
    537                                        else if( ( fnm + "_PFX" ).equalsIgnoreCase( clm ) ) {           // ﾌﾟﾚﾌｨｯｸｽｶﾗﾑ
    538                                                nm   = name + "_PFX" ;
    539                                                val  = multi.getParameter( nm );
    540                                        }
    541                                        else if( ( fnm + "_SFX" ).equalsIgnoreCase( clm ) ) {           // ｻﾌｨｯｸｽｶﾗﾑ
    542                                                nm   = name + "_SFX" ;
    543                                                val  = multi.getParameter( nm );
    544                                        }
    545                                        else if( ( fnm + "_HASH" ).equalsIgnoreCase( clm ) ) {          // ﾊｯｼｭｺｰﾄﾞ 8.1.2.0 (2022/03/10)
    546                                                nm   = name + "_HASH" ;
    547                                                final File localFile = files[i].getFile( useLocal );
    548                                                val  = HybsCryptography.getHash( HASH_CODE, localFile );
    549                                        }
    550                                        else {
    551                                                nm  = clmNames[j] + sub;                                        // sub は、ｱﾝﾀﾞｰﾊﾞｰ含む添え字
    552                                                // 5.6.5.2 (2013/06/21) ﾁｪｯｸﾎﾞｯｸｽ配列の値取得を考慮した、MultipartRequest のﾊﾟﾗﾒｰﾀ値取得
    553                                                val = getParamVal( nm,multi );
    554                                        }
    555                                        if( val != null ) { values[j] = val ; }         // val が null でないときのみｾｯﾄします。
    556                                }
    557                        }
    558                        table.addColumnValues( values );
    559                }
    560                // 6.2.3.0 (2015/05/01) ｱｯﾌﾟﾛｰﾄﾞﾌｧｲﾙを、UPLOAD_FILESｷｰに、Listｵﾌﾞｼﾞｪｸﾄに格納します。
    561                setRequestAttribute( UPLOAD_FILES,list );
    562
    563                // Attribute で使えるようにｾｯﾄしておく。
    564                setRequestAttribute( "directory",fileURL );
    565
    566                // Attribute で使えるようにｾｯﾄしておく。
    567                final String[] params = multi.getParameterNames();
    568                for( int i=0; i<params.length; i++ ) {
    569                        final String name = params[i];
    570                        // 5.3.2.0 (2011/02/01) ﾁｪｯｸ行のﾊﾟﾗﾒｰﾀｰはint配列側に変換
    571                        if( HybsSystem.ROW_SEL_KEY.equals( name ) ) {
    572                                setRequestAttribute( name,multi.getIntParameters(name) );
    573                        }
    574                        // 8.2.0.2 (2022/06/24) must と mustAny の複数選択対応
    575                        else if( name.startsWith( HybsSystem.MUST_KEY ) ) {
    576                                setRequestAttribute( name,multi.getParameters(name) );          // MUST_KEY+"must" or MUST_KEY+"mustAny"
    577                        }
    578                        else {
    579                                // 5.6.5.2 (2013/06/21) ﾁｪｯｸﾎﾞｯｸｽ配列の値取得を考慮した、MultipartRequest のﾊﾟﾗﾒｰﾀ値取得
    580                                final String val = getParamVal( name,multi );
    581                                setRequestAttribute( name,val );
    582                                prmNames.add( name );                           // 5.7.1.1 (2013/12/13) List に設定する。
    583                        }
    584                }
    585
    586                // 5.3.2.0 (2011/02/01) ﾊﾟﾗﾒｰﾀｰ名を保存する。
    587                // 5.7.1.1 (2013/12/13) List に設定する。
    588                setParameterNames( prmNames.toArray( new String[prmNames.size()] ) );
    589
    590                return table ;
    591        }
    592
    593        /**
    594         * ﾁｪｯｸﾎﾞｯｸｽ配列の値取得を考慮した、MultipartRequest のﾊﾟﾗﾒｰﾀ値取得
    595         *
    596         * ここでは、、MultipartRequest のﾊﾟﾗﾒｰﾀ値を取得します。
    597         * 値の取得で、ﾁｪｯｸﾎﾞｯｸｽ配列の場合は、取得した値が、"0" の場合のみ
    598         * 配列でﾊﾟﾗﾒｰﾀを取得し直し、"1" がないかどうか再度検索します。
    599         * ﾁｪｯｸﾎﾞｯｸｽでは、ﾁｪｯｸ時の "1" と、ﾁｪｯｸされなかった場合の、
    600         * hidden の "0" の両方の値が配列としてﾘｸｴｽﾄされるｹｰｽがある為です。
    601         *
    602         * @og.rev 5.6.5.2 (2013/06/21) 新規作成
    603         * @og.rev 6.3.9.1 (2015/11/27) MultipartRequest#getParameters(String)は、null ではなく長さが0の配列を返す。
    604         *
    605         * @param       key             MultipartRequestのﾊﾟﾗﾒｰﾀ取得のためのｷｰ
    606         * @param       multi   MultipartRequestｵﾌﾞｼﾞｪｸﾄ
    607         * @return      ﾁｪｯｸﾎﾞｯｸｽ配列を考慮したﾊﾟﾗﾒｰﾀ値
    608         */
    609        private String getParamVal( final String key , final MultipartRequest multi ) {
    610                String val = multi.getParameter( key );
    611
    612                if( "0".equals(val) ){ // 5.4.4.2 ﾁｪｯｸﾎﾞｯｸｽ配列対応。
    613                        final String[] vals = multi.getParameters( key );
    614                        for( final String tmp : vals ) {
    615                                if( "1".equals( tmp ) ) {
    616                                        val = "1";
    617                                        break;
    618                                }
    619                        }
    620                }
    621                return val ;
    622        }
    623
    624        /**
    625         * 【TAG】ﾌｧｲﾙをｱｯﾌﾟﾛｰﾄﾞするﾃﾞｨﾚｸﾄﾘを指定します
    626         *              (初期値:FILE_URL[={@og.value SystemData#FILE_URL}])。
    627         *
    628         * @og.tag
    629         * この属性で指定されるﾃﾞｨﾚｸﾄﾘに、ｱｯﾌﾟﾛｰﾄﾞされたﾌｧｲﾙをｾｰﾌﾞします。
    630         * 指定方法は、通常の fileURL 属性と同様に、先頭が、'/' (UNIX) または、２文字目が、
    631         * ":" (Windows)の場合は、指定のURLそのままのﾃﾞｨﾚｸﾄﾘに、そうでない場合は、
    632         * fileURL = "{&#064;USER.ID}" と指定すると、FILE_URL 属性で指定のﾌｫﾙﾀﾞの下に、
    633         * さらに、各個人ID別のﾌｫﾙﾀﾞを作成して、そこにｾｰﾌﾞします。
    634         * (初期値:ｼｽﾃﾑ定数のFILE_URL[={@og.value SystemData#FILE_URL}])。
    635         *
    636         * @og.rev 4.0.0.0 (2005/01/31) StringUtil.urlAppend ﾒｿｯﾄﾞの利用
    637         * @og.rev 4.0.0.0 (2007/11/20) 指定されたﾃﾞｨﾚｸﾄﾘ名の最後が"\"or"/"で終わっていない場合に、"/"を付加する。
    638         * @og.rev 5.7.1.1 (2013/12/13) ﾘｸｴｽﾄ変数が使えないｴﾗｰを表示する。
    639         * @og.rev 5.7.4.3 (2014/03/28) ﾘｸｴｽﾄ変数が使えない事のﾁｪｯｸを行う。
    640         * @og.rev 6.4.2.1 (2016/02/05) URLの最後に、"/" を追加する処理を廃止。
    641         *
    642         * @param       url     ﾌｧｲﾙURL
    643         * @see         org.opengion.hayabusa.common.SystemData#FILE_URL
    644         */
    645        public void setFileURL( final String url ) {
    646                final String furl = nval( getRequestParameter( url ),null );
    647                // 6.4.1.1 (2016/01/16) PMD refactoring. Avoid if (x != y) ..; else ..;
    648                if( furl == null ) {
    649                        chckReqParam( url,"fileURL" );          // 5.7.4.3 (2014/03/28) ﾘｸｴｽﾄ変数が使えない事のﾁｪｯｸ
    650                }
    651                else {
    652                        fileURL = StringUtil.urlAppend( fileURL,furl );
    653                }
    654        }
    655
    656        /**
    657         * 【TAG】最大転送ｻｲｽﾞ(Byte)を指定します(初期値:31457280)。
    658         *
    659         * @og.tag
    660         * 最大転送ｻｲｽﾞを指定します。初期値は、30*1024*1024 = 30MB です。
    661         * 指定は、Byte 単位で指定します。
    662         * 0,またはﾏｲﾅｽを指定することで、制限ﾁｪｯｸを外す（＝無制限）事ができます。
    663         *
    664         * @og.rev 3.0.1.1 (2003/03/06) maxPostSize の設定ﾊﾞｸﾞ修正。
    665         * @og.rev 5.6.5.3 (2013/06/28) ｺﾒﾝﾄ追加（0,またはﾏｲﾅｽで無制限）
    666         * @og.rev 5.7.4.3 (2014/03/28) ﾘｸｴｽﾄ変数が使えない事のﾁｪｯｸを行う。
    667         * @og.rev 6.0.2.4 (2014/10/17) 最大ﾌｧｲﾙ容量 10M → 30M 変更(JavaDocの修正)
    668         *
    669         * @param       maxPS   最大転送ｻｲｽﾞ
    670         */
    671        public void setMaxPostSize( final String maxPS ) {
    672                maxPostSize = nval( getRequestParameter( maxPS ),maxPostSize );
    673
    674                chckReqParam( maxPS,"maxPostSize" );            // 5.7.4.3 (2014/03/28) ﾘｸｴｽﾄ変数が使えない事のﾁｪｯｸ
    675        }
    676
    677        /**
    678         * 【TAG】(通常は使いません)結果のDBTableModelを、sessionに登録するときのｷｰを指定します
    679         *              (初期値:HybsSystem#TBL_MDL_KEY[={@og.value HybsSystem#TBL_MDL_KEY}])。
    680         *
    681         * @og.tag
    682         * 検索結果より、DBTableModelｵﾌﾞｼﾞｪｸﾄを作成します。これを、下流のviewﾀｸﾞ等に
    683         * 渡す場合に、通常は、session を利用します。その場合の登録ｷｰです。
    684         * query ﾀｸﾞを同時に実行して、結果を求める場合、同一ﾒﾓﾘに配置される為、
    685         * この tableId 属性を利用して、ﾒﾓﾘ空間を分けます。
    686         *              (初期値:HybsSystem#TBL_MDL_KEY[={@og.value HybsSystem#TBL_MDL_KEY}])。
    687         *
    688         * @og.rev 5.7.4.3 (2014/03/28) ﾘｸｴｽﾄ変数が使えない事のﾁｪｯｸを行う。
    689         *
    690         * @param       id      ﾃｰﾌﾞﾙID (sessionに登録する時のID)
    691         */
    692        public void setTableId( final String id ) {
    693                tableId = nval( getRequestParameter( id ),tableId );
    694
    695                chckReqParam( id,"tableId" );           // 5.7.4.3 (2014/03/28) ﾘｸｴｽﾄ変数が使えない事のﾁｪｯｸ
    696        }
    697
    698        /**
    699         * 【TAG】(通常は使いません)ﾌｧｲﾙを作成するときのﾌｧｲﾙ名をｾｯﾄします(初期値:null)。
    700         *
    701         * @og.tag
    702         * ﾌｧｲﾙを作成するときのﾌｧｲﾙ名をｾｯﾄします。
    703         * これは、複数同時にｱｯﾌﾟﾛｰﾄﾞﾌｧｲﾙ名を変更する時に使用できません。
    704         * 通常、ｱｯﾌﾟﾛｰﾄﾞされたﾌｧｲﾙ名を指定する場合、ｱｯﾌﾟﾛｰﾄﾞするinput ﾀｸﾞの
    705         * name 属性に指定する名称 ＋ "_NEW" というﾘｸｴｽﾄ値を同時に送信すれば、
    706         * 内部的に関連付けて、ﾌｧｲﾙ名を更新します。
    707         * その場合、ｸﾗｲｱﾝﾄより指定したﾌｧｲﾙ名は、name属性＋"_ORG" という
    708         * ﾘｸｴｽﾄ値として取得することが可能になります。
    709         * name属性 には、最終的に設定されたﾌｧｲﾙ名がｾｯﾄされています。
    710         * いずれの値も、{&#064;name属性＋"_ORG"} や、{&#064;name属性＋"_NEW"}として、
    711         * ｱｯﾌﾟﾛｰﾄﾞのｵﾘｼﾞﾅﾙと変更後のﾌｧｲﾙ名を取得することが出来ます。
    712         *
    713         * 5.7.1.2 (2013/12/20) zip 対応
    714         * filename 属性に、".zip" の拡張子のﾌｧｲﾙ名を指定した場合は、ｱｯﾌﾟﾛｰﾄﾞされた一連のﾌｧｲﾙを
    715         * ZIP圧縮します。これは、ｱｯﾌﾟﾛｰﾄﾞ後の処理になります。
    716         * ZIP圧縮のｵﾘｼﾞﾅﾙﾌｧｲﾙは、そのまま残ります。
    717         * なお、ZIPﾌｧｲﾙは、useBackup属性を true に設定しても、無関係に、上書きされます。
    718         *
    719         * 5.7.4.3 (2014/03/28) filename 属性のﾘｸｴｽﾄ変数対応
    720         * filename 属性のみ、{&#064;XXXX} のﾘｸｴｽﾄ変数が使えるようにします。
    721         * 他のﾊﾟﾗﾒｰﾀでは使えません。
    722         * これは、multipart/form-data のﾘｸｴｽﾄでは、ﾊﾟｰﾄの分解処理をしないと、ﾘｸｴｽﾄ変数が
    723         * 拾えない為、ﾘｸｴｽﾄ変数は、この、upload ﾀｸﾞ以降でのみ利用可能でした。
    724         * zip対応と関連付けて、filename 属性のみ、利用できるように、MultipartRequest 側の処理に組み込みます。
    725         *
    726         * @og.rev 3.5.4.2 (2003/12/15) ﾌｧｲﾙ名を指定できるようにします。
    727         * @og.rev 5.7.1.1 (2013/12/13) ﾘｸｴｽﾄ変数が使えないｴﾗｰを表示する。
    728         * @og.rev 5.7.4.3 (2014/03/28) ﾘｸｴｽﾄ変数を使えるようにします。
    729         *
    730         * @param       fname   ﾌｧｲﾙ名
    731         */
    732        public void setFilename( final String fname ) {
    733                filename = nval( getReservedParameter( fname ),null );          // 予約語のみ処理をします。
    734        }
    735
    736        /**
    737         * 【TAG】DBTableModel作成時に、指定のｶﾗﾑの"_01"～"_99"の添え字をﾚｺｰﾄﾞとして作成します。
    738         *
    739         * @og.tag
    740         * 現状は、"KEY","VALUE","ISFILE" のｶﾗﾑに、ﾃﾞｰﾀを縦持ちで作成しています。
    741         * これを、横持で作成しますが、ｶﾗﾑの末尾に、"_01"～"_99" までの添え字を
    742         * 持つ場合は、これをﾚｺｰﾄﾞと認識させます。
    743         * ｱﾝﾀﾞｰﾊﾞｰがない場合は、ｶﾗﾑだけ作成されます。ｶﾗﾑ名と同じﾘｸｴｽﾄがあれば、
    744         * すべてのﾚｺｰﾄﾞに同じ値がｾｯﾄされます。
    745         * この処理は、columns 属性を設定した場合のみとします。
    746         *
    747         * @og.rev 5.6.5.2 (2013/06/21) 新規作成
    748         * @og.rev 5.7.4.3 (2014/03/28) ﾘｸｴｽﾄ変数が使えない事のﾁｪｯｸを行う。
    749         *
    750         * @param       clms    DBTableModel作成時のｶﾗﾑ列(CSV形式)
    751         */
    752        public void setColumns( final String clms ) {
    753                columns = nval( getRequestParameter( clms ),columns );
    754
    755                chckReqParam( clms,"columns" );         // 5.7.4.3 (2014/03/28) ﾘｸｴｽﾄ変数が使えない事のﾁｪｯｸ
    756        }
    757
    758        /**
    759         * 【TAG】すでに同名のﾌｧｲﾙが存在した場合に、ﾊﾞｯｸｱｯﾌﾟ処理するかどうか[true/false/rename]を指定します(初期値:null=false)。
    760         *
    761         * @og.tag
    762         * ﾌｧｲﾙｱｯﾌﾟﾛｰﾄﾞ時に、ｱｯﾌﾟﾛｰﾄﾞ先に、同名のﾌｧｲﾙが存在した場合は、既存機能は、そのまま
    763         * 置き換えていましたが、簡易ﾊﾞｰｼﾞｮﾝｱｯﾌﾟ機能として、useBackup="true" を指定すると、既存のﾌｧｲﾙを
    764         * ﾘﾈｰﾑして、ﾊﾞｯｸｱｯﾌﾟﾌｧｲﾙを作成します。
    765         * ﾊﾞｯｸｱｯﾌﾟﾌｧｲﾙは、ｱｯﾌﾟﾛｰﾄﾞﾌｫﾙﾀﾞを基準として、_backup/ﾌｧｲﾙ名.拡張子_処理時刻のlong値.拡張子 になります。
    766         * ｵﾘｼﾞﾅﾙのﾌｧｲﾙ名（拡張子付）を残したまま、"_処理時刻のlong値" を追加し、さらに、ｵﾘｼﾞﾅﾙの拡張子を追加します。
    767         * ﾊﾞｯｸｱｯﾌﾟﾌｧｲﾙの形式は指定できません。
    768         *
    769         * 初期値は、互換性を持たせるため、null(=false) です。
    770         *
    771         * 6.0.2.4 (2014/10/17)
    772         * useBackup="rename" で、すでに同名のﾌｧｲﾙが存在した場合に、"_001" のような文字列を追加したﾌｧｲﾙにﾘﾈｰﾑします。
    773         * Windowsの " - ｺﾋﾟｰ (2)" に近いですが、桁数を抑えるのと、useBackup="true" と異なり、過去の同一ﾌｧｲﾙ名は
    774         * そのまま、有効になります。同一ﾌｧｲﾙが同一ﾌｫﾙﾀﾞに存在する場合のみ連番が付与されます。
    775         *
    776         * @og.rev 5.6.5.3 (2013/06/28) 新規作成
    777         * @og.rev 5.7.4.3 (2014/03/28) ﾘｸｴｽﾄ変数が使えない事のﾁｪｯｸを行う。
    778         * @og.rev 6.0.2.4 (2014/10/17) true/false 以外に、rename も有効とする。
    779         *
    780         * @param       flag    ﾊﾞｯｸｱｯﾌﾟ処理可否 [true:する/false:しない]
    781         */
    782        public void setUseBackup( final String flag ) {
    783                useBackup = nval( getRequestParameter( flag ),useBackup );
    784
    785                // 6.0.2.4 (2014/10/17) ﾊﾟﾗﾒｰﾀﾁｪｯｸをしておきます。
    786                if( useBackup != null && "true/false/rename".indexOf( useBackup.toLowerCase(Locale.JAPAN) ) < 0 ) {
    787                        final String errMsg = "useBackup 属性は、[true/false/rename] から、指定してください。"
    788                                                                + " useBackup=[" + useBackup + "]" + CR ;
    789                        throw new HybsSystemException( errMsg );
    790                }
    791
    792                chckReqParam( flag,"useBackup" );               // 5.7.4.3 (2014/03/28) ﾘｸｴｽﾄ変数が使えない事のﾁｪｯｸ
    793        }
    794
    795        /**
    796         * ﾘｸｴｽﾄ変数が使えない事のﾁｪｯｸを行います。
    797         *
    798         * upload では、enctype="multipart/form-data" のため、{&#064;XXXX}形式のﾊﾟﾗﾒｰﾀが使えません。
    799         * 5.7.4.3 (2014/03/28) から、filename のみ利用可能としたことで、同様に利用できると
    800         * 勘違いするｹｰｽに対応する為、すべてのﾊﾟﾗﾒｰﾀについてﾁｪｯｸを行います。
    801         * ここでは、getRequestParameter( String ) の実行後、すぐに、isNull() 判定を行う事で、
    802         * ﾘｸｴｽﾄ変数の存在ﾁｪｯｸを行う事にしています。
    803         *
    804         * @og.rev 5.7.4.3 (2014/03/28) ﾘｸｴｽﾄ変数が使えない事のﾁｪｯｸを行う。
    805         *
    806         * @param       org     引数のｵﾘｼﾞﾅﾙ値
    807         * @param       key     ｴﾗｰの発生した変数名
    808         * @throws      HybsSystemException     ﾊﾟﾗﾒｰﾀが使用されていた場合
    809         */
    810        private void chckReqParam( final String org,final String key ) {
    811                if( isNull() && org != null && org.contains( "{@" ) ) {
    812                        final String errMsg = "upload では、enctype=\"multipart/form-data\" のため、{@XXXX}形式のﾊﾟﾗﾒｰﾀが使えません。"
    813                                                                + CR
    814                                                                + "    " + key + "=[" + org + "]" ;
    815                        throw new HybsSystemException( errMsg );                // ﾘｸｴｽﾄ変数が使えないｴﾗｰ
    816                }
    817        }
    818
    819        /**
    820         * ﾀｸﾞの名称を、返します。
    821         * 自分自身のｸﾗｽ名より、自動的に取り出せないため、このﾒｿｯﾄﾞをｵｰﾊﾞｰﾗｲﾄﾞします。
    822         *
    823         * @og.rev 4.0.0.0 (2005/01/31) 新規追加
    824         *
    825         * @return  ﾀｸﾞの名称
    826         * @og.rtnNotNull
    827         */
    828        @Override
    829        protected String getTagName() {
    830                return "upload" ;
    831        }
    832
    833//      /**
    834//       * 【TAG】保存先ｽﾄﾚｰｼﾞﾀｲﾌﾟを設定します。
    835//       *
    836//       * @og.tag
    837//       * ﾌｧｲﾙを読み取り元の、ｽﾄﾚｰｼﾞﾀｲﾌﾟを設定します。
    838//       * 未設定の場合は、ｼｽﾃﾑﾘｿｰｽの｢CLOUD_TARGET｣が参照されます。
    839//       * 自身のｻｰﾊﾞを指定する場合は、｢default｣を設定してください。
    840//       * 強制的に、ﾛｰｶﾙﾌｧｲﾙを指定する場合は、空文字列ではなく、"LOCAL" を指定します。
    841//       *
    842//       * @og.rev 5.10.9.0 (2019/03/01) 新規追加
    843//       * @og.rev 8.0.1.0 (2021/10/29) storageType , bucketName 削除
    844//       *
    845//       * @param       type    保存先ｽﾄﾚｰｼﾞﾀｲﾌﾟ
    846//       */
    847//      public void setStorageType( final String type ) {
    848//              storage  = nval( getRequestParameter(type), storage );
    849//      }
    850
    851//      /**
    852//       * 【TAG】保存先ﾊﾞｹｯﾄ名を設定します。
    853//       *
    854//       * @og.tag
    855//       * ﾌｧｲﾙを読み取り元の、ﾊﾞｹｯﾄ名を指定します。
    856//       * ｸﾗｳﾄﾞｽﾄﾚｰｼﾞ利用時のみ有効です。
    857//       * 未設定の場合は、ｼｽﾃﾑﾘｿｰｽの｢CLOUD_BUCKET｣が参照されます。
    858//       * 強制的に、ﾛｰｶﾙﾌｧｲﾙを指定する場合は、空文字列ではなく、"LOCAL" を指定します。
    859//       *
    860//       * @og.rev 5.10.9.0 (2019/03/01) 新規追加
    861//       * @og.rev 8.0.1.0 (2021/10/29) storageType , bucketName 削除
    862//       *
    863//       * @param       bkt     保存先ﾊﾞｹｯﾄ名
    864//       */
    865//      public void setBucket( final String bkt )  {
    866//              bucket = nval( getRequestParameter(bkt), bucket );
    867//      }
    868
    869        /**
    870         * 【TAG】ｼｽﾃﾑ定数でｸﾗｳﾄﾞ設定されていても、ｸﾗｳﾄﾞ環境を使用しない場合、trueを指定します(初期値:false)。
    871         *
    872         * @og.tag
    873         * ｸﾗｳﾄﾞ設定は、ｼｽﾃﾑ定数の『CLOUD_TARGET』と『CLOUD_BUCKET』の設定で自動的に使用しますが、
    874         * どうしてもﾛｰｶﾙでのみ使いたい場合は、この属性を true に設定します。
    875         * 標準はfalse:設定どおりとなります。
    876         *
    877         * true/false以外を指定した場合はfalse扱いとします。
    878         *
    879         * @og.rev 8.0.1.0 (2021/10/29) useLocal 属性を追加。
    880         *
    881         * @param       flag    ﾛｰｶﾙ環境のみ [true:ﾛｰｶﾙのみ/false:設定どおり]
    882         */
    883        public void setUseLocal( final String flag ) {
    884                useLocal = nval( getRequestParameter( flag ),useLocal );
    885        }
    886
    887        /**
    888         * このｵﾌﾞｼﾞｪｸﾄの文字列表現を返します。
    889         * 基本的にﾃﾞﾊﾞｯｸﾞ目的に使用します。
    890         *
    891         * @return      このｸﾗｽの文字列表現
    892         * @og.rtnNotNull
    893         */
    894        @Override
    895        public String toString() {
    896                return ToString.title( this.getClass().getName() )
    897                                .println( "VERSION"             ,VERSION        )
    898                                .println( "names"               ,NAMES          )
    899                                .println( "ENCODE"              ,ENCODE         )
    900                                .println( "fileURL"             ,fileURL        )
    901                                .println( "filename"    ,filename       )
    902                                .println( "maxPostSize" ,maxPostSize)
    903                                .println( "tableId"             ,tableId        )
    904                                .println( "columns"             ,columns        )                               // 5.6.5.2 (2013/06/21)
    905                                .println( "useBackup"   ,useBackup      )                               // 5.6.5.3 (2013/06/28)
    906                                .println( "Other..."    ,getAttributes().getAttribute() )
    907                                .fixForm().toString() ;
    908        }
    909}
    910
    911/*
    912 * ※ ｺﾒﾝﾄが多すぎて、GF23 登録ｴﾗｰになったため、削除します。
    913 *
    914 * 5.7.1.2 (2013/12/20) zip 対応
    915 * filename 属性に、".zip" の拡張子のﾌｧｲﾙ名を指定した場合は、ｱｯﾌﾟﾛｰﾄﾞされた一連のﾌｧｲﾙを
    916 * ZIP圧縮します。これは、ｱｯﾌﾟﾛｰﾄﾞ後の処理になります。
    917 * ZIP圧縮のｵﾘｼﾞﾅﾙﾌｧｲﾙは、そのまま残ります。
    918 * なお、ZIPﾌｧｲﾙは、useBackup属性を true に設定しても、無関係に、上書きされます。
    919 *
    920 * 5.7.4.3 (2014/03/28) filename 属性のﾘｸｴｽﾄ変数対応
    921 * filename 属性のみ、{&#064;XXXX} のﾘｸｴｽﾄ変数が使えるようにします。
    922 * 他のﾊﾟﾗﾒｰﾀでは使えません。
    923 * これは、multipart/form-data のﾘｸｴｽﾄでは、ﾊﾟｰﾄの分解処理をしないと、ﾘｸｴｽﾄ変数が
    924 * 拾えない為、ﾘｸｴｽﾄ変数は、この、upload ﾀｸﾞ以降でのみ利用可能でした。
    925 * zip対応と関連付けて、filename 属性のみ、利用できるように、MultipartRequest 側の処理に組み込みます。
    926 *
    927 * 5.7.6.3 (2014/05/23) ｱｯﾌﾟﾛｰﾄﾞﾌｧｲﾙのCSVｾｯﾄ
    928 * 個々に指定したｱｯﾌﾟﾛｰﾄﾞﾌｧｲﾙ名は、XXX_NEW や XXX_ORG で取得できますが、
    929 * HTML5 の multiple 属性使用時や、ｱｯﾌﾟﾛｰﾄﾞされたﾌｧｲﾙを一連で処理したい場合に
    930 * ﾌｧｲﾙ名を、CSV形式で取り出せるようにします。
    931 * ｷｰは、共通で、UPLOAD_FILES とします。
    932 *
    933 * 5.9.25.0 (2017/10/06)
    934 * ｸﾗｳﾄﾞ上のPaaSでｵﾌﾞｼﾞｪｸﾄｽﾄﾚｰｼﾞを利用する際は以下のｼｽﾃﾑﾘｿｰｽを設定してください。
    935 * CLOUD_TARGET,CLOUD_BUCKET
    936 * plugin/cloud内のｸﾗｽを利用してﾌｧｲﾙｱｯﾌﾟﾛｰﾄﾞ(FileUploadﾀｸﾞ)、ﾀﾞｳﾝﾛｰﾄﾞ(FileDownloadｻｰﾌﾞﾚｯﾄ)をAPI経由で行います。
    937 * ﾌﾟﾗｸﾞｲﾝが利用するjarﾌｧｲﾙの配置は必要です。
    938 */