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