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