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.HybsSystemException;
019    import org.opengion.hayabusa.html.TableFormatter;
020    import org.opengion.hayabusa.html.FormatterType;
021    
022    import static org.opengion.fukurou.util.StringUtil.nval ;
023    
024    /**
025     * ヘッãƒ??フッター、ã?ãƒ?‚£ー部のフォーマットを汎用çš?�«定義するタグですã?
026     *
027     * thead,tfoot,tbody に代わる表示フォーマットをカスタマイズするときに使用する親クラスですã?
028     * こã?クラス自身がタグとしては表に現れませんã€?
029     *
030     * @og.formSample
031     * ●形式ï¼?タグとしては使われません)
032     * ●body?šあã‚?EVAL_BODY_BUFFERED:BODYを評価しã?{@XXXX} を解析しまã�?
033     *
034     * @og.rev 3.5.4.0 (2003/11/25) 新規追åŠ?
035     * @og.rev 3.5.4.2 (2003/12/15) カスタãƒ?‚¿グクラスから削除しますã?(abstractåŒ?
036     * @og.rev 4.0.0.0 (2006/01/31) カスタãƒ?‚¿グクラスに復活させますã?(publicåŒ?
037     * @og.group 画面部å“?
038     *
039     * @version  4.0
040     * @author       Kazuhiko Hasegawa
041     * @since    JDK5.0,
042     */
043    public class TFormatTag extends CommonTagSupport {
044            //* こã?プログラãƒ??VERSIONæ–?­—å?を設定しますã?       {@value} */
045            private static final String VERSION = "5.5.0.3 (2012/03/13)" ;
046    
047            private static final long serialVersionUID = 550320120313L ;
048    
049            private String rowspan          = "2";
050            private String noClass          = "false";
051            private String usableKey        = null;
052            private String usableList       = "1" ;
053            private String itdBody          = "";                   // 3.5.6.0 (2004/06/18)
054            private boolean useTrCut        = true;                 // 5.5.0.3 (2012/03/13 )
055    
056            /**
057             * Taglibの開始タグが見つかったときに処ç�?�™ã‚?doStartTag() ã‚?オーバã?ライドしますã?
058             *
059             * @og.rev 5.2.2.0 (2010/11/01) caseKey 、caseVal 属æ?対å¿?
060             *
061             * @return      後続å?ç�??æŒ?¤º( EVAL_BODY_BUFFERED )
062             */
063            @Override
064            public int doStartTag() {
065                    // 5.2.2.0 (2010/11/01) caseKey 、caseVal 属æ?対å¿?
066                    if( useTag() ) {
067                            return( EVAL_BODY_BUFFERED );   // Body を評価するã€? extends BodyTagSupport æ™?
068                    }
069                    return ( SKIP_BODY );                           // Body を評価しなã�?
070            }
071    
072            /**
073             * Taglibの終äº?‚¿グが見つかったときに処ç�?�™ã‚?doEndTag() ã‚?オーバã?ライドしますã?
074             *
075             * @og.rev 3.5.6.0 (2004/06/18) setItdBody メソãƒ?ƒ‰による itdBody の登録処ç�?¿½åŠ?
076             * @og.rev 5.1.7.0 (2010/06/01) フォーマットã?{@XXXX}の値に[が含まれる場合ã?、サイニタイズ("\\]\\"に変換)するã€?
077             * @og.rev 5.2.2.0 (2010/11/01) caseKey 、caseVal 属æ?対å¿?
078             *
079             * @return      後続å?ç�??æŒ?¤º(EVAL_PAGE)
080             */
081            @Override
082            public int doEndTag() {
083                    debugPrint();           // 4.0.0 (2005/02/28)
084                    // 5.2.2.0 (2010/11/01) caseKey 、caseVal 属æ?対å¿?
085                    if( useTag() ) {
086                            ViewFormTag viewform = (ViewFormTag)findAncestorWithClass( this,ViewFormTag.class );
087                            if( viewform == null ) {
088                                    String errMsg = "<b>こã?タグは、ViewFormTagのå†??(要ç´?に記述してくださいã€?/b>";
089                                    throw new HybsSystemException( errMsg );
090                            }
091                            // 5.1.7.0 (2010/06/01) フォーマットã?{@XXXX}の値に[が含まれる場合ã?、サイニタイズ("\\]\\"に変換)するã€?
092            //              String bodyFormat = getBodyString();
093                            String bodyFormat = getSanitizedBodyString();
094    
095                            TableFormatter format = new TableFormatter();
096                            format.setFormatType( getType() );
097    //                      format.setFormat( bodyFormat );
098                            format.setFormat( bodyFormat, useTrCut ); // 5.5.0.3 (2012/03/13)
099                            format.setRowspan( rowspan );
100                            format.setNoClass( noClass );
101                            format.setUsableKey( usableKey );
102                            format.setUsableList( usableList );
103                            format.setItdBody( itdBody );           // 3.5.6.0 (2004/06/18)
104                            viewform.addFormatter( format );
105                    }
106                    return(EVAL_PAGE);              // ペã?ジの残りを評価するã€?
107            }
108    
109            /**
110             * タグリブオブジェクトをリリースしますã?
111             * キャãƒ?‚·ュされて再利用されるã?で、フィールドã?初期設定を行いますã?
112             *
113             * @og.rev 3.5.6.0 (2004/06/18) itdBody 属æ?の追åŠ?
114             *
115             */
116            @Override
117            protected void release2() {
118                    super.release2();
119                    rowspan         = "2";
120                    noClass         = "false";
121                    usableKey       = null;
122                    usableList      = "1" ;
123                    itdBody         = "";                   // 3.5.6.0 (2004/06/18)
124            }
125    
126            /**
127             * 【TAG】表示ãƒ??タを作æ?する場合ã?フォーマットã?行数(rowspan)をセãƒ?ƒˆしまã�?初期値:2)ã€?
128             *
129             * @og.tag
130             * 表示ãƒ??タを作æ?する場合ã?フォーマットã?行数をセãƒ?ƒˆしますã?
131             * 上位ã? viewFormタグより、こちらが優先されますã?
132             *
133             * @param       span フォーマットã?行数
134             */
135            public void setRowspan( final String span ) {
136                    rowspan = span;
137            }
138    
139            /**
140             * 【TAG】カラãƒ??クラスå�?VERCHAR2,NUMBER など)を使用するかどã�?�‹[true/false]を指定しまã�?初期値:false)ã€?
141             *
142             * @og.tag
143             * "true" で、クラス属æ?を設定しません。これã?ã€?¼£?³?³ファイルに書かれてã�?‚‹属æ?ã‚?
144             * 使用しなã�?�“とを意味しますã?
145             * 初期値はã€?false" ですã?
146             *
147             * @param       flag クラス名使用の有無(true:使用しなã�?false:使用するã€?
148             */
149            public void setNoClass( final String flag ) {
150                    this.noClass = flag;
151            }
152    
153            /**
154             * こã?フォーマットã?タイプを返しますã?
155             *
156             * タイプã?ã€?head/body/foot" の中から、指定しますã?
157             *
158             * @og.rev 3.5.5.8 (2004/05/20) abstract しますã?
159             *
160             * @return      こã?フォーマットã?タイプを返しますã?
161             */
162            protected FormatterType getType() {
163                    String errMsg = "こã?メソãƒ?ƒ‰は、THead/TBody/TFoot のå�?‚µブクラスで実è£?�—てくださいã€?;
164                    throw new UnsupportedOperationException( errMsg );
165            }
166    
167    //      protected String getType() {
168    //              String errMsg = "こã?メソãƒ?ƒ‰は、THead/TBody/TFoot のå�?‚µブクラスで実è£?�—てくださいã€?;
169    //              throw new UnsupportedOperationException( errMsg );
170    //      }
171    
172            /**
173             * 【TAG】フォーマットã?使用可否を判断するキーとなるカラãƒ?��を指定しますã?
174             *
175             * @og.tag
176             * キーがã?usableList に含まれる場合ã?、このフォーãƒ?‚’使用できますã?
177             * キー(カラãƒ?��)が指定されなã�??合ã?、常に使用されますã?
178             * ※ 現時点では、BODYタイプã?み使用してã�?�¾すã?
179             *
180             * @param  key フォーマットã?使用可否を判断するカラãƒ?��
181             */
182            public void setUsableKey( final String key ) {
183                    usableKey = key;
184            }
185    
186            /**
187             * 【TAG】フォーマットã?使用可否を判断するæ–?­—å?リストをæŒ?®šしまã�?初期値:"1")ã€?
188             *
189             * @og.tag
190             * キーがã?こã?æ–?­—å?リスト中に存在する場合ã?、このフォーãƒ?‚’使用できますã?
191             * こã?æ–?­—å?リストã?、固定なæ–?­—å?ですã?{&#064;XXXX}は使用できますが、[XXXX]は
192             * 使用できませんã€?
193             * 初期値はã€?1" ですã?
194             * ※ 現時点では、BODYタイプã?み使用してã�?�¾すã?
195             *
196             * @param  list フォーマットã?使用可否を判断するæ–?­—å?リスãƒ?
197             */
198            public void setUsableList( final String list ) {
199                    usableList = nval( getRequestParameter(list),usableList );
200            }
201    
202            /**
203             *  itdフォーマット文字å?を設定しますã?
204             *
205             * itd ボディ部のæ–?­—å?を指定しますã?
206             * itd ボディは、繰り返し処ç�?‚’行いますã?これをã?上位ã?ボディæ–?­—å?の中の
207             * HYBS_ITD_MARKER æ–?­—å? と置き換えますã?
208             *
209             * @og.rev 3.5.6.0 (2004/06/18) itdフォーマット文字å?の取り込み
210             *
211             * @param  itd itdフォーマットã?æ–?­—å?
212             */
213            public void setItdBody( final String itd ) {
214                    if( itd != null ) {
215                            itdBody = itd;
216                    }
217            }
218    
219            /**
220             * 【TAGã€?先é?trタグを削除するかどã�?�‹[true/false]を指定しまã�?初期値:true)ã€?
221             *
222             * @og.tag
223             * フォーマットã?先é?がtrタグの場合ã?削除する処ç�?�Œありますがã€?
224             * CustomDataのような場合では削除したくありませんã€?
225             * falseを指定すると削除処ç�?‚’行わなã�?‚ˆã�?�«なりますã?
226             *
227             * @og.rev 5.5.0.3 (2012/03/13) 新規追åŠ?
228             *
229             * @param  useFlg  æƒ??出力をæŒ?®?[true:有効/false:無効]
230             */
231            public void setUseTrCut( final String useFlg ) {
232                    useTrCut = nval( getRequestParameter( useFlg ),useTrCut );
233            }
234    
235            /**
236             * こã?オブジェクトã?æ–?­—å?表現を返しますã?
237             * 基本çš?�«ãƒ?ƒ�ãƒ?‚°目çš?�«使用しますã?
238             *
239             * @return こã?クラスのæ–?­—å?表現
240             */
241            @Override
242            public String toString() {
243                    return org.opengion.fukurou.util.ToString.title( this.getClass().getName() )
244            //                      .println( "VERSION"             ,VERSION        )
245                                    .println( "rowspan"             ,rowspan        )
246                                    .println( "noClass"             ,noClass        )
247                                    .println( "usableKey"   ,usableKey      )
248                                    .println( "usableList"  ,usableList     )
249                                    .println( "itdBody"             ,itdBody        )
250                                    .println( "Other..."    ,getAttributes().getAttribute() )
251                                    .fixForm().toString() ;
252            }
253    }