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     */
016    package org.opengion.hayabusa.taglib;
017    
018    import org.opengion.hayabusa.common.HybsSystem;
019    import org.opengion.hayabusa.common.HybsSystemException;
020    import org.opengion.hayabusa.db.DBTableModel;
021    import org.opengion.hayabusa.db.DBColumn;
022    import org.opengion.hayabusa.io.TableReader;
023    import org.opengion.fukurou.util.ErrorMessage;
024    import org.opengion.fukurou.util.FileUtil;
025    import org.opengion.fukurou.util.Closer ;
026    import org.opengion.fukurou.util.StringUtil ;
027    import static org.opengion.fukurou.util.StringUtil.nval ;
028    
029    import java.io.File;
030    import java.io.BufferedReader;
031    import java.util.Locale ;
032    import java.io.ObjectOutputStream;
033    import java.io.ObjectInputStream;
034    import java.io.IOException;
035    
036    /**
037     * æŒ?®šã?ファイルã‚?DBTableModelオブジェクトに読み取るファイル入力タグですã?
038     *
039     * ãƒ??タ(DBTableModel)と、コントローラ(ReadTableタグ)を与えて、外部からコントロールすることでã€?
040     * å�?¨®形式で ãƒ??タ(DBTableModel)を表示させることã�?できますã?
041     * ReadTableタグ に対して、コマンドを与えることにより、å?部のコントローラの実è£?�«対応しã�?
042     * 形式でãƒ??タを作æ?しますã?
043     * すべての読取ã?初期クラス名を リソースファイルの TABLE_READER_DEFAULT_CLASS でæŒ?®š可能ですã?
044     * そã?場合ã?AutoReader を指定すると、Excel と Default(ãƒ?‚­スãƒ? をé?番に試しますã?
045     *
046     * 入力件数ã‚?DB.COUNT" キーでリクエストにセãƒ?ƒˆしてã�?�¾すã?
047     *
048     * @og.formSample
049     * ●形式ï¼?
050     *     <og:readTable
051     *         command      = "NEW"
052     *         fileURL      = "{@USER.ID}"     読み取りå…?ƒ‡ィレクトリå�?
053     *         filename     = "{@filename}"    読み取りå…?ƒ•ァイルå�?
054     *         encode       = "UnicodeLittle"       読み取りå…?ƒ•ァイルエンコード名
055     *         maxRowCount  = "10000"               読取最大件数(0:[無制限])
056     *     />
057     * ●body?šなã�?
058     *
059     * ●Tag定義??
060     *   <og:readTable
061     *       readerClass        【TAG】実際に読み出すクラス名ã?略称(TableReader_**** の ****)をセãƒ?ƒˆしまã�?{@og.doc03Link readerClass 初期値:Default})
062     *       fileURL            【TAG】読み取りå…?ƒ‡ィレクトリ名をæŒ?®šしまã�?初期値:FILE_URL)
063     *       filename           【TAG】ファイルを作æ?するときã?ファイル名をセãƒ?ƒˆしまã�?(初期値:FILE_FILENAME[=file.xls])
064     *       encode             【TAG】ファイルを作æ?するときã?ファイルエンコーãƒ?‚£ング名をセãƒ?ƒˆしまã�?初期値:FILE_ENCODE)
065     *       maxRowCount        【TAG】読取時のæœ?¤§取り込み件数をセãƒ?ƒˆしまã�?(初期値:DB_MAX_ROW_COUNT[=1000])(0:[無制限])
066     *       separator          【TAG】可変長ファイルを作æ?するときã?é ?›®区åˆ?‚Šæ–?­—をセãƒ?ƒˆしまã�?
067     *       tableId            【TAGã€?通常使ã�?�¾せん)sessionからæ‰?¾—すã‚?DBTableModelオブジェクトã? ID
068     *       command            【TAG】コマンãƒ?NEW,RENEW)をセãƒ?ƒˆしまã�?初期値:NEW)
069     *       modifyType         【TAG】ファイル取り込み時ã? モãƒ?‚£ファイタイãƒ?A(追åŠ?,C(更新),D(削除))を指定しまã�?
070     *       displayMsg         【TAG】query の結果を画面上に表示するメãƒ?‚»ージIDを指定しまã�?初期値:MSG0033[ã€?»¶検索しました])
071     *       notfoundMsg        【TAG】検索結果がゼロ件の場合に表示するメãƒ?‚»ージリソースIDを指定しまã�?初期値:MSG0077[対象ãƒ??タはありませんでした])
072     *       sheetName          【TAG】EXCELファイルを読み込ã‚?�¨きã?シート名を設定しまã�?初期値:æŒ?®šなã�?
073     *       sheetNos           【TAG】EXCELファイルを読み込ã‚?�¨きã?シート番号をè¤?•°設定できまã�?初期値:0)
074     *       sheetConstKeys     【TAG】EXCELファイルを読み込ã‚?�¨きã?固定å?となるカラãƒ?��(CSV形å¼?
075     *       sheetConstAdrs     【TAG】EXCELファイルを読み込ã‚?�¨きã?固定å?となるアドレス(è¡?åˆ?è¡?åˆ?・・・)
076     *       nullBreakClm       【TAG】カラãƒ??に NULL が現れた時点で読み取りを中止しまã�?è¤?•°Sheetの場合ã?、次のSheetを読みまã�?ã€?
077     *       columns            【TAG】読み取りå…?ƒ•ァイルのカラãƒ??をã?外部(タグ)よりæŒ?®šしまã�?
078     *       useNumber          【TAG】行番号æƒ??をã?使用してã�?‚‹/してã�?�ªい[true/false]を指定しまã�?初期値:true)
079     *       adjustColumns      【TAG】読み取りå…?ƒ•ァイルのãƒ??タ変換を行うカラãƒ??をカンマ指定しまã�?
080     *       checkColumns       【TAG】読み取りå…?ƒ•ァイルの整合æ?チェãƒ?‚¯を行うカラãƒ??をカンマ指定しまã�?
081     *       nullCheck          【TAG】NULL チェãƒ?‚¯すべきカラãƒ??をカンマ区åˆ?‚Š(CVS形å¼?でæŒ?®šしまã�?
082     *       language           【TAG】タグå†?ƒ¨で使用するè¨?ªžコード[ja/en/zh/…]を指定しまã�?
083     *       stopZero           【TAG】読込件数が0件のときå?ç�?‚’続行するかどã�?�‹[true/false]を指定しまã�?初期値:false[続行する])
084     *       scope              【TAG】キャãƒ?‚·ュする場合ã?スコープ[request/page/session/applicaton]を指定しまã�?初期値:session)
085     *       mainTrans          【TAGã€?通常使ã�?�¾せん)タグで処ç�?�•れる処ç�?�Œメインとなるトランザクション処ç�?�‹どã�?�‹を指定しまã�?初期値:false)
086     *       skipRowCount       【TAGã€?通常は使ã�?�¾せん)ãƒ??タの読み飛ã?し件数を設定しまã�?
087     *       useRenderer        【TAG】読取å?ç�?�§ラベルをコードリソースにé€?¤‰換を行うかどã�?�‹を指定しまã�?(初期値:USE_TABLE_READER_RENDERER[=false])
088     *       caseKey            【TAG】このタグ自体を利用するかどã�?�‹の条件キーを指定しまã�?初期値:null) 5.7.7.2 (2014/06/20)
089     *       caseVal            【TAG】このタグ自体を利用するかどã�?�‹の条件値を指定しまã�?初期値:null) 5.7.7.2 (2014/06/20)
090     *       caseNN             【TAG】指定ã?値がã?null/ゼロæ–?­—å? でなã�??å�?Not Null=NN)は、このタグは使用されまã�?初期値:true) 5.7.7.2 (2014/06/20)
091     *       caseNull           【TAG】指定ã?値がã?null/ゼロæ–?­—å? の場合ã?、このタグは使用されまã�?初期値:true) 5.7.7.2 (2014/06/20)
092     *       debug              【TAG】デバッグæƒ??をå?力するかどã�?�‹[true/false]を指定しまã�?初期値:false)
093     *   />
094     *
095     * ●使用ä¾?
096     *
097     *     <og:readTable
098     *         command        = "NEW"
099     *         readerClass    = "Fixed"               固定長ãƒ??タの読み取り
100     *         modifyType     = "{@modifyType}"  読取時のモãƒ?‚£ファイタイãƒ?A,Cç­?
101     *         fileURL        = "{@USER.ID}"     読み取りå…?ƒ‡ィレクトリå�?
102     *         filename       = "{@filename}"    読み取りå…?ƒ•ァイルå�?
103     *         encode         = "Shift_JIS"           読み取りå…?ƒ•ァイルエンコード名
104     *         maxRowCount    = "10000"               読取最大件数(0:[無制限])
105     *         columns        = "OYA,KO,HJO,SU,DYSTR,DYEND"   #NAME に対応するカラãƒ??
106     *         useNumber      = "false"               行番号の存在しなã�?ƒ‡ータを読み取りますã?
107     *         adjustColumns  = "OYA,KO,HJO,SU"       ãƒ??タ変換するカラãƒ??("*" で全カラãƒ?
108     *         checkColumns   = "OYA,KO,HJO,SU"       整合æ?チェãƒ?‚¯するカラãƒ??("*" で全カラãƒ?
109     *         nullCheck      = "OYA,KO,SU"           NULLチェãƒ?‚¯を実行しまã�?"*" で全カラãƒ?
110     *         stopZero       = "true"                取å¾?件の場合に以降ã?処ç�?‚’停止しまã�?
111     *         skipRowCount   = "4"                   ãƒ??タの読み飛ã?し件数(読み込み開始ã?、この数字+1行目から)
112     *     />
113     *
114     * @og.group ファイル入åŠ?
115     *
116     * @version  4.0
117     * @author   Kazuhiko Hasegawa
118     * @since    JDK5.0,
119     */
120    public class ReadTableTag extends CommonTagSupport {
121            //* こã?プログラãƒ??VERSIONæ–?­—å?を設定しますã?       {@value} */
122            private static final String VERSION = "5.7.7.2 (2014/06/20)" ;
123    
124            private static final long serialVersionUID = 577220140620L ;
125    
126            private static final int ERROR_ROW_COUNT = 200 ;        // 4.0.0 (2007/05/25)
127    
128            /** command 引数に渡す事ã?出来ã‚?コマンãƒ? 新規作æ? {@value} */
129            public static final String CMD_NEW   = "NEW" ;
130            /** command 引数に渡す事ã?出来ã‚?コマンãƒ? 再検索 {@value} */
131            public static final String CMD_RENEW = "RENEW" ;
132    
133            private static final String[] COMMAND_LIST = new String[] { CMD_NEW , CMD_RENEW };
134    
135            private String  separator               = TableReader.TAB_SEPARATOR;     // é ?›®区åˆ?‚Šæ–?­?
136            private String  fileURL                 = HybsSystem.sys( "FILE_URL" );
137            private String  filename                = HybsSystem.sys( "FILE_FILENAME"               );       // ファイルå�?
138            private String  encode                  = HybsSystem.sys( "FILE_ENCODE"                 );       // ファイルエンコーãƒ?‚£ング  "JISAutoDetect" ,"JIS", "EUC_JP", "MS932", "SJIS" , "Windows-31J" , "Shift_JIS"
139            private String  readerClass     = HybsSystem.sys( "TABLE_READER_DEFAULT_CLASS" );               // 3.8.5.3 (2006/08/07)
140            private int             maxRowCount             = -1;
141            private String  displayMsg              = HybsSystem.sys( "VIEW_DISPLAY_MSG" );
142            private String  notfoundMsg             = "MSG0077";    // 対象ãƒ??タはありませんでしたã€?
143            private int     executeCount    = -1;                   // 検索/実行件数
144            private String  modifyType              = null;
145            private String adjustColumns    = null;         // 3.6.0.2 (2004/10/04) 取り込み時チェãƒ?‚¯
146            private String checkColumns             = null;         // 3.6.0.2 (2004/10/04) 取り込み時チェãƒ?‚¯
147            private String nullCheck                = null;         // 3.8.0.2 (2005/06/30) nullチェãƒ?‚¯確èª?
148    
149            private transient DBTableModel table      = null;
150            private String          command         = CMD_NEW;
151            private String          tableId         = HybsSystem.TBL_MDL_KEY ;
152            private String          sheetName       = null ;                // 3.5.4.2 (2003/12/15)
153            private String          sheetNos        = null ;                // 5.5.7.2 (2012/10/09) è¤?•°シートをæŒ?®šできるようにシート番号を指定できるようにするã€?
154            private String          sheetConstKeys  = null ;        // 5.5.8.2 (2012/11/09) 固定å?となるカラãƒ?��(CSV形å¼?
155            private String          sheetConstAdrs  = null ;        // 5.5.8.2 (2012/11/09) 固定å?となるアドレス(è¡?åˆ?è¡?åˆ?・・・)
156            private String          nullBreakClm    = null;         // 5.5.8.2 (2012/11/09) 取込み条件/Sheet BREAK条件
157    
158            // 3.5.4.5 (2004/01/23) 外部よりカラãƒ??(カンマ区åˆ?‚Š)を指定できるようにするã€?
159            private String          columns         = null;
160            private boolean         useNumber       = true;                 // 3.7.0.5 (2005/04/11)
161    
162            private boolean         stopZero        = false;                // 4.3.7.0 (2009/06/01) stopZero属æ?追åŠ?
163    
164            // 5.1.8.0 (2010/07/01) AutoReaderのCalc対å¿?
165            private static final String[] AUTO_READER_CLASS  = new String[] { "Excel","Calc","Default"      ,"Default"     };
166            private static final String[] AUTO_READER_ENCODE = new String[] { null   ,null  ,"UnicodeLittle","Windows-31J" };
167    
168            private boolean isMainTrans             = true;                 // 5.1.6.0 (2010/05/01) DBLastSqlの処ç�??見直ã�?
169            private int             skipRowCount    = 0;                    // 5.1.6.0 (2010/05/01) ãƒ??タの読み飛ã?し設å®?
170    
171            // 5.2.1.0 (2010/10/01) 読取å?ç�?�§コードリソースのラベル変換を行うかどã�?�‹
172            private boolean useRenderer             = HybsSystem.sysBool( "USE_TABLE_READER_RENDERER" );    // 5.2.1.0 (2010/10/01)
173    
174            /**
175             * Taglibの終äº?‚¿グが見つかったときに処ç�?�™ã‚?doEndTag() ã‚?オーバã?ライドしますã?
176             *
177             * @og.rev 3.0.1.4 (2003/03/17) displayMsg ã�??�Byteの場合ã?、件数も表示しなã�?‚ˆã�?�«変更ã€?
178             * @og.rev 3.1.1.2 (2003/04/04) Tomcat4.1 対応ã?release2() ã‚?doEndTag()で呼ぶã€?
179             * @og.rev 3.5.4.1 (2003/12/01) 引数の BufferedReader をã?InputStream に変更ã€?
180             * @og.rev 3.5.4.3 (2004/01/05) 引数の InputStream をã? BufferedReader に戻すã?
181             * @og.rev 3.5.6.5 (2004/08/09) 暫定的に、DBTableModelをå?行削除しますã?
182             * @og.rev 3.6.0.0 (2004/09/24) DBTableModel の先行削除は、scope="session" の場合ã?みã€?
183             * @og.rev 3.6.0.2 (2004/10/04) 取り込み時チェãƒ?‚¯用に、checkColumns,adjustColumns 属æ?追åŠ?
184             * @og.rev 3.6.0.8 (2004/11/19) DBTableModel をセーブする時に、トランザクションチェãƒ?‚¯を行いますã?
185             * @og.rev 3.8.5.3 (2006/08/07) readerClassã�?"Excel"でエラーが発生したときã?もうä¸?º¦Defaultで再読取を行いますã?
186             * @og.rev 4.0.0.0 (2007/10/12) checkTableColumn 前に、modifyType 設定を行いますã?
187             * @og.rev 4.0.0.0 (2007/10/18) メãƒ?‚»ージリソース統å�? getResource().getMessage â‡?getResource().getLabel )
188             * @og.rev 4.3.1.1 (2008/10/08) columnsが指定されてã�?‚‹場合ã?、AutoReader禁止
189             * @og.rev 4.3.7.0 (2009/06/01) stopZero機è?,DB.COUNTリクエストキーへ読込件数セãƒ?ƒˆを追åŠ?
190             * @og.rev 5.1.6.0 (2010/05/01) DBLastSqlの処ç�??、DBTableModelが新規作æ?されたå?ç�?�§のみ行うã€?
191             * @og.rev 5.1.8.0 (2010/07/01) AutoReaderのCalc対å¿?
192             * @og.rev 5.1.9.0 (2010/08/01) AutoReaderでのExceptionの判定をThrowableに変更
193             * @og.rev 5.7.1.2 (2013/12/20) tempMsg.toString() â‡?errMsg 変更
194             * @og.rev 5.7.7.2 (2014/06/20) caseKey,caseVal,caseNN,caseNull 属æ?を追åŠ?
195             *
196             * @return      後続å?ç�??æŒ?¤º
197             */
198            @Override
199            public int doEndTag() {
200                    debugPrint();           // 4.0.0 (2005/02/28)
201                    // 5.7.7.2 (2014/06/20) caseKey,caseVal,caseNN,caseNull 属æ?を追åŠ?
202                    if( !useTag() ) { return EVAL_PAGE ; }
203    
204                    if( check( command, COMMAND_LIST ) ) {
205                            useMainTrans( isMainTrans );                    // 5.1.6.0 (2010/05/01) DBLastSqlの処ç�??見直ã�?
206                            startQueryTransaction( tableId );               // 3.6.0.8 (2004/11/19)
207    
208                            // 3.5.6.5 (2004/08/09) 削除するのは、セãƒ?‚·ョンのオブジェクトでよいã€?
209                            // 3.6.0.0 (2004/09/24) 削除するのは、scope="session" の場合ã?みã€?
210                            if( "session".equals( getScope() ) ) {
211                                    removeSessionAttribute( tableId );
212                                    removeSessionAttribute( HybsSystem.VIEWFORM_KEY );
213                            }
214    
215                            if( maxRowCount < 0 ) {
216                                    maxRowCount     = sysInt( "DB_MAX_ROW_COUNT" );
217                            }
218    
219                            // ファイル の読み込み?šAutoReader 処ç�?
220                            BufferedReader pw = null;
221                            final String[] READER_CLASS  ;
222                            final String[] READER_ENCODE ;
223                            if( "AutoReader".equalsIgnoreCase( readerClass ) ) {
224                                    // 4.3.1.1 (2008/10/08)
225                                    if( columns != null && columns.length() > 0 ) {
226                                            String errMsg = "columnsが指定されてã�?‚‹場合ã?、readerClass=\"AutoReader\"は使えません";
227                                            throw new HybsSystemException( errMsg ); // 4.3.4.4 (2009/01/01)
228                                    }
229                                    READER_CLASS  = AUTO_READER_CLASS ;
230                                    READER_ENCODE = AUTO_READER_ENCODE;
231                            }
232                            else {
233                                    READER_CLASS  = new String[] { readerClass };
234                                    READER_ENCODE = new String[] { encode };
235                            }
236    
237                            StringBuilder tempMsg = new StringBuilder();
238                            for( int i=0; i<READER_CLASS.length; i++ ) {
239                                    readerClass = READER_CLASS[i];
240                                    encode      = READER_ENCODE[i];
241    
242                                    try {
243                                            // 5.1.8.0 (2010/07/01) AutoReaderのCalc対å¿?
244                                            if( "Excel".equalsIgnoreCase( readerClass ) || "Calc".equalsIgnoreCase( readerClass ) ) {
245                                                    create( null );
246                                            }
247                                            else {
248                                                    pw = getBufferedReader();
249                                                    create( pw );
250                                            }
251                                            // 成功すれば、エラーメãƒ?‚»ージをクリアして、その場で抜けるã?
252                                            tempMsg = null;
253                                            break;
254                                    }
255                                    // 3.8.5.3 (2006/08/07) readerClassã�?"Excel"でエラーが発生したときã?もうä¸?º¦Defaultで再読取を行いますã?
256                                    // 5.1.9.0 (2010/08/01) RuntimeException系のExceptionがキャãƒ?ƒ�できなã�?�Ÿめã?Throwableで受けã‚?
257                                    catch( Throwable th ) {
258                                            tempMsg.append( "readerClass=["  ).append( readerClass )
259                                                            .append( "],encode=["    ).append( encode )
260                                                            .append( "] Error!"      ).append( HybsSystem.CR )
261                                                            .append( th.getMessage() ).append( HybsSystem.CR ) ;
262                                    }
263                                    finally {
264                                            Closer.ioClose( pw );           // 4.0.0 (2006/01/31) close 処ç�?™‚の IOException を無è¦?
265                                    }
266                            }
267    
268                            if( tempMsg != null ) { // æœ?¾Œまでエラーがあれã?、例外å?ç�?‚’発行しますã?
269                                    String errMsg = tempMsg.toString();
270                                    System.err.print( errMsg );
271                                    throw new HybsSystemException( errMsg );                // 5.7.1.2 (2013/12/20) msg â‡?errMsg 変更
272                            }
273    
274                            if( table != null ) {
275                                    // 3.6.0.2 (2004/10/04)
276                                    // 4.0.0.0 (2007/10/12) checkTableColumn 前に、modifyType 設定を行いますã?
277                                    executeCount = table.getRowCount();
278                                    if( modifyType != null ) {
279                                            for( int row=0; row<executeCount; row++ ) {
280                                                    table.setModifyType( row,modifyType );
281                                            }
282                                    }
283    
284                                    ErrorMessage errMsg = checkTableColumn( table );
285                                    if( errMsg != null && ! errMsg.isOK()) {
286                                            jspPrint( TaglibUtil.makeHTMLErrorTable( errMsg,getResource() ) );
287                                            return SKIP_PAGE ;
288                                    }
289    
290                            }
291                            // 3.6.0.8 (2004/11/19) トランザクションチェãƒ?‚¯を行いますã?
292                            if( ! commitTableObject( tableId, table ) ) {
293                                    jspPrint( "ReadTableTag Query処ç�?�Œ割り込まれましたã€?BTableModel は登録しませんã€? );
294                                    return SKIP_PAGE ;
295                            }
296    
297                            StringBuilder buf = new StringBuilder( HybsSystem.BUFFER_SMALL );
298    
299                            // 実行件数の表示 command="NEW" のときã?み、displayMsg を表示させますã?
300                            // 4.0.0 (2005/11/30) 出力é?の変更。ä¸?•ªæœ??に出力しますã?
301                            if( CMD_NEW.equals( command ) ) {
302                                    if( executeCount > 0 && displayMsg != null && displayMsg.length() > 0 ) {
303                                            buf.append( executeCount );
304                                            buf.append( getResource().getLabel( displayMsg ) );
305                                            buf.append( HybsSystem.BR );
306                                    }
307                                    else if( executeCount == 0 && notfoundMsg != null && notfoundMsg.length() > 0 ) {
308                                            buf.append( getResource().getLabel( notfoundMsg ) );
309                                            buf.append( HybsSystem.BR );
310                                    }
311                            }
312    
313                            // 4.3.7.0 (2009/06/01) 読込件数をã?"DB.COUNT" キーでリクエストにセãƒ?ƒˆするã€?
314                            setRequestAttribute( "DB.COUNT"   , String.valueOf( executeCount ) );
315    
316                            jspPrint( buf.toString() );
317                    }
318    
319                    // 4.3.7.0 (2009/06/01) stopZero機è?を追åŠ?
320                    final int rtnCode ;
321                    if( executeCount == 0 && stopZero )     {
322                            rtnCode = SKIP_PAGE;
323                    }
324                    else {
325                            rtnCode = EVAL_PAGE;
326                    }
327    
328                    return rtnCode ;
329            }
330    
331            /**
332             * タグリブオブジェクトをリリースしますã?
333             * キャãƒ?‚·ュされて再利用されるã?で、フィールドã?初期設定を行いますã?
334             *
335             * @og.rev 2.0.0.4 (2002/09/27) カスタãƒ?‚¿グの release() メソãƒ?ƒ‰をã?追åŠ?
336             * @og.rev 3.1.1.2 (2003/04/04) Tomcat4.1 対応ã?release2() ã‚?doEndTag()で呼ぶã€?
337             * @og.rev 3.1.3.0 (2003/04/10) FILE_ENCODE から、エンコード情報を取得するã?
338             * @og.rev 3.1.4.0 (2003/04/18) command 属æ?に、å?期å?(NEW)を設定するã?
339             * @og.rev 3.5.4.2 (2003/12/15) EXCELのシート名を指定できるように変更ã€?
340             * @og.rev 3.5.4.5 (2004/01/23) 外部よりカラãƒ??(カンマ区åˆ?‚Š)を指定できるようにするã€?
341             * @og.rev 3.6.0.2 (2004/10/04) checkColumns,adjustColumns,allColumnCheck 属æ?追åŠ?
342             * @og.rev 3.7.0.5 (2005/04/11) useNumber 属æ?を追åŠ?�—ますã?
343             * @og.rev 3.8.0.2 (2005/06/30) nullCheck 属æ?追åŠ?
344             * @og.rev 3.8.5.3 (2006/08/07) readerClass 属æ?の初期値をシスãƒ?ƒ リソースより取得しますã?
345             * @og.rev 4.3.7.0 (2009/06/01) stopZero属æ?追åŠ?
346             * @og.rev 5.1.6.0 (2010/05/01) DBLastSqlの処ç�??、DBTableModelが新規作æ?されたå?ç�?�§のみ行うã€?
347             * @og.rev 5.1.6.0 (2010/05/01) ãƒ??タの読み飛ã?し設å®?skipRowCount 属æ?追åŠ?
348             * @og.rev 5.2.1.0 (2010/10/01) 読取å?ç�?�§コードリソースのラベル変換を行うかどã�?�‹ useRenderer 属æ?追åŠ?
349             * @og.rev 5.5.7.2 (2012/10/09) è¤?•°シートをæŒ?®šできるようにシート番号を指定できるように、sheetNos属æ?追åŠ?
350             * @og.rev 5.5.8.2 (2012/11/09) 固定å?となるカラãƒ?��、アドレスのæŒ?®šã?ための、sheetConstKeys、sheetConstAdrs属æ?追åŠ?
351             * @og.rev 5.5.8.2 (2012/11/09) カラãƒ??に NULL が現れた時点で読み取りを中止する、nullBreakClm属æ?追åŠ?
352             */
353            @Override
354            protected void release2() {
355                    super.release2();
356                    separator               = TableReader.TAB_SEPARATOR;   // é ?›®区åˆ?‚Šæ–?­?
357                    fileURL                 = HybsSystem.sys( "FILE_URL" );
358                    filename                = HybsSystem.sys( "FILE_FILENAME" );   // ファイルå�?
359                    encode                  = HybsSystem.sys( "FILE_ENCODE"   );   // ファイルエンコーãƒ?‚£ング  "JISAutoDetect" ,"JIS", "EUC_JP", "MS932", "SJIS" , "Windows-31J" , "Shift_JIS"
360                    readerClass             = HybsSystem.sys( "TABLE_READER_DEFAULT_CLASS" );               // 3.8.5.3 (2006/08/07)
361                    maxRowCount             = -1;
362                    displayMsg              = HybsSystem.sys( "VIEW_DISPLAY_MSG" );
363                    notfoundMsg             = "MSG0077";    // 対象ãƒ??タはありませんでしたã€?
364                    executeCount    = -1;                   // 検索/実行件数
365                    modifyType              = null;
366                    command                 = CMD_NEW;
367                    table                   = null;
368                    tableId                 = HybsSystem.TBL_MDL_KEY ;
369                    sheetName               = null;         // 3.5.4.2 (2003/12/15)
370                    sheetNos                = null ;        // 5.5.7.2 (2012/10/09) è¤?•°シートをæŒ?®šできるようにシート番号を指定できるようにするã€?
371                    sheetConstKeys  = null ;        // 5.5.8.2 (2012/11/09) 固定å?となるカラãƒ?��(CSV形å¼?
372                    sheetConstAdrs  = null ;        // 5.5.8.2 (2012/11/09) 固定å?となるアドレス(è¡?åˆ?è¡?åˆ?・・・)
373                    nullBreakClm    = null;         // 5.5.8.2 (2012/11/09) 取込み条件/Sheet BREAK条件
374                    columns                 = null;         // 3.5.4.5 (2004/01/23)
375                    useNumber               = true;         // 3.7.0.5 (2005/04/11)
376                    adjustColumns   = null;         // 3.6.0.2 (2004/10/04) 取り込み時チェãƒ?‚¯
377                    checkColumns    = null;         // 3.6.0.2 (2004/10/04) 取り込み時チェãƒ?‚¯
378                    nullCheck               = null;         // 3.8.0.2 (2005/06/30)
379                    stopZero                = false;        // 4.3.7.0 (2009/06/01) soptZero追åŠ?
380                    isMainTrans             = true;         // 5.1.6.0 (2010/05/01) DBLastSqlの処ç�??見直ã�?
381                    skipRowCount    = 0;            // 5.1.6.0 (2010/05/01) ãƒ??タの読み飛ã?し設å®?
382                    useRenderer             = HybsSystem.sysBool( "USE_TABLE_READER_RENDERER" );    // 5.2.1.0 (2010/10/01)
383            }
384    
385            /**
386             * TableReader の実オブジェクトを生æ?して?ŒBufferedReader に書き込みますã?
387             *
388             * @og.rev 3.5.4.1 (2003/12/01) 引数の BufferedReader をã?InputStream に変更ã€?
389             * @og.rev 3.5.4.2 (2003/12/15) TableReader のサブクラス名変更ã€?
390             * @og.rev 3.5.4.2 (2003/12/15) EXCELのシート名を指定できるように変更ã€?
391             * @og.rev 3.5.4.3 (2004/01/05) 引数の InputStream をã? BufferedReader に戻すã?
392             * @og.rev 3.5.4.5 (2004/01/23) TableReader に、encode を渡すよã�?�«変更ã€?
393             * @og.rev 3.5.6.0 (2004/06/18) å�?¨®プラグイン関連付け設定を、シスãƒ?ƒ パラメータ に記述しますã?
394             * @og.rev 3.7.0.5 (2005/04/11) useNumber 属æ?を追åŠ?�—ますã?
395             * @og.rev 4.0.0.0 (2005/01/31) キーのæŒ?®šを、TableReader. から、TableReader_ に変更しますã?
396             * @og.rev 4.0.0.0 (2005/01/31) lang â‡?ResourceManager へ変更
397             * @og.rev 5.1.6.0 (2010/05/01) ãƒ??タの読み飛ã?し設å®?skipRowCount 属æ?追åŠ?
398             * @og.rev 5.2.1.0 (2010/10/01) 読取å?ç�?�§コードリソースのラベル変換を行うかどã�?�‹設å®?useRenderer 属æ?追åŠ?
399             * @og.rev 5.5.7.2 (2012/10/09) è¤?•°シートをæŒ?®šできるようにシート番号を指定できるように、sheetNos属æ?追åŠ?
400             * @og.rev 5.5.8.2 (2012/11/09) 固定å?となるカラãƒ?��、アドレスのæŒ?®šã?ための、sheetConstKeys、sheetConstAdrs属æ?追åŠ?
401             * @og.rev 5.5.8.2 (2012/11/09) カラãƒ??に NULL が現れた時点で読み取りを中止する、nullBreakClm属æ?追åŠ?
402             *
403             * @param       out     出力するBufferedReaderオブジェクãƒ?
404             */
405            protected void create( final BufferedReader out )  {
406    
407                    String className = HybsSystem.sys( "TableReader_" + readerClass ) ;             // 4.0.0 (2005/01/31)
408                    TableReader reader = (TableReader)HybsSystem.newInstance( className );  // 3.5.5.3 (2004/04/09)
409    
410                    reader.setResourceManager( getResource() );     // 4.0.0 (2005/01/31)
411                    reader.setSeparator( separator );
412                    reader.setEncode( encode );                                             // 3.5.4.5 (2004/01/23)
413                    reader.setColumns( columns );                                   // 3.5.4.5 (2004/01/23)
414                    reader.setUseNumber( useNumber );                               // 3.7.0.5 (2005/04/11)
415                    reader.setMaxRowCount( maxRowCount );
416                    reader.setSkipRowCount( skipRowCount );                 // 5.1.6.0 (2010/05/01)
417                    reader.setUseRenderer( useRenderer );                   // 5.2.1.0 (2010/10/01)
418                    reader.setDebug( isDebug() );                                   // 5.5.7.2 (2012/10/09) ãƒ?ƒ�ãƒ?‚°æƒ??をå?力するかどã�?�‹を指å®?
419                    if( reader.isExcel() ) {                                                // 3.5.4.3 (2004/01/05)
420                            reader.setFilename( HybsSystem.url2dir( StringUtil.urlAppend( fileURL,filename )));
421                            reader.setSheetName( sheetName );                       // 3.5.4.2 (2003/12/15)
422                            reader.setSheetNos( sheetNos );                         // 5.5.7.2 (2012/10/09) è¤?•°シートをæŒ?®šできるようにシート番号を指定できるようにするã€?
423                            reader.setSheetConstData( sheetConstKeys,sheetConstAdrs ) ;             // 5.5.8.2 (2012/11/09) 固定å?となるカラãƒ?��、アドレスのæŒ?®?
424                            reader.setNullBreakClm( nullBreakClm ) ;        // 5.5.8.2 (2012/11/09) 取込み条件/Sheet BREAK条件
425                            reader.readDBTable();
426                    }
427                    else {
428                            reader.readDBTable( out );
429                    }
430                    table = reader.getDBTableModel();
431            }
432    
433            /**
434             * BufferedReader を取得しますã?
435             *
436             * ここでは、ä¸?ˆ¬çš?�ªファイル出力をè€??した BufferedReader を作æ?しますã?
437             *
438             * @og.rev 2.2.0.0 (2002/12/17) 中国èª?国際化)対å¿?エンコードã?取得方法変更
439             * @og.rev 3.1.3.0 (2003/04/10) FILE_ENCODE から、エンコード情報を取得するã?
440             * @og.rev 3.5.4.1 (2003/12/01) 引数の BufferedReader をã?InputStream に変更ã€?
441             * @og.rev 3.5.4.3 (2004/01/05) 引数の InputStream をã? BufferedReader に戻すã?
442             * @og.rev 3.5.5.9 (2004/06/07) FileUtil.getBufferedReader を使用
443             *
444             * @return      ファイル読取BufferedReaderオブジェクãƒ?
445             */
446            private BufferedReader getBufferedReader() {
447                    if( filename == null ) {
448                            String errMsg = "ファイル名がセãƒ?ƒˆされてã�?�¾せんã€?;
449                            throw new HybsSystemException( errMsg );
450                    }
451                    String directory = HybsSystem.url2dir( fileURL );
452                    File file = new File( StringUtil.urlAppend( directory,filename ) );
453    
454                    BufferedReader out = FileUtil.getBufferedReader( file,encode );
455    
456                    return out ;
457            }
458    
459            /**
460             * カラãƒ?–‡字å?(CSV形å¼?から、カラãƒ?•ª号配å?を作æ?しますã?
461             * 簡易メソãƒ?ƒ‰ですã?
462             * 引数がã?"*" の場合ã?、å?カラãƒ?‚’æŒ?®šしたことになりますã?
463             * null の場合ã?、サイズã�???の配å?を返しますã?
464             *
465             * @og.rev 4.0.0.0 (2007/05/25) 新規作æ?
466             *
467             * @param       clms    カラãƒ?–‡字å?(CSV形å¼?
468             * @param       table   DBTableModelオブジェクãƒ?
469             *
470             * @return      カラãƒ?•ª号配å?(無ã�??合ã?ã€?•·さ0ã?配å?)
471             */
472            private int[] makeClmNos( final String clms,final DBTableModel table ) {
473                    final int[] clmNo;
474    
475                    if( clms == null ) {
476                            clmNo = new int[0];
477                    }
478                    else if( "*".equals( clms ) ) {
479                            int size = table.getColumnCount();
480                            clmNo = new int[size];
481                            for( int i=0; i<size; i++ ) {
482                                    clmNo[i] = i;
483                            }
484                    }
485                    else {
486                            String[] clmStr = StringUtil.csv2Array( clms );
487                            int size = clmStr.length;
488                            clmNo = new int[size];
489                            for( int i=0; i<size; i++ ) {
490                                    clmNo[i] = table.getColumnNo( clmStr[i] );
491                            }
492                    }
493    
494                    return clmNo;
495            }
496    
497            /**
498             * checkColumns にæŒ?®šされたカラãƒ?‚’チェãƒ?‚¯しますã?
499             * カラãƒ?‚ªブジェクトã?DBType属æ?に対応したチェãƒ?‚¯を行いますã?
500             * チェãƒ?‚¯結果で、エラーが発生したå?合ã?、ErrorMessage オブジェクトを
501             * 返しますã?
502             * DBColumn#valueCheck( String ) の結果のErrorMessageをすべて append
503             * してã�?��ますã?
504             * useAdjust==true で、かつ、エラーがなã�??合ã?、adjustColumns 処ç�?µ�果ã‚?
505             * DBTableModel に反映させますã?
506             * debug=true で、エラー時ã?詳細なãƒ??タをå?力しますã?
507             *
508             * @og.rev 3.6.0.2 (2004/10/04) 新規作æ?
509             * @og.rev 3.8.0.2 (2005/06/30) nullチェãƒ?‚¯確èª?
510             * @og.rev 4.0.0.0 (2007/05/25) 処ç�??序書き換ã�?
511             *
512             * @param       table   DBTableModelオブジェクãƒ?
513             *
514             * @return      カラãƒ?‚­ー ??値 のエラーメãƒ?‚»ージオブジェクãƒ?
515             */
516            private ErrorMessage checkTableColumn( final DBTableModel table ) {
517                    ErrorMessage errMsg = new ErrorMessage( "Check Columns Error!" );
518    
519                    int rowCnt = table.getRowCount();
520                    int[] adjClmNo = makeClmNos( adjustColumns,table );
521                    int[] chkClmNo = makeClmNos( checkColumns,table );
522                    int[] nllclmNo = makeClmNos( nullCheck,table );
523    
524                    boolean useAdjust = adjClmNo.length > 0 ;
525    
526                    for( int row=0; row<rowCnt; row++ ) {
527                            String[]   vals   = table.getValues( row );
528                            DBColumn[] dbClms = table.getDBColumns();
529                            boolean isError = false;                                                // 5.5.7.2 (2012/10/09) エラー時ã?フラグ。ループでクリアするã€?
530    
531                            // adjustColumns 処ç�?
532                            for( int i=0; i<adjClmNo.length; i++ ) {
533                                    int no = adjClmNo[i];
534                                    vals[no] = dbClms[no].valueSet( vals[no] );
535                            }
536    
537                            // checkColumns 処ç�?
538                            for( int i=0; i<chkClmNo.length; i++ ) {
539                                    int no = chkClmNo[i];
540                                    ErrorMessage msg = dbClms[no].valueCheck( vals[no] );
541                                    if( msg.getKekka() > ErrorMessage.OK ) {
542                                            isError = true;
543                                            errMsg.append( row+1,dbClms[no].valueCheck( vals[no] ) );
544                                    }
545                            }
546    
547                            // nullCheck 処ç�?
548                            for( int i=0; i<nllclmNo.length; i++ ) {
549                                    int no = nllclmNo[i];
550                                    if( vals[no] == null || vals[no].length() == 0 ) {
551                                            isError = true;
552                                            String label = dbClms[no].getLabel();
553                                            // ERR0012 : æŒ?®šã?ãƒ??タがセãƒ?ƒˆされてã�?�¾せんã€?NULLエラー)。key={0}
554                                            errMsg.addMessage( row+1,ErrorMessage.NG,"ERR0012",label );
555                                    }
556                            }
557    
558                            // 5.5.7.2 (2012/10/09) エラー時ã?ãƒ?ƒ�ãƒ?‚°出åŠ?
559                            if( isDebug() && isError ) {
560                                    errMsg.addMessage( row+1,ErrorMessage.OK,"Debug Info",java.util.Arrays.toString(table.getValues(row) ) );
561                            }
562    
563                            // adjustColumns 処ç�?µ�果を反æ˜?�•せますã?
564                            if( useAdjust && !isError ) { table.setValues( vals,row ); }
565                            if( errMsg.size() > ERROR_ROW_COUNT ) { break; }
566                    }
567    
568                    return errMsg;
569            }
570    
571            /**
572             * 【TAGã€?通常は使ã�?�¾せん)結果のDBTableModelをã?sessionに登録するときã?キーを指定しまã�?
573             *              (初期値:HybsSystem#TBL_MDL_KEY[={@og.value org.opengion.hayabusa.common.HybsSystem#TBL_MDL_KEY}])ã€?
574             *
575             * @og.tag
576             * 検索結果より、DBTableModelオブジェクトを作æ?しますã?これをã?下流ã?viewタグ等に
577             * 渡すå?合にã€??常は、session を利用しますã?そã?場合ã?登録キーですã?
578             * query タグを同時に実行して、結果を求めるå?合ã?同ä¸?ƒ¡モリに配置される為ã€?
579             * こã? tableId 属æ?を利用して、メモリ空間をåˆ?�‘ますã?
580             *              (初期値:HybsSystem#TBL_MDL_KEY[={@og.value org.opengion.hayabusa.common.HybsSystem#TBL_MDL_KEY}])ã€?
581             *
582             * @param       id sessionに登録する時ã? ID
583             */
584            public void setTableId( final String id ) {
585                    tableId = nval( getRequestParameter( id ), tableId );
586            }
587    
588            /**
589             * 【TAG】可変長ファイルを作æ?するときã?é ?›®区åˆ?‚Šæ–?­—をセãƒ?ƒˆしますã?
590             *
591             * @og.tag 可変長ファイルを作æ?するときã?é ?›®区åˆ?‚Šæ–?­—をセãƒ?ƒˆしますã?
592             *
593             * @param   separator é ?›®区åˆ?‚Šæ–?­?
594             */
595            public void setSeparator( final String separator ) {
596                    this.separator = nval( getRequestParameter( separator ),this.separator );
597            }
598    
599            /**
600             * 【TAG】読み取りå…?ƒ‡ィレクトリ名をæŒ?®šしまã�?
601             *              (初期値:FILE_URL[={@og.value org.opengion.hayabusa.common.SystemData#FILE_URL}])ã€?
602             *
603             * @og.tag
604             * こã?属æ?でæŒ?®šされるãƒ?‚£レクトリより、ファイルを読み取りますã?
605             * æŒ?®š方法ã?ã€??常の fileURL 属æ?と同様に、å?頭がã?'/' (UNIX) またã?ã€?¼’文字目がã?
606             * ":" (Windows)の場合ã?、指定ã?URLそã?ままのãƒ?‚£レクトリに、そã�?�§なã�??合ã?ã€?
607             * fileURL = "{&#064;USER.ID}" とæŒ?®šすると、FILE_URL 属æ?でæŒ?®šã?フォルãƒ??下にã€?
608             * さらに、各個人ID別のフォルãƒ?‚’作æ?して、そこを操作しますã?
609             * (初期値:シスãƒ?ƒ 定数のFILE_URL[={@og.value org.opengion.hayabusa.common.SystemData#FILE_URL}])ã€?
610             *
611             * @og.rev 4.0.0.0 (2005/01/31) StringUtil.urlAppend メソãƒ?ƒ‰の利用
612             * @og.rev 4.0.0.0 (2007/11/20) æŒ?®šされたãƒ?‚£レクトリ名ã?æœ?¾Œが"\"or"/"で終わってã�?�ªã�??合にã€?/"を付加するã€?
613             *
614             * @param       url 読み取りå…?ƒ‡ィレクトリå�?
615             * @see         org.opengion.hayabusa.common.SystemData#FILE_URL
616             */
617            public void setFileURL( final String url ) {
618                    String furl = nval( getRequestParameter( url ),null );
619                    if( furl != null ) {
620                            char ch = furl.charAt( furl.length()-1 );
621                            if( ch != '/' && ch != '\\' ) { furl = furl + "/"; }
622                            fileURL = StringUtil.urlAppend( fileURL,furl );
623                    }
624            }
625    
626            /**
627             * 【TAG】ファイルを作æ?するときã?ファイル名をセãƒ?ƒˆしまã�?
628             *              (初期値:FILE_FILENAME[={@og.value org.opengion.hayabusa.common.SystemData#FILE_FILENAME}])ã€?
629             *
630             * @og.tag ファイルを作æ?するときã?ファイル名をセãƒ?ƒˆしますã?
631             * (初期値:シスãƒ?ƒ 定数のFILE_FILENAME[={@og.value org.opengion.hayabusa.common.SystemData#FILE_FILENAME}])ã€?
632             *
633             * @param   filename ファイルå�?
634             * @see         org.opengion.hayabusa.common.SystemData#USE_SQL_INJECTION_CHECK
635             */
636            public void setFilename( final String filename ) {
637                    this.filename = nval( getRequestParameter( filename ),this.filename );
638            }
639    
640            /**
641             * 【TAG】ファイルを作æ?するときã?ファイルエンコーãƒ?‚£ング名をセãƒ?ƒˆしまã�?
642             *              (初期値:FILE_ENCODE[={@og.value org.opengion.hayabusa.common.SystemData#FILE_ENCODE}])ã€?
643             *
644             * @og.tag
645             * Shift_JIS,MS932,Windows-31J,UTF-8,ISO-8859-1,UnicodeLittle
646             * (初期値:シスãƒ?ƒ 定数のFILE_ENCODE[={@og.value org.opengion.hayabusa.common.SystemData#FILE_ENCODE}])ã€?
647             *
648             * @og.rev 2.2.0.0 (2002/12/17) 中国èª?国際化)対å¿?エンコードã?取得方法変更
649             * @og.rev 3.1.3.0 (2003/04/10) FILE_ENCODE から、エンコード情報を取得するã?
650             *
651             * @param   enc ファイルエンコーãƒ?‚£ングå�?
652             * @see     <a href="http://www.iana.org/assignments/character-sets">IANA Charset Registry</a>
653             * @see         org.opengion.hayabusa.common.SystemData#FILE_ENCODE
654             */
655            public void setEncode( final String enc ) {
656                    encode = nval( getRequestParameter( enc ),encode );
657            }
658    
659            /**
660             * 【TAG】実際に読み出すクラス名ã?略称(TableReader_**** の ****)をセãƒ?ƒˆしまã�?{@og.doc03Link readerClass 初期値:Default})ã€?
661             *
662             * @og.tag
663             * 実際に読み出すクラスå�?の略称)をセãƒ?ƒˆしますã?
664             * これは、org.opengion.hayabusa.io 以下ã? TableReader_**** クラスの **** ã‚?
665             * 与えますã?これらã?、TableReader インターフェースを継承したサブクラスですã?
666             * 属æ?クラス定義の {@link org.opengion.hayabusa.io.TableReader TableReader} を参照願いますã?
667             * {@og.doc03Link readerClass TableReader_**** クラス}
668             *
669             * @param   readerClass クラスå�?の略称)
670             * @see         org.opengion.hayabusa.io.TableReader  TableReaderのサブクラス
671             */
672            public void setReaderClass( final String readerClass ) {
673                    this.readerClass = nval( getRequestParameter( readerClass ),this.readerClass );
674            }
675    
676            /**
677             * 【TAG】読取時のæœ?¤§取り込み件数をセãƒ?ƒˆしまã�?
678             *              (初期値:DB_MAX_ROW_COUNT[={@og.value org.opengion.hayabusa.common.SystemData#DB_MAX_ROW_COUNT}])ã€?
679             *
680             * @og.tag
681             * DBTableModelのãƒ??タとして登録するæœ?¤§件数をこの値に設定しますã?
682             * サーバã?のメモリè³?º�と応答時間ã?確保ã?為ですã?
683             * 0 をセãƒ?ƒˆすると、無制é™?Integer.MAX_VALUE)になりますã?
684             * (初期値:ユーザー定数のDB_MAX_ROW_COUNT[={@og.value org.opengion.hayabusa.common.SystemData#DB_MAX_ROW_COUNT}])ã€?
685             *
686             * @og.rev 5.5.8.5 (2012/11/27) 0を無制限として処ç�?�—ますã?
687             *
688             * @param   count 読取時のæœ?¤§取り込み件数
689             * @see         org.opengion.hayabusa.common.SystemData#DB_MAX_ROW_COUNT
690             */
691            public void setMaxRowCount( final String count ) {
692                    maxRowCount = nval( getRequestParameter( count ),maxRowCount );
693                    if( maxRowCount == 0 ) { maxRowCount = Integer.MAX_VALUE ; }            // 5.5.8.5 (2012/11/27)
694            }
695    
696            /**
697             * 【TAG】コマンãƒ?NEW,RENEW)をセãƒ?ƒˆしまã�?初期値:NEW)ã€?
698             *
699             * @og.tag
700             * コマンドã?,HTMLから(get/post)æŒ?®šされますã?で,CMD_xxx で設定される
701             * フィールド定数値のã�?�¥れかをã?æŒ?®šできますã?
702             * 何も設定されなã�??またã?、null の場合ã?ã€?NEW" がå?期å?にセãƒ?ƒˆされますã?
703             *
704             * @param       cmd コマンãƒ?public static final 宣è¨?�•れてã�?‚‹æ–?­—å?)
705             * @see         <a href="../../../../constant-values.html#org.opengion.hayabusa.taglib.ReadTableTag.CMD_NEW">コマンド定数</a>
706             */
707            public void setCommand( final String cmd ) {
708                    String cmd2 = getRequestParameter( cmd );
709                    if( cmd2 != null && cmd2.length() > 0 ) { command = cmd2.toUpperCase(Locale.JAPAN); }
710            }
711    
712            /**
713             * 【TAG】query の結果を画面上に表示するメãƒ?‚»ージIDを指定しまã�?初期値:MSG0033[ã€?»¶検索しました])ã€?
714             *
715             * @og.tag
716             * ここでは、検索結果の件数ã‚?™»録された件数をまずå?力しã€?
717             * そã?次に、ここでæŒ?®šしたメãƒ?‚»ージをリソースから取得して
718             * 表示しますã?
719             * 表示させたくなã�??合ã?, displayMsg = "" をセãƒ?ƒˆしてくださいã€?
720             * 初期値は、検索件数を表示しますã?
721             *
722             * @param   id ãƒ?‚£スプレイに表示させるメãƒ?‚»ージ ID
723             */
724            public void setDisplayMsg( final String id ) {
725                    if( id != null ) { displayMsg = id; }
726            }
727    
728            /**
729             * 【TAG】検索結果がゼロ件の場合に表示するメãƒ?‚»ージリソースIDを指定しまã�?初期値:MSG0077[対象ãƒ??タはありませんでした])ã€?
730             *
731             * @og.tag
732             * ここでは、検索結果がゼロ件の場合ã?み、特別なメãƒ?‚»ージを表示させますã?
733             * 従来は、displayMsg と兼用で、ã?0ã€?»¶検索しました』とã�?�†表示でしたがã?
734             * displayMsg の初期表示は、OFF になりましたので、ゼロ件の場合ã?み別に表示させますã?
735             * 表示させたくなã�??合ã?, notfoundMsg = "" をセãƒ?ƒˆしてくださいã€?
736             * 初期値は、MSG0077[対象ãƒ??タはありませんでした]ですã?
737             *
738             * @param       id ãƒ?‚£スプレイに表示させるメãƒ?‚»ージ ID
739             */
740            public void setNotfoundMsg( final String id ) {
741                    String ids = getRequestParameter( id );
742                    if( ids != null ) { notfoundMsg = ids; }
743            }
744    
745            /**
746             * 【TAG】ファイル取り込み時ã? モãƒ?‚£ファイタイãƒ?A(追åŠ?,C(更新),D(削除))を指定しますã?
747             *
748             * @og.tag
749             * ファイル読み込み時に、そのãƒ??タをA(追åŠ?、C(更新)、D(削除)の
750             * モãƒ?‚£ファイタイプをつけた状態にしますã?
751             * そã?状態で、そのまま、update する事が可能になりますã?
752             *
753             * @param   type ファイル取り込み時ã? モãƒ?‚£ファイタイãƒ?A,C,D属æ?)
754             */
755            public void setModifyType( final String type ) {
756                    modifyType = getRequestParameter( type );
757            }
758    
759            /**
760             * 【TAG】EXCELファイルを読み込ã‚?�¨きã?シート名を設定しまã�?初期値:æŒ?®šなã�?ã€?
761             *
762             * @og.tag
763             * EXCELファイルを読み込ã‚?™‚に、シート名を指定しますã?これにより、è¤?•°の形式ã?
764             * 異なるデータをé?次読み込ã‚?�“とã‚??シートをæŒ?®šして読み取ることが可能になりますã?
765             * sheetNos と sheetName が同時にæŒ?®šされた場合ã?、sheetNos が優先されますã?エラーにはならなã�??でご注意くã�?�•ã�??
766             * 初期値は、指定なしですã?
767             *
768             * @og.rev 3.5.4.2 (2003/12/15) 新規追åŠ?
769             *
770             * @param   sheet EXCELファイルのシート名
771             * @see         #setSheetNos( String ) 
772             */
773            public void setSheetName( final String sheet ) {
774                    sheetName = nval( getRequestParameter( sheet ),sheetName );
775            }
776    
777            /**
778             * 【TAG】EXCELファイルを読み込ã‚?�¨きã?シート番号を指定しまã�?初期値:0)ã€?
779             *
780             * @og.tag
781             * EXCEL読み込み時にè¤?•°シートをマã?ジして取り込みますã?
782             * シート番号はã€? から始まる数字で表しますã?
783             * ヘッãƒ??は、最初ã?シートã?カラãƒ?½�置に合わせますã??ˆã?ãƒ?ƒ€ータイトルの自動認識ã?ありません。ï¼?
784             * よって、指定するシートã?、すべて同ä¸?ƒ¬イアウトでなã�?�¨取り込み時にカラãƒ??ずれが発生しますã?
785             * 
786             * シート番号のæŒ?®šã?、カンマ区åˆ?‚Šで、è¤?•°æŒ?®šできますã?またã?N-M の様にハイフンで繋げることでã€?
787             * N 番から、M 番のシートç¯?›²をä¸?‹¬æŒ?®š可能ですã?またã?"*" による、å?シート指定が可能ですã?
788             * これらã?çµ?�¿合わせも可能ですã???0,1,3,5-8,10-* ??
789             * ただしã?"*" に関しては例外的に、ä¸?–‡字だけで、すべてのシートを表すか、N-* を最後にæŒ?®šするかの
790             * どちらかですã?途中にはã€?*" は、現れませんã€?
791             * シート番号はã€?‡�è¤?1,1,2,2)ã€??転(3,2,1) でのæŒ?®šが可能ですã?これは、そのæŒ?®šé?で、読み込まれますã?
792             * sheetNos と sheetName が同時にæŒ?®šされた場合ã?、sheetNos が優先されますã?エラーにはならなã�??でご注意くã�?�•ã�??
793             * 
794             * 初期値はã€??ˆ第ä¸?‚·ートï¼?ですã?
795             *
796             * @og.rev 5.5.7.2 (2012/10/09) 新規追åŠ?
797             *
798             * @param   sheet EXCELファイルのシート番号??から始まるï¼?
799             * @see         #setSheetName( String ) 
800             */
801            public void setSheetNos( final String sheet ) {
802                    sheetNos = nval( getRequestParameter( sheet ),sheetNos );
803                    if( sheetNos != null && sheetNos.length() > 0 ) {
804                            boolean errFlag = false;
805                            for( int i=0; i<sheetNos.length(); i++ ) {
806                                    char ch = sheetNos.charAt(i);
807                                    if( ch == '-' || ch == ',' ) { continue; }
808                                    if( ch == '*' && ( i==0 || i==sheetNos.length()-1 ) ) { continue; }
809                                    if( ch < '0' || ch > '9' ) { errFlag = true; break; }
810                            }
811                            if( errFlag ) {
812                                    String errMsg = "sheetNos のæŒ?®šを見直してください。sheetNos=[" + sheetNos + "]";
813                                    throw new HybsSystemException( errMsg );
814                            }
815                    }
816            }
817    
818            /**
819             * 【TAG】EXCELファイルを読み込ã‚?�¨きã?シート単位ã?固定å?を設定するためã?カラãƒ?��を指定しますã?
820             *
821             * @og.tag
822             * カラãƒ?��は、カンマ区åˆ?‚ŠでæŒ?®šしますã?
823             * これにより、シートã?ä¸?�‹æ‰?�«書かれてã�?‚‹æƒ??をã?DBTableModel のカラãƒ?�«固定å?として
824             * 設定することができますã?
825             * 例として、DB定義書で、テーブル名をシートã?全レコードに設定したい場合などに使ã�?�¾すã?
826             * こã?メソãƒ?ƒ‰は、isExcel() == true の場合ã?み利用されますã?
827             *
828             * @og.rev 5.5.8.2 (2012/11/09) 新規追åŠ?
829             *
830             * @param   constKeys 固定å?となるカラãƒ?��(CSV形å¼?
831             * @see         #setSheetConstAdrs( String ) 
832             */
833            public void setSheetConstKeys( final String constKeys ) {
834                    sheetConstKeys = nval( getRequestParameter( constKeys ),null );
835            }
836    
837            /**
838             * 【TAG】EXCELファイルを読み込ã‚?�¨きã?シート単位ã?固定å?を設定するためã?カラãƒ?��に対応するアドレスを指定しますã?
839             *
840             * @og.tag
841             * アドレスは、EXCEL上ã?è¡?列をカンマ区åˆ?‚ŠでæŒ?®šしますã?
842             * 行å?は、EXCELオブジェクトに準拠するためã€?¼�から始まる整数ですã?
843             * 0-0 â‡?A1 , 1-0 â‡?A2 , 0-1 â‡?B1 になりますã?
844             * これにより、シートã?ä¸?�‹æ‰?�«書かれてã�?‚‹æƒ??をã?DBTableModel のカラãƒ?�«固定å?として
845             * 設定することができますã?
846             * 例として、DB定義書で、テーブル名をシートã?全レコードに設定したい場合などに使ã�?�¾すã?
847             * こã?メソãƒ?ƒ‰は、isExcel() == true の場合ã?み利用されますã?
848             *
849             * 5.7.6.3 (2014/05/23) よりã€?
850             *   â‘?XCEL表記に準拠した、A1,A2,B1 の記述もå?ç�?�§きるように対応しますã?
851             *     なおã?A1,A2,B1 の記述は、å¿?�š、英å­?æ–?­—+数å­?にしてくださいã€?A?žZまで)
852             *   ②処ç�?¸­のEXCELシート名をカラãƒ?�«割り当てるためにã€?SHEET" とã�?�†記号に対応しますã?
853             * 例えば、sheetConstKeys="CLM,LANG,NAME" としã?sheetConstAdrs="0-0,A2,SHEET" とするとã€?
854             * NAMEカラãƒ?�«は、シート名を読み込ã‚?�“とができますã?
855             * これは、å?部処ç�??簡ç´?Œ–のためですã?
856             *
857             * ちなみに、EXCELのセルに、シート名を表示させるå?合ã?関数は、下記ã?様になりますã?
858             * =RIGHT(CELL("filename",$A$1),LEN(CELL("filename",$A$1))-FIND("]",CELL("filename",$A$1)))
859             *
860             * @og.rev 5.5.8.2 (2012/11/09) 新規追åŠ?
861             *
862             * @param   constAdrs 固定å?となるアドレス(è¡?åˆ?è¡?åˆ?・・・)
863             * @see         #setSheetConstKeys( String ) 
864             */
865            public void setSheetConstAdrs( final String constAdrs ) {
866                    sheetConstAdrs = nval( getRequestParameter( constAdrs ),null );
867            }
868    
869            /**
870             * 【TAG】ここにæŒ?®šされたカラãƒ??に NULL が現れた時点で読み取りを中止しますã?
871             *
872             * @og.tag
873             * これは、指定ã?カラãƒ??å¿??とã�?�†事を条件に、そのレコードだけを読み取る処ç�?‚’行いますã?
874             * è¤?•°Sheetの場合ã?、次のSheetを読みますã?
875             * 現時点では、Excel の場合ã?み有効ですã?
876             *
877             * @og.rev 5.5.8.2 (2012/11/09) 新規追åŠ?
878             *
879             * @param   clm カラãƒ??
880             */
881            public void setNullBreakClm( final String clm ) {
882                    nullBreakClm = nval( getRequestParameter( clm ),null );
883            }
884    
885            /**
886             * 【TAG】読み取りå…?ƒ•ァイルのカラãƒ??をã?外部(タグ)よりæŒ?®šしますã?
887             *
888             * @og.tag
889             * 読み取りå…?ƒ•ァイルのカラãƒ??をã?外部(タグ)よりæŒ?®šしますã?
890             * ファイルに記述されã�?#NAME より優先して使用されますã?
891             * これは、å?ファイルのカラãƒ?‚’é ?•ªにæŒ?®šã?カラãƒ?��に割り当てる機è?で
892             * ファイルの特定ã?カラãƒ??を抜きå?して取り込ã‚?©Ÿè?ではありませんã€?
893             *
894             * @og.rev 3.5.4.5 (2004/01/23) 新規作æ?
895             *
896             * @param   clms 読み取りå…?ƒ•ァイルのカラãƒ??(カンマ区åˆ?‚Šæ–?­?
897             */
898            public void setColumns( final String clms ) {
899                    columns = nval( getRequestParameter( clms ),columns );
900            }
901    
902            /**
903             * 【TAG】読み取りå…?ƒ•ァイルの整合æ?チェãƒ?‚¯を行うカラãƒ??をカンマ指定しますã?
904             *
905             * @og.tag
906             * カラãƒ?‚ªブジェクトã?DBType属æ?に対応したチェãƒ?‚¯を行いますã?
907             * æŒ?®šã?カラãƒ?��をカンマ区åˆ?‚Š(CSV)でè¤?•°æŒ?®šできますã?
908             * 全てのカラãƒ??チェãƒ?‚¯を行う場合ã?、allColumnCheck = "true" ã‚?
909             * æŒ?®šして下さã�??
910             * åˆ?§£方法ã?ã€??常のパラメータ取得後に、CSVåˆ?§£しますã?
911             *
912             * @og.rev 3.6.0.2 (2004/10/04) 新規追åŠ?取り込み時チェãƒ?‚¯用
913             * @og.rev 3.8.8.5 (2007/03/09) 通常のパラメータ取得後に、CSVåˆ?§£に戻しますã?
914             *
915             * @param   clms 整合æ?チェãƒ?‚¯を行うカラãƒ??(カンマ区åˆ?‚Šæ–?­?
916             */
917            public void setCheckColumns( final String clms ) {
918                    checkColumns = nval( getRequestParameter( clms ),checkColumns );
919            }
920    
921            /**
922             * 【TAG】読み取りå…?ƒ•ァイルのãƒ??タ変換を行うカラãƒ??をカンマ指定しますã?
923             *
924             * @og.tag
925             * カラãƒ?‚ªブジェクトã?DBType属æ?に対応したデータ変換を行いますã?
926             * æŒ?®šã?カラãƒ?��をカンマ区åˆ?‚Š(CSV)でè¤?•°æŒ?®šできますã?
927             * åˆ?§£方法ã?ã€??常のパラメータ取得後に、CSVåˆ?§£しますã?
928             *
929             * @og.rev 3.6.0.2 (2004/10/04) 新規追åŠ?取り込み時データ変換
930             * @og.rev 3.8.8.5 (2007/03/09) 通常のパラメータ取得後に、CSVåˆ?§£に戻しますã?
931             *
932             * @param   clms ãƒ??タ変換を行うカラãƒ??(カンマ区åˆ?‚Šæ–?­?
933             */
934            public void setAdjustColumns( final String clms ) {
935                    adjustColumns = nval( getRequestParameter( clms ),adjustColumns );
936            }
937    
938            /**
939             * 【TAG】NULL チェãƒ?‚¯すべきカラãƒ??をカンマ区åˆ?‚Š(CVS形å¼?でæŒ?®šしますã?
940             *
941             * @og.tag nullCheck="AAA,BBB,CCC,DDD"
942             * åˆ?§£方法ã?ã€??常のパラメータ取得後に、CSVåˆ?§£しますã?
943             *
944             * @og.rev 3.8.0.2 (2005/06/30) 新規追åŠ?
945             * @og.rev 3.8.8.5 (2007/03/09) 通常のパラメータ取得後に、CSVåˆ?§£に戻しますã?
946             *
947             * @param   clms カラãƒ??(CVS形å¼?
948             */
949            public void setNullCheck( final String clms ) {
950                    nullCheck = nval( getRequestParameter( clms ),nullCheck );
951            }
952    
953            /**
954             * 【TAG】行番号æƒ??をã?使用してã�?‚‹/してã�?�ªい[true/false]を指定しまã�?初期値:true)ã€?
955             *
956             * @og.tag
957             * 通常のフォーマットでは、各行ã?先é?に行番号がå?力されてã�?�¾すã?
958             * 読み取り時にã€?NAME 属æ?を使用する場合ã?、この行番号を無視してã�?�¾すã?
959             * #NAME 属æ?を使用せず、columns 属æ?でカラãƒ?��を指定するå?å�?他シスãƒ?ƒ の
960             * 出力ファイルを読み取るケースç­?では、行番号も存在しなã�?‚±ースがありã?
961             * そã?様な場合に、useNumber="false" を指定すれã?、データのæœ??から読み取り始めますã?
962             * こã?場合ã?出力データのカラãƒ??並びé ?�Œ変更されたå?合ã?columns 属æ?ã‚?
963             * æŒ?®šしなおすå¿?¦�がありますã?で、できるã�?�‘ã€?NAME 属æ?を使用するように
964             * してくださいã€?
965             * なおã?EXCEL 入力には、この設定ã?適用されませんã€?暫定対å¿?
966             * 初期値は、true(使用する) ですã?
967             *
968             * @og.rev 3.7.0.5 (2005/04/11) 新規追åŠ?
969             *
970             * @param   useNo 行番号æƒ?? [true:使用する/false:使用しない]
971             */
972            public void setUseNumber( final String useNo ) {
973                    useNumber = nval( getRequestParameter( useNo ),useNumber );
974            }
975    
976            /**
977             * 【TAG】読込件数が0件のときå?ç�?‚’続行するかどã�?�‹[true/false]を指定しまã�?初期値:false[続行する])ã€?
978             *
979             * @og.tag
980             * 初期値は、false(続行すã‚?ですã?
981             *
982             * @og.rev 4.3.7.0 (2009/06/01) 新規追åŠ?
983             *
984             * @param  cmd 読込件数が0件のときã?処ç�?‚’ [true:中止する/false:続行する]
985             */
986            public void setStopZero( final String cmd ) {
987                    stopZero = nval( getRequestParameter( cmd ), stopZero );
988            }
989    
990            /**
991             * 【TAGã€?通常使ã�?�¾せん)タグで処ç�?�•れる処ç�?�Œメインとなるトランザクション処ç�?�‹どã�?�‹を指定しまã�?初期値:false)ã€?
992             *
993             * @og.tag
994             * こã?値は、ファイルãƒ?‚¦ンロードå?ç�?�«影響しますã?こã?値がtrueにæŒ?®šされた時にcommitされたDBTableModelã�?
995             * ファイルãƒ?‚¦ンロードã?対象の表になりますã?
996             *
997             * こã?パラメーターはã€??常、各タグにより実è£?�•れã?ユーザーが指定するå¿?¦�ã?ありませんã€?
998             * ä½?�—ã€?つのJSPå†?�§DBTableModelがè¤?•°生æ?されるå?合に、前に処ç�?�—たDBTableModelにつã�?�¦ファイルãƒ?‚¦ンロードをさせたい
999             * 場合ã?、後ろでDBTableModelを生成するタグで、æ?示çš?�«こã?値をfalseにæŒ?®šすることで、ファイルãƒ?‚¦ンロードå?ç�??対象から
1000             * 除外することができますã?
1001             *
1002             * @og.rev 5.1.6.0 (2010/05/01) 新規作æ?
1003             *
1004             * @param  flag メイントランザクションかどã�?�‹
1005             */
1006            public void setMainTrans( final String flag ) {
1007                    isMainTrans = nval( getRequestParameter( flag ),isMainTrans );
1008            }
1009    
1010            /**
1011             * 【TAGã€?通常は使ã�?�¾せん)ãƒ??タの読み飛ã?し件数を設定しますã?
1012             *
1013             * @og.tag
1014             * TAB区åˆ?‚Šãƒ?‚­ストやEXCEL等ã?ãƒ??タの読み始めの初期値を指定しますã?
1015             * ファイルの先é?行がã€?¼�行としてカウントしますã?で、設定å?は、読み飛ã?ã�?
1016             * 件数になりますã?(?‘とæŒ?®šするとã€?¼‘件読み飛ã?しã??’行目から読み込みますã?)
1017             * 読み飛ã?しã?、コメント行などは、無視しますã?で、実際の行数åˆ?ª­み飛ã?しますã?
1018             * ?ƒNAME属æ?ã‚??columns 属æ?は、有効ですã?
1019             *
1020             * @og.rev 5.1.6.0 (2010/05/01) 新規作æ?
1021             *
1022             * @param       count 読み始めの初期値
1023             */
1024            public void setSkipRowCount( final String count ) {
1025                    skipRowCount = nval( getRequestParameter( count ),skipRowCount );
1026            }
1027    
1028            /**
1029             * 【TAG】読取å?ç�?�§ラベルをコードリソースにé€?¤‰換を行うかどã�?�‹を指定しまã�?
1030             *              (初期値:USE_TABLE_READER_RENDERER[={@og.value org.opengion.hayabusa.common.SystemData#USE_TABLE_READER_RENDERER}])ã€?
1031             *
1032             * @og.tag
1033             * TableWriter_Renderer 系のクラスで出力したå?合ã?、コードリソースがラベルで出力されますã?
1034             * そã?ファイルを読み取ると、当然、エラーになりますã?
1035             * ここでは、コードリソースのカラãƒ?�«対して、ラベルからコードを求めるé?変換を行うことでã€?
1036             * Renderer 系で出力したファイルを取り込ã‚?�“とができるようにしますã?
1037             *
1038             * ここでは、TableWriter 系と同様に、TableReader_Renderer 系のクラスを作るのではなくã?
1039             * 属æ?値のフラグで、制御しますã?
1040             * å°?�¥çš?�«は、TableWriter 系もå»?­¢して、同様ã?フラグで制御するように変更する予定ですã?
1041             * (初期値:シスãƒ?ƒ 定数のUSE_TABLE_READER_RENDERER[={@og.value org.opengion.hayabusa.common.SystemData#USE_TABLE_READER_RENDERER}])ã€?
1042             *
1043             * @og.rev 5.2.1.0 (2010/10/01) 新規作æ?
1044             *
1045             * @param  flag コードリソースのラベルé€?¤‰換を行うかどã�?�‹
1046             * @see         org.opengion.hayabusa.common.SystemData#USE_TABLE_READER_RENDERER
1047             */
1048            public void setUseRenderer( final String flag ) {
1049                    useRenderer = nval( getRequestParameter( flag ),useRenderer );
1050            }
1051    
1052            /**
1053             * シリアライズ用のカスタãƒ?‚·リアライズ書き込みメソãƒ?ƒ‰
1054             *
1055             * @og.rev 4.0.0.0 (2006/09/31) 新規追åŠ?
1056             * @serialData ä¸?ƒ¨のオブジェクトã?、シリアライズされませんã€?
1057             *
1058             * @param       strm    ObjectOutputStreamオブジェクãƒ?
1059             * @throws IOException  入出力エラーが発生したå?å�?
1060             */
1061            private void writeObject( final ObjectOutputStream strm ) throws IOException {
1062                    strm.defaultWriteObject();
1063            }
1064    
1065            /**
1066             * シリアライズ用のカスタãƒ?‚·リアライズ読み込みメソãƒ?ƒ‰
1067             *
1068             * ここでは、transient 宣è¨?�•れたå†?ƒ¨変数のå†??初期化がå¿?¦�なフィールドã?み設定しますã?
1069             *
1070             * @og.rev 4.0.0.0 (2006/09/31) 新規追åŠ?
1071             * @serialData ä¸?ƒ¨のオブジェクトã?、シリアライズされませんã€?
1072             *
1073             * @param       strm    ObjectInputStreamオブジェクãƒ?
1074             * @see #release2()
1075             * @throws IOException  シリアライズに関する入出力エラーが発生したå?å�?
1076             * @throws ClassNotFoundException       クラスを見つけることができなかったå?å�?
1077             */
1078            private void readObject( final ObjectInputStream strm ) throws IOException , ClassNotFoundException {
1079                    strm.defaultReadObject();
1080            }
1081    
1082            /**
1083             * こã?オブジェクトã?æ–?­—å?表現を返しますã?
1084             * 基本çš?�«ãƒ?ƒ�ãƒ?‚°目çš?�«使用しますã?
1085             *
1086             * @return こã?クラスのæ–?­—å?表現
1087             */
1088            @Override
1089            public String toString() {
1090                    return org.opengion.fukurou.util.ToString.title( this.getClass().getName() )
1091                                    .println( "VERSION"                     ,VERSION        )
1092                                    .println( "separator"           ,separator              )
1093                                    .println( "fileURL"             ,fileURL                )
1094                                    .println( "filename"            ,filename               )
1095                                    .println( "encode"                      ,encode                 )
1096                                    .println( "readerClass"         ,readerClass    )
1097                                    .println( "maxRowCount"         ,maxRowCount    )
1098                                    .println( "displayMsg"          ,displayMsg             )
1099                                    .println( "executeCount"        ,executeCount   )
1100                                    .println( "modifyType"          ,modifyType             )
1101                                    .println( "checkColumns"        ,checkColumns   )
1102                                    .println( "adjustColumns"       ,adjustColumns  )
1103                                    .println( "nullCheck"           ,nullCheck              )
1104                                    .println( "command"                     ,command                )
1105                                    .println( "tableId"                     ,tableId                )
1106                                    .println( "sheetName"           ,sheetName              )
1107                                    .println( "sheetNos"            ,sheetNos               )               // 5.5.7.2 (2012/10/09)
1108                                    .println( "columns"                     ,columns                )
1109                                    .println( "useNumber"           ,useNumber              )
1110                                    .println( "Other..."    ,getAttributes().getAttribute() )
1111                                    .fixForm().toString() ;
1112            }
1113    }