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    
020    import static org.opengion.fukurou.util.StringUtil.nval;
021    
022    import java.util.concurrent.atomic.AtomicInteger;       // 5.5.2.6 (2012/05/25) findbugs対å¿?
023    
024    /**
025     * 表示のON/OFF制御がå?来るフィールドセãƒ?ƒˆを作æ?するタグですã?
026     *
027     * フィールドセãƒ?ƒˆは関連するフォーãƒ??部品やラベルをグループ化する要ç´?�§ã€?
028     * 表示のON/OFF制御がå?来ますã?
029     * BODY 部åˆ?�«るフォーãƒ?ƒ¨品などのタグを記述すれば、そのままタイトル付きのグループ化
030     * された状態を作æ?できますã?
031     * useDisplayHide="false" で通常の fieldset と同じ機è?になりますã?通常、useDisplayHide="true"
032     * にすることで、タイトル部(ä¸?ˆ¬のlegendタグ)をクリãƒ?‚¯すると、表示がON/OFFしますã?
033     * useDisplayHide の初期値は、true(表示 ON/OFF機è?を使用する)ですã?
034     * 表示機è?が使用できる状æ…?useDisplayHide="true")では、さらに、å?期表示を行うかどã�?�‹ã‚?
035     * æŒ?®šできますã?これは、defaultNone="true" とすると初期表示は "style=display:none;" に
036     * 設定さã‚?つまりã?表示されなã�?жæ…?、defaultNone="false" とすると初期表示されますã?
037     * defaultNone の初期値は、true(表示されなã�?жæ…?ですã?
038     * こã?タグにはã€??常、第ä¸?¦�ç´?�¨してBODY部に記述する legendタグ は設定不要ですã?
039     * こã?タグの lbl 属æ?に、リソースæƒ??を記述することで、直接 legendタグ ã‚?
040     * 生æ?してã�?�¾すã?
041     *
042     * @og.formSample
043     * ●形式ï¼?lt;og:fieldset
044     *                    lbl="…"                      ラベルリソースのキー
045     *                  [ useDisplayHide="true" ]       表示 ON/OFF機è?を使用する(true)かどã�?�‹
046     *                  [ useDisplayHide="true" ]       初期値を表示ON(false)にするかOFF(true)にするã�?
047     *         >
048     *             <input …" />
049     *             <input …" />
050     *         </og:fieldset>
051     * ●body?šあã‚?EVAL_BODY_INCLUDE:BODYをインクルードし、{@XXXX} は解析しません)
052     *
053     * ●Tag定義??
054     *   <og:fieldset
055     *       lbl                【TAG】ラベルリソースのラベルIDを指定しまã�?
056     *       useDisplayHide     【TAG】表示 ON/OFF機è?を使用するかどã�?�‹[true/false]を指定しまã�?初期値:true)
057     *       defaultNone        【TAG】表示ON/OFF機è?を使用する場合ã?初期値をã?éš?�—(none)にするかどã�?�‹[true/false]を指定しまã�?初期値:true)
058     *       caseKey            【TAG】このタグ自体を利用するかどã�?�‹の条件キーを指定しまã�?初期値:null) 5.7.7.2 (2014/06/20)
059     *       caseVal            【TAG】このタグ自体を利用するかどã�?�‹の条件値を指定しまã�?初期値:null) 5.7.7.2 (2014/06/20)
060     *       caseNN             【TAG】指定ã?値がã?null/ゼロæ–?­—å? でなã�??å�?Not Null=NN)は、このタグは使用されまã�?初期値:true) 5.7.7.2 (2014/06/20)
061     *       caseNull           【TAG】指定ã?値がã?null/ゼロæ–?­—å? の場合ã?、このタグは使用されまã�?初期値:true) 5.7.7.2 (2014/06/20)
062     *       debug              【TAG】デバッグæƒ??をå?力するかどã�?�‹[true/false]を指定しまã�?初期値:false)
063     *   >   ... Body ...
064     *   </og:fieldset>
065     *
066     * ●使用ä¾?
067     *    例ï¼?通常の状態ã?表示ON/OFF機è?を使用しã?初期値は表示OFF 状æ…?
068     *     <og:fieldset lbl="INSERT_GEA11" >
069     *         <og:submit  value="insertGEA11" lbl="COPY" command="COPY" />
070     *         <og:column  name="SYSTEM_ID" useRequestValue="false" must="true" td="no" />
071     *     </og:fieldset>
072     *
073     *    例ï¼?通常の状態ã?表示ON/OFF機è?を使用しã?初期値は表示ON 状æ…?
074     *     <og:fieldset lbl="GEM0001" defaultNone="false" >
075     *         <og:column  name="SYSTEM_ID" useRequestValue="false" must="true" td="no" />
076     *     </og:fieldset>
077     *
078     * @og.rev 4.0.0.0 (2005/11/30) 新規作æ?
079     * @og.group 画面部å“?
080     *
081     * @version  4.0
082     * @author   Kazuhiko Hasegawa
083     * @since    JDK5.0,
084     */
085    public class FieldsetTag extends CommonTagSupport {
086            //* こã?プログラãƒ??VERSIONæ–?­—å?を設定しますã?       {@value} */
087            private static final String VERSION = "5.7.7.2 (2014/06/20)" ;
088    
089            private static final long serialVersionUID = 577220140620L ;
090    
091            private static AtomicInteger uniqID = new AtomicInteger(1);             // 5.5.2.6 (2012/05/25) findbugs対å¿?
092    
093            private boolean useDisplayHide  = true;         // 表示 ON/OFF機è?を使用する(true)かどã�?�‹
094            private boolean defaultNone             = true;         // 初期値を表示ON(false)にするかOFF(true)にするã�?
095    
096            /**
097             * Taglibの開始タグが見つかったときに処ç�?�™ã‚?doStartTag() ã‚?オーバã?ライドしますã?
098             *
099             * @og.rev 3.8.5.2 (2006/05/31) 初期値:defaultNone ã‚?hidden で出力しておくã€?
100             * @og.rev 5.5.2.6 (2012/05/25) findbugs対応ã?staticフィールドへの書き込みに、AtomicInteger を利用しますã?
101             * @og.rev 5.7.7.2 (2014/06/20) caseKey,caseVal,caseNN,caseNull 属æ?を追åŠ?
102             *
103             * @return      後続å?ç�??æŒ?¤º( EVAL_BODY_INCLUDE )
104             */
105            @Override
106            public int doStartTag() {
107                    // 5.7.7.2 (2014/06/20) caseKey,caseVal,caseNN,caseNull 属æ?を追åŠ?
108                    if( !useTag() ) { return SKIP_BODY ; }
109    
110                    String id = String.valueOf( uniqID.getAndIncrement() ); // 5.5.2.6 (2012/05/25) findbugs対å¿?
111    
112                    String hideFunc = "";
113                    String onoffMsg = "";
114                    String divBody  = "";
115                    String hiddenVal = "";
116    
117                    if( useDisplayHide ) {
118                            hideFunc = " onClick=\"hide( \'FS" + id + "\' );\"" ;
119                            divBody  = "<div id=\"FS" + id + "A\" style=\"display:" ;
120                            hiddenVal = "<input type=\"hidden\" name=\"FS" + id + "C\" value=\"" + defaultNone + "\" />" ;
121                            if( defaultNone ) {
122                                    onoffMsg = "<span id=\"FS" + id + "B\" >+ </span>";
123                                    divBody += "none;\" >" ;
124                            }
125                            else {
126                                    onoffMsg = "<span id=\"FS" + id + "B\" >- </span>";
127                                    divBody += "inline;\" >" ;
128                            }
129                    }
130    
131                    StringBuilder buf = new StringBuilder( HybsSystem.BUFFER_MIDDLE );
132                    buf.append( "<fieldset style=\"display:inline;\">" ).append( HybsSystem.CR );
133                    buf.append( "<legend" ).append( hideFunc ).append( ">" );
134                    buf.append( "<strong>" ).append( onoffMsg );
135                    buf.append( getLongLabel() );
136                    buf.append( "</strong></legend>" ).append( HybsSystem.CR );
137                    buf.append( divBody );
138                    buf.append( HybsSystem.CR );
139                    buf.append( hiddenVal );
140                    buf.append( HybsSystem.CR );
141    
142                    jspPrint( buf.toString() );
143                    return EVAL_BODY_INCLUDE ;      // Body インクルーãƒ? extends TagSupport æ™?
144            }
145    
146            /**
147             * Taglibの終äº?‚¿グが見つかったときに処ç�?�™ã‚?doEndTag() ã‚?オーバã?ライドしますã?
148             *
149             * @og.rev 5.7.7.2 (2014/06/20) caseKey,caseVal,caseNN,caseNull 属æ?を追åŠ?
150             *
151             * @return      後続å?ç�??æŒ?¤º
152             */
153            @Override
154            public int doEndTag() {
155                    debugPrint();           // 4.0.0 (2005/02/28)
156    
157                    // 5.7.7.2 (2014/06/20) caseKey,caseVal,caseNN,caseNull 属æ?を追åŠ?
158                    if( useTag() ) {
159                            if( useDisplayHide ) {
160                                    jspPrint( "</div></fieldset>" + HybsSystem.CR );
161                            }
162                            else {
163                                    jspPrint( "</fieldset>" + HybsSystem.CR );
164                            }
165                    }
166    
167                    return EVAL_PAGE ;              // ペã?ジの残りを評価するã€?
168            }
169    
170            /**
171             * タグリブオブジェクトをリリースしますã?
172             * キャãƒ?‚·ュされて再利用されるã?で、フィールドã?初期設定を行いますã?
173             *
174             */
175            @Override
176            protected void release2() {
177                    super.release2();
178                    useDisplayHide  = true;
179                    defaultNone             = true;
180            }
181    
182            /**
183             * 【TAG】表示 ON/OFF機è?を使用するかどã�?�‹[true/false]を指定しまã�?初期値:true)ã€?
184             *
185             * @og.tag
186             * 表示 ON/OFF機è?を使用する場合ã?、true / 通常の fieldset を使用する場合ã?ã€?
187             * false を指定しますã?
188             * 初期値は、true(ON/OFF機è?を使用する)ですã?
189             *
190             * @param       flag 表示 ON/OFF機è? [true:使用する/false:使用しない]
191             * @see         #setDefaultNone( String )
192             */
193            public void setUseDisplayHide( final String flag ) {
194                    useDisplayHide = nval( getRequestParameter( flag ),useDisplayHide ) ;
195            }
196    
197            /**
198             * 【TAG】表示ON/OFF機è?を使用する場合ã?初期値をã?éš?�—(none)にするかどã�?�‹[true/false]を指定しまã�?初期値:true)ã€?
199             *
200             * @og.tag
201             * 表示 ON/OFF機è?を使用する場合にのみ設定å?は有効に機è?しますã?
202             * éš?�—(none)にする場合ã?、true をã?表示にする場合ã?、false をセãƒ?ƒˆしますã?
203             * 初期値は、true(éš?�—(none)にする)ですã?
204             *
205             * @param       flag 表示ON/OFF機è?の初期値を隠しにするかどã�?�‹ [true:éš?�—(none)にする/false:表示にする]
206             * @see         #setUseDisplayHide( String )
207             */
208            public void setDefaultNone( final String flag ) {
209                    defaultNone = nval( getRequestParameter( flag ),defaultNone ) ;
210            }
211    
212            /**
213             * こã?オブジェクトã?æ–?­—å?表現を返しますã?
214             * 基本çš?�«ãƒ?ƒ�ãƒ?‚°目çš?�«使用しますã?
215             *
216             * @return こã?クラスのæ–?­—å?表現
217             */
218            @Override
219            public String toString() {
220                    return org.opengion.fukurou.util.ToString.title( this.getClass().getName() )
221                                    .println( "VERSION"                     ,VERSION                                                )
222                                    .println( "key"                         ,getLabelInterface().getKey()   )
223                                    .println( "msglbl"                      ,getMsglbl()                                    )
224                                    .println( "useDisplayHide"      ,useDisplayHide                                 )
225                                    .println( "defaultNone"         ,defaultNone                                    )
226                                    .println( "Other..."            ,getAttributes().getAttribute() )
227                                    .fixForm().toString() ;
228            }
229    }