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