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.fukurou.util.StringUtil;
020    import org.opengion.fukurou.util.TagBuffer;
021    
022    /**
023     * 明細棒グラフで、バー部のヘッãƒ??にã€??捗率を示す線を表示しますã?
024     *
025     * iHead タグは、ガントã? ヘッãƒ??部に使用されますã?
026     * 進捗率を示す線ã?ã€?¼’本あり、デフォルトでは、中間点とæœ?¤§値になりますã?
027     * グラフã?右に、何かを表示する場合ã?、å¹?width)を指定するå¿?¦�がありますã?
028     *
029     * @og.formSample
030     * ●形式ï¼?lt;og:iHead  ... />
031     * ●body?šなã�?
032     * ●前提:headタグで、adjustEvent="Bar" を指定してくださいã€?
033     *
034     * ●Tag定義??
035     *   <og:iHead
036     *       width              【TAG】グラフ部åˆ??横å¹?‚’[px]でæŒ?®šしますã?
037     *       leftVal            【TAG】左線ã?ヘッãƒ?ƒ¨åˆ??æ–?­—をæŒ?®šします(å?期å??š最大桁ã?半å???
038     *       leftLoc            【TAG】左線ã?ヘッãƒ?ƒ¨æ–?­—(及び線)ã?位置を左からの割合でæŒ?®šしますã?
039     *       leftBorderStyle    【TAG】左線ã?スタイルを指定しまã�?初期値=dotted gray 1px)ã€?
040     *       adjustLeft         【TAG】左線ã?ヘッãƒ?ƒ¨åˆ??æ–?­—ã?上下位置をピクセル単位でæŒ?®šしまã�?è²??数で下方å�?ã€?
041     *       rightVal           【TAG】右線ã?ヘッãƒ?ƒ¨åˆ??æ–?­—をæŒ?®šします(å?期å??š最大æ¡?¼?
042     *       rightLoc           【TAG】右線ã?ヘッãƒ?ƒ¨æ–?­—(及び線)ã?位置を左からの割合でæŒ?®šしますã?
043     *       rightBorderStyle   【TAG】右線ã?スタイルを指定しまã�?初期値=dotted gray 1px)ã€?
044     *       adjustRight        【TAG】右線ã?ヘッãƒ?ƒ¨åˆ??æ–?­—ã?上下位置をピクセル単位でæŒ?®šしまã�?è²??数で下方å�?ã€?
045     *       debug              【TAG】デバッグæƒ??をå?力するかどã�?�‹[true/false]を指定しまã�?初期値:false)
046     *   />
047     *
048     * ●使用ä¾?
049     *    <og:view
050     *        viewFormType = "HTMLCustomTable"
051     *        command      = "{@command}"
052     *        writable     = "false"
053     *        useScrollBar = "false"
054     *        headerSkipCount="10"
055     *    >
056     *      <og:thead rowspan="2">
057     *        <tr>
058     *          <td rowspan="2">[NOORDER]</td>
059     *          <td rowspan="2">
060     *              <og:iHead width="150px"
061     *                      leftVal ="now"      leftLoc ="0.8"  leftBorderStyle ="solid red 1px"    adjustLeft ="15px" 
062     *                      rightVal="Target"   rightLoc="1.0"  rightBorderStyle="dashed red 2px"   adjustRight="-15px"
063     *              />
064     *          <td rowspan="2">[SINTYOKU]</td>
065     *        </tr>
066     *      </og:thead>
067     *      <og:tbody rowspan="2">
068     *          <td rowspan="2">[NOORDER]</td>
069     *          <td rowspan="2">
070     *              <iBar id="B0_[I]" type="0" value="[SINTYOKU]" baseVal="[KNORDER]" />
071     *              <iBar id="B1_[I]" type="1" value="[KNORDER_G]" color="[COLOR]" text="[KNORDER]" />
072     *              <br/>
073     *              <iBar id="B2_[I]" type="1" value="[KNJISK_G],[KNMIKM_G]" color="black,green" />
074     *              <iBar id="B3_[I]" type="2" value="[KNJISK_G],[KNMIKM_G]" baseVal="[KNORDER_G]" color="green" />
075     *          <td rowspan="2">[SINTYOKU]</td>
076     *      </og:tbody>
077     *    </og:view>
078     *
079     * @og.rev 5.6.3.2 (2013/04/12) 新規作æ?
080     * @og.group 画面部å“?
081     *
082     * @version  5.0
083     * @author       Kazuhiko Hasegawa
084     * @since    JDK6.0,
085     */
086    public class ViewIHeadTag extends CommonTagSupport {
087            /** こã?プログラãƒ??VERSIONæ–?­—å?を設定しますã?       {@value} */
088            private static final String VERSION = "5.6.3.2 (2013/04/12)" ;
089    
090            private static final long serialVersionUID = 563220130412L ;
091    
092            private TagBuffer tag = new TagBuffer( "iHead" ) ;
093    
094            /**
095             * Taglibの終äº?‚¿グが見つかったときに処ç�?�™ã‚?doEndTag() ã‚?オーバã?ライドしますã?
096             *
097             * @return      後続å?ç�??æŒ?¤º
098             */
099            @Override
100            public int doEndTag() {
101                    debugPrint();           // 4.0.0 (2005/02/28)
102    
103                    jspPrint( tag.makeTag() );
104    
105                    return(EVAL_PAGE);              // ペã?ジの残りを評価するã€?
106            }
107    
108            /**
109             * タグリブオブジェクトをリリースしますã?
110             * キャãƒ?‚·ュされて再利用されるã?で、フィールドã?初期設定を行いますã?
111             *
112             */
113            @Override
114            protected void release2() {
115                    super.release2();
116                    tag = new TagBuffer( "iHead" );
117            }
118    
119            /**
120             * 【TAG】グラフ部åˆ??横å¹?‚’[px]でæŒ?®šしますã?
121             *
122             * @og.tag
123             * æŒ?®šしなã�??合ã?残りの横å¹??てとなりますã?
124             * グラフã?右側に何かを表示したã�??合ã?æŒ?®šするå¿?¦�がありますã?
125             * 単ä½?px)は設定不要ですã?それ以外ã?単位ã?設定できませんã€?
126             *
127             * @param   width グラフ部åˆ??横å¹?
128             */
129            public void setWidth( final String width ) {
130                    // JavaScript 側の都合で、px 単位ã?、削除しますã?
131                    String tmpW = StringUtil.nval( getRequestParameter( width ),null ) ;
132                    if( tmpW != null && tmpW.endsWith("px") ) {
133                            tmpW = tmpW.substring( 0,tmpW.length()-2 );
134                    }
135    
136                    tag.add( "width",tmpW );
137            }
138    
139            /**
140             * 【TAG】左線ã?ヘッãƒ?ƒ¨åˆ??æ–?­—をæŒ?®šします(å?期å??š最大桁ã?半å??‰ã?
141             *
142             * @og.tag
143             * 左線ã?ヘッãƒ?ƒ¨åˆ?�«表示するæ–?­—をæŒ?®šしますã?
144             * 左線ã?、中間データ、またã?ã€??中経過を意味しますã?で、その様な単語にしますã?
145             * なにも指定しなã�??合ã?、右側が最大桁以下をåˆ?‚Š捨てした値となりã?左側はそã?半å?の値ですã?
146             * leftValに関してはã€?.4,0.4のようにè¤?•°の値をカンマ区åˆ?‚Šで書く事が可能ですã?
147             *
148             * @param   leftVal 左線ã?ヘッãƒ?ƒ¨åˆ??æ–?­?
149             */
150            public void setLeftVal( final String leftVal ) {
151                    tag.add( "leftVal",StringUtil.nval( getRequestParameter( leftVal ),null ) );
152            }
153    
154            /**
155             * 【TAG】左線ã?ヘッãƒ?ƒ¨æ–?­—(及び線)ã?位置を左からの割å�?少数)でæŒ?®šしますã?
156             *
157             * @og.tag
158             * グラフå¹??体を1として、左からの割合でæŒ?®šしますã?(左ã�?.3で右ã�?.9など??
159             * leftLocに関してはã€?.4,0.4のようにè¤?•°の値をカンマ区åˆ?‚Šで書く事が可能ですã?
160             *
161             * @param   leftLoc 左線ã?ヘッãƒ?ƒ¨æ–?­—(及び線)ã?位置の割å�?少数)
162             */
163            public void setLeftLoc( final String leftLoc ) {
164                    tag.add( "leftLoc",StringUtil.nval( getRequestParameter( leftLoc ),null ) );
165            }
166    
167            /**
168             * 【TAG】左線ã?スタイルを指定しまã�?初期値=dotted gray 1px)ã€?
169             *
170             * @og.tag
171             * グラフに引かれる左線ã?スタイルを指定しますã?
172             * 初期値は、dotted gray 1px ですã?
173             *
174             * @param   leftBorderStyle 左線ã?ヘッãƒ?ƒ¨æ–?­—(及び線)ã?位置の割å�?少数)
175             */
176            public void setLeftBorderStyle( final String leftBorderStyle ) {
177                    tag.add( "leftBorderStyle",StringUtil.nval( getRequestParameter( leftBorderStyle ),null ) );
178            }
179    
180            /**
181             * 【TAG】左線ã?ヘッãƒ?ƒ¨åˆ??æ–?­—ã?上下位置をピクセル単位でæŒ?®šしまã�?è²??数で下方å�?ã€?
182             *
183             * @og.tag
184             * 左右のæ–?­—が重なる可能性があるå?合に利用しますã?
185             * 10とæŒ?®šするとã€?0マイナスされてæ–?­—が上方向にずれますã?
186             * è²??数を指定すると、文字が下方向にずれますã?
187             * 単ä½?px)は設定不要ですã?それ以外ã?単位ã?設定できませんã€?
188             *
189             * @param   adjustLeft æ–?­—ã?上下位置æŒ?®?
190             */
191            public void setAdjustLeft( final String adjustLeft ) {
192                    // JavaScript 側の都合で、px 単位ã?、削除しますã?
193                    String tmpA = StringUtil.nval( getRequestParameter( adjustLeft ),null ) ;
194                    if( tmpA != null && tmpA.endsWith("px") ) {
195                            tmpA = tmpA.substring( 0,tmpA.length()-2 );
196                    }
197    
198                    tag.add( "adjustLeft",tmpA );
199            }
200    
201            /**
202             * 【TAG】右線ã?ヘッãƒ?ƒ¨åˆ??æ–?­—をæŒ?®šします(å?期å??š最大æ¡?¼‰ã?
203             *
204             * @og.tag
205             * 右線ã?ヘッãƒ?ƒ¨åˆ?�«表示するæ–?­—をæŒ?®šしますã?
206             * 右線ã?、最終データ、またã?、最大ãƒ??タを意味しますã?で、その様な単語にしますã?
207             * なにも指定しなã�??合ã?、右側が最大桁以下をåˆ?‚Š捨てした値となりã?左側はそã?半å?の値ですã?
208             *
209             * @param   rightVal 左線ã?ヘッãƒ?ƒ¨åˆ??æ–?­?
210             */
211            public void setRightVal( final String rightVal ) {
212                    tag.add( "rightVal",StringUtil.nval( getRequestParameter( rightVal ),null ) );
213            }
214    
215            /**
216             * 【TAG】右線ã?ヘッãƒ?ƒ¨æ–?­—(及び線)ã?位置を左からの割å�?少数)でæŒ?®šしますã?
217             *
218             * @og.tag
219             * グラフå¹??体を1として、左からの割合でæŒ?®šしますã?(左ã�?.3で右ã�?.9など??
220             *
221             * @param   rightLoc 右線ã?ヘッãƒ?ƒ¨æ–?­—(及び線)ã?位置の割å�?少数)
222             */
223            public void setRightLoc( final String rightLoc ) {
224                    tag.add( "rightLoc",StringUtil.nval( getRequestParameter( rightLoc ),null ) );
225            }
226    
227            /**
228             * 【TAG】右線ã?スタイルを指定しまã�?初期値=dotted gray 1px)ã€?
229             *
230             * @og.tag
231             * グラフに引かれる右線ã?スタイルを指定しますã?
232             * 初期値は、dotted gray 1px ですã?
233             *
234             * @param   rightBorderStyle 左線ã?ヘッãƒ?ƒ¨æ–?­—(及び線)ã?位置の割å�?少数)
235             */
236            public void setRightBorderStyle( final String rightBorderStyle ) {
237                    tag.add( "rightBorderStyle",StringUtil.nval( getRequestParameter( rightBorderStyle ),null ) );
238            }
239    
240            /**
241             * 【TAG】右線ã?ヘッãƒ?ƒ¨åˆ??æ–?­—ã?上下位置をピクセル単位でæŒ?®šしまã�?è²??数で下方å�?ã€?
242             *
243             * @og.tag
244             * 左右のæ–?­—が重なる可能性があるå?合に利用しますã?
245             * 10とæŒ?®šするとã€?0マイナスされてæ–?­—が上方向にずれますã?
246             * è²??数を指定すると、文字が下方向にずれますã?
247             * 単ä½?px)は設定不要ですã?それ以外ã?単位ã?設定できませんã€?
248             *
249             * @param   adjustRight æ–?­—ã?上下位置æŒ?®?
250             */
251            public void setAdjustRight( final String adjustRight ) {
252                    // JavaScript 側の都合で、px 単位ã?、削除しますã?
253                    String tmpA = StringUtil.nval( getRequestParameter( adjustRight ),null ) ;
254                    if( tmpA != null && tmpA.endsWith("px") ) {
255                            tmpA = tmpA.substring( 0,tmpA.length()-2 );
256                    }
257    
258                    tag.add( "adjustRight",tmpA );
259            }
260    
261            /**
262             * タグの名称をã?返しますã?
263             * 自åˆ??身のクラス名よりã?自動的に取り出せなã�?�Ÿめã?こã?メソãƒ?ƒ‰をオーバã?ライドしますã?
264             *
265             * @return  タグの名称
266             */
267            @Override
268            protected String getTagName() {
269                    return "iHead" ;
270            }
271    
272            /**
273             * こã?オブジェクトã?æ–?­—å?表現を返しますã?
274             * 基本çš?�«ãƒ?ƒ�ãƒ?‚°目çš?�«使用しますã?
275             *
276             * @return こã?クラスのæ–?­—å?表現
277             */
278            @Override
279            public String toString() {
280                    return org.opengion.fukurou.util.ToString.title( this.getClass().getName() )
281                                    .println( "VERSION"             ,VERSION        )
282                                    .println( "tag"                 ,tag.makeTag()  )
283                                    .println( "Other..."    ,getAttributes().getAttribute() )
284                                    .fixForm().toString() ;
285            }
286    }