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 = "{@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 * いずれの値も、{@name属性+"_ORG"} や、{@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 属性のみ、{@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" のため、{@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 属性のみ、{@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 */