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.io.TableWriter;
022    import org.opengion.fukurou.util.FileUtil;
023    import org.opengion.fukurou.util.HybsEntry;
024    import org.opengion.fukurou.util.Closer ;
025    import org.opengion.fukurou.util.StringUtil ;
026    import static org.opengion.fukurou.util.StringUtil.nval ;
027    
028    import javax.servlet.ServletResponse ;
029    import javax.servlet.http.HttpServletResponse ;
030    import javax.servlet.jsp.JspWriter ;
031    
032    import java.util.zip.GZIPOutputStream;
033    import java.util.zip.ZipOutputStream;
034    import java.util.zip.ZipEntry;
035    import java.util.List;
036    import java.util.ArrayList;
037    import java.util.Locale;
038    import java.io.File;
039    import java.io.OutputStream;
040    import java.io.PrintWriter;
041    import java.io.FileOutputStream;
042    import java.io.ByteArrayOutputStream;
043    import java.io.ObjectOutputStream;
044    import java.io.ObjectInputStream;
045    import java.io.IOException;
046    
047    /**
048     * DBTableModelオブジェクトを??ファイルに出力するタグです?
049     *
050     * ??タ(DBTableModel)と、コントローラ(WriteTableTagForm)を与えて?
051     * 外部からコントロールすることで、各種形式で ??タ(DBTableModel)を表示できます?
052     * writeTableタグ に対して、コマンドを与えることにより、?部のコントローラの
053     * 実?対応した? 形式で??タを作?します?
054     *
055     * @og.formSample
056     * ●形式?
057     *     <og:writeTable
058     *         fileURL   = "{@USER.ID}"    保存??レクトリ?
059     *         filename  = "{@filename}"   保存ファイル?
060     *         encode    = "UnicodeLittle"      保存ファイルエンコード名
061     *     />
062     *
063     * ●body?あ?EVAL_BODY_BUFFERED:BODYを評価し?{@XXXX} を解析しま?
064     *
065     * ●Tag定義??
066     *   <og:writeTable
067     *       writerClass        【TAG】実際に書き?すクラス名?略称(TableWriter_**** クラスの ****)を指定しま?初期値:Default)
068     *       separator          【TAG】可変長ファイルを作?するとき??区??をセ?しま?(初期値:TableWriter#TAB_SEPARATOR[= ])
069     *       headerSequence     【TAG】DBTableModelの出力?(LNSCD など)をセ?しま?
070     *       fileURL            【TAG】ファイル保存??レクトリ名を?しま?
071     *       filename           【TAG】ファイルを作?するとき?ファイル名をセ?しま?(初期値:FILE_FILENAME[=UnicodeLittle])
072     *       sheetName          【TAG】EXCELファイルを書き?すとき?シート名を設定しま?
073     *       beforeDelete       【TAG】事前にファイルを削除するかど?をセ?しま?(初期値:false)
074     *       encode             【TAG】ファイルを作?するとき?ファイルエンコー?ング名をセ?しま?(初期値:FILE_ENCODE[=UnicodeLittle])
075     *       fileAppend         【TAG】追?ードで書き込?ど?[true/false]を指定しま?初期値:false[新規モード])
076     *       direct             【?】結果をダイレクトにEXCEL起動するかど?[true/false]を指定しま?初期値:false[ファイル])
077     *       zip                【TAG】結果をファイルに出力するときに、ZIPで圧縮するかど?[true/false]を指定しま?初期値:false)
078     *       tableId            【TAG?通常使?せん)sessionから?す?DBTableModelオブジェクト? ID
079     *       scope              【TAG】キャ?ュする場合?スコープ[request/page/session/applicaton]を指定しま?初期値:session)
080     *       disposition        【TAG】Content-Disposition (inline:埋め込?attachment:?アログを起?を指定しま?初期値:attachment)
081     *       refFileURL         【TAG】EXCEL雛型参?ファイルの?レクトリ名をセ?しま?
082     *       refFilename        【TAG】EXCEL雛型参?ファイル名をセ?しま?
083     *       refSheetName       【TAG】EXCEL雛型参?ファイルのシート名を設定しま?
084     *       useNumber          【TAG】行番号??を?出力す?しない[true/false]を指定しま?初期値:true)
085     *       columns            【TAG】書き込み先ファイルのカラ??を?外部(タグ)より?しま?
086     *       useRenderer        【TAG】書込処?コードリソースのラベル変換を行うかど?を指定しま?(初期値:USE_TABLE_WRITER_RENDERER[=false])
087     *       selectedAll        【TAG】チェ?行?みを対象にするかを?しま?初期値:true)?
088     *       fontName           【TAG】EXCEL出力時の?ォルトフォント名を設定しま?(初期値:TABLE_WRITER_DEFAULT_FONT_NAME[=?? ?ゴシ?])
089     *       fontPoint          【TAG】EXCEL出力時の?ォルトフォント?イント数を設定しま?初期値:TABLE_WRITER_DEFAULT_FONT_POINTS[=11])
090     *       skipRowCount       【TAG?通常は使?せん)??タの書き込み開始位置を設定しま?
091     *       language           【TAG】タグ?で使用する?コード[ja/en/zh/…]を指定しま?
092     *       caseKey            【TAG】このタグ自体を利用するかど?の条件キーを指定しま?初期値:null) 5.7.7.2 (2014/06/20)
093     *       caseVal            【TAG】このタグ自体を利用するかど?の条件値を指定しま?初期値:null) 5.7.7.2 (2014/06/20)
094     *       caseNN             【TAG】指定?値が?null/ゼロ?? でな???Not Null=NN)は、このタグは使用されま?初期値:true) 5.7.7.2 (2014/06/20)
095     *       caseNull           【TAG】指定?値が?null/ゼロ?? の場合?、このタグは使用されま?初期値:true) 5.7.7.2 (2014/06/20)
096     *       debug              【TAG】デバッグ??を?力するかど?[true/false]を指定しま?初期値:false)
097     *   >   ... Body ...
098     *   </og:writeTable>
099     *
100     * ●使用?
101     *     <og:writeTable ????? >
102     *         <og:writeTableParam
103     *             key  = "Tablename"  value="GE12"
104     *         />
105     *         <og:writeTableParam
106     *             key  = "First"             First:??に登録
107     *         >
108     *                      insert into GE12bk
109     *                         select * from GE12
110     *                         where SYSTEM_ID='**'
111     *         </og:writeTableParam
112     *         <og:writeTableParam
113     *             key  = "First"             First:の?番目に登録
114     *         >
115     *              delete from GE12 where SYSTEM_ID='**' and KBSAKU='0'
116     *         </og:writeTableParam
117     *         <og:writeTableParam
118     *             key  = "Last"              Last:?に登録
119     *         >
120     *              update GE12 set XXXX='YYYY' where SYSTEM_ID='**' and KBSAKU='0'
121     *         </og:writeTableParam
122     *     </og:writeTableParam
123     *
124     * @og.group ファイル出?
125     *
126     * @version  4.0
127     * @author   Kazuhiko Hasegawa
128     * @since    JDK5.0,
129     */
130    public class WriteTableTag extends CommonTagSupport {
131            //* こ?プログラ??VERSION??を設定します?       {@value} */
132            private static final String VERSION = "5.7.9.0 (2014/08/08)" ;
133    
134            private static final long serialVersionUID = 579020140808L ;
135    
136            private final String  BASE_URL  = HybsSystem.sys( "FILE_URL" );
137    
138            private String  separator               = TableWriter.TAB_SEPARATOR;     // ?区???
139            private String  headerSequence  = null;                         // ヘッ???の並び?
140            private String  fileURL                 = BASE_URL;
141            private String  filename                = HybsSystem.sys( "FILE_FILENAME" );   // ファイル?
142            private String  sheetName               = "Sheet1" ;            // 3.5.4.2 (2003/12/15)
143            private String  refFileURL              = BASE_URL;                     // 3.5.4.3 (2004/01/05)
144            private String  refFilename     = null;                         // 3.5.4.3 (2004/01/05)
145            private String  refSheetName    = null ;                        // 3.5.4.3 (2004/01/05)
146            private String  fontName                = HybsSystem.sys( "TABLE_WRITER_DEFAULT_FONT_NAME" );                   // 3.8.5.3 (2006/08/07)
147            private String  fontPoint               = HybsSystem.sys( "TABLE_WRITER_DEFAULT_FONT_POINTS" );                 // 3.8.5.3 (2006/08/07)
148            private String  encode                  = HybsSystem.sys( "FILE_ENCODE" );      // ファイルエンコー?ング  "DEFAULT","JISAutoDetect" ,"JIS", "EUC_JP", "MS932", "SJIS" , "Windows-31J" , "Shift_JIS"
149            private String  writerClass     = HybsSystem.sys( "TABLE_WRITER_DEFAULT_CLASS" );               // 3.8.5.3 (2006/08/07)
150            private boolean fileAppend              = false;                        // ファイルをAPPENDモードで出力するか
151            private boolean direct                  = false;
152            private boolean zip                     = false;
153            private String  disposition     = "attachment";         // 3.8.0.9 (2005/10/17) Content-Disposition 初期値変更 inline ?attachment
154    
155            private transient DBTableModel table      = null;
156            private String  tableId                 = HybsSystem.TBL_MDL_KEY ;
157            private String  directory               = null ;                        // 3.8.6.0 (2006/08/23)
158    
159            private transient List<HybsEntry> param   = null ;                // 4.0.0 (2005/02/28)
160    
161            private boolean useNumber               = true;                         // 3.7.0.2 (2005/02/14)
162            // 4.0.0 (2005/12/31) 外部よりカラ??(カンマ区?)を指定できるようにする?
163            private String          columns         = null;
164            // 5.2.1.0 (2010/10/01) 書込処?コードリソースのラベル変換を行うかど?
165            private boolean useRenderer             = HybsSystem.sysBool( "USE_TABLE_WRITER_RENDERER" );    // 5.2.1.0 (2010/10/01)
166            
167            // 5.5.5.5 (2012/08/24) チェ?対?
168            private boolean selectedAll             = true;                         // 5.5.5.5 (2012/08/24)
169    
170            // 5.5.9.1 (2012/12/07) 事前にファイルを削除するかど?。互換性のため、false に設定?推奨は、true
171            private boolean beforeDelete    = false;                        // 5.5.9.1 (2012/12/07) 事前にファイルを削除するかど??
172    
173            private int             skipRowCount    = 0;                            // 5.7.9.0 (2014/08/08) ??タの書き込み開始位置設?
174    
175            /**
176             * Taglibの開始タグが見つかったときに処??doStartTag() ?オーバ?ライドします?
177             *
178             * @og.rev 5.5.9.1 (2012/12/07) 事前にファイルを削除するかど???eforeDelete?フラグを追?
179             * @og.rev 5.7.7.2 (2014/06/20) caseKey,caseVal,caseNN,caseNull 属?を追?
180             *
181             * @return      後続????( EVAL_BODY_BUFFERED )
182             */
183            @Override
184            public int doStartTag() {
185                    // 5.7.7.2 (2014/06/20) caseKey,caseVal,caseNN,caseNull 属?を追?
186                    if( !useTag() ) { return SKIP_BODY ; }
187    
188                    directory = HybsSystem.url2dir( fileURL );              // 5.5.9.1 (2012/12/07) doEndTag() から移?
189    
190                    // 5.5.9.1 (2012/12/07) 事前にファイルを削除するかど?
191                    if( beforeDelete && !fileAppend ) {
192                            File delFile = null;
193                            if( zip ) { delFile = new File( directory,filename + ".zip" ); }
194                            else      { delFile = new File( directory,filename ); }
195                            if( delFile.exists() ) { delFile.delete(); }
196                    }
197    
198                    return EVAL_BODY_BUFFERED ;     // Body を評価する? extends BodyTagSupport ?
199            }
200    
201            /**
202             * Taglibの終?グが見つかったときに処??doEndTag() ?オーバ?ライドします?
203             *
204             * @og.rev 2.1.3.1 (2002/12/13) ContentType を?x-msexcel から vnd.ms-excel に変更した?
205             * @og.rev 3.1.1.2 (2003/04/04) Tomcat4.1 対応?release2() ?doEndTag()で呼ぶ?
206             * @og.rev 3.1.3.0 (2003/04/10) FILE_ENCODE から、エンコード情報を取得する?
207             * @og.rev 3.1.5.0 (2003/04/20) Content-Disposition を外部から?できるように変更?
208             * @og.rev 3.2.0.0 (2003/05/22) GZIPOutputStream を使用して?が?ZipOutputStream に変更?
209             * @og.rev 3.5.4.1 (2003/12/01) 引数の PrintWriter を?OutputStream に変更?
210             * @og.rev 3.5.4.3 (2004/01/05) 引数を? PrintWriter に戻す?
211             * @og.rev 3.6.0.2 (2004/10/04) EXCEL?レクト?力時にファイルエンドまで出力されな??合対?
212             * @og.rev 3.8.0.9 (2005/10/17) disposition属?を使用できるように変更します?
213             * @og.rev 3.8.6.0 (2006/08/23) フォル?な??合?、?階層??フォル?自動で作?します?
214             * @og.rev 4.3.4.3 (2008/12/22) Excel出力?判別方法を前方??に変更
215             * @og.rev 5.1.6.0 (2010/05/01) 画面帳票作?機?対?
216             * @og.rev 5.5.2.0 (2012/05/01) ZIP時にもencodeが有効にする
217             * @og.rev 5.5.5.5 (2012/08/24) selectedAllの処?追?
218             * @og.rev 5.5.9.1 (2012/12/07) beforeDeleteフラグの追?伴??ロジ?変更
219             * @og.rev 5.7.7.2 (2014/06/20) caseKey,caseVal,caseNN,caseNull 属?を追?
220             *
221             * @return      後続????
222             */
223            @Override
224            public int doEndTag() {
225                    debugPrint();           // 4.0.0 (2005/02/28)
226    
227                    // 5.7.7.2 (2014/06/20) caseKey,caseVal,caseNN,caseNull 属?を追?
228                    if( !useTag() ) { return EVAL_PAGE ; }
229    
230                    table = (DBTableModel)getObject( tableId );
231                    if( ! selectedAll ){ // 5.5.5.5 (2012/08/24) 
232                            table = getSelRowsTable( table );
233                    }
234                    if( table != null && table.getRowCount() > 0 ) {
235    
236                            File dir = new File(directory);
237                            if( ! dir.exists() && ! dir.mkdirs() ) {
238                                    String errMsg = "?レクトリの作?に失敗しました?" + directory + "]";
239                                    throw new HybsSystemException( errMsg );
240                            }
241    
242                            PrintWriter pw = null;
243                            ByteArrayOutputStream bt = null ;
244                            try {
245                                    if( direct ) {
246                                            if( zip ) {
247                                                    bt = new ByteArrayOutputStream();
248                                                    pw = new PrintWriter( bt );
249                                                    create( pw ) ;
250                                                    pw.flush();                             // 3.6.0.2 (2004/10/04)
251                                                    ServletResponse response = pageContext.getResponse() ;
252                                                    ((HttpServletResponse)response).addHeader( "Content-Encoding","gzip" );
253    
254                                                    GZIPOutputStream gzip = new GZIPOutputStream(bt);
255                                                    gzip.finish() ;
256                                                    response.setContentLength( bt.size() );
257    
258                                                    JspWriter out = pageContext.getOut();
259                                                    out.clear();
260                                                    out.print( bt );
261                                                    out.flush();                    // 3.6.0.2 (2004/10/04)
262                                            }
263                                            else {
264                                                    bt = new ByteArrayOutputStream();
265                                                    pw = new PrintWriter( bt );
266                                                    create( pw ) ;
267                                                    pw.flush();                             // 3.6.0.2 (2004/10/04)
268                                                    ServletResponse response = pageContext.getResponse() ;
269                                                    response.setContentType( "application/vnd.ms-excel; charset=" + encode );
270            //                                      response.setContentType( "application/x-msexcel; charset=" + encode );
271            //                                      response.setContentType( "text/comma-separated-values ; charset=" + encode );
272            //                                      ((HttpServletResponse)response).setHeader( "contentType","application/x-msexcel; charset=Shift_JIS" );
273            //                                      ((HttpServletResponse)response).setHeader( "Content-Disposition","attachment; filename=\"" + filename + "\"" );
274            //                                      ((HttpServletResponse)response).setHeader( "Content-Disposition","inline; filename=\"" + filename + "\"" );
275                                                    // 3.8.0.9 (2005/10/17) disposition属?を使用できるように変更します?
276                                                    ((HttpServletResponse)response).setHeader( "Content-Disposition",disposition + "; filename=\"" + filename + "\"" );
277    
278                                                    JspWriter out = pageContext.getOut();
279                                                    out.clear();
280                                                    out.print( bt );
281                                                    out.flush();                    // 3.6.0.2 (2004/10/04)
282                                            }
283                                    }
284                                    else {
285                                    // 3.2.0.0 (2003/05/22) GZIPOutputStream を使用して?が?ZipOutputStream に変更?
286                                            if( zip ) {
287                                                    bt = new ByteArrayOutputStream();
288                                                    if( writerClass.toUpperCase(Locale.JAPAN).startsWith("EXCEL") // 5.5.2.0(2012/05/01)
289                                                                    || writerClass.toUpperCase(Locale.JAPAN).startsWith("CALC") ) {
290                                                            pw = new PrintWriter( bt );
291                                                    }
292                                                    else{
293                                                            pw = getPrintWriter(bt);
294                                                    }
295                                                    create( pw ) ;
296                                                    pw.flush();                             // 3.6.0.2 (2004/10/04)
297    
298                                                    ZipOutputStream gzip = null;
299                                                    try {
300                                                            gzip = new ZipOutputStream(
301                                                                                            new FileOutputStream(
302                                                                                                    StringUtil.urlAppend( directory,filename + ".zip" )));
303                                                            gzip.putNextEntry( new ZipEntry( filename ) );
304                                                            (bt).writeTo( gzip );
305                                                            gzip.finish() ;
306                                                    }
307                                                    finally {
308                                                            Closer.ioClose( gzip );         // 4.0.0 (2006/01/31) close 処?の IOException を無?
309                                                    }
310                                            }
311                                            else {
312                                                    // if( "Excel".equalsIgnoreCase( writerClass ) ) {
313                                                    if( writerClass.toUpperCase(Locale.JAPAN).startsWith("EXCEL") // 4.3.4.3 (2008/12/22)
314                                                            ||  writerClass.toUpperCase(Locale.JAPAN).startsWith("CALC") ) { // 5.1.6.0 (2010/05/01)
315                                                            create( null );
316                                                    }
317                                                    else {
318                                                            pw = getPrintWriter();
319                                                            create( pw );
320                                                            pw.flush();                             // 3.6.0.2 (2004/10/04)
321                                                    }
322                                            }
323                                    }
324                            }
325                            catch( IOException ex ) {
326                                    String errMsg = "??ブル出力時に、IOエラーが発生しました? + toString();
327                                    throw new HybsSystemException( errMsg,ex );             // 3.5.5.4 (2004/04/15) 引数の並び?更
328                            }
329                            finally {
330                                    Closer.ioClose( pw );           // 4.0.0 (2006/01/31) close 処?の IOException を無?
331                                    Closer.ioClose( bt );           // 4.0.0 (2006/01/31) close 処?の IOException を無?
332                            }
333                    }
334    
335                    return EVAL_PAGE ;
336            }
337    
338            /**
339             * タグリブオブジェクトをリリースします?
340             * キャ?ュされて再利用される?で、フィールド?初期設定を行います?
341             *
342             * @og.rev 2.0.0.4 (2002/09/27) カスタ?グの release() メソ?を?追?
343             * @og.rev 3.1.1.2 (2003/04/04) Tomcat4.1 対応?release2() ?doEndTag()で呼ぶ?
344             * @og.rev 3.1.3.0 (2003/04/10) FILE_ENCODE から、エンコード情報を取得する?
345             * @og.rev 3.1.5.0 (2003/04/20) Content-Disposition を外部から?できるように変更?
346             * @og.rev 3.5.4.2 (2003/12/15) EXCELのシート名を指定できるように変更?
347             * @og.rev 3.5.4.3 (2004/01/05) EXCEL雛型参?ファイルのURL,filenameを追?ます?
348             * @og.rev 3.8.5.3 (2006/08/07) writerClass 属?の初期値をシス?リソースより取得します?
349             * @og.rev 3.8.5.3 (2006/08/07) fontName 属?を追?ます?
350             * @og.rev 3.8.5.3 (2006/08/07) fontPoint 属?を追?ます?
351             * @og.rev 3.8.6.0 (2006/08/23) directory 属?を追?ます?
352             * @og.rev 4.0.0.0 (2005/02/28) XMLファイルにセ?する、param を追??
353             * @og.rev 5.2.1.0 (2010/10/01) 書込処?コードリソースのラベル変換を行うかど? useRenderer 属?追?
354             * @og.rev 5.5.5.5 (2012/08/24) selectedAll属?を追?
355             * @og.rev 5.5.9.1 (2012/12/07) 事前にファイルを削除するかど?。互換性のため、false に設定?推奨は、true
356             * @og.rev 5.7.9.0 (2014/08/08) ??タの書き込み開始位置(skipRowCount)を設?
357             *
358             */
359            @Override
360            protected void release2() {
361                    super.release2();
362                    separator               = TableWriter.TAB_SEPARATOR;   // ?区???
363                    headerSequence  = null;                         // ヘッ???の並び?
364                    fileURL                 = BASE_URL;
365                    filename                = HybsSystem.sys( "FILE_FILENAME" );   // ファイル?
366                    sheetName               = "Sheet1";                     // 3.5.4.2 (2003/12/15)
367                    beforeDelete    = false;                        // 5.5.9.1 (2012/12/07)
368                    refFileURL              = BASE_URL;                     // 3.5.4.3 (2004/01/05)
369                    refFilename     = null;                         // 3.5.4.3 (2004/01/05)
370                    refSheetName    = null;                         // 3.5.4.2 (2003/12/15)
371                    fontName                = HybsSystem.sys( "TABLE_WRITER_DEFAULT_FONT_NAME" );                   // 3.8.5.3 (2006/08/07)
372                    fontPoint               = HybsSystem.sys( "TABLE_WRITER_DEFAULT_FONT_POINTS" );                 // 3.8.5.3 (2006/08/07)
373                    encode                  = HybsSystem.sys( "FILE_ENCODE" );       // ファイルエンコー?ング  "DEFAULT","JISAutoDetect" ,"JIS", "EUC_JP", "MS932", "SJIS" , "Windows-31J" , "Shift_JIS"
374                    writerClass     = HybsSystem.sys( "TABLE_WRITER_DEFAULT_CLASS" );               // 3.8.5.3 (2006/08/07)
375                    fileAppend              = false;                        // ファイルをAPPENDモードで出力するか
376                    direct                  = false;
377                    zip                     = false;
378                    table                   = null;
379                    tableId                 = HybsSystem.TBL_MDL_KEY ;
380                    disposition     = "attachment";         // 3.8.0.9 (2005/10/17) 初期値変更 inline ?attachment
381                    param                   = null ;                        // 4.0.0 (2005/01/31)
382                    useNumber               = true;                         // 3.7.0.2 (2005/02/14)
383                    skipRowCount    = 0;                            // 5.7.9.0 (2014/08/08) ??タの書き込み開始位置を設?
384                    directory               = null;                         // 3.8.6.0 (2006/08/23)
385                    columns                 = null;                         // 4.0.0 (2005/12/31)
386                    useRenderer             = HybsSystem.sysBool( "USE_TABLE_WRITER_RENDERER" );    // 5.2.1.0 (2010/10/01)
387                    selectedAll             = true;                         // 5.5.5.5 (2012/08/24)
388            }
389    
390            /**
391             * TableWriter の実オブジェクトを生?して?OutputStream に書き込みます?
392             *
393             * @og.rev 3.5.4.1 (2003/12/01) 引数の PrintWriter を?OutputStream に変更?
394             * @og.rev 3.5.4.2 (2003/12/15) lang 引数?table と同時に設定します?
395             * @og.rev 3.5.4.2 (2003/12/15) TableWriter のサブクラス名変更?
396             * @og.rev 3.5.4.3 (2004/01/05) EXCEL雛型参?ファイルを指定するよ?変更?
397             * @og.rev 3.5.4.3 (2004/01/05) 引数を? PrintWriter に戻す?
398             * @og.rev 3.5.4.5 (2004/01/23) ?エンコードを渡すよ?変更する?
399             * @og.rev 3.5.6.0 (2004/06/18) ?プラグイン関連付け設定を、シス?パラメータ に記述します?
400             * @og.rev 3.8.5.3 (2006/08/07) EXCEL時に fontName と fontPoint 属?をセ?します?
401             * @og.rev 4.0.0.0 (2005/01/31) キーの?を、TableWriter. から、TableWriter_ に変更します?
402             * @og.rev 4.0.0.0 (2005/12/31) 外部よりカラ??(カンマ区?)を指定できるようにする?
403             * @og.rev 5.2.1.0 (2010/10/01) 書込処?コードリソースのラベル変換を行うかど?設?useRenderer 属?追?
404             * @og.rev 5.7.9.0 (2014/08/08) ??タの書き込み開始位置(skipRowCount)を設?
405             *
406             * @param   out PrintWriterオブジェク?
407             */
408            private void create( final PrintWriter out )  {
409                    // 5.2.1.0 (2010/10/01) writerClass で Renderer系の場合?、useRendererフラグに変更する?
410                    if( "ExcelRenderer".equalsIgnoreCase( writerClass ) ) {
411                            writerClass = "Excel" ;
412                            useRenderer = true;
413                    }
414                    else if( "Renderer".equalsIgnoreCase( writerClass ) ) {
415                            writerClass = "Default" ;
416                            useRenderer = true;
417                    }
418    
419                    String className = HybsSystem.sys( "TableWriter_" + writerClass ) ;             // 4.0.0 (2005/01/31)
420                    TableWriter writer = (TableWriter)HybsSystem.newInstance( className );  // 3.5.5.3 (2004/04/09)
421    
422                    writer.setDBTableModel( table,getLanguage() );
423                    writer.setSeparator( separator );
424                    writer.setHeaderSequence( headerSequence );
425                    writer.setEncode( encode );                                     // 3.5.4.5 (2004/01/23)
426                    writer.setAppend( fileAppend );                         // 3.5.4.2 (2003/12/15)
427                    if( param != null ) { writer.setParam( param ); }       // 4.0.0 (2005/01/31)
428                    writer.setUseNumber( useNumber );                       // 3.7.0.2 (2005/02/14)
429            //      if( columns == null ) {
430            //              columns = (String)getSessionAttribute( HybsSystem.TBL_WRITER_CLMS );
431            //              removeSessionAttribute( HybsSystem.TBL_WRITER_CLMS );
432            //      }
433                    writer.setColumns( columns );                           // 4.0.0 (2005/12/31)
434                    writer.setUseRenderer( useRenderer );           // 5.2.1.0 (2010/10/01)
435                    if( writer.isExcel() ) {                                        // 3.5.4.3 (2004/01/05)
436                            writer.setSheetName( sheetName );
437                            writer.setFilename( StringUtil.urlAppend( directory , filename ) );
438                            if( refFileURL != null && refFilename != null ) {
439                                    writer.setRefFilename( StringUtil.urlAppend( HybsSystem.url2dir(refFileURL) , refFilename ) );
440                            }
441                            if( refSheetName != null && fontPoint.length() > 0 ) {               // 5.7.9.0 (2014/08/08) nullチェ?
442                                    writer.setRefSheetName( refSheetName );
443                            }
444    //                      writer.setFontName( nval( fontName,null ) );                            // 3.8.5.3 (2006/08/07)
445                            writer.setFontName( fontName )  ;                                                       // 5.7.9.0 (2014/08/08) nvalはずし
446                            if( fontPoint != null && fontPoint.length() > 0 ) {
447                                    writer.setFontPoint( Short.parseShort( fontPoint ) );   // 3.8.5.3 (2006/08/07)
448                            }
449                            writer.setSkipRowCount( skipRowCount );                                         // 5.7.9.0 (2014/08/08)
450                            writer.writeDBTable();
451                    }
452                    else {
453                            writer.writeDBTable( out );
454                    }
455            }
456    
457            /**
458             * PrintWriter を取得します?
459             *
460             * ここでは、??ファイル出力を??した PrintWriter を作?します?
461             *
462             * @og.rev 2.2.0.0 (2002/12/17) 中国?国際化)対?エンコード?取得方法変更
463             * @og.rev 3.1.3.0 (2003/04/10) FILE_ENCODE から、エンコード情報を取得する?
464             * @og.rev 3.5.4.1 (2003/12/01) PrintWriter を?OutputStream に変更?
465             * @og.rev 3.5.5.9 (2004/06/07) FileUtil.getBufferedReader を使用
466             * @og.rev 3.7.1.1 (2005/05/23) フォル?な??合?、?階層??フォル?自動で作?します?
467             * @og.rev 3.8.0.0 (2005/06/07) FileUtil#getPrintWriter を利用?
468             *
469             * @return      ファイル書き?し用のPrintWriterオブジェク?
470             */
471            private PrintWriter getPrintWriter() {
472                    if( filename == null ) {
473                            String errMsg = "ファイル名がセ?されて?せん?;
474                            throw new HybsSystemException( errMsg );
475                    }
476    
477                    // ※ 注?StringUtil.urlAppend を?込んで?意図が不?。?削除して?すが、注?
478                    // 3.8.0.0 (2005/06/07) FileUtil#getPrintWriter を利用?
479            //      out = FileUtil.getPrintWriter( StringUtil.urlAppend( directory,filename ),fileAppend,encode);
480                    PrintWriter out = FileUtil.getPrintWriter( new File( directory,filename ),encode,fileAppend );
481    
482                    return out ;
483            }
484    
485            /**
486             * PrintWriter を取得します?
487             *
488             * 引数で?したOutputStreamを利用して出力します?
489             *
490             * @og.rev 5.5.2.0 (2012/05/01) 新規作?
491             *
492             * @param       os      OutputStreamオブジェク?
493             *
494             * @return      ?したstreamに書き?すPrintWriter
495             */
496            private PrintWriter getPrintWriter( final OutputStream os ) {
497                    PrintWriter out = FileUtil.getPrintWriter( os,encode );
498    
499                    return out ;
500            }
501            
502            /**
503             * チェ?????ブルモ?を?構?します?
504             *
505             * @og.rev 5.5.5.5 (2012/08/24) 新規作?
506             * @og.rev 5.5.9.1 (2012/12/07) ?処?更
507             *
508             * @param       oldTable        コピ??ーブルモ?
509             *
510             * @return      チェ?した?けで再構?した??ブルモ?
511             */
512            private DBTableModel getSelRowsTable( final DBTableModel oldTable ) {
513                    if( oldTable == null ) { return null; }         // 5.5.9.1 (2012/12/07) 引数のDBTableModel?null の場合?処??
514    
515                    DBTableModel newTable = oldTable.newModel();
516                    final int[] rowNo = getParameterRows();
517                    final int rowCount = rowNo.length ;
518    
519                    for( int i=0; i<rowCount; i++ ) {
520                            newTable.addValues( oldTable.getValues(rowNo[i]), i );
521                    }
522                    return newTable;
523            }
524    
525            /**
526             * 【TAG?通常は使?せん)結果のDBTableModelを?sessionに登録するとき?キーを指定しま?
527             *              (初期値:HybsSystem#TBL_MDL_KEY[={@og.value org.opengion.hayabusa.common.HybsSystem#TBL_MDL_KEY}])?
528             *
529             * @og.tag
530             * 検索結果より、DBTableModelオブジェクトを作?します?これを?下流?viewタグ等に
531             * 渡す?合に??常は、session を利用します?そ?場合?登録キーです?
532             * query タグを同時に実行して、結果を求める?合?同?モリに配置される為?
533             * こ? tableId 属?を利用して、メモリ空間を?ます?
534             *              (初期値:HybsSystem#TBL_MDL_KEY[={@og.value org.opengion.hayabusa.common.HybsSystem#TBL_MDL_KEY}])?
535             *
536             * @param       id sessionに登録する時? ID
537             */
538            public void setTableId( final String id ) {
539                    tableId = nval( getRequestParameter( id ), tableId );
540            }
541    
542            /**
543             * 【TAG】可変長ファイルを作?するとき??区??をセ?しま?
544             *              (初期値:TableWriter#TAB_SEPARATOR[={@og.value TableWriter#TAB_SEPARATOR}])?
545             *
546             * @og.tag 可変長ファイルを作?するとき??区??をセ?します?
547             * (初期値:TableWriter#TAB_SEPARATOR[={@og.value TableWriter#TAB_SEPARATOR}])?
548             *
549             * @param   separator ?区???
550             * @see         org.opengion.hayabusa.io.TableWriter#TAB_SEPARATOR
551             */
552            public void setSeparator( final String separator ) {
553                    this.separator = nval( getRequestParameter( separator ),this.separator );
554            }
555    
556            /**
557             * 【TAG】DBTableModelの出力?(LNSCD など)をセ?します?
558             *
559             * @og.tag
560             * Label,Name,Size,Class,Data の?ィールド?頭??アルファベットで
561             * 出力?を設定します?
562             *
563             * @param   hs 出力? (LNSCD など)
564             */
565            public void setHeaderSequence( final String hs ) {
566                    String[] headers = getRequestParameterValues( hs );
567                    if( headers != null ) {
568                            StringBuilder buf = new StringBuilder();
569                            for( int i=0; i<headers.length; i++ ) {
570                                    if( headers[i] != null ) { buf.append( headers[i] ); }
571                            }
572                            headerSequence = buf.toString();
573                    }
574            }
575    
576            /**
577             * 【TAG】ファイル保存??レクトリ名を?します?
578             *
579             * @og.tag
580             * こ?属?で?される?レクトリに、ファイルをセーブします?
581             * ?方法???常の fileURL 属?と同様に、?頭が?'/' (UNIX) また??文字目が?
582             * ":" (Windows)の場合?、指定?URLそ?ままの?レクトリに、そ?な??合??
583             * シス?パラメータ の FILE_URL 属?で??フォル??下に、作?されます?
584             * fileURL = "{&#064;USER.ID}" と?すると、FILE_URL 属?で??フォル??下に?
585             * さらに、各個人ID別のフォル?作?して、そこにセーブします?
586             *
587             * @og.rev 3.5.4.3 (2004/01/05) ?処?、makeFileURL に移動?
588             * @og.rev 4.0.0.0 (2005/01/31) StringUtil.urlAppend メソ?の利用
589             * @og.rev 4.0.0.0 (2007/11/20) ?された?レクトリ名??が"\"or"/"で終わって???合に?/"を付加する?
590             *
591             * @param       url 保存??レクトリ?
592             */
593            public void setFileURL( final String url ) {
594                    String furl = nval( getRequestParameter( url ),null );
595                    if( furl != null ) {
596                            char ch = furl.charAt( furl.length()-1 );
597                            if( ch != '/' && ch != '\\' ) { furl = furl + "/"; }
598                            fileURL = StringUtil.urlAppend( fileURL,furl );
599                    }
600            }
601    
602            /**
603             * 【TAG】ファイルを作?するとき?ファイル名をセ?しま?
604             *              (初期値:FILE_ENCODE[={@og.value org.opengion.hayabusa.common.SystemData#FILE_ENCODE}])?
605             *
606             * @og.tag ファイルを作?するとき?ファイル名をセ?します?
607             * (初期値:シス?定数のFILE_ENCODE[={@og.value org.opengion.hayabusa.common.SystemData#FILE_ENCODE}])?
608             *
609             * @param   filename ファイル?
610             * @see         org.opengion.hayabusa.common.SystemData#FILE_ENCODE
611             */
612            public void setFilename( final String filename ) {
613                    this.filename = nval( getRequestParameter( filename ),this.filename );
614            }
615    
616            /**
617             * 【TAG】EXCELファイルを書き?すとき?シート名を設定します?
618             *
619             * @og.tag
620             * EXCELファイルを書き?す時に、シート名を指定します?これにより、?の形式?
621             * 異なるデータを?次書き?した?appendモードを併用)すること??シートを?して
622             * 新規にEXCELを作?することが可能になります?
623             * 初期値は、Sheet1 です?
624             *
625             * @og.rev 3.5.4.2 (2003/12/15) 新規追?
626             *
627             * @param   sheet EXCELファイルのシート名
628             */
629            public void setSheetName( final String sheet ) {
630                    sheetName = nval( getRequestParameter( sheet ),sheetName );
631            }
632    
633            /**
634             * 【TAG】ファイルを作?するとき?ファイルエンコー?ング名をセ?しま?
635             *              (初期値:FILE_ENCODE[={@og.value org.opengion.hayabusa.common.SystemData#FILE_ENCODE}])?
636             *
637             * @og.tag
638             * "DEFAULT","JISAutoDetect" ,"JIS", "EUC_JP", "MS932", "SJIS" , "Windows-31J" , "Shift_JIS"
639             * (初期値:シス?定数のFILE_ENCODE[={@og.value org.opengion.hayabusa.common.SystemData#FILE_ENCODE}])?
640             *
641             * @og.rev 2.2.0.0 (2002/12/17) 中国?国際化)対?エンコード?取得方法変更
642             * @og.rev 3.1.3.0 (2003/04/10) FILE_ENCODE から、エンコード情報を取得する?
643             *
644             * @param   enc ファイルエンコー?ング?
645             * @see     <a href="http://www.iana.org/assignments/character-sets">IANA Charset Registry</a>
646             * @see         org.opengion.hayabusa.common.SystemData#FILE_ENCODE
647             */
648            public void setEncode( final String enc ) {
649                    encode = nval( getRequestParameter( enc ),encode );
650            }
651    
652            /**
653             * 【TAG】実際に書き?すクラス名?略称({@og.doc03Link writerClass TableWriter_**** クラスの ****})を指定しま?初期値:Default)?
654             *
655             * @og.tag
656             * 実際に書き?すクラス?の略称)をセ?します?
657             * org.opengion.hayabusa.io.TableWriter インターフェースを継承したサブクラスです?
658             * これは、org.opengion.plugin.io 以下? TableWriter_**** クラスの **** を与えます?
659             * 属?クラス定義の {@link org.opengion.hayabusa.io.TableWriter TableWriter} を参照願います?
660             * {@og.doc03Link writerClass TableWriter_**** クラス}
661             *
662             * ExcelRenderer と、Renderer は、特別な名前で、useRenderer 属?に?true" をセ?するのと同じ効果があります?
663             * 実際は、ExcelRenderer ?Excel 、Renderer  ?Default のクラスが呼ばれます?
664             *
665             * @param   writerClass クラス?の略称)
666             * @see         org.opengion.hayabusa.io.TableWriter  TableWriterのサブクラス
667             */
668            public void setWriterClass( final String writerClass ) {
669                    this.writerClass = nval( getRequestParameter( writerClass ),this.writerClass );
670            }
671    
672            /**
673             * 【TAG】追?ードで書き込?ど?[true/false]を指定しま?初期値:false[新規モード])?
674             *
675             * @og.tag DBTableModelのファイルを?追?ードで書き込?ど?をセ?します?
676             *
677             * @param   flag  [true:追?ー?それ以?新規モード]
678             */
679            public void setFileAppend( final String flag ) {
680                    fileAppend = nval( getRequestParameter( flag ),fileAppend );
681            }
682    
683            /**
684             * 【?】結果をダイレクトにEXCEL起動するかど?[true/false]を指定しま?初期値:false[ファイル])?
685             *
686             * @og.tag 結果をダイレクトに EXCEL ファイルとして出力するかど?をセ?します?
687             *
688             * @param  flag  [true:?レク?それ以?ファイル]
689             * @deprecated 結果をダイレクトするとエンコード等でおかしな動きをする可能性がある?
690             */
691            @Deprecated public void setDirect( final String flag ) {
692                    direct = nval( getRequestParameter( flag ),direct );
693            }
694    
695            /**
696             * 【TAG】結果をファイルに出力するときに、ZIPで圧縮するかど?[true/false]を指定しま?初期値:false)?
697             *
698             * @og.tag
699             * 初期値は、圧縮しな?す?
700             *
701             * @param  flag ZIPで圧縮する [true:圧縮する/それ以?しない]
702             */
703            public void setZip( final String flag ) {
704                    zip = nval( getRequestParameter( flag ),zip );
705            }
706    
707            /**
708             * 【TAG】Content-Disposition (inline:埋め込?attachment:?アログを起?を指定しま?初期値:attachment)?
709             *
710             * @og.tag
711             * Content-Disposition を指定することで、ブラウザにアプリケーション??タ?
712             * 埋め込???inline)、セー?オープンの?アログを起動する??attachment)
713             * ?します?
714             * こ?属?が有効なのは、direct="true" で、zip="false"(初期値)のとき?みです?
715             * 値は、inline 、attachment が指定できます?
716             * 初期値は、attachment です?
717             * 注意:動作検証しましたが?inline と attachment で動作に差が現れませんでした?
718             *
719             * @og.rev 3.1.5.0 (2003/04/20) Content-Disposition を外部から?できるように変更?
720             * @og.rev 3.8.0.9 (2005/10/17) Content-Disposition 初期値変更 inline ?attachment
721             *
722             * @param  pos Content-Disposition [inline/attachment]
723             */
724            public void setDisposition( final String pos ) {
725                    disposition = nval( getRequestParameter( pos ),disposition );
726                    if( !"inline".equals( disposition ) && !"attachment".equals( disposition ) ) {
727                            String errMsg = "disposition には、inline ?attachment 以外??できません?
728                                                    + "disposition=[" + disposition + "]" ;
729                            throw new HybsSystemException( errMsg );
730                    }
731            }
732    
733            /**
734             * 【TAG】EXCEL雛型参?ファイルの?レクトリ名をセ?します?
735             *
736             * @og.tag
737             * こ?属?で?される?レクトリに、ファイルをセーブします?
738             * ?方法???常の fileURL 属?と同様に、?頭が?'/' (UNIX) また??文字目が?
739             * ":" (Windows)の場合?、指定?URLそ?ままの?レクトリに、そ?な??合??
740             * シス?パラメータ の FILE_URL 属?で??フォル??下に、作?されます?
741             * fileURL = "{&#064;USER.ID}" と?すると、FILE_URL 属?で??フォル??下に?
742             * さらに、各個人ID別のフォル?作?して、そこにセーブします?
743             *
744             * @og.rev 3.5.4.3 (2004/01/05) 新規作?
745             * @og.rev 4.0.0.0 (2005/01/31) StringUtil.urlAppend メソ?の利用
746             * @og.rev 4.0.0.0 (2007/11/20) ?された?レクトリ名??が"\"or"/"で終わって???合に?/"を付加する?
747             *
748             * @param       url EXCEL雛型参?ファイルの?レクトリ?
749             */
750            public void setRefFileURL( final String url ) {
751                    String furl = nval( getRequestParameter( url ),null );
752                    if( furl != null ) {
753                            char ch = furl.charAt( furl.length()-1 );
754                            if( ch != '/' && ch != '\\' ) { furl = furl + "/"; }
755                            refFileURL = StringUtil.urlAppend( refFileURL,furl );
756                    }
757            }
758    
759            /**
760             * 【TAG】EXCEL雛型参?ファイル名をセ?します?
761             *
762             * @og.tag
763             * ?処?には?形ファイルの雛形シートをメモリ上に構築し?
764             * そ?シート?セルに、データを追?て?ます?
765             * ?には?形シートとして存在しな???、すべて削除します?
766             * 雛形シートを使わな??合?、新規シートに追?て?ことになります?
767             * appendモード?場合?、オリジナルが雛形ファイルになります?
768             * 雛形ファイルの??、無効になります?
769             * ※ 互換性の為、同じ名前?設定?有効です?
770             *
771             * ※ Excel2007形?XSSF)では、行?体を?した色?線??
772             * セルとして認識されません。??で、罫線や色付けを行う?があります?
773             *
774             * @og.rev 3.5.4.3 (2004/01/05) 新規作?
775             *
776             * @param   filename EXCEL雛型参?ファイル?
777             */
778            public void setRefFilename( final String filename ) {
779                    refFilename = nval( getRequestParameter( filename ),refFilename );
780            }
781    
782            /**
783             * 【TAG】EXCEL雛型参?ファイルのシート名を設定します?
784             *
785             * @og.tag
786             * EXCELファイルを書き?す時に?型として参?するシート名を指定します?
787             * これにより、?の形式?異なるデータを?次書き?した?appendモードを併用)する
788             * こと??シートを?して新規にEXCELを作?する場合にフォー?設定する事が可能になります?
789             * 初期値は、null(第?ー? です?
790             *
791             * @og.rev 3.5.4.3 (2004/01/05) 新規追?
792             *
793             * @param   sheet EXCEL雛型参?ファイルのシート名
794             */
795            public void setRefSheetName( final String sheet ) {
796                    refSheetName = nval( getRequestParameter( sheet ),refSheetName );
797            }
798    
799            /**
800             * 【TAG】EXCEL出力時の?ォルトフォント名を設定しま?
801             *              (初期値:TABLE_WRITER_DEFAULT_FONT_NAME[={@og.value org.opengion.hayabusa.common.SystemData#TABLE_WRITER_DEFAULT_FONT_NAME}])?
802             *
803             * @og.tag
804             * これは、EXCEL追??として実?れて?す?
805             *
806             * EXCELファイルを書き?す時に、デフォルトフォント名を指定します?
807             * フォント名は、EXCELのフォント名をそのまま使用してください?
808             * ??、POI の org.apache.poi.hssf.usermodel.HSSFFont#setFontName( String )
809             * に設定されます?
810             * (初期値:シス?定数のTABLE_WRITER_DEFAULT_FONT_NAME[={@og.value org.opengion.hayabusa.common.SystemData#TABLE_WRITER_DEFAULT_FONT_NAME}])?
811             *
812             * @og.rev 3.8.5.3 (2006/08/07) 新規追?
813             *
814             * @param   name ?ォルトフォント名
815             * @see         org.opengion.hayabusa.common.SystemData#TABLE_WRITER_DEFAULT_FONT_NAME
816             */
817            public void setFontName( final String name ) {
818                    fontName = nval( getRequestParameter( name ),fontName );
819            }
820    
821            /**
822             * 【TAG】EXCEL出力時の?ォルトフォント?イント数を設定します?
823             *
824             * @og.tag
825             * これは、EXCEL追??として実?れて?す?
826             *
827             * EXCELファイルを書き?す時に、デフォルト?イント数を指定します?
828             * ??、POI の org.apache.poi.hssf.usermodel.HSSFFont#setFontHeightInPoints( short )
829             * に設定されます?
830             * 初期値は、シス?リソース の TABLE_WRITER_DEFAULT_FONT_POINTS です?
831             *
832             * @og.rev 3.8.5.3 (2006/08/07) 新規追?
833             *
834             * @param   point ?ォルトフォント?イント数
835             */
836            public void setFontPoint( final String point ) {
837                    fontPoint = nval( getRequestParameter( point ),fontPoint );
838            }
839    
840            /**
841             * 【TAG】行番号??を?出力す?しない[true/false]を指定しま?初期値:true)?
842             *
843             * @og.tag
844             * 通常のフォーマットでは、各行?先?に行番号を?力します?
845             * これは?NAME 属?を使用する場合には、?出力する?があります?
846             * (#NAME 属?は、読み取り時には、??です?)
847             * こ?、?頭の行番号が不要な場?つまり?他?シス?への??タ出力?
848             * こ?シス?では?NAME 属?が?力されな?め?読み込みできません?
849             * こ?行番号を?力しな??できます?
850             * なお?EXCEL 出力には、この設定?適用されません?暫定対?
851             * 初期値は、true(出力す? です?
852             *
853             * @og.rev 3.7.0.2 (2005/02/14) 新規追?
854             *
855             * @param   useNo 行番号??を指?[true:出力す?false:しない]
856             */
857            public void setUseNumber( final String useNo ) {
858                    useNumber = nval( getRequestParameter( useNo ),useNumber );
859            }
860    
861            /**
862             * 【TAG】書き込み先ファイルのカラ??を?外部(タグ)より?します?
863             *
864             * @og.tag
865             * こ??により、書き込?ラ?限定的に使用することが可能です?
866             * カラ?は、検索したDBTableModel上に含まれる名前で?する?があります?
867             * 別名で書き込みたい場合?、予めそ?名前で検索しておく?があります?
868             *
869             * @og.rev 4.0.0.0 (2005/12/31) 新規作?
870             *
871             * @param   clms 書き込み先ファイルのカラ??(カンマ区???
872             */
873            public void setColumns( final String clms ) {
874                    columns = nval( getRequestParameter( clms ),columns );
875            }
876    
877            /**
878             * 【TAG】書込処?コードリソースのラベル変換を行うかど?を指定しま?
879             *              (初期値:USE_TABLE_WRITER_RENDERER[={@og.value org.opengion.hayabusa.common.SystemData#USE_TABLE_WRITER_RENDERER}])?
880             *
881             * @og.tag
882             * コードリソースをそのままの値で出力すると、数字や記号になり何が書かれて?の?
883             * 不?になります?
884             * これは、コードリソースをラベルに変換して出力するかど?を指定します?
885             * 当然、コード?ユニ?クですが、ラベルはユニ?クになるかど?保障はされて?せんので
886             * TableReader 系で読み込??合には、リスクが発生します?
887             * また?TableReader 系で読み込??合にも?ラベルからコードを求める?変換を行うように?
888             * setUseRenderer メソ?で?する?があります?
889             *
890             * 従来は、TableWriter 系に、TableWriter_Renderer 系のクラスを作って対応して?したが?
891             * こ?メソ?の属?値のフラグで、制御します?
892             * (初期値:シス?定数のUSE_TABLE_WRITER_RENDERER[={@og.value org.opengion.hayabusa.common.SystemData#USE_TABLE_WRITER_RENDERER}])?
893             *
894             * @og.rev 5.2.1.0 (2010/10/01) 新規作?
895             *
896             * @param  flag コードリソースのラベル変換を行うかど?
897             * @see         org.opengion.hayabusa.common.SystemData#USE_TABLE_WRITER_RENDERER
898             */
899            public void setUseRenderer( final String flag ) {
900                    useRenderer = nval( getRequestParameter( flag ),useRenderer );
901            }
902    
903            /**
904             * 【TAG?通常は使?せん)??タの書き込み開始行番号を設定しま?初期値:0)?
905             *
906             * @og.tag
907             * TAB区??ストやEXCEL等???タの書き込みの開始行番号を指定します?
908             * 属?名?、行を飛?す???ことで、readTable タグと同じ名称です?
909             * ファイルの先?行が?行としてカウントします?で、設定?は、読み飛??
910             * 件数になります?(?と?すると?行読み飛?し??行目から読み込みます?)
911             * 行?読み飛?しと、カラ??読み飛??columns)、refFileURL、refFilename?
912             * refSheetName とともに使用すれば、ある程度のレイアウト設定が可能です?
913             * なお?こ?機?は、TableWriter_Excel のみに実?ます?
914             *
915             * @og.rev 5.7.9.0 (2014/08/08) 新規作?
916             *
917             * @param       count 書き込み開始行番号
918             */
919            public void setSkipRowCount( final String count ) {
920                    skipRowCount = nval( getRequestParameter( count ),skipRowCount );
921            }
922    
923            /**
924             * 【TAG】チェ?行?みを対象にするかを?しま?初期値:true)?
925             *
926             * @og.tag
927             * falseを指定する事で、前画面でチェ?した行?みを?力します?
928             * 初期値は全ての行を出?true)です?
929             * 出力されるファイルの行番号は?から振りなおされます?
930             *
931             * @og.rev 5.5.5.5 (2012/08/24) 新規作?
932             *
933             * @param   flag 対象にするか指?[true:全件/false:対象のみ]
934             */
935            public void setSelectedAll( final String flag ) {
936                    selectedAll = nval( getRequestParameter( flag ),selectedAll );          // 5.5.9.1 (2012/12/07) バグ対?
937            }
938            
939            /**
940             * 【TAG】事前にファイルを削除するかど?を指定しま?初期値:false)?
941             *
942             * @og.tag
943             * 出力?の DBTableModel が?存在しな??件の場合?過去に作?したファイル?
944             * そ?まま、残って?と、不要なトラブルのもととなる為、実行前に削除する?
945             * ど?を指定できます?
946             * なお?fileAppend="true"?追?ードで書き込???時には、データが0件で?
947             * 事前削除は行いません?
948             * 初期値は互換性のため削除しな?false)です?
949             *
950             * @og.rev 5.5.9.1 (2012/12/07) 新規作?
951             *
952             * @param   flag 事前削除するかど? [true:削除する/false:削除しない]
953             */
954            public void setBeforeDelete( final String flag ) {
955                    beforeDelete = nval( getRequestParameter( flag ),beforeDelete );
956            }
957    
958            /**
959             * WriteTable オブジェクトに渡すパラメータオブジェクトをセ?します?
960             *
961             * @og.tag
962             * WriteTableParamTag クラスよりセ?されます?
963             *
964             * @og.rev 4.0.0.0 (2005/02/28) 新規追?
965             *
966             * @param   entry HybsEntryオブジェク?
967             */
968            protected void addParam( final HybsEntry entry ) {
969                    if( param == null ) { param = new ArrayList<HybsEntry>(); }
970                    param.add( entry );
971            }
972    
973            /**
974             * シリアライズ用のカスタ?リアライズ書き込みメソ?
975             *
976             * @og.rev 4.0.0.0 (2006/09/31) 新規追?
977             * @serialData ?のオブジェクト?、シリアライズされません?
978             *
979             * @param       strm    ObjectOutputStreamオブジェク?
980             * @throws IOException  入出力エラーが発生した??
981             */
982            private void writeObject( final ObjectOutputStream strm ) throws IOException {
983                    strm.defaultWriteObject();
984            }
985    
986            /**
987             * シリアライズ用のカスタ?リアライズ読み込みメソ?
988             *
989             * ここでは、transient 宣?れた?変数の??初期化が?なフィールド?み設定します?
990             *
991             * @og.rev 4.0.0.0 (2006/09/31) 新規追?
992             * @serialData ?のオブジェクト?、シリアライズされません?
993             *
994             * @param       strm    ObjectInputStreamオブジェク?
995             * @see #release2()
996             * @throws IOException  シリアライズに関する入出力エラーが発生した??
997             * @throws ClassNotFoundException       クラスを見つけることができなかった??
998             */
999            private void readObject( final ObjectInputStream strm ) throws IOException , ClassNotFoundException {
1000                    strm.defaultReadObject();
1001            }
1002    
1003            /**
1004             * こ?オブジェクト???表現を返します?
1005             * 基本???目?使用します?
1006             *
1007             * @return こ?クラスの??表現
1008             */
1009            @Override
1010            public String toString() {
1011                    return org.opengion.fukurou.util.ToString.title( this.getClass().getName() )
1012                                    .println( "VERSION"                     ,VERSION                )
1013                                    .println( "BASE_URL"            ,BASE_URL               )
1014                                    .println( "separator"           ,separator              )
1015                                    .println( "headerSequence"      ,headerSequence )
1016                                    .println( "fileURL"                     ,fileURL                )
1017                                    .println( "filename"            ,filename               )
1018                                    .println( "refFileURL"          ,refFileURL             )
1019                                    .println( "refFilename"         ,refFilename    )
1020                                    .println( "encode"                      ,encode                 )
1021                                    .println( "writerClass"         ,writerClass    )
1022                                    .println( "fileAppend"          ,fileAppend             )
1023                                    .println( "direct"                      ,direct                 )
1024                                    .println( "zip"                         ,zip                    )
1025                                    .println( "disposition"         ,disposition    )
1026                                    .println( "tableId"                     ,tableId                )
1027                                    .println( "sheetName"           ,sheetName              )
1028                                    .println( "refSheetName"        ,refSheetName   )
1029                                    .println( "useNumber"           ,useNumber              )
1030                                    .println( "Other..."    ,getAttributes().getAttribute() )
1031                                    .fixForm().toString() ;
1032            }
1033    }