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 * を指定した場合の、他のリクエスト情報も、{@XXXX} 変数で取り出すことが可能です。
047 *
048 * この upload タグでは、アップロード後に、指定のファイル名に変更する機能があります。
049 * file 登録ダイアログで指定した name に、"_NEW" という名称を付けたリクエスト値を
050 * ファイルのアップロードと同時に送信することで、この名前にファイルを付け替えます。
051 * また、アップロード後のファイル名は、name 指定の名称で、取り出せます。
052 * クライアントから登録したオリジナルのファイル名は、name に、"_ORG" という名称
053 * で取り出すことが可能です。
054 *
055 * 通常では、これらのパラメータを、RequestAttribute 変数にセットしますので、{@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 * ●形式:<og:upload fileURL="…" maxPostSize="…" />
086 * ●body:なし
087 *
088 * ●Tag定義:
089 *       <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 *       />
104 *
105 * ●使用例 :
106 * 【query.jsp】
107 *               <form method="POST" action="result.jsp" enctype="multipart/form-data" target="RESULT">
108 *               <table>
109 *               <tr><og:input type="text" name="submitter" value="{@USER.JNAME}" size="20" lbl="MSG0014" /></tr>
110 *               <tr>
111 *                       <og:input type="file"       name="file_01"          size="30" lbl="MSG0015" />
112 *                       <og:input                           name="file_01_NEW"      size="10" lbl="FILENAME" />
113 *               </tr><tr>
114 *                       <og:input type="file"       name="file_02"          size="30" lbl="MSG0015" />
115 *                       <og:input                           name="file_02_NEW"      size="10" lbl="FILENAME" />
116 *               </tr><tr>
117 *                       <og:input type="file"       name="file_03"          size="30" lbl="MSG0015" />
118 *                       <og:input                           name="file_03_NEW"      size="10" lbl="FILENAME" />
119 *               </tr><tr>
120 *                       <og:column name="writable"  value="false"   />
121 *               </tr>
122 *               </table>
123 *
124 * 【result.jsp】
125 *               <og:upload
126 *                       fileURL        = "{@USER.ID}"
127 *               />
128 *               <br />
129 *               <og:message lbl="MSG0003" comment="ファイルの登録が完了しました。" />
130 *
131 *               <og:view
132 *                       command                = "NEW"
133 *                       viewFormType   = "HTMLTable"
134 *                       writable               = "{@writable}"
135 *               />
136 *
137 *               <table>
138 *               <tr><og:input name="submitter"        value="{@submitter}"       /></tr>
139 *               <tr><og:input name="writable"         value="{@writable}"        /></tr>
140 *               <tr><og:input name="directory"        value="{@directory}"       /></tr>
141 *               <tr><og:input name="file_01"          value="{@file_01}"         /></tr>
142 *               <tr><og:input name="file_01_NEW"      value="{@file_01_NEW}"     /></tr>
143 *               <tr><og:input name="file_01_ORG"      value="{@file_01_ORG}"     /></tr>
144 *               <tr><og:input name="file_02"          value="{@file_02}"         /></tr>
145 *               <tr><og:input name="file_02_NEW"      value="{@file_02_NEW}"     /></tr>
146 *               <tr><og:input name="file_02_ORG"      value="{@file_02_ORG}"     /></tr>
147 *               <tr><og:input name="file_03"          value="{@file_03}"         /></tr>
148 *               <tr><og:input name="file_03_NEW"      value="{@file_03_NEW}"     /></tr>
149 *               <tr><og:input name="file_03_ORG"      value="{@file_03_ORG}"     /></tr>
150 *               </table>
151 *
152 * 【result.jsp】
153 *               <og:upload
154 *                       fileURL         = "{@USER.ID}"
155 *                       columns         = "submitter,file"
156 *               />
157 *               <br />
158 *               <og:message lbl="MSG0003" comment="ファイルの登録が完了しました。" />
159 *
160 *               <og:view
161 *                       command          = "NEW"
162 *                       viewFormType = "HTMLTable"
163 *                       writable         = "{@writable}"
164 *               />
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         * {@XXXX} で値が取り出せる様にしています。
329         *
330         * @og.rev 2.2.0.0 (2002/12/17) 中国語(国際化)対応 エンコードの取得方法変更
331         * @og.rev 3.0.1.1 (2003/03/06) request 情報から{@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         *
349         * @return       テーブルモデル
350         */
351        private DBTableModel makeDBTable( final MultipartRequest multi ) {
352
353                final DBTableModel table = DBTableModelUtil.newDBTable();
354
355                table.init( NAMES.length );
356
357                for( int i=0; i<NAMES.length; i++ ) {
358                        final DBColumn dbColumn = getDBColumn( NAMES[i] );
359                        table.setDBColumn( i,dbColumn );
360                }
361
362                String[] values ;               // 4.0.0.0 (2007/10/12)
363                final List<String> prmNames = new ArrayList<>();
364
365                // 5.7.1.1 (2013/12/13) HTML5 ファイルアップロードの複数選択(multiple)対応
366                // 6.2.3.0 (2015/05/01) アップロードファイルを、UPLOAD_FILESキーに、Listオブジェクトに格納します。
367                final List<String> list = new ArrayList<>();
368                final UploadedFile[] files = multi.getUploadedFile();
369                for( int i=0; i<files.length; i++ ) {
370                        final String name = files[i].getName();                                 // multiple対応では、キーがかぶることがある。
371                        String val  = files[i].getUploadFile();                         // 5.9.25.0 (2017/10/06) MODIFY getUploadFileで取得される値をFileからStringに変更対応
372
373                        // 6.2.3.0 (2015/05/01) アップロードファイルを、UPLOAD_FILESキーに、Listオブジェクトに格納します。
374                        list.add( val );
375
376                        // "KEY","VALUE","ISFILE" の順にデータを作成します。
377                        values = new String[] { name, val, "1" };
378                        table.addColumnValues( values );
379                        setRequestAttribute( name,val );
380                        prmNames.add( name );                           // 5.7.1.1 (2013/12/13) List に設定する。
381
382                        final String orgName = name + "_ORG" ;
383                        val  = files[i].getOriginalFileName();  // 注意:取得は、送信名
384
385                        // "KEY","VALUE","ISFILE" の順にデータを作成します。
386                        values = new String[] { orgName, val, "2" };
387                        table.addColumnValues( values );
388                        setRequestAttribute( orgName,val );
389                }
390
391                // 6.2.3.0 (2015/05/01) アップロードファイルを、UPLOAD_FILESキーに、Listオブジェクトに格納します。
392                setRequestAttribute( UPLOAD_FILES,list );
393
394                // "KEY","VALUE","ISFILE" の順にデータを作成します。
395                values = new String[] { "directory", fileURL, "0" };
396                table.addColumnValues( values );
397                setRequestAttribute( "directory",fileURL );
398
399                final String[] params = multi.getParameterNames();
400                for( int i=0; i<params.length; i++ ) {
401                        final String name = params[i];
402                        // 5.3.2.0 (2011/02/01) チェック行のパラメーターはint配列側に変換
403                        if( HybsSystem.ROW_SEL_KEY.equals( name ) ) {
404                                setRequestAttribute( name,multi.getIntParameters(name) );
405                        }
406                        // 8.2.0.2 (2022/06/24) must と mustAny の複数選択対応
407                        else if( name.startsWith( HybsSystem.MUST_KEY ) ) {
408                                setRequestAttribute( name,multi.getParameters(name) );          // MUST_KEY+"must" or MUST_KEY+"mustAny"
409                        }
410                        else {
411                                // 5.6.5.2 (2013/06/21) チェックボックス配列の値取得を考慮した、MultipartRequest のパラメータ値取得
412                                final String val = getParamVal( name,multi );
413
414                                values = new String[] { name, val, "0" };
415                                table.addColumnValues( values );
416                                setRequestAttribute( name,val );
417                                prmNames.add( name );                           // 5.7.1.1 (2013/12/13) List に設定する。
418                        }
419                }
420
421                // 5.3.2.0 (2011/02/01) パラメーター名を保存する。
422                // 5.7.1.1 (2013/12/13) List に設定する。
423                setParameterNames( prmNames.toArray( new String[prmNames.size()] ) );
424
425                return table ;
426        }
427
428        /**
429         * ファイルアップロードの実行結果を 横持の DBTableModel に記述します。
430         *
431         * この処理は、columns 属性を設定した場合のみとします。
432         *
433         * DBTableModel作成時に、指定のカラムの"_01"~"_99"の添え字をレコードとして作成します。
434         * 現状は、"KEY","VALUE","ISFILE" のカラムに、データを縦持ちで作成しています。
435         * これを、横持で作成しますが、カラムの末尾に、"_01"~"_99" までの添え字を
436         * 持つ場合は、これをレコードと認識させます。
437         * 添え字がない場合は、カラムだけ作成されます。カラム名と同じリクエストがあれば、
438         * すべてのレコードに同じ値がセットされます。
439         *
440         * @og.rev 5.6.5.2 (2013/06/21) 新規作成
441         * @og.rev 5.6.6.1 (2013/07/12) 添え字がない場合の処理の見直し
442         * @og.rev 5.7.1.2 (2013/12/20) zip対応で、UploadedFile のメソッド変更
443         * @og.rev 5.7.3.0 (2014/02/07) zip対応の修正で、取得ファイル名が異なっていた。
444         * @og.rev 5.7.6.3 (2014/05/23) アップロードファイルのCSVセット
445         * @og.rev 6.0.2.4 (2014/10/17) _PFX , _SFX 対応
446         * @og.rev 6.2.3.0 (2015/05/01) アップロードファイルを、UPLOAD_FILESキーに、Listオブジェクトに格納します。
447         * @og.rev 5.9.25.0 (2017/10/06) クラウド対応
448         * @og.rev 8.1.2.0 (2022/03/10) _HASH(ファイルのハッシュ値) 対応
449         * @og.rev 8.2.0.2 (2022/06/24) must と mustAny の複数選択対応
450         *
451         * @param        multi     MultipartRequestオブジェクト
452         *
453         * @return       テーブルモデル
454         */
455        private DBTableModel makeDBTableFromClms( final MultipartRequest multi ) {
456
457                final DBTableModel table = DBTableModelUtil.newDBTable();
458
459                final String[] clmNames = columns.split( "," );
460
461                table.init( clmNames.length );
462
463                // 値配列(1行分)
464                String[] rowVal = new String[clmNames.length];
465
466                // 5.7.1.1 (2013/12/13) HTML5 ファイルアップロードの複数選択(multiple)対応
467                final UploadedFile[] files = multi.getUploadedFile();
468
469                final List<String> prmNames = new ArrayList<>();
470
471                for( int i=0; i<clmNames.length; i++ ) {
472                        final String clm = clmNames[i] ;
473                        final DBColumn dbColumn = getDBColumn( clm );
474                        table.setDBColumn( i,dbColumn );
475
476                        // 先に、カラム名と一致するパラメータを初期値としてセットしておきます。
477                        String val = getParamVal( clm,multi );
478
479                        // 5.6.6.1 (2013/07/12) ファイル名も同様に、あれば初期値セットしておきます。
480                        if( val == null ) {
481                                // 5.7.1.1 (2013/12/13) HTML5 ファイルアップロードの複数選択(multiple)対応
482                                for( int j=0; j<files.length; j++ ) {
483                                        final String nm = files[j].getName();
484                                        if( clm.equalsIgnoreCase( nm ) ) {
485                                                val = files[i].getUploadFile();                         // 5.9.25.0 (2017/10/06) getUploadFileの型をFileからStringに変更対応
486                                                break;                                                                          // 5.7.6.3 (2014/05/23) たぶん有ったほうが良い。
487                                        }
488                                }
489                        }
490                        // 5.7.1.1 (2013/12/13) getFilesystemName() の中に、newFile が null の場合は、original を返す処理がある。
491                        rowVal[i] = ( val == null ) ? "" : val ;
492                }
493
494                // 6.2.3.0 (2015/05/01) アップロードファイルを、UPLOAD_FILESキーに、Listオブジェクトに格納します。
495                final List<String> list = new ArrayList<>();
496
497                for( int i=0; i<files.length; i++ ) {
498                        final String name = files[i].getName();
499                        // 5.6.6.1 (2013/07/12) 添え字がない場合の処理の見直し。先にレコードを作成
500                        String[] values = new String[clmNames.length];
501                        System.arraycopy( rowVal,0,values,0,values.length );            // 行にセットするに当たり、rowVal を values にコピーしておく。
502
503                        // ファイル名を Attribute で使えるようにセットしておく。
504                        final String fval = files[i].getUploadFile();                           // 5.9.25.0 (2017/10/06) getUploadで取得される値をFileからStringに変更
505                        setRequestAttribute( name,fval );
506                        prmNames.add( name );                                                                           // 5.7.1.1 (2013/12/13) List に設定する。
507
508                        // 6.2.3.0 (2015/05/01) アップロードファイルを、UPLOAD_FILESキーに、Listオブジェクトに格納します。
509                        list.add( fval );
510
511                        final String orgName = name + "_ORG" ;
512                        final String oval  = files[i].getOriginalFileName();    // 注意:取得は、送信名
513                        setRequestAttribute( orgName,oval );
514
515                        // ファイルのキーを元に、添え字を検索します。
516                        final int adrs = name.lastIndexOf( '_' );               // 添え字は、'_' で区切られます。
517                        // 5.6.6.1 (2013/07/12) 添え字がない場合の処理の見直し。後続処理を行う。
518                        if( adrs > 0 ) {
519                                final String fnm = name.substring( 0,adrs );    // ファイル名(分割後)
520                                final String sub = name.substring( adrs );      // 添え字(アンダーバー含む)
521
522                                // カラム名で検索しながら、レコード単位になるようにセットしていきます。
523                                for( int j=0; j<clmNames.length; j++ ) {
524                                        final String clm = clmNames[j] ;
525                                        String nm  = null;
526                                        String val = null;
527
528                                        if( fnm.equalsIgnoreCase( clm ) ) {             // ファイル名カラム(_NEWファイル名も、この値にすでに変わっている)
529                                                val = fval;
530                                        }
531                                        else if( ( fnm + "_ORG" ).equalsIgnoreCase( clm ) ) {           // 元ファイル名カラム
532                                                val  = oval;
533                                        }
534                                        else if( ( fnm + "_NEW" ).equalsIgnoreCase( clm ) ) {           // 新ファイル名カラム
535                                                nm   = name + "_NEW" ;
536                                                val  = multi.getParameter( nm );
537                                        }
538                                        // 6.0.2.4 (2014/10/17) _PFX , _SFX 対応
539                                        else if( ( fnm + "_PFX" ).equalsIgnoreCase( clm ) ) {           // プレフィックスカラム
540                                                nm   = name + "_PFX" ;
541                                                val  = multi.getParameter( nm );
542                                        }
543                                        else if( ( fnm + "_SFX" ).equalsIgnoreCase( clm ) ) {           // サフィックスカラム
544                                                nm   = name + "_SFX" ;
545                                                val  = multi.getParameter( nm );
546                                        }
547                                        else if( ( fnm + "_HASH" ).equalsIgnoreCase( clm ) ) {          // ハッシュコード 8.1.2.0 (2022/03/10)
548                                                nm   = name + "_HASH" ;
549                                                final File localFile = files[i].getFile( useLocal );
550                                                val  = HybsCryptography.getHash( HASH_CODE, localFile );
551                                        }
552                                        else {
553                                                nm  = clmNames[j] + sub;                                        // sub は、アンダーバー含む添え字
554                                                // 5.6.5.2 (2013/06/21) チェックボックス配列の値取得を考慮した、MultipartRequest のパラメータ値取得
555                                                val = getParamVal( nm,multi );
556                                        }
557                                        if( val != null ) { values[j] = val ; }         // val が null でないときのみセットします。
558                                }
559                        }
560                        table.addColumnValues( values );
561                }
562                // 6.2.3.0 (2015/05/01) アップロードファイルを、UPLOAD_FILESキーに、Listオブジェクトに格納します。
563                setRequestAttribute( UPLOAD_FILES,list );
564
565                // Attribute で使えるようにセットしておく。
566                setRequestAttribute( "directory",fileURL );
567
568                // Attribute で使えるようにセットしておく。
569                final String[] params = multi.getParameterNames();
570                for( int i=0; i<params.length; i++ ) {
571                        final String name = params[i];
572                        // 5.3.2.0 (2011/02/01) チェック行のパラメーターはint配列側に変換
573                        if( HybsSystem.ROW_SEL_KEY.equals( name ) ) {
574                                setRequestAttribute( name,multi.getIntParameters(name) );
575                        }
576                        // 8.2.0.2 (2022/06/24) must と mustAny の複数選択対応
577                        else if( name.startsWith( HybsSystem.MUST_KEY ) ) {
578                                setRequestAttribute( name,multi.getParameters(name) );          // MUST_KEY+"must" or MUST_KEY+"mustAny"
579                        }
580                        else {
581                                // 5.6.5.2 (2013/06/21) チェックボックス配列の値取得を考慮した、MultipartRequest のパラメータ値取得
582                                final String val = getParamVal( name,multi );
583                                setRequestAttribute( name,val );
584                                prmNames.add( name );                           // 5.7.1.1 (2013/12/13) List に設定する。
585                        }
586                }
587
588                // 5.3.2.0 (2011/02/01) パラメーター名を保存する。
589                // 5.7.1.1 (2013/12/13) List に設定する。
590                setParameterNames( prmNames.toArray( new String[prmNames.size()] ) );
591
592                return table ;
593        }
594
595        /**
596         * チェックボックス配列の値取得を考慮した、MultipartRequest のパラメータ値取得
597         *
598         * ここでは、、MultipartRequest のパラメータ値を取得します。
599         * 値の取得で、チェックボックス配列の場合は、取得した値が、"0" の場合のみ
600         * 配列でパラメータを取得し直し、"1" がないかどうか再度検索します。
601         * チェックボックスでは、チェック時の "1" と、チェックされなかった場合の、
602         * hidden の "0" の両方の値が配列としてリクエストされるケースがある為です。
603         *
604         * @og.rev 5.6.5.2 (2013/06/21) 新規作成
605         * @og.rev 6.3.9.1 (2015/11/27) MultipartRequest#getParameters(String)は、null ではなく長さが0の配列を返す。
606         *
607         * @param        key       MultipartRequestのパラメータ取得のためのキー
608         * @param        multi     MultipartRequestオブジェクト
609         *
610         * @return       チェックボックス配列を考慮したパラメータ値
611         */
612        private String getParamVal( final String key , final MultipartRequest multi ) {
613                String val = multi.getParameter( key );
614
615                if( "0".equals(val) ){ // 5.4.4.2 チェックボックス配列対応。
616                        final String[] vals = multi.getParameters( key );
617                        for( final String tmp : vals ) {
618                                if( "1".equals( tmp ) ) {
619                                        val = "1";
620                                        break;
621                                }
622                        }
623                }
624                return val ;
625        }
626
627        /**
628         * 【TAG】ファイルをアップロードするディレクトリを指定します
629         *              (初期値:FILE_URL[={@og.value SystemData#FILE_URL}])。
630         *
631         * @og.tag
632         * この属性で指定されるディレクトリに、アップロードされたファイルをセーブします。
633         * 指定方法は、通常の fileURL 属性と同様に、先頭が、'/' (UNIX) または、2文字目が、
634         * ":" (Windows)の場合は、指定のURLそのままのディレクトリに、そうでない場合は、
635         * fileURL = "{&#064;USER.ID}" と指定すると、FILE_URL 属性で指定のフォルダの下に、
636         * さらに、各個人ID別のフォルダを作成して、そこにセーブします。
637         * (初期値:システム定数のFILE_URL[={@og.value SystemData#FILE_URL}])。
638         *
639         * @og.rev 4.0.0.0 (2005/01/31) StringUtil.urlAppend メソッドの利用
640         * @og.rev 4.0.0.0 (2007/11/20) 指定されたディレクトリ名の最後が"\"or"/"で終わっていない場合に、"/"を付加する。
641         * @og.rev 5.7.1.1 (2013/12/13) リクエスト変数が使えないエラーを表示する。
642         * @og.rev 5.7.4.3 (2014/03/28) リクエスト変数が使えない事のチェックを行う。
643         * @og.rev 6.4.2.1 (2016/02/05) URLの最後に、"/" を追加する処理を廃止。
644         *
645         * @param       url ファイルURL
646         * @see         org.opengion.hayabusa.common.SystemData#FILE_URL
647         */
648        public void setFileURL( final String url ) {
649                final String furl = nval( getRequestParameter( url ),null );
650                // 6.4.1.1 (2016/01/16) PMD refactoring. Avoid if (x != y) ..; else ..;
651                if( furl == null ) {
652                        chckReqParam( url,"fileURL" );          // 5.7.4.3 (2014/03/28) リクエスト変数が使えない事のチェック
653                }
654                else {
655                        fileURL = StringUtil.urlAppend( fileURL,furl );
656                }
657        }
658
659        /**
660         * 【TAG】最大転送サイズ(Byte)を指定します(初期値:31457280)。
661         *
662         * @og.tag
663         * 最大転送サイズを指定します。初期値は、30*1024*1024 = 30MB です。
664         * 指定は、Byte 単位で指定します。
665         * 0,またはマイナスを指定することで、制限チェックを外す(=無制限)事ができます。
666         *
667         * @og.rev 3.0.1.1 (2003/03/06) maxPostSize の設定バグ修正。
668         * @og.rev 5.6.5.3 (2013/06/28) コメント追加(0,またはマイナスで無制限)
669         * @og.rev 5.7.4.3 (2014/03/28) リクエスト変数が使えない事のチェックを行う。
670         * @og.rev 6.0.2.4 (2014/10/17) 最大ファイル容量 10M → 30M 変更(JavaDocの修正)
671         *
672         * @param       maxPS 最大転送サイズ
673         */
674        public void setMaxPostSize( final String maxPS ) {
675                maxPostSize = nval( getRequestParameter( maxPS ),maxPostSize );
676
677                chckReqParam( maxPS,"maxPostSize" );            // 5.7.4.3 (2014/03/28) リクエスト変数が使えない事のチェック
678        }
679
680        /**
681         * 【TAG】(通常は使いません)結果のDBTableModelを、sessionに登録するときのキーを指定します
682         *              (初期値:HybsSystem#TBL_MDL_KEY[={@og.value HybsSystem#TBL_MDL_KEY}])。
683         *
684         * @og.tag
685         * 検索結果より、DBTableModelオブジェクトを作成します。これを、下流のviewタグ等に
686         * 渡す場合に、通常は、session を利用します。その場合の登録キーです。
687         * query タグを同時に実行して、結果を求める場合、同一メモリに配置される為、
688         * この tableId 属性を利用して、メモリ空間を分けます。
689         *              (初期値:HybsSystem#TBL_MDL_KEY[={@og.value HybsSystem#TBL_MDL_KEY}])。
690         *
691         * @og.rev 5.7.4.3 (2014/03/28) リクエスト変数が使えない事のチェックを行う。
692         *
693         * @param       id テーブルID (sessionに登録する時のID)
694         */
695        public void setTableId( final String id ) {
696                tableId = nval( getRequestParameter( id ),tableId );
697
698                chckReqParam( id,"tableId" );           // 5.7.4.3 (2014/03/28) リクエスト変数が使えない事のチェック
699        }
700
701        /**
702         * 【TAG】(通常は使いません)ファイルを作成するときのファイル名をセットします(初期値:null)。
703         *
704         * @og.tag
705         * ファイルを作成するときのファイル名をセットします。
706         * これは、複数同時にアップロードファイル名を変更する時に使用できません。
707         * 通常、アップロードされたファイル名を指定する場合、アップロードするinput タグの
708         * name 属性に指定する名称 + "_NEW" というリクエスト値を同時に送信すれば、
709         * 内部的に関連付けて、ファイル名を更新します。
710         * その場合、クライアントより指定したファイル名は、name属性+"_ORG" という
711         * リクエスト値として取得することが可能になります。
712         * name属性 には、最終的に設定されたファイル名がセットされています。
713         * いずれの値も、{&#064;name属性+"_ORG"} や、{&#064;name属性+"_NEW"}として、
714         * アップロードのオリジナルと変更後のファイル名を取得することが出来ます。
715         *
716         * 5.7.1.2 (2013/12/20) zip 対応
717         * filename 属性に、".zip" の拡張子のファイル名を指定した場合は、アップロードされた一連のファイルを
718         * ZIP圧縮します。これは、アップロード後の処理になります。
719         * ZIP圧縮のオリジナルファイルは、そのまま残ります。
720         * なお、ZIPファイルは、useBackup属性を true に設定しても、無関係に、上書きされます。
721         *
722         * 5.7.4.3 (2014/03/28) filename 属性のリクエスト変数対応
723         * filename 属性のみ、{&#064;XXXX} のリクエスト変数が使えるようにします。
724         * 他のパラメータでは使えません。
725         * これは、multipart/form-data のリクエストでは、パートの分解処理をしないと、リクエスト変数が
726         * 拾えない為、リクエスト変数は、この、upload タグ以降でのみ利用可能でした。
727         * zip対応と関連付けて、filename 属性のみ、利用できるように、MultipartRequest 側の処理に組み込みます。
728         *
729         * @og.rev 3.5.4.2 (2003/12/15) ファイル名を指定できるようにします。
730         * @og.rev 5.7.1.1 (2013/12/13) リクエスト変数が使えないエラーを表示する。
731         * @og.rev 5.7.4.3 (2014/03/28) リクエスト変数を使えるようにします。
732         *
733         * @param   fname ファイル名
734         */
735        public void setFilename( final String fname ) {
736                filename = nval( getReservedParameter( fname ),null );          // 予約語のみ処理をします。
737        }
738
739        /**
740         * 【TAG】DBTableModel作成時に、指定のカラムの"_01"~"_99"の添え字をレコードとして作成します。
741         *
742         * @og.tag
743         * 現状は、"KEY","VALUE","ISFILE" のカラムに、データを縦持ちで作成しています。
744         * これを、横持で作成しますが、カラムの末尾に、"_01"~"_99" までの添え字を
745         * 持つ場合は、これをレコードと認識させます。
746         * アンダーバーがない場合は、カラムだけ作成されます。カラム名と同じリクエストがあれば、
747         * すべてのレコードに同じ値がセットされます。
748         * この処理は、columns 属性を設定した場合のみとします。
749         *
750         * @og.rev 5.6.5.2 (2013/06/21) 新規作成
751         * @og.rev 5.7.4.3 (2014/03/28) リクエスト変数が使えない事のチェックを行う。
752         *
753         * @param   clms DBTableModel作成時のカラム列(CSV形式)
754         */
755        public void setColumns( final String clms ) {
756                columns = nval( getRequestParameter( clms ),columns );
757
758                chckReqParam( clms,"columns" );         // 5.7.4.3 (2014/03/28) リクエスト変数が使えない事のチェック
759        }
760
761        /**
762         * 【TAG】すでに同名のファイルが存在した場合に、バックアップ処理するかどうか[true/false/rename]を指定します(初期値:null=false)。
763         *
764         * @og.tag
765         * ファイルアップロード時に、アップロード先に、同名のファイルが存在した場合は、既存機能は、そのまま
766         * 置き換えていましたが、簡易バージョンアップ機能として、useBackup="true" を指定すると、既存のファイルを
767         * リネームして、バックアップファイルを作成します。
768         * バックアップファイルは、アップロードフォルダを基準として、_backup/ファイル名.拡張子_処理時刻のlong値.拡張子 になります。
769         * オリジナルのファイル名(拡張子付)を残したまま、"_処理時刻のlong値" を追加し、さらに、オリジナルの拡張子を追加します。
770         * バックアップファイルの形式は指定できません。
771         *
772         * 初期値は、互換性を持たせるため、null(=false) です。
773         *
774         * 6.0.2.4 (2014/10/17)
775         * useBackup="rename" で、すでに同名のファイルが存在した場合に、"_001" のような文字列を追加したファイルにリネームします。
776         * Windowsの " - コピー (2)" に近いですが、桁数を抑えるのと、useBackup="true" と異なり、過去の同一ファイル名は
777         * そのまま、有効になります。同一ファイルが同一フォルダに存在する場合のみ連番が付与されます。
778         *
779         * @og.rev 5.6.5.3 (2013/06/28) 新規作成
780         * @og.rev 5.7.4.3 (2014/03/28) リクエスト変数が使えない事のチェックを行う。
781         * @og.rev 6.0.2.4 (2014/10/17) true/false 以外に、rename も有効とする。
782         *
783         * @param   flag バックアップ処理可否 [true:する/false:しない]
784         */
785        public void setUseBackup( final String flag ) {
786                useBackup = nval( getRequestParameter( flag ),useBackup );
787
788                // 6.0.2.4 (2014/10/17) パラメータチェックをしておきます。
789                if( useBackup != null && "true/false/rename".indexOf( useBackup.toLowerCase(Locale.JAPAN) ) < 0 ) {
790                        final String errMsg = "useBackup 属性は、[true/false/rename] から、指定してください。"
791                                                                + " useBackup=[" + useBackup + "]" + CR ;
792                        throw new HybsSystemException( errMsg );
793                }
794
795                chckReqParam( flag,"useBackup" );               // 5.7.4.3 (2014/03/28) リクエスト変数が使えない事のチェック
796        }
797
798        /**
799         * リクエスト変数が使えない事のチェックを行います。
800         *
801         * upload では、enctype="multipart/form-data" のため、{&#064;XXXX}形式のパラメータが使えません。
802         * 5.7.4.3 (2014/03/28) から、filename のみ利用可能としたことで、同様に利用できると
803         * 勘違いするケースに対応する為、すべてのパラメータについてチェックを行います。
804         * ここでは、getRequestParameter( String ) の実行後、すぐに、isNull() 判定を行う事で、
805         * リクエスト変数の存在チェックを行う事にしています。
806         *
807         * @og.rev 5.7.4.3 (2014/03/28) リクエスト変数が使えない事のチェックを行う。
808         *
809         * @param   org 引数のオリジナル値
810         * @param   key エラーの発生した変数名
811         * @throws      HybsSystemException     パラメータが使用されていた場合
812         */
813        private void chckReqParam( final String org,final String key ) {
814                if( isNull() && org != null && org.contains( "{@" ) ) {
815                        final String errMsg = "upload では、enctype=\"multipart/form-data\" のため、{@XXXX}形式のパラメータが使えません。"
816                                                                + CR
817                                                                + "    " + key + "=[" + org + "]" ;
818                        throw new HybsSystemException( errMsg );                // リクエスト変数が使えないエラー
819                }
820        }
821
822        /**
823         * タグの名称を、返します。
824         * 自分自身のクラス名より、自動的に取り出せないため、このメソッドをオーバーライドします。
825         *
826         * @og.rev 4.0.0.0 (2005/01/31) 新規追加
827         *
828         * @return  タグの名称
829         * @og.rtnNotNull
830         */
831        @Override
832        protected String getTagName() {
833                return "upload" ;
834        }
835
836//      /**
837//       * 【TAG】保存先ストレージタイプを設定します。
838//       *
839//       * @og.tag
840//       * ファイルを読み取り元の、ストレージタイプを設定します。
841//       * 未設定の場合は、システムリソースの「CLOUD_TARGET」が参照されます。
842//       * 自身のサーバを指定する場合は、「default」を設定してください。
843//       * 強制的に、ローカルファイルを指定する場合は、空文字列ではなく、"LOCAL" を指定します。
844//       *
845//       * @og.rev 5.10.9.0 (2019/03/01) 新規追加
846//       * @og.rev 8.0.1.0 (2021/10/29) storageType , bucketName 削除
847//       *
848//       * @param type 保存先ストレージタイプ
849//       */
850//      public void setStorageType( final String type ) {
851//              storage  = nval( getRequestParameter(type), storage );
852//      }
853
854//      /**
855//       * 【TAG】保存先バケット名を設定します。
856//       *
857//       * @og.tag
858//       * ファイルを読み取り元の、バケット名を指定します。
859//       * クラウドストレージ利用時のみ有効です。
860//       * 未設定の場合は、システムリソースの「CLOUD_BUCKET」が参照されます。
861//       * 強制的に、ローカルファイルを指定する場合は、空文字列ではなく、"LOCAL" を指定します。
862//       *
863//       * @og.rev 5.10.9.0 (2019/03/01) 新規追加
864//       * @og.rev 8.0.1.0 (2021/10/29) storageType , bucketName 削除
865//       *
866//       * @param bkt 保存先バケット名
867//       */
868//      public void setBucket( final String bkt )  {
869//              bucket = nval( getRequestParameter(bkt), bucket );
870//      }
871
872        /**
873         * 【TAG】システム定数でクラウド設定されていても、クラウド環境を使用しない場合、trueを指定します(初期値:false)。
874         *
875         * @og.tag
876         * クラウド設定は、システム定数の『CLOUD_TARGET』と『CLOUD_BUCKET』の設定で自動的に使用しますが、
877         * どうしてもローカルでのみ使いたい場合は、この属性を true に設定します。
878         * 標準はfalse:設定どおりとなります。
879         *
880         * true/false以外を指定した場合はfalse扱いとします。
881         *
882         * @og.rev 8.0.1.0 (2021/10/29) useLocal 属性を追加。
883         *
884         * @param flag ローカル環境のみ [true:ローカルのみ/false:設定どおり]
885         */
886        public void setUseLocal( final String flag ) {
887                useLocal = nval( getRequestParameter( flag ),useLocal );
888        }
889
890        /**
891         * このオブジェクトの文字列表現を返します。
892         * 基本的にデバッグ目的に使用します。
893         *
894         * @return このクラスの文字列表現
895         * @og.rtnNotNull
896         */
897        @Override
898        public String toString() {
899                return ToString.title( this.getClass().getName() )
900                                .println( "VERSION"             ,VERSION        )
901                                .println( "names"               ,NAMES          )
902                                .println( "ENCODE"              ,ENCODE         )
903                                .println( "fileURL"             ,fileURL        )
904                                .println( "filename"    ,filename       )
905                                .println( "maxPostSize" ,maxPostSize)
906                                .println( "tableId"             ,tableId        )
907                                .println( "columns"             ,columns        )                               // 5.6.5.2 (2013/06/21)
908                                .println( "useBackup"   ,useBackup      )                               // 5.6.5.3 (2013/06/28)
909                                .println( "Other..."    ,getAttributes().getAttribute() )
910                                .fixForm().toString() ;
911        }
912}
913
914/*
915 * ※ コメントが多すぎて、GF23 登録エラーになったため、削除します。
916 *
917 * 5.7.1.2 (2013/12/20) zip 対応
918 * filename 属性に、".zip" の拡張子のファイル名を指定した場合は、アップロードされた一連のファイルを
919 * ZIP圧縮します。これは、アップロード後の処理になります。
920 * ZIP圧縮のオリジナルファイルは、そのまま残ります。
921 * なお、ZIPファイルは、useBackup属性を true に設定しても、無関係に、上書きされます。
922 *
923 * 5.7.4.3 (2014/03/28) filename 属性のリクエスト変数対応
924 * filename 属性のみ、{&#064;XXXX} のリクエスト変数が使えるようにします。
925 * 他のパラメータでは使えません。
926 * これは、multipart/form-data のリクエストでは、パートの分解処理をしないと、リクエスト変数が
927 * 拾えない為、リクエスト変数は、この、upload タグ以降でのみ利用可能でした。
928 * zip対応と関連付けて、filename 属性のみ、利用できるように、MultipartRequest 側の処理に組み込みます。
929 *
930 * 5.7.6.3 (2014/05/23) アップロードファイルのCSVセット
931 * 個々に指定したアップロードファイル名は、XXX_NEW や XXX_ORG で取得できますが、
932 * HTML5 の multiple 属性使用時や、アップロードされたファイルを一連で処理したい場合に
933 * ファイル名を、CSV形式で取り出せるようにします。
934 * キーは、共通で、UPLOAD_FILES とします。
935 *
936 * 5.9.25.0 (2017/10/06)
937 * クラウド上のPaaSでオブジェクトストレージを利用する際は以下のシステムリソースを設定してください。
938 * CLOUD_TARGET,CLOUD_BUCKET
939 * plugin/cloud内のクラスを利用してファイルアップロード(FileUploadタグ)、ダウンロード(FileDownloadサーブレット)をAPI経由で行います。
940 * プラグインが利用するjarファイルの配置は必要です。
941 */