001/* 002 * Copyright (c) 2009 The openGion Project. 003 * 004 * Licensed under the Apache License, Version 2.0 (the "License"); 005 * you may not use this file except in compliance with the License. 006 * You may obtain a copy of the License at 007 * 008 * http://www.apache.org/licenses/LICENSE-2.0 009 * 010 * Unless required by applicable law or agreed to in writing, software 011 * distributed under the License is distributed on an "AS IS" BASIS, 012 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, 013 * either express or implied. See the License for the specific language 014 * governing permissions and limitations under the License. 015 */ 016package org.opengion.hayabusa.taglib; 017 018// import java.io.File; 019import java.io.IOException; 020import java.util.List; 021import java.util.ArrayList; 022import java.util.Locale ; // 6.0.2.4 (2014/10/17) 023 024import jakarta.servlet.http.HttpServletRequest; 025 026import org.opengion.fukurou.util.StringUtil; 027import org.opengion.fukurou.util.ToString; // 6.1.1.0 (2015/01/17) 028import org.opengion.hayabusa.common.HybsSystem; 029import org.opengion.hayabusa.common.HybsSystemException; 030import org.opengion.hayabusa.db.DBColumn; 031import org.opengion.hayabusa.db.DBTableModel; 032import org.opengion.hayabusa.db.DBTableModelUtil; 033import org.opengion.hayabusa.servlet.MultipartRequest; 034import org.opengion.hayabusa.servlet.UploadedFile; 035 036import static org.opengion.fukurou.util.StringUtil.nval; 037 038/** 039 * クライアントのファイルをサーバーにアップロードするタグです。 040 * 041 * アップロード後の属性は、DBTableModel に格納することにより、通常のデータと 042 * 同様の取り出し方が可能です。 043 * また、通常のファイルアップロード時の、form で使用する、enctype="multipart/form-data" 044 * を指定した場合の、他のリクエスト情報も、{@XXXX} 変数で取り出すことが可能です。 045 * 046 * この upload タグでは、アップロード後に、指定のファイル名に変更する機能があります。 047 * file 登録ダイアログで指定した name に、"_NEW" という名称を付けたリクエスト値を 048 * ファイルのアップロードと同時に送信することで、この名前にファイルを付け替えます。 049 * また、アップロード後のファイル名は、name 指定の名称で、取り出せます。 050 * クライアントから登録したオリジナルのファイル名は、name に、"_ORG" という名称 051 * で取り出すことが可能です。 052 * 053 * 通常では、これらのパラメータを、RequestAttribute 変数にセットしますので、{@XXXX}で 054 * 取り出すことが可能になります。さらに、"KEY","VALUE","ISFILE" のカラムを持った、 055 * DBTableModel にセットします。 056 * 057 * 新機能として、columns を指定する事で、columns のカラムを持つ DBTableModel にセットします。 058 * その場合は、カラム名_01 ~ カラム名_99 のように、アンダーバーで列データとなるキーを定義してください。 059 * アンダーバーがない場合は、カラムだけ作成されます。カラム名と同じリクエストがあれば、 060 * すべてのレコードに同じ値がセットされます。 061 * 062 * 新ファイル名に拡張子が設定されていない場合は、オリジナルファイル名の拡張子をセットします。 063 * 064 * HTML5 の type="file" 時の multiple 属性(アップロードファイルの複数選択機能)に対応します。(5.7.1.1 (2013/12/13)) 065 * その場合は、新しいファイル名への変更はできません。オリジナルのファイル名でアップロードされます 066 * 067 * 5.7.1.2 (2013/12/20) zip 対応 068 * filename 属性に、".zip" の拡張子のファイル名を指定した場合は、アップロードされた一連のファイルを 069 * ZIP圧縮します。これは、アップロード後の処理になります。 070 * ZIP圧縮のオリジナルファイルは、そのまま残ります。 071 * なお、ZIPファイルは、useBackup属性を true に設定しても、無関係に、上書きされます。 072 * 073 * 5.7.4.3 (2014/03/28) filename 属性のリクエスト変数対応 074 * filename 属性のみ、{@XXXX} のリクエスト変数が使えるようにします。 075 * 他のパラメータでは使えません。 076 * これは、multipart/form-data のリクエストでは、パートの分解処理をしないと、リクエスト変数が 077 * 拾えない為、リクエスト変数は、この、upload タグ以降でのみ利用可能でした。 078 * zip対応と関連付けて、filename 属性のみ、利用できるように、MultipartRequest 側の処理に組み込みます。 079 * 080 * 5.7.6.3 (2014/05/23) アップロードファイルのCSVセット 081 * 個々に指定したアップロードファイル名は、XXX_NEW や XXX_ORG で取得できますが、 082 * HTML5 の multiple 属性使用時や、アップロードされたファイルを一連で処理したい場合に 083 * ファイル名を、CSV形式で取り出せるようにします。 084 * キーは、共通で、UPLOAD_FILES とします。 085 * 086 * 6.0.2.4 (2014/10/17) 087 * ① name + _NEW と同じ考え方で、_PFX(接頭辞) , _SFX(接尾辞) 機能を追加します。 088 * ② 上記機能は、_NEW との併用可能。_NEW がない場合は、オリジナル(アップロードされた元のファイル名)に付与 089 * ③ useBackup="rename" で、すでに同名のファイルが存在した場合に、"_001" のような文字列を追加したファイルにリネームします。 090 * Windowsの " - コピー (2)" に近いですが、桁数を抑えるのと、useBackup="true" と異なり、過去の同一ファイル名は 091 * そのまま、有効になります。同一ファイルが同一フォルダに存在する場合のみ連番が付与されます。 092 * ④ name + _NEW の指定に、フォルダを含めることが可能。ただし、接続文字列は、"/" とする。 093 * 同時にアップロードを行う場合に、個別にフォルダを振り分けたり、_PFX(接頭辞) に、フォルダを指定 094 * することも可能です。 095 * ⑤ 最大転送サイズ(Byte)を 10M → 30M に変更 096 * 097 * 5.9.25.0 (2017/10/06) 098 * クラウド上のPaaSでオブジェクトストレージを利用する際は以下のシステムリソースを設定してください。 099 * CLOUD_TARGET,CLOUD_BUCKET 100 * plugin/cloud内のクラスを利用してファイルアップロード(FileUploadタグ)、ダウンロード(FileDownloadサーブレット)をAPI経由で行います。 101 * プラグインが利用するjarファイルの配置は必要です。 102 * 103 * @og.formSample 104 * ●形式:<og:upload fileURL="…" maxPostSize="…" /> 105 * ●body:なし 106 * 107 * ●Tag定義: 108 * <og:upload 109 * fileURL 【TAG】ファイルをアップロードするディレクトリを指定します (初期値:FILE_URL[=filetemp/]) 110 * filename 【TAG】(通常は使いません)ファイルを作成するときのファイル名をセットします(初期値:null) 111 * maxPostSize 【TAG】最大転送サイズ(Byte)を指定します(初期値:31457280=30M) 0,またはマイナスで無制限です。 112 * scope 【TAG】キャッシュする場合のスコープ[request/page/session/application]を指定します(初期値:session) 113 * tableId 【TAG】(通常は使いません)sessionから所得する DBTableModelオブジェクトの ID 114 * columns 【TAG】DBTableModel作成時に、指定のカラムの"_01"~"_99"の添え字をレコードとして作成します。 115 * useBackup 【TAG】すでに同名のファイルが存在した場合に、バックアップ処理するかどうか[true/false/rename]を指定します(初期値:null=false) 116 * useBackup="rename" で、"_001" のような文字列を追加します。 117 * storage 【TAG】保存先ストレージタイプを指定します 5.10.9.0 (2019/03/01) ADD 118 * bucket 【TAG】保存先バケット名を指定します 5.10.9.0 (2019/03/01) ADD 119 * useLocal 【TAG】システム定数でクラウド設定されていても、クラウド環境を使用しない場合、trueを指定します(初期値:false) 8.0.1.0 (2021/10/29) 120 * language 【TAG】タグ内部で使用する言語コード[ja/en/zh/…]を指定します 121 * debug 【TAG】デバッグ情報を出力するかどうか[true/false]を指定します(初期値:false) 122 * /> 123 * 124 * ●使用例 : 125 * 【query.jsp】 126 * <form method="POST" action="result.jsp" enctype="multipart/form-data" target="RESULT"> 127 * <table summary="layout" > 128 * <tr><og:input type="text" name="submitter" value="{@USER.JNAME}" size="20" lbl="MSG0014" /></tr> 129 * <tr> 130 * <og:input type="file" name="file_01" size="30" lbl="MSG0015" /> 131 * <og:input name="file_01_NEW" size="10" lbl="FILENAME" /> 132 * </tr><tr> 133 * <og:input type="file" name="file_02" size="30" lbl="MSG0015" /> 134 * <og:input name="file_02_NEW" size="10" lbl="FILENAME" /> 135 * </tr><tr> 136 * <og:input type="file" name="file_03" size="30" lbl="MSG0015" /> 137 * <og:input name="file_03_NEW" size="10" lbl="FILENAME" /> 138 * </tr><tr> 139 * <og:column name="writable" value="false" /> 140 * </tr> 141 * </table> 142 * 143 * 【result.jsp】 144 * <og:upload 145 * fileURL = "{@USER.ID}" 146 * /> 147 * <br /> 148 * <og:message lbl="MSG0003" comment="ファイルの登録が完了しました。" /> 149 * 150 * <og:view 151 * command = "NEW" 152 * viewFormType = "HTMLTable" 153 * writable = "{@writable}" 154 * /> 155 * 156 * <table> 157 * <tr><og:input name="submitter" value="{@submitter}" /></tr> 158 * <tr><og:input name="writable" value="{@writable}" /></tr> 159 * <tr><og:input name="directory" value="{@directory}" /></tr> 160 * <tr><og:input name="file_01" value="{@file_01}" /></tr> 161 * <tr><og:input name="file_01_NEW" value="{@file_01_NEW}" /></tr> 162 * <tr><og:input name="file_01_ORG" value="{@file_01_ORG}" /></tr> 163 * <tr><og:input name="file_02" value="{@file_02}" /></tr> 164 * <tr><og:input name="file_02_NEW" value="{@file_02_NEW}" /></tr> 165 * <tr><og:input name="file_02_ORG" value="{@file_02_ORG}" /></tr> 166 * <tr><og:input name="file_03" value="{@file_03}" /></tr> 167 * <tr><og:input name="file_03_NEW" value="{@file_03_NEW}" /></tr> 168 * <tr><og:input name="file_03_ORG" value="{@file_03_ORG}" /></tr> 169 * </table> 170 * 171 * 【result.jsp】 172 * <og:upload 173 * fileURL = "{@USER.ID}" 174 * columns = "submitter,file" 175 * /> 176 * <br /> 177 * <og:message lbl="MSG0003" comment="ファイルの登録が完了しました。" /> 178 * 179 * <og:view 180 * command = "NEW" 181 * viewFormType = "HTMLTable" 182 * writable = "{@writable}" 183 * /> 184 * 185 * @og.group ファイル入力 186 * 187 * @version 4.0 188 * @author Kazuhiko Hasegawa 189 * @since JDK5.0, 190 */ 191public class FileUploadTag extends CommonTagSupport { 192 /** このプログラムのVERSION文字列を設定します。 {@value} */ 193 private static final String VERSION = "8.0.1.0 (2021/10/29)" ; 194 private static final long serialVersionUID = 801020211029L ; 195 196 /** 5.7.6.3 (2014/05/23) アップロードファイルのCSVセットのキー */ 197 public static final String UPLOAD_FILES = "UPLOAD_FILES" ; 198 199 // 3.5.2.0 (2003/10/20) カラム名に、ISFILEを追加。 200 private static final String[] NAMES = { "KEY","VALUE","ISFILE" }; // 6.4.1.1 (2016/01/16) names → NAMES refactoring 201 private static final String ENCODE = "UTF-8"; // 3.5.2.0 (2003/10/20) 廃止 202 private String fileURL = HybsSystem.sys( "FILE_URL" ); 203 private String filename ; // 3.5.4.2 (2003/12/15) 204 205 private int maxPostSize = 30*1024*1024; // 6.0.2.4 (2014/10/17) 最大ファイル容量 30MB 206 private String tableId = HybsSystem.TBL_MDL_KEY ; 207 208 // 5.6.5.2 (2013/06/21) DBTableModel作成時に、指定のカラムの"_01"~"_99"の添え字をレコードとして作成します。 209 private String columns ; 210 // 5.6.5.3 (2013/06/28) すでに同名のファイルが存在した場合に、バックアップ処理(renameTo)するかどうか[true/false]を指定します(初期値:false) 211 // 6.0.2.4 (2014/10/17) useBackup は、true/false/rename が指定可能 212 private String useBackup ; 213 private String storage ; // 5.10.9.0 (2019/03/01) ADD 214 private String bucket ; // 5.10.9.0 (2019/03/01) ADD 215 private boolean useLocal ; // 8.0.1.0 (2021/10/29) クラウド設定を使用しない場合は、true 216 217 /** 218 * デフォルトコンストラクター 219 * 220 * @og.rev 6.4.2.0 (2016/01/29) PMD refactoring. Each class should declare at least one constructor. 221 */ 222 public FileUploadTag() { super(); } // これも、自動的に呼ばれるが、空のメソッドを作成すると警告されるので、明示的にしておきます。 223 224 /** 225 * Taglibの終了タグが見つかったときに処理する doEndTag() を オーバーライドします。 226 * 227 * @og.rev 2.2.0.0 (2002/12/17) 中国語(国際化)対応 エンコードの取得方法変更 228 * @og.rev 3.1.1.2 (2003/04/04) Tomcat4.1 対応。release2() を doEndTag()で呼ぶ。 229 * @og.rev 3.1.3.0 (2003/04/10) UTF-8 決め打ちのエンコード情報を取得する。 230 * @og.rev 3.5.2.0 (2003/10/20) scope 属性を追加。 231 * @og.rev 3.5.4.2 (2003/12/15) ファイル名を指定できるようにします。 232 * @og.rev 3.6.0.8 (2004/11/19) DBTableModel をセーブする時に、トランザクションチェックを行います。 233 * @og.rev 3.7.1.1 (2005/05/23) フォルダがない場合は、複数階層分のフォルダを自動で作成します。 234 * @og.rev 3.8.1.3A (2006/01/30) 新ファイル名にオリジナルファイル名の拡張子をセットします 235 * @og.rev 5.3.7.0 (2011/07/01) エラーメッセージ内容変更 236 * @og.rev 5.6.5.2 (2013/06/21) columns 属性の追加 237 * @og.rev 5.6.5.3 (2013/06/28) useBackup 属性の追加 238 * @og.rev 5.8.8.0 (2015/06/05) エラー文の日本語化 239 * @og.rev 5.9.25.0 (2017/10/06) クラウドストレージの利用追加対応 240 * @og.rev 6.9.0.1 (2018/02/05) ファイルをセーブするディレクトリは、必要な場合のみ、作成します。 241 * 242 * @return 後続処理の指示 243 */ 244 @Override 245 public int doEndTag() { 246 debugPrint(); // 4.0.0 (2005/02/28) 247 startQueryTransaction( tableId ); // 3.6.0.8 (2004/11/19) 248 final HttpServletRequest request = (HttpServletRequest)getRequest(); 249 250 if( useLocal ) { // 8.0.1.0 (2021/10/29) クラウド設定を使用しない場合は、true 251 bucket = "LOCAL" ; 252 } 253 254 try { 255 final String directory = HybsSystem.url2dir( fileURL ); 256 // 6.9.0.1 (2018/02/05) ファイルをセーブするディレクトリは、必要な場合のみ、作成します。 257// final File dir = new File(directory); 258// if( ! dir.exists() && ! dir.mkdirs() ) { 259// // ERR0043:ディレクトリの作成に失敗しました。 260// final String errMsg = getResource().getLabel( "ERR0043" ) + "[" + directory + "]"; // 5.8.8.0 (2015/06/05) 261// throw new HybsSystemException( errMsg ); 262// } 263 264 // 3.8.1.3A (2006/01/30) 新ファイル名にオリジナルファイル名の拡張子をセットします 265 // 5.6.5.3 (2013/06/28) useBackup 属性の追加 266 // 5.9.25.0 (2017/10/06) fileURL 属性の追加 267 // 5.10.9.0 (2019/03/01) storage, bucket を追加。 268// final MultipartRequest multi = new MultipartRequest( request,directory,maxPostSize,ENCODE,filename,useBackup,fileURL ); 269 final MultipartRequest multi = new MultipartRequest( request,directory,maxPostSize,ENCODE,filename,useBackup,fileURL,storage,bucket ); 270// // 5.6.5.2 (2013/06/21) columns 属性の追加 271// DBTableModel table = null; 272// if( columns == null ) { // 5.6.5.2 (2013/06/21) columns 属性の追加 273// table = makeDBTable( multi ); 274// } 275// else { 276// table = makeDBTableFromClms( multi ); 277// } 278 279 // 6.9.0.1 (2018/02/05) ついでに修正 280 final DBTableModel table = columns == null ? makeDBTable( multi ) : makeDBTableFromClms( multi ); 281 282 // 3.5.2.0 (2003/10/20) scope 属性を追加。 283 // 3.6.0.8 (2004/11/19) トランザクションチェックを行います。 284 if( ! commitTableObject( tableId, table ) ) { 285 // ERR0041:検索処理中に割り込みの検索要求がありました。処理されません。 286 jspPrint( "FileUploadTag " + getResource().getLabel( "ERR0041" ) ); // 5.8.8.0 (2015/06/05) 287 return SKIP_PAGE; 288 } 289 } 290 // 6.9.0.1 (2018/02/05) セーブディレクトリ に関係するエラーを、IllegalArgumentException で返します。(無理から) 291 catch( final IllegalArgumentException ex ) { 292 // ERR0043:ディレクトリの作成に失敗しました。 293 final String errMsg = getResource().getLabel( "ERR0043" ) + "[" + fileURL + "]" // 5.8.8.0 (2015/06/05) 294 + CR + ex.getMessage() ; 295 throw new HybsSystemException( errMsg , ex ); 296 } 297 catch( final IOException ex ) { 298 // ERR0044:ファイル登録エラー! 299 final String errMsg = getResource().getLabel( "ERR0044" ) // 5.8.8.0 (2015/06/05) 300 + ex.getMessage() + CR // 5.3.7.0 (2011/07/01) errMsg 修正 301 + "(" + toString() + CR 302 + "FileURL=" + fileURL + ")"; 303 throw new HybsSystemException( errMsg , ex ); // 3.5.5.4 (2004/04/15) 引数の並び順変更 304 } 305 306 return EVAL_PAGE ; 307 } 308 309 /** 310 * タグリブオブジェクトをリリースします。 311 * キャッシュされて再利用されるので、フィールドの初期設定を行います。 312 * 313 * @og.rev 2.0.0.4 (2002/09/27) カスタムタグの release() メソッドを、追加 314 * @og.rev 3.0.1.1 (2003/03/06) columns を廃止 315 * @og.rev 3.1.1.2 (2003/04/04) Tomcat4.1 対応。release2() を doEndTag()で呼ぶ。 316 * @og.rev 3.5.4.2 (2003/12/15) ファイル名を指定できるようにします。 317 * @og.rev 5.6.5.2 (2013/06/21) columns 属性の追加 318 * @og.rev 5.6.5.2 (2013/06/21) useBackup 属性の追加 319 * @og.rev 6.0.2.4 (2014/10/17) useBackup 修正、最大ファイル容量 変更 320 * @og.rev 8.0.1.0 (2021/10/29) useLocal 属性を追加。 321 */ 322 @Override 323 protected void release2() { 324 super.release2(); 325 fileURL = HybsSystem.sys( "FILE_URL" ); 326 maxPostSize = 30*1024*1024; // 6.0.2.4 (2014/10/17) 最大ファイル容量 30MB 327 tableId = HybsSystem.TBL_MDL_KEY ; 328 filename = null; // 3.5.4.2 (2003/12/15) 329 columns = null; // 5.6.5.2 (2013/06/21) 330 useBackup = null; // 6.0.2.4 (2014/10/17) 331 storage = null; // 5.10.9.0 (2019/03/01) ADD 332 bucket = null; // 5.10.9.0 (2019/03/01) ADD 333 useLocal = false; // 8.0.1.0 (2021/10/29) クラウド設定を使用しない場合は、true 334 } 335 336 /** 337 * ファイルアップロードの実行結果を DBTableModel に記述します。 338 * 339 * ここでは、"KEY","VALUE","ISFILE" のカラムに対して、値を設定していきます。 340 * 同時に、RequestAttribute 変数に、これらの値をセットすることで、 341 * {@XXXX} で値が取り出せる様にしています。 342 * 343 * @og.rev 2.2.0.0 (2002/12/17) 中国語(国際化)対応 エンコードの取得方法変更 344 * @og.rev 3.0.1.1 (2003/03/06) request 情報から{@XXXX} で値が取り出せる様に修正。 345 * @og.rev 3.5.2.0 (2003/10/20) カラム名(KEY,VALUE)に ISFILE を追加 346 * @og.rev 3.5.6.5 (2004/08/09) MultipartRequest 変更に伴なう修正(Enum変更、元ファイル名取得) 347 * @og.rev 3.5.6.6 (2004/08/23) 上記変更時のバグ修正。 348 * @og.rev 3.5.6.6 (2004/08/23) 元ファイルのキーを、XXXX_ORG にします。 349 * @og.rev 4.0.0.0 (2007/10/12) テーブルモデルの登録方法を変更 350 * @og.rev 5.3.2.0 (2011/02/01) チェック行のパラメーターはint配列側に変換して復元する。パラメーター名を保存する。 351 * @og.rev 5.4.4.2 (2012/02/03) CommonTagSupportと同様のチェックボックス判定を行う 352 * @og.rev 5.7.1.1 (2013/12/13) HTML5 ファイルアップロードの複数選択(multiple)対応 353 * @og.rev 5.7.1.2 (2013/12/20) 5.7.1.2 (2013/12/20) zip対応で、UploadedFile のメソッド変更 354 * @og.rev 5.7.3.0 (2014/02/07) zip対応の修正で、取得ファイル名が異なっていた。 355 * @og.rev 5.7.6.3 (2014/05/23) アップロードファイルのCSVセット 356 * @og.rev 6.2.3.0 (2015/05/01) アップロードファイルを、UPLOAD_FILESキーに、Listオブジェクトに格納します。 357 * @og.rev 5.9.25.0 (2017/10/06) クラウド対応 358 * 359 * @param multi MultipartRequestオブジェクト 360 * 361 * @return テーブルモデル 362 */ 363 private DBTableModel makeDBTable( final MultipartRequest multi ) { 364 365 final DBTableModel table = DBTableModelUtil.newDBTable(); 366 367 table.init( NAMES.length ); 368 369 for( int i=0; i<NAMES.length; i++ ) { 370 final DBColumn dbColumn = getDBColumn( NAMES[i] ); 371 table.setDBColumn( i,dbColumn ); 372 } 373 374 String[] values ; // 4.0.0.0 (2007/10/12) 375 final List<String> prmNames = new ArrayList<>(); 376 377 // 5.7.1.1 (2013/12/13) HTML5 ファイルアップロードの複数選択(multiple)対応 378 // 6.2.3.0 (2015/05/01) アップロードファイルを、UPLOAD_FILESキーに、Listオブジェクトに格納します。 379 final List<String> list = new ArrayList<>(); 380 final UploadedFile[] files = multi.getUploadedFile(); 381 for( int i=0; i<files.length; i++ ) { 382 final String name = files[i].getName(); // multiple対応では、キーがかぶることがある。 383 String val = files[i].getUploadFile(); // 5.9.25.0 (2017/10/06) MODIFY getUploadFileで取得される値をFileからStringに変更対応 384 385 // 6.2.3.0 (2015/05/01) アップロードファイルを、UPLOAD_FILESキーに、Listオブジェクトに格納します。 386 list.add( val ); 387 388 // "KEY","VALUE","ISFILE" の順にデータを作成します。 389 values = new String[] { name, val, "1" }; 390 table.addColumnValues( values ); 391 setRequestAttribute( name,val ); 392 prmNames.add( name ); // 5.7.1.1 (2013/12/13) List に設定する。 393 394 final String orgName = name + "_ORG" ; 395 val = files[i].getOriginalFileName(); // 注意:取得は、送信名 396 397 // "KEY","VALUE","ISFILE" の順にデータを作成します。 398 values = new String[] { orgName, val, "2" }; 399 table.addColumnValues( values ); 400 setRequestAttribute( orgName,val ); 401 } 402 403 // 6.2.3.0 (2015/05/01) アップロードファイルを、UPLOAD_FILESキーに、Listオブジェクトに格納します。 404 setRequestAttribute( UPLOAD_FILES,list ); 405 406 // "KEY","VALUE","ISFILE" の順にデータを作成します。 407 values = new String[] { "directory", fileURL, "0" }; 408 table.addColumnValues( values ); 409 setRequestAttribute( "directory",fileURL ); 410 411 final String[] params = multi.getParameterNames(); 412 for( int i=0; i<params.length; i++ ) { 413 final String name = params[i]; 414 // 5.3.2.0 (2011/02/01) チェック行のパラメーターはint配列側に変換 415 if( HybsSystem.ROW_SEL_KEY.equals( name ) ) { 416 setRequestAttribute( name,multi.getIntParameters(name) ); 417 } 418 else { 419 // 5.6.5.2 (2013/06/21) チェックボックス配列の値取得を考慮した、MultipartRequest のパラメータ値取得 420 final String val = getParamVal( name,multi ); 421 422 values = new String[] { name, val, "0" }; 423 table.addColumnValues( values ); 424 setRequestAttribute( name,val ); 425 prmNames.add( name ); // 5.7.1.1 (2013/12/13) List に設定する。 426 } 427 } 428 429 // 5.3.2.0 (2011/02/01) パラメーター名を保存する。 430 // 5.7.1.1 (2013/12/13) List に設定する。 431 setParameterNames( prmNames.toArray( new String[prmNames.size()] ) ); 432 433 return table ; 434 } 435 436 /** 437 * ファイルアップロードの実行結果を 横持の DBTableModel に記述します。 438 * 439 * この処理は、columns 属性を設定した場合のみとします。 440 * 441 * DBTableModel作成時に、指定のカラムの"_01"~"_99"の添え字をレコードとして作成します。 442 * 現状は、"KEY","VALUE","ISFILE" のカラムに、データを縦持ちで作成しています。 443 * これを、横持で作成しますが、カラムの末尾に、"_01"~"_99" までの添え字を 444 * 持つ場合は、これをレコードと認識させます。 445 * 添え字がない場合は、カラムだけ作成されます。カラム名と同じリクエストがあれば、 446 * すべてのレコードに同じ値がセットされます。 447 * 448 * @og.rev 5.6.5.2 (2013/06/21) 新規作成 449 * @og.rev 5.6.6.1 (2013/07/12) 添え字がない場合の処理の見直し 450 * @og.rev 5.7.1.2 (2013/12/20) zip対応で、UploadedFile のメソッド変更 451 * @og.rev 5.7.3.0 (2014/02/07) zip対応の修正で、取得ファイル名が異なっていた。 452 * @og.rev 5.7.6.3 (2014/05/23) アップロードファイルのCSVセット 453 * @og.rev 6.0.2.4 (2014/10/17) _PFX , _SFX 対応 454 * @og.rev 6.2.3.0 (2015/05/01) アップロードファイルを、UPLOAD_FILESキーに、Listオブジェクトに格納します。 455 * @og.rev 5.9.25.0 (2017/10/06) クラウド対応 456 * 457 * @param multi MultipartRequestオブジェクト 458 * 459 * @return テーブルモデル 460 */ 461 private DBTableModel makeDBTableFromClms( final MultipartRequest multi ) { 462 463 final DBTableModel table = DBTableModelUtil.newDBTable(); 464 465 final String[] clmNames = columns.split( "," ); 466 467 table.init( clmNames.length ); 468 469 // 値配列(1行分) 470 String[] rowVal = new String[clmNames.length]; 471 472 // 5.7.1.1 (2013/12/13) HTML5 ファイルアップロードの複数選択(multiple)対応 473 final UploadedFile[] files = multi.getUploadedFile(); 474 475 final List<String> prmNames = new ArrayList<>(); 476 477 for( int i=0; i<clmNames.length; i++ ) { 478 final String clm = clmNames[i] ; 479 final DBColumn dbColumn = getDBColumn( clm ); 480 table.setDBColumn( i,dbColumn ); 481 482 // 先に、カラム名と一致するパラメータを初期値としてセットしておきます。 483 String val = getParamVal( clm,multi ); 484 485 // 5.6.6.1 (2013/07/12) ファイル名も同様に、あれば初期値セットしておきます。 486 if( val == null ) { 487 // 5.7.1.1 (2013/12/13) HTML5 ファイルアップロードの複数選択(multiple)対応 488 for( int j=0; j<files.length; j++ ) { 489 final String nm = files[j].getName(); 490 if( clm.equalsIgnoreCase( nm ) ) { 491 val = files[i].getUploadFile(); // 5.9.25.0 (2017/10/06) getUploadFileの型をFileからStringに変更対応 492 break; // 5.7.6.3 (2014/05/23) たぶん有ったほうが良い。 493 } 494 } 495 } 496 // 5.7.1.1 (2013/12/13) getFilesystemName() の中に、newFile が null の場合は、original を返す処理がある。 497 rowVal[i] = ( val == null ) ? "" : val ; 498 } 499 500 // 6.2.3.0 (2015/05/01) アップロードファイルを、UPLOAD_FILESキーに、Listオブジェクトに格納します。 501 final List<String> list = new ArrayList<>(); 502 503 for( int i=0; i<files.length; i++ ) { 504 final String name = files[i].getName(); 505 // 5.6.6.1 (2013/07/12) 添え字がない場合の処理の見直し。先にレコードを作成 506 String[] values = new String[clmNames.length]; 507 System.arraycopy( rowVal,0,values,0,values.length ); // 行にセットするに当たり、rowVal を values にコピーしておく。 508 509 // ファイル名を Attribute で使えるようにセットしておく。 510 final String fval = files[i].getUploadFile(); // 5.9.25.0 (2017/10/06) getUploadで取得される値をFileからStringに変更 511 setRequestAttribute( name,fval ); 512 prmNames.add( name ); // 5.7.1.1 (2013/12/13) List に設定する。 513 514 // 6.2.3.0 (2015/05/01) アップロードファイルを、UPLOAD_FILESキーに、Listオブジェクトに格納します。 515 list.add( fval ); 516 517 final String orgName = name + "_ORG" ; 518 final String oval = files[i].getOriginalFileName(); // 注意:取得は、送信名 519 setRequestAttribute( orgName,oval ); 520 521 // ファイルのキーを元に、添え字を検索します。 522 final int adrs = name.lastIndexOf( '_' ); // 添え字は、'_' で区切られます。 523 // 5.6.6.1 (2013/07/12) 添え字がない場合の処理の見直し。後続処理を行う。 524 if( adrs > 0 ) { 525 final String fnm = name.substring( 0,adrs ); // ファイル名(分割後) 526 final String sub = name.substring( adrs ); // 添え字(アンダーバー含む) 527 528 // カラム名で検索しながら、レコード単位になるようにセットしていきます。 529 for( int j=0; j<clmNames.length; j++ ) { 530 final String clm = clmNames[j] ; 531 String nm = null; 532 String val = null; 533 534 if( fnm.equalsIgnoreCase( clm ) ) { // ファイル名カラム(_NEWファイル名も、この値にすでに変わっている) 535 val = fval; 536 } 537 else if( ( fnm + "_ORG" ).equalsIgnoreCase( clm ) ) { // 元ファイル名カラム 538 val = oval; 539 } 540 else if( ( fnm + "_NEW" ).equalsIgnoreCase( clm ) ) { // 新ファイル名カラム 541 nm = name + "_NEW" ; 542 val = multi.getParameter( nm ); 543 } 544 // 6.0.2.4 (2014/10/17) _PFX , _SFX 対応 545 else if( ( fnm + "_PFX" ).equalsIgnoreCase( clm ) ) { // プレフィックスカラム 546 nm = name + "_PFX" ; 547 val = multi.getParameter( nm ); 548 } 549 else if( ( fnm + "_SFX" ).equalsIgnoreCase( clm ) ) { //サフィックスカラム 550 nm = name + "_SFX" ; 551 val = multi.getParameter( nm ); 552 } 553 else { 554 nm = clmNames[j] + sub; // sub は、アンダーバー含む添え字 555 // 5.6.5.2 (2013/06/21) チェックボックス配列の値取得を考慮した、MultipartRequest のパラメータ値取得 556 val = getParamVal( nm,multi ); 557 } 558 if( val != null ) { values[j] = val ; } // val が null でないときのみセットします。 559 } 560 } 561 table.addColumnValues( values ); 562 } 563 // 6.2.3.0 (2015/05/01) アップロードファイルを、UPLOAD_FILESキーに、Listオブジェクトに格納します。 564 setRequestAttribute( UPLOAD_FILES,list ); 565 566 // Attribute で使えるようにセットしておく。 567 setRequestAttribute( "directory",fileURL ); 568 569 // Attribute で使えるようにセットしておく。 570 final String[] params = multi.getParameterNames(); 571 for( int i=0; i<params.length; i++ ) { 572 final String name = params[i]; 573 // 5.3.2.0 (2011/02/01) チェック行のパラメーターはint配列側に変換 574 if( HybsSystem.ROW_SEL_KEY.equals( name ) ) { 575 setRequestAttribute( name,multi.getIntParameters(name) ); 576 } 577 else { 578 // 5.6.5.2 (2013/06/21) チェックボックス配列の値取得を考慮した、MultipartRequest のパラメータ値取得 579 final String val = getParamVal( name,multi ); 580 setRequestAttribute( name,val ); 581 prmNames.add( name ); // 5.7.1.1 (2013/12/13) List に設定する。 582 } 583 } 584 585 // 5.3.2.0 (2011/02/01) パラメーター名を保存する。 586 // 5.7.1.1 (2013/12/13) List に設定する。 587 setParameterNames( prmNames.toArray( new String[prmNames.size()] ) ); 588 589 return table ; 590 } 591 592 /** 593 * チェックボックス配列の値取得を考慮した、MultipartRequest のパラメータ値取得 594 * 595 * ここでは、、MultipartRequest のパラメータ値を取得します。 596 * 値の取得で、チェックボックス配列の場合は、取得した値が、"0" の場合のみ 597 * 配列でパラメータを取得し直し、"1" がないかどうか再度検索します。 598 * チェックボックスでは、チェック時の "1" と、チェックされなかった場合の、 599 * hidden の "0" の両方の値が配列としてリクエストされるケースがある為です。 600 * 601 * @og.rev 5.6.5.2 (2013/06/21) 新規作成 602 * @og.rev 6.3.9.1 (2015/11/27) MultipartRequest#getParameters(String)は、null ではなく長さが0の配列を返す。 603 * 604 * @param key MultipartRequestのパラメータ取得のためのキー 605 * @param multi MultipartRequestオブジェクト 606 * 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 * 844 * @param type 保存先ストレージタイプ 845 */ 846 public void setStorageType( final String type ) { 847 storage = nval( getRequestParameter(type), storage ); 848 } 849 850 /** 851 * 【TAG】保存先バケット名を設定します。 852 * 853 * @og.tag 854 * ファイルを読み取り元の、バケット名を指定します。 855 * クラウドストレージ利用時のみ有効です。 856 * 未設定の場合は、システムリソースの「CLOUD_BUCKET」が参照されます。 857 * 強制的に、ローカルファイルを指定する場合は、空文字列ではなく、"LOCAL" を指定します。 858 * 859 * @og.rev 5.10.9.0 (2019/03/01) 新規追加 860 * 861 * @param bkt 保存先バケット名 862 */ 863 public void setBucket( final String bkt ) { 864 bucket = nval( getRequestParameter(bkt), bucket ); 865 } 866 867 /** 868 * 【TAG】システム定数でクラウド設定されていても、クラウド環境を使用しない場合、trueを指定します(初期値:false)。 869 * 870 * @og.tag 871 * クラウド設定は、システム定数の『CLOUD_TARGET』と『CLOUD_BUCKET』の設定で自動的に使用しますが、 872 * どうしてもローカルでのみ使いたい場合は、この属性を true に設定します。 873 * 標準はfalse:設定どおりとなります。 874 * 875 * true/false以外を指定した場合はfalse扱いとします。 876 * 877 * @og.rev 8.0.1.0 (2021/10/29) useLocal 属性を追加。 878 * 879 * @param flag ローカル環境のみ [true:ローカルのみ/false:設定どおり] 880 */ 881 public void setUseLocal( final String flag ) { 882 useLocal = nval( getRequestParameter( flag ),useLocal ); 883 } 884 885 /** 886 * このオブジェクトの文字列表現を返します。 887 * 基本的にデバッグ目的に使用します。 888 * 889 * @return このクラスの文字列表現 890 * @og.rtnNotNull 891 */ 892 @Override 893 public String toString() { 894 return ToString.title( this.getClass().getName() ) 895 .println( "VERSION" ,VERSION ) 896 .println( "names" ,NAMES ) 897 .println( "ENCODE" ,ENCODE ) 898 .println( "fileURL" ,fileURL ) 899 .println( "filename" ,filename ) 900 .println( "maxPostSize" ,maxPostSize) 901 .println( "tableId" ,tableId ) 902 .println( "columns" ,columns ) // 5.6.5.2 (2013/06/21) 903 .println( "useBackup" ,useBackup ) // 5.6.5.3 (2013/06/28) 904 .println( "Other..." ,getAttributes().getAttribute() ) 905 .fixForm().toString() ; 906 } 907}