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.fukurou.db.ConnectionFactory;
019    import org.opengion.fukurou.util.StringUtil;
020    import org.opengion.hayabusa.common.HybsSystem;
021    import org.opengion.hayabusa.common.HybsSystemException;
022    import org.opengion.hayabusa.io.ChartDataset;
023    import org.opengion.hayabusa.db.DBTableModel;
024    
025    import java.sql.SQLException;
026    import java.sql.Connection;
027    import java.io.ObjectOutputStream;
028    import java.io.ObjectInputStream;
029    import java.io.IOException;
030    
031    /**
032     * BODY部にæŒ?®šã?SQLの検索結果をグラãƒ?å†??棒ã?ç·?で表示するタグですã?
033     *
034     * グラフ化には、JFreeChart (http://www.jfree.org/jfreechart/) を使用してã�?�¾すã?
035     * chartType 属æ?には、ChartFactoryクラスで定義された変換表に基づくã?チャートã?
036     * 種類をæŒ?®šしますã?こã?キーから、レンãƒ?ƒ©ーã‚?ƒ‡ータセãƒ?ƒˆクラスを求めますã?
037     * それぞれのクラス毎に細かい設定å?がありますが、å?期レベルとしましては、主要チャートã?
038     * 主要属æ?のみサポã?トしますã?またã?æŒ?®šã? chartType では使用しなã�?±žæ?を指定したå?合でã‚?
039     * 単に無視するだけで、警告等ã?ありませんので、ご注意くã�?�•ã�??
040     *
041     * å�?±žæ?は、{@XXXX} 変数が使用できますã?
042     * これは、ServletRequest から、XXXX をキーに値を取りå?ã�?こã?変数に割り当てますã?
043     * つまりã?こã?XXXXをキーにリクエストすれã?、この変数に値をセãƒ?ƒˆすることができますã?
044     *
045     * useTableData="false"(初期値)の場合ã?、BODY部に書かれã�?SQL æ–?‚’実行してãƒ??タを取得しますã?
046     * useTableData="true" にすると、その前ã? query タグ等で作æ?した DBTableModel を利用して
047     * グラフ化しますã?そã?場合ã?、BODY部の SQL æ–??、無視されますã?
048     * 利用する DBTableModel は、tableId と scope 属æ?から取得しますã?
049     *
050     * @og.formSample
051     * ●形式ï¼?lt;og:chartDataset renderer="…" … />
052     * ●body?šあã‚?EVAL_BODY_BUFFERED:BODYを評価しã?{@XXXX} を解析しまã�?
053     *
054     * ●Tag定義??
055     *   <og:chartDataset
056     *       chartType        ○ã?TAG】ChartDataset のãƒ??タタイプをæŒ?®šしまã�?å¿??)ã€?
057     *       dbid               【TAGã€?通常は使ã�?�¾せん)Datasetオブジェクトを作æ?する時ã?DB接続IDを指定しまã�?
058     *       useTableData       【TAG】グラフ化するãƒ??タã‚?DBTableModel から作æ?するかどã�?�‹(初期値:false)
059     *       tableId            【TAGã€?通常使ã�?�¾せん)sessionからæ‰?¾—すã‚?DBTableModelオブジェクトã? ID (初期値:HybsSystem#TBL_MDL_KEY[=h_tblmdl])
060     *       scope              【TAG】キャãƒ?‚·ュする場合ã?スコープ[request/page/session/applicaton]を指定しまã�?初期値:session)
061     *       baseLegend         【TAG】シリーズ単位ã?凡ä¾?の表示可否を設定しまã�?
062     *       valueLabel         【TAG】縦軸の表示名称を指定しまã�?
063     *       markValues         【TAG】ã?ーカーラインの設定å?をカンマ区åˆ?‚Š形式でè¤?•°æŒ?®šしまã�?
064     *       markColors         【TAG】ã?ーカーラインの色をカンマ区åˆ?‚Š形式でè¤?•°æŒ?®šしまã�?
065     *       markOverColors     【TAG】ã?ーカーラインのè¶?�Ž時ã?Shape色をカンマ区åˆ?‚Š形式でè¤?•°æŒ?®šしまã�?
066     *       dynamicOCNo        【TAG】動çš?�ªマã?カーラインの基準シリーズ番号を設定しまã�?初期値:null)
067     *       useMarkAnchor      【TAG】ã?ーカーライン描画時に、その設定å?を表示しまã�?
068     *       lowerBound         【TAG】チャートã?縦軸のæœ?°�å?をセãƒ?ƒˆしまã�?初期値:自動計ç®?
069     *       upperBound         【TAG】チャートã?縦軸のæœ?¤§値をセãƒ?ƒˆしまã�?初期値:自動計ç®?
070     *       tickSize           【TAG】チャートã?縦軸の目盛ã?å¹?‚’セãƒ?ƒˆしまã�?初期値:自動計ç®?
071     *       useGradient        【TAG】バーチャートã?グラãƒ??ション処ç�?‚’行うかどã�?�‹[true/false]をセãƒ?ƒˆしまã�?初期値:false)
072     *       shapesVisible      【TAG】ラインチャートã?ポイントを四角表示するかどã�?�‹を指定しまã�?初期値:true)
073     *       shapeColors        【TAG】データ毎にShapeをå?り替える時ã?色の繰返しパターンを文字å?配å?でæŒ?®šしまã�?
074     *       shapeScale         【TAG】shapeの大きさをå?çŽ?Œ‡定で変更しまã�?初期値:null)
075     *       useDottedLine      【TAG】ラインチャートã?線をドットラインにするかどã�?�‹[true/false]を指定しまã�?初期値:false 線å?)
076     *       seriesColors       【TAG】è¤?•°チャート描画時ã?チャート色の繰返しパターンをCVS形式でè¤?•°æŒ?®šしまã�?
077     *       valueLabelsVisible 【TAG】Value(縦軸)のラベルを表示するかどã�?�‹を指定しまã�?初期値:true[表示する])
078     *       valueMarksVisible  【TAG】Value(縦軸)のマã?カーを表示するかどã�?�‹を指定しまã�?初期値:true[表示する])
079     *       itemLabelVisible   【TAG】データの値(itemText)を表示するかどã�?�‹[true/false/last]を指定しまã�?初期値:false[表示しない])
080     *       useItemLabelSep    【TAG】データの値(itemText)の表示に、桁区åˆ?‚Šæ–?­—を使用するかどã�?�‹[true/false]を指定しまã�?初期値:true[使用する])
081     *       valueInset         【TAG】縦軸の表示領域INSET値(double)を指定しまã�?
082     *       barMaxWidth        【TAG】BOXチャートã?バã?å¹??æœ?¤§値(0.0??.0)を指定しまã�?
083     *       barItemMargin      【TAG】BOXチャートã?バã?アイãƒ?ƒ のマã?ジン(0.0??.0)を指定しまã�?
084     *       barWidth           【TAG】BOXチャートã?バã?å¹?double)を指定しまã�?
085     *       visibleLimit       【TAG】表示下限値(これ以下ã?ãƒ??タは未表示)の値(double)を指定しまã�?
086     *       domainMargin       【TAG】グラフã?書きå?し位置の調整比率を指定しまã�?
087     *       timeFormatType     【TAG】時刻を表すå?合ã?表現の仕方[E1/E2/E3/H1/H2/H3]を指定しまã�?初期値:null)
088     *       useVerticalLabels  【TAG】ラベルの表示向きを縦にするかどã�?�‹[false/true]を指定しまã�?初期値:false)
089     *       debug              【TAG】デバッグæƒ??をå?力するかどã�?�‹[true/false]を指定しまã�?初期値:false)
090     *   >   ... Body ...
091     *   </og:chartDataset>
092     *
093     * ●使用ä¾?
094     *      <og:chartCreate
095     *          command     = "{@command}"
096     *          title       = "{@title}"
097     *          domainLabel = "{@domainLabel}"
098     *          width       = "{@width}"
099     *          height      = "{@height}"
100     *          rectangleEdge   = "{@rectangleEdge}"
101     *          plotOrientation = "{@plotOrientation}"
102     *          chartBackColor  = "{@chartBackColor}"
103     *          plotBackColor   = "{@plotBackColor}"
104     *          domainMarker    = "{@domainMarker}"
105     *          useMarkerLabel  = "{@useMarkerLabel}" >
106     *              <og:chartDataset
107     *                  chartType   = "[Bar|LineAndShape|?¥?¥?¥]"      チャートã?種é¡?
108     *                  baseLegend  = "[true|false]"                シリーズ単位ã?凡ä¾?の表示可否
109     *                  valueLabel  = "縦軸"                        縦軸のラベル
110     *                  lowerBound  = "0"                           下限値
111     *                  upperBound  = "5000"                        上限値
112     *                  tickSize    = "1000"                        縦軸の目盛ã?å¹?
113     *                  markValues  = "2500,2800"                   縦軸設定å?(横æ£?
114     *                  markColors  = "RED,GREEN"                   縦軸設定ライン色
115     *                  markOverColors = "BLUE,YELLOW,RED"          マã?カーラインのè¶?�Ž時ã?Shape色
116     *                  dynamicOCNo   = "2"                         動的なマã?カーラインの基準シリーズ番号
117     *                  useMarkAnchor = "[true|false]"              縦軸設定å?(横æ£?を表示するかどã�?�‹
118     *                  useGradient   = "[false|true]"              バã?チャートã?グラãƒ??ション処ç�?
119     *                  shapesVisible = "[true|false]"              ラインの四角表示
120     *                  shapeColors   = "RED,GREEN,BLUE"            ãƒ??タ毎ã?Shapeの色
121     *                  shapeScale    = "0.8"                       shapeの大きさの倍率(double)
122     *                  useDottedLine = "[false|true]"              点線使用有無
123     *                  seriesColors  = "RED,GREEN,BLUE"            シリーズの色サイクルæŒ?®?
124     *                  valueLabelsVisible = "[true|false]"         縦軸のラベルの表示有無
125     *                  valueMarksVisible  = "[true|false]"         縦軸のマã?カーの表示有無
126     *                  itemLabelVisible   = "[false|true|last]"    ãƒ??タの値の表示有無
127     *                  useItemLabelSep    = "[true|false]"         ãƒ??タの桁区åˆ?‚Šæ–?­—ã?使用有無
128     *                  valueInset         = "15"                   縦軸の表示領域INSET値
129     *                  barMaxWidth        = "[0.0??.0]"           バã?å¹??æœ?¤§値(0.0??.0)
130     *                  barItemMargin      = "[0.0??.0]"           バã?アイãƒ?ƒ のマã?ジン(0.0??.0)
131     *                  barWidth           = "10"                   バã?å¹??実å¹?double)
132     *                  visibleLimit       = "0"                    表示下限値(これ以下ã?ãƒ??タは未表示))
133     *                  domainMargin       = "1.0"                  グラフã?書きå?し位置の調整比率
134     *                  useTableData       = "[false|true]"         SQLではなくã?DBTableModelからグラフを作æ?するかどã�?�‹
135     *                  timeFormatType     = "[1|2]"                時間軸の設å®?00:00表示)
136     *                  useVerticalLabels  = "[false|true]"         時間軸の設å®?ラベルの縦書ã�?
137     *                  tableId            = "AAA"                  useTableData="true"の場合ã?DBTableModelの取得å?ID
138     *                  scope              = "[session|request]"    useTableData="true"の場合ã?DBTableModelの取得å?scope
139     *              >
140     *                         {@SQL}
141     *              </og:chartDataset>
142     *      </og:chartCreate>
143     *
144     *    è¤?•°のグラフを重ã?合わせる場合ã?、chartDataset タグã‚?chartCreate のBODY部に
145     *    è¤?•°記述しますã?
146     *      <og:chartCreate
147     *          title       = "{@title}"
148     *          domainLabel = "{@domainLabel}"
149     *          width       = "{@width}"
150     *          height      = "{@height}" >
151     *          rectangleEdge   = "{@rectangleEdge}" >
152     *          plotOrientation = "{@plotOrientation}" >
153     *              <og:chartDataset
154     *                  chartType   = "{@chartType1}"
155     *                  valueLabel  = "{@valueLabel1}"
156     *                  lowerBound  = "{@lowerBound1}"
157     *                  upperBound  = "{@upperBound1}"
158     *                  markValues  = "{@markValues1}"
159     *                  markColors  = "{@markColors1}"
160     *              >
161     *                         {@SQL1}
162     *              </og:chartDataset>
163     *              <og:chartDataset
164     *                  chartType   = "{@chartType2}"
165     *                  valueLabel  = "{@valueLabel2}"
166     *                  lowerBound  = "{@lowerBound2}"
167     *                  upperBound  = "{@upperBound2}"
168     *                  markValues  = "{@markValues2}"
169     *                  markColors  = "{@markColors2}"
170     *              >
171     *                         {@SQL2}
172     *              </og:chartDataset>
173     *      </og:chartCreate>
174     *
175     *    chartType属æ? は、チャートã?種類をæŒ?®šするã?固有IDですã?
176     *    [chartType属æ?]
177     *      Area            , Bar               , Bar3D          , BoxAndWhisker    , CategoryStep  ,
178     *      Gantt           , GroupedStackedBar , IntervalBar    , LayeredBar       , Level         ,
179     *      LineAndShape    , Line3D            , MinMax         , StackedArea      , StackedBar    ,
180     *      StackedBar3D    , WaterfallBar      , CyclicXYItem   , HighLow          , StackedXYArea ,
181     *      StackedXYArea2  , StandardXYItem    , XYBubble       , XYDifference     , XYDot         ,
182     *      XYError         , XYLine3D          , XYLineAndShape , XYStepArea       , XYStep        ,
183     *      Meter           , MultiplePie       , Pie            , Pie3D            , Ring          ,
184     *      SpiderWeb       , Thermometer
185     *
186     *    markColors属æ? は、ã?ーカーラインの色を指定しまã�?
187     *    java.awt.Color クラスのstatic フィールド名のæ–?­—å?でæŒ?®šしますã?
188     *    [renderer属æ?]
189     *      BLACK   , BLUE   , CYAN , DARK_GRAY , GRAY  , GREEN , LIGHT_GRAY ,
190     *      MAGENTA , ORANGE , PINK , RED       , WHITE , YELLOW
191     *      #XXXXXX形式ã?16bitRGB表è¨?
192     *
193     * @og.group 画面表示
194     *
195     * @version  0.9.0      2007/06/19
196     * @author       Nakamura
197     * @since        JDK1.4,
198     */
199    public class ChartDatasetTag extends CommonTagSupport {
200            //* こã?プログラãƒ??VERSIONæ–?­—å?を設定しますã?       {@value} */
201            private static final String VERSION = "5.5.2.1 (2012/05/07)" ;
202    
203            private static final long serialVersionUID = 552120120507L ;
204    
205            private transient ChartDataset chDataset = new ChartDataset();
206    
207            // 4.0.0.0 (2007/10/10) dbid の初期値をã?"DEFAULT" から null に変更
208    //      private String  dbid    = "DEFAULT";
209            private String  dbid    = null;
210            private String  sql             = null;
211    
212            // 5.3.0.0 (2010/12/01) DBTableModel を利用して、グラフを作æ?しますã?
213            private boolean useTableData    = false;                // 互換性の関係かã‚?
214            private String  tableId                 = HybsSystem.TBL_MDL_KEY;
215    
216            /**
217             * Taglibの開始タグが見つかったときに処ç�?�™ã‚?doStartTag() ã‚?オーバã?ライドしますã?
218             *
219             * @og.rev 5.3.0.0 (2010/12/01) useTableDataによるãƒ??タ取得方法ã?機è?追åŠ?
220             *
221             * @return      後続å?ç�??æŒ?¤º( EVAL_BODY_BUFFERED )
222             */
223            @Override
224            public int doStartTag() {
225                    // 5.3.0.0 (2010/12/01) useTableDataによるãƒ??タ取得方法ã?機è?追åŠ?
226    //              return( EVAL_BODY_BUFFERED );   // Body を評価するã€? extends BodyTagSupport æ™?
227    
228                    if( useTableData ) {    // DBTableModel から取得するã?
229                            DBTableModel table = (DBTableModel)getObject( HybsSystem.TBL_MDL_KEY );
230                            chDataset.makeDataset( table );
231    
232                            return( SKIP_BODY );                    // Body を評価しなã�?
233                    }
234                    else {
235                            return( EVAL_BODY_BUFFERED );   // Body を評価するã€? extends BodyTagSupport æ™?
236                    }
237            }
238    
239            /**
240             * Taglibのタグ本体を処ç�?�™ã‚?doAfterBody() ã‚?オーバã?ライドしますã?
241             *
242             * @og.rev 5.3.0.0 (2010/12/01) ãƒ??タベã?ス検索処ç�?‚’、doEndTag() メソãƒ?ƒ‰から移å‹?
243             *
244             * @return      後続å?ç�??æŒ?¤º(SKIP_BODY)
245             */
246            @Override
247            public int doAfterBody() {
248                    sql = getBodyString();
249                    if( sql != null && sql.length() > 0 ) {
250                            sql = sql.trim();
251                    }
252    
253                    // 5.3.0.0 (2010/12/01) doEndTag() メソãƒ?ƒ‰から移å‹?
254                    boolean errFlag = true;
255    //              Connection conn = ConnectionFactory.connection( dbid,getApplicationInfo() );
256                    Connection conn = null;
257                    try {
258                            conn = ConnectionFactory.connection( dbid,getApplicationInfo() );
259                            chDataset.makeDataset( conn,sql );
260                            errFlag = false;                // エラーではなã�?
261                    }
262                    catch( SQLException ex ) {
263                            String errMsg = "ãƒ??タセãƒ?ƒˆ作æ?時にエラーが発生しましたã€? + HybsSystem.CR
264                                                    + " SQL=" + sql + HybsSystem.CR
265                                                    + ex.getMessage();                      // 5.1.8.0 (2010/07/01) errMsg 修正
266                            throw new HybsSystemException( errMsg,ex );
267                    }
268                    finally {
269                            if( errFlag ) { ConnectionFactory.remove( conn,dbid ); }        // 削除
270                            else {                  ConnectionFactory.close( conn,dbid );  }        // 返却
271                    }
272    
273                    return(SKIP_BODY);
274            }
275    
276            /**
277             * Taglibの終äº?‚¿グが見つかったときに処ç�?�™ã‚?doEndTag() ã‚?オーバã?ライドしますã?
278             *
279             * @og.rev 4.0.0.1 (2007/12/03) try ??catch ??finally をきちんと行うã€?
280             * @og.rev 5.2.1.0 (2010/10/01) debugPrint() メソãƒ?ƒ‰追åŠ?
281             * @og.rev 5.3.0.0 (2010/12/01) ãƒ??タベã?ス検索処ç�?‚’、doAfterBody() へ移å‹?
282             *
283             * @return      後続å?ç�??æŒ?¤º
284             */
285            @Override
286            public int doEndTag() {
287                    debugPrint();           // 5.2.1.0 (2010/10/01) debugPrint() メソãƒ?ƒ‰追åŠ?
288    
289                    // ç�?±ˆ上ã?ChartCreateTag の存在チェãƒ?‚¯がここで行われるがã?DB検索処ç�??、å?に行ってã�?‚‹ã€?
290                    // つまりã?無é§?�ªQUERYが実行される可能性がå?てきたがã?開発段階ã?みの話であるのでここに残しておくã€?
291                    ChartCreateTag chartTag = (ChartCreateTag)findAncestorWithClass( this,ChartCreateTag.class );
292    
293                    if( chartTag == null ) {
294                            String errMsg = "chartCreate タグが見つかりませんでしたã€?;
295                            throw new HybsSystemException( errMsg );
296                    }
297    
298                    // 5.3.0.0 (2010/12/01) doAfterBody() へ移å‹?
299    //              boolean errFlag = true;
300    ////            Connection conn = ConnectionFactory.connection( dbid,getApplicationInfo() );
301    //              Connection conn = null;
302    //              try {
303    //                      conn = ConnectionFactory.connection( dbid,getApplicationInfo() );
304    //                      chDataset.makeDataset( conn,sql );
305    //                      errFlag = false;                // エラーではなã�?
306    //              }
307    //              catch( SQLException ex ) {
308    //                      String errMsg = "ãƒ??タセãƒ?ƒˆ作æ?時にエラーが発生しましたã€? + HybsSystem.CR
309    //                                              + " SQL=" + sql + HybsSystem.CR
310    //                                              + ex.getMessage();                      // 5.1.8.0 (2010/07/01) errMsg 修正
311    //                      throw new HybsSystemException( errMsg,ex );
312    //              }
313    //              finally {
314    //                      if( errFlag ) { ConnectionFactory.remove( conn,dbid ); }        // 削除
315    //                      else {                  ConnectionFactory.close( conn,dbid );  }        // 返却
316    //              }
317    
318                    chartTag.addChartDataset( chDataset );
319    
320                    return EVAL_PAGE;
321            }
322    
323            /**
324             * タグリブオブジェクトをリリースしますã?
325             * キャãƒ?‚·ュされて再利用されるã?で、フィールドã?初期設定を行いますã?
326             *
327             * @og.rev 4.0.0.0 (2007/10/10) dbid の初期値をã?"DEFAULT" から null に変更
328             * @og.rev 5.3.0.0 (2010/12/01) useTableData,tableId 属æ?追åŠ?
329             */
330            @Override
331            protected void release2() {
332                    super.release2();
333                    chDataset       = new ChartDataset();
334    //              dbid            = "DEFAULT";
335                    dbid            = null;
336                    sql                     = null;
337                    useTableData    = false;                                        // 5.3.0.0 (2010/12/01)
338                    tableId                 = HybsSystem.TBL_MDL_KEY;       // 5.3.0.0 (2010/12/01)
339            }
340    
341            /**
342             * 【TAGã€?通常は使ã�?�¾せん)Datasetオブジェクトを作æ?する時ã?DB接続IDを指定しますã?
343             *
344             * @og.tag
345             * Datasetオブジェクトを作æ?する時ã?DB接続IDを指定しますã?
346             * これは、シスãƒ?ƒ リソースで、DEFAULT_DB_URL 等でæŒ?®šしてã�?‚‹ ãƒ??タベã?ス接続å?
347             * æƒ??に、XX_DB_URL を定義することでã€?dbid="XX" とすると、この 接続å?を使用して
348             * ãƒ??タベã?スにアクセスできますã?
349             *
350             * @param       id      ãƒ??タベã?ス接続ID
351             */
352            public void setDbid( final String id ) {
353                    dbid = StringUtil.nval( getRequestParameter( id ),dbid );
354            }
355    
356            /**
357             * 【TAG】ChartDataset のãƒ??タタイプをæŒ?®šしますã?
358             *
359             * @og.tag
360             * チャートタイãƒ?は、外部からチャートをæŒ?®šするã?に便利なように、キーåŒ?
361             * されてã�?�¾すã?こã?キーに基づã�?�¦、ChartFactory クラスの
362             * チャートタイプ変換表に基づã�?�¦、レンãƒ?ƒ©ーã‚??ãƒ??タセãƒ?ƒˆを作æ?しますã?
363             * 基本çš?�«は、チャートタイãƒ?は、この、レンãƒ?ƒ©ー名称から決定してã�?�¾すã?
364             * <pre>
365             *  Area            , Bar               , Bar3D          , BoxAndWhisker    , CategoryStep  ,
366             *  Gantt           , GroupedStackedBar , IntervalBar    , LayeredBar       , Level         ,
367             *  LineAndShape    , Line3D            , MinMax         , StackedArea      , StackedBar    ,
368             *  StackedBar3D    , WaterfallBar      , CyclicXYItem   , HighLow          , StackedXYArea ,
369             *  StackedXYArea2  , StandardXYItem    , XYBubble       , XYDifference     , XYDot         ,
370             *  XYError         , XYLine3D          , XYLineAndShape , XYStepArea       , XYStep        ,
371             *  Meter           , MultiplePie       , Pie            , Pie3D            , Ring          ,
372             *  SpiderWeb       , Thermometer
373             * </pre>
374             *
375             * @param       chartType       チャートタイãƒ?
376             * @see         org.jfree.chart.renderer.category.CategoryItemRenderer
377             * @see         org.jfree.chart.renderer.xy.XYItemRenderer
378             */
379            public void setChartType( final String chartType ) {
380                    chDataset.setChartType( getRequestParameter( chartType ) );
381            }
382    
383            /**
384             * 【TAG】グラフ化するãƒ??タã‚?DBTableModel から作æ?するかどã�?�‹(初期値:false)ã€?
385             *
386             * @og.tag
387             * useTableData="false"(初期値)の場合ã?、BODY部に書かれã�?SQL æ–?‚’実行してãƒ??タを取得しますã?
388             * useTableData="true" にすると、その前ã? query タグ等で作æ?した DBTableModel を利用して
389             * グラフ化しますã?そã?場合ã?、BODY部の SQL æ–??、無視されますã?
390             * 利用する DBTableModel は、tableId と scope 属æ?から取得しますã?
391             *
392             * @og.rev 5.3.0.0 (2010/12/01) 新規追åŠ?
393             *
394             * @param       flag    ãƒ??タをDBTableModelを利用する場合ã?true
395             */
396            public void setUseTableData( final String flag ) {
397                    useTableData = StringUtil.nval( getRequestParameter( flag ),useTableData );
398            }
399    
400            /**
401             * 【TAGã€?通常は使ã�?�¾せん)結果のDBTableModelをã?sessionに登録するときã?キーを指定しまã�?
402             *              (初期値:HybsSystem#TBL_MDL_KEY[={@og.value org.opengion.hayabusa.common.HybsSystem#TBL_MDL_KEY}])ã€?
403             *
404             * @og.tag
405             * 検索結果より、DBTableModelオブジェクトを作æ?しますã?これをã?下流ã?viewタグ等に
406             * 渡すå?合にã€??常は、session を利用しますã?そã?場合ã?登録キーですã?
407             * query タグを同時に実行して、結果を求めるå?合ã?同ä¸?ƒ¡モリに配置される為ã€?
408             * こã? tableId 属æ?を利用して、メモリ空間をåˆ?�‘ますã?
409             *              (初期値:HybsSystem#TBL_MDL_KEY[={@og.value org.opengion.hayabusa.common.HybsSystem#TBL_MDL_KEY}])ã€?
410             *
411             * @param       id sessionに登録する時ã? ID
412             */
413            public void setTableId( final String id ) {
414                    tableId = StringUtil.nval( getRequestParameter( id ), tableId );
415            }
416    
417            /**
418             * 【TAG】シリーズ単位ã?凡ä¾?の表示可否を設定しますã?
419             *
420             * @og.tag
421             * シリーズ単位ã?凡ä¾?の表示可否を設定しますã?
422             *
423             * @param       baseLegend      シリーズ単位ã?凡ä¾?の表示可否
424             */
425            public void setBaseLegend( final String baseLegend ) {
426                    boolean flag = StringUtil.nval( getRequestParameter( baseLegend ),true );
427                    chDataset.setBaseLegend( flag );
428            }
429    
430            /**
431             * 【TAG】縦軸の表示名称を指定しますã?
432             *
433             * @og.tag
434             * 縦軸の表示名称を指定しますã?
435             *
436             * @param       valueLabel      縦軸の表示名称
437             */
438            public void setValueLabel( final String valueLabel ) {
439                    chDataset.setValueLabel( getRequestParameter( valueLabel ) );
440            }
441    
442            /**
443             * 【TAG】ã?ーカーラインの設定å?をカンマ区åˆ?‚Š形式でè¤?•°æŒ?®šしますã?
444             *
445             * @og.tag
446             * æŒ?®šã?値にマã?カーラインを引きますã?
447             * 色は、setMarkColors( String ) でæŒ?®šしますã?
448             * markColors と、å?数をあわせて設定するå¿?¦�がありますã?
449             * どちらかがã?æŒ?®šされてã�?�ªã�??合ã?、ã?ーカー表示されませんã€?
450             * dynamicOCNo を使用する場合ã?、そのValues の並びのç®?‰€にã€?
451             * "G"  とã�?�†æ–?­—å?を設定して下さã�??
452             * 例ï¼?000,G  基準1ã?ã€?000の直線ã?基準2ã?、グラãƒ?とã�?�†意味ã€?
453             *
454             * @param       markValues      マã?カーラインの設定å?(CSV形å¼?
455             * @see         #setMarkColors( String )
456             */
457            public void setMarkValues( final String markValues ) {
458                    String vals = StringUtil.nval( getRequestParameter( markValues ),null );
459                    if( vals != null ) {
460                            chDataset.setMarkValues( StringUtil.csv2Array( vals ) );
461                    }
462            }
463    
464            /**
465             * 【TAG】ã?ーカーライン描画時に、その設定å?を表示しますã?
466             *
467             * @og.tag
468             * マã?カーラインの縦軸の設定å?(markValues)に、設定å?をラベル表示しますã?
469             * 位置は、TextAnchor.BASELINE_LEFT 固定ですã?
470             * 初期値は、表示する(true)ですã?
471             *
472             * @og.rev 4.1.1.0 (2008/02/04) 新規追åŠ?
473             *
474             * @param   useAnchor true:設定å?を表示するã€?
475             */
476            public void setUseMarkAnchor( final String useAnchor ) {
477                    boolean flag = StringUtil.nval( getRequestParameter( useAnchor ),true );
478                    chDataset.setUseMarkAnchor( flag );
479            }
480    
481            /**
482             * 【TAG】ã?ーカーラインの色をカンマ区åˆ?‚Š形式でè¤?•°æŒ?®šしますã?
483             *
484             * @og.tag
485             * マã?カーラインとは、縦軸設定ã?ラインの事で、縦軸の設定å?(markValues)に
486             * 横方向にラインを付与しますã?こã?ラインの色をã?カンマ区åˆ?‚Š形式で
487             * æŒ?®šしますã?
488             * markValues と、あわせて設定するå¿?¦�がありますã?
489             * 個数が異なるå?合ã?、markValues が優先されã?無æŒ?®šã?場合ã?、Color.REDで
490             * 表示されますã?
491             *
492             * æŒ?®š文字å?は、java.awt.Color クラスのstatic フィールド名でæŒ?®šしますã?
493             * BLACK , BLUE , CYAN , DARK_GRAY , GRAY , GREEN , LIGHT_GRAY ,
494             * MAGENTA , ORANGE , PINK , RED , WHITE , YELLOW , (PURPLE) が指定できますã?
495             * またã?#XXXXXX形式ã?16bitRGB表è¨?でも指定可能ですã?
496             * <pre>
497             *      BLACK   , BLUE   , CYAN , DARK_GRAY , GRAY  , GREEN , LIGHT_GRAY ,
498             *      MAGENTA , ORANGE , PINK , RED       , WHITE , YELLOW , (PURPLE)
499             *      #XXXXXX形式ã?16bitRGB表è¨?でも指定可能ですã?
500             * </pre>
501             *
502             * @param       markColors      マã?カーラインの色(CSV形å¼?
503             * @see         java.awt.Color#BLACK
504             * @see         #setMarkValues( String )
505             */
506            public void setMarkColors( final String markColors ) {
507                    String clrs = StringUtil.nval( getRequestParameter( markColors ),null );
508                    if( clrs != null ) {
509                            chDataset.setMarkColors( StringUtil.csv2Array( clrs ) );
510                    }
511            }
512    
513            /**
514             * 【TAG】ã?ーカーラインのè¶?�Ž時ã?Shape色をカンマ区åˆ?‚Š形式でè¤?•°æŒ?®šしますã?
515             *
516             * @og.tag
517             * HybsLine でのみ使用可能ですã?
518             * マã?カーラインを使用する場合に、そのラインをè¶?�ˆなã�?‰²、è¶?�ˆる色を指定しますã?
519             * こã?色のæŒ?®šã?、ã?ーカーラインの色ã‚??ーカーラインの設定å?の個数?‹1に
520             * なりますã?つまりã?色?‘:設定å??‘:色?’:設定å??’:色??となりますã?
521             * 色?‘ã?、設定å??‘より小さã�??合に使用され、色?’ã?、設定å??‘より大きくã€?
522             * 設定å??’より小さã�??合ã?色?“ã?、設定å??’より大きい場合になりますã?
523             *
524             * æŒ?®š文字å?は、java.awt.Color クラスのstatic フィールド名でæŒ?®šしますã?
525             * BLACK , BLUE , CYAN , DARK_GRAY , GRAY , GREEN , LIGHT_GRAY ,
526             * MAGENTA , ORANGE , PINK , RED , WHITE , YELLOW , (PURPLE) が指定できますã?
527             * またã?#XXXXXX形式ã?16bitRGB表è¨?でも指定可能ですã?
528             * markValues と、あわせて設定するå¿?¦�がありますã?
529             * どちらかがã?æŒ?®šされてã�?�ªã�??合ã?、ã?ーカー表示されませんã€?
530             * <pre>
531             *      BLACK   , BLUE   , CYAN , DARK_GRAY , GRAY  , GREEN , LIGHT_GRAY ,
532             *      MAGENTA , ORANGE , PINK , RED       , WHITE , YELLOW , (PURPLE)
533             *      #XXXXXX形式ã?16bitRGB表è¨?でも指定可能ですã?
534             * </pre>
535             *
536             * @og.rev 4.0.3.0 (2008/01/07) 新規追åŠ?
537             *
538             * @param       overColors      マã?カーラインのè¶?�Ž時ã?Shape色(CSV形å¼?
539             * @see         java.awt.Color#BLACK
540             */
541            public void setMarkOverColors( final String overColors ) {
542                    String clrs = StringUtil.nval( getRequestParameter( overColors ),null );
543                    if( clrs != null ) {
544                            chDataset.setMarkOverColors( StringUtil.csv2Array( clrs ) );
545                    }
546            }
547    
548            /**
549             * 【TAG】動çš?�ªマã?カーラインの基準シリーズ番号を設定しまã�?初期値:null)ã€?
550             *
551             * @og.tag
552             * 動的なマã?カーラインを使用する場合ã?、基準å?となるシリーズ番号を指定しますã?
553             *
554             * マã?カーラインのæœ?¸‹位閾値に相当しますã?これは、グラフ化されますがã€?
555             * Shape は自動的に削除されますã?
556             * こã?設定を使用する場合ã?æœ??のãƒ??タには、å¿?�šShapeが付きますã?それ以外ã?
557             * ãƒ??タに、Shape を付けるかどã�?�‹は、shapesVisible 属æ?でæŒ?®šしますã?
558             * こã?線ã?色は、markColors でæŒ?®šしたã?æœ?¸‹位ã?色になりますã?またã?
559             * markValues でæŒ?®šしたã?æœ?¸‹位ã?値は、使用されません。たã�?�—、色æŒ?®šã?
560             * 関係上ã?設定しておくå¿?¦�がありますã?
561             * またã?isValueVisible == true で、設定å?の値表示を行う場合も、最下位ã?
562             * 値は表示しなã�?‚ˆã�?�«しますã?
563             * 初期値は、使用しなã�?null)ですã?
564             *
565             * @og.rev 4.1.1.0 (2008/02/04) 新規追åŠ?
566             * @og.rev 4.1.1.0 (2008/02/19) setUseDynamicOC �setDynamicOCNo
567             *
568             * @param   dynamicOCNo true:動的なマã?カーラインの基準シリーズ番号
569             */
570            public void setDynamicOCNo( final String dynamicOCNo ) {
571                    int ocNo = StringUtil.nval( getRequestParameter( dynamicOCNo ),-1 );
572                    chDataset.setDynamicOCNo( ocNo );
573    //              boolean flag = StringUtil.nval( getRequestParameter( useDynamicOC ),false );
574    //              chDataset.setUseDynamicOCNo( flag );
575            }
576    
577            /**
578             * 【TAG】チャートã?縦軸のæœ?°�å?をセãƒ?ƒˆしまã�?初期値:自動計ç®?ã€?
579             *
580             * @og.tag
581             * 何もæŒ?®šしなã�??合ã?、データのæœ?°�å?から、è?動的に計算しますã?
582             *
583             * @param       lowerBound      縦軸のæœ?°�å?
584             */
585            public void setLowerBound( final String lowerBound ) {
586                    chDataset.setLowerBound( getRequestParameter( lowerBound ) );
587            }
588    
589            /**
590             * 【TAG】チャートã?縦軸のæœ?¤§値をセãƒ?ƒˆしまã�?初期値:自動計ç®?ã€?
591             *
592             * @og.tag
593             * 何もæŒ?®šしなã�??合ã?、データのæœ?¤§値から、è?動的に計算しますã?
594             *
595             * @param       upperBound      縦軸のæœ?¤§値
596             */
597            public void setUpperBound( final String upperBound ) {
598                    chDataset.setUpperBound( getRequestParameter( upperBound ) );
599            }
600    
601            /**
602             * 【TAG】チャートã?縦軸の目盛ã?å¹?‚’セãƒ?ƒˆしまã�?初期値:自動計ç®?ã€?
603             *
604             * @og.tag
605             * 何もæŒ?®šしなã�??合ã?、データのç¯?›²から、è?動的に計算しますã?
606             *
607             * @og.rev 4.0.3.0 (2008/01/07) 新規追åŠ?
608             *
609             * @param   size 縦軸のチック(目ç›?のå¹?
610             */
611            public void setTickSize( final String size ) {
612                    chDataset.setTickSize( getRequestParameter( size ) );
613            }
614    
615            /**
616             * 【TAG】バーチャートã?グラãƒ??ション処ç�?‚’行うかどã�?�‹[true/false]をセãƒ?ƒˆしまã�?初期値:false)ã€?
617             *
618             * @og.tag
619             * 通常のバã?チャートã?、単ä¸?‰²表示で表されますが、これにグラãƒ??ション効果を
620             * 付加するかどã�?�‹を指定しますã?
621             * 通常のバã?チャートが、少しきれã�?�«見えますã?
622             * 初期値は、false(使用しなã�?ですã?
623             *
624             * @param       useGradient     グラãƒ??ション処ç�?[true:する/false:しない]
625             */
626            public void setUseGradient( final String useGradient ) {
627                    boolean flag = StringUtil.nval( getRequestParameter( useGradient ),false );
628                    chDataset.setUseGradient( flag );
629            }
630    
631            /**
632             * 【TAG】ラインチャートã?ポイントを四角表示するかどã�?�‹を指定しまã�?初期値:true)ã€?
633             *
634             * @og.tag
635             * ラインチャートã?ã€??常、線å?で表され、各ポイントにつã�?�¦もã?線å?で接続されますã?
636             * shapesVisible ã‚?true に設定すると、各ポイントが、線上に四角く表示されã€?
637             * そã?ポイントã?位置をã?容易に判断出来るよã�?�«なりますã?
638             * 初期値は、true( LineAndShape )ですã?
639             *
640             * @param       shapesVisible   ポイントを四角表示するかどã�?�‹
641             */
642            public void setShapesVisible( final String shapesVisible ) {
643                    boolean flag = StringUtil.nval( getRequestParameter( shapesVisible ),true );
644                    chDataset.setShapesVisible( flag );
645            }
646    
647            /**
648             * 【TAG】データ毎にShapeをå?り替える時ã?色の繰返しパターンを文字å?配å?でæŒ?®šしますã?
649             *
650             * @og.tag
651             * HybsLine でのみ使用可能ですã?
652             * これは、データそã?もã?がã?繰返し性のある場合に、その繰返し性に対応しã�?
653             * 形状のShape を表示させるå?合に使用しますã?
654             * 繰返しShapeの形状は、JFreeChart のシリーズ毎ã?繰返し標準形状を使用しますã?
655             * 現在のバã?ジョンではã€?¼‘0å?までの繰返しに対応可能ですã?
656             * 繰返し色をã?æŒ?®šしたå?ã�?�‘ã€??に使用されてã�?��ますã?
657             *
658             * æŒ?®š文字å?は、java.awt.Color クラスのstatic フィールド名でæŒ?®šしますã?
659             * BLACK , BLUE , CYAN , DARK_GRAY , GRAY , GREEN , LIGHT_GRAY ,
660             * MAGENTA , ORANGE , PINK , RED , WHITE , YELLOW , (PURPLE) が指定できますã?
661             * またã?#XXXXXX形式ã?16bitRGB表è¨?でも指定可能ですã?
662             *
663             * @og.rev 4.0.3.0 (2008/01/07) 新規追åŠ?
664             *
665             * @param       colors  ãƒ??タ毎ã?色の繰返しパターン(æ–?­—å?配å?)
666             * @see         java.awt.Color#BLACK
667             */
668            public void setShapeColors( final String colors ) {
669                    String clrs = StringUtil.nval( getRequestParameter( colors ),null );
670                    if( clrs != null ) {
671                            chDataset.setShapeColors( StringUtil.csv2Array( clrs ) );
672                    }
673            }
674    
675            /**
676             * 【TAG】繰返しshapeの開始番号を指定しまã�?初期値:0)ã€?
677             *
678             * @og.tag
679             * ラインチャートã?Shape(å�?‚°ラフã?ポイントã?マã?カー)はã€??常はã€?
680             * シリーズ毎に自動変更されますã?
681             * これの変更開始é?の開始番号を指定する事で、Shapeの開始形状を指定できますã?
682             * 初期値(0) では、■、●、▲、◆、横長方形、▼、楕å?、右三角ã?縦長方形ã€?
683             * 左三角ã?とã�?�†繰返しになりますã?
684             * これのã€?–‹始形状を指定することで、●から始めたり、▲から始める事が
685             * 可能になりますã?
686             * 初期値はã€?:â–?�§すã?
687             *
688             * @og.rev 4.1.1.0 (2008/02/04) 新規追åŠ?
689             *
690             * @param   startNo 繰返しshapeの開始番号
691             */
692    //      public void setShapeStartNo( final String startNo ) {
693    //              int no = StringUtil.nval( getRequestParameter( startNo ),0 );
694    //              chDataset.setShapeStartNo( no );
695    //      }
696    
697            /**
698             * 【TAG】shapeの大きさをå?çŽ?Œ‡定で変更しまã�?初期値:null)ã€?
699             *
700             * @og.tag
701             * ラインチャートã?Shape(å�?‚°ラフã?ポイントã?マã?カー)の大きさはã€??常はã€?
702             * 自動設定されますã?
703             * こã?大きさをã?倍率æŒ?®šで、変更可能ですã?
704             * æŒ?®šã?、double 型ですã?
705             * 初期値は、null は、スケール変更しません(自動設定ã?ままの大きさ)
706             *
707             * @og.rev 4.1.1.0 (2008/02/04) 新規追åŠ?
708             *
709             * @param       scale   shapeの大きさの倍率
710             */
711            public void setShapeScale( final String scale ) {
712                    String shapeScale = StringUtil.nval( getRequestParameter( scale ),null );
713                    if( shapeScale != null ) {
714                            chDataset.setShapeScale( shapeScale );
715                    }
716            }
717    
718            /**
719             * 【TAG】ラインチャートã?線をドットラインにするかどã�?�‹[true/false]を指定しまã�?初期値:false[線å?])ã€?
720             *
721             * @og.tag
722             * ラインチャートã?ã€??常、線å?で表されますã?
723             * これに、点線で表すことで、グラフã?違いをã?色ã�?�‘でなく形状でも識別
724             * しやすくすることが可能ですã?
725             * 初期値は、false(線å?)ですã?
726             *
727             * @param       useDottedLine   ドットラインにするかどã�?�‹ [true:点ç·?false:線å?]
728             */
729            public void setUseDottedLine( final String useDottedLine ) {
730                    boolean flag = StringUtil.nval( getRequestParameter( useDottedLine ),false );
731                    chDataset.setUseDottedLine( flag );
732            }
733    
734            /**
735             * 【TAG】è¤?•°チャート描画時ã?チャート色の繰返しパターンをCVS形式でè¤?•°æŒ?®šしますã?
736             *
737             * @og.tag
738             * 通常、è¤?•°のチャートを同時に表示させるå?合ã?、縦軸がå?通であればã€?
739             * ?‘回のSelectåˆ?�§è¤?•°ãƒ??タを取得しますã?
740             * こã?、データをシリーズと呼んでおり、これを区別する為に、色をå?けますã?
741             * 初期値は、JFreeChart がè?動で割り振りますã?
742             * これをã?外部からCVS形式で、カンマ区åˆ?‚Šで色コードをæŒ?®šしますã?
743             * æŒ?®šデータが多い場合ã?、多いåˆ??色は使用されません。少なã�??合ã?ã€?
744             * é ?•ªに繰り返して使用されますã?
745             * 例えばã€?¼‘色ã�?�‘æŒ?®šしたå?合ã?、すべてのシリーズが同じ色で表されますã?
746             *
747             * æŒ?®š文字å?は、java.awt.Color クラスのstatic フィールド名でæŒ?®šしますã?
748             * BLACK , BLUE , CYAN , DARK_GRAY , GRAY , GREEN , LIGHT_GRAY ,
749             * MAGENTA , ORANGE , PINK , RED , WHITE , YELLOW , (PURPLE) が指定できますã?
750             *
751             * またã?#XXXXXX形式ã?16bitRGB表è¨?でも指定可能ですã?
752             *
753             * @param       colors  チャート色の繰返しパターン(CVS形å¼?
754             * @see         java.awt.Color#BLACK
755             */
756            public void setSeriesColors( final String colors ) {
757                    String clrs = StringUtil.nval( getRequestParameter( colors ),null );
758                    if( clrs != null ) {
759                            chDataset.setSeriesColors( StringUtil.csv2Array( clrs ) );
760                    }
761            }
762    
763            /**
764             * 【TAG】Value(縦軸)の線を表示するかどã�?�‹を指定しまã�?初期値:true[表示する])ã€?
765             *
766             * @og.tag
767             * ValueAxis にて設定される、縦軸æƒ??の、罫線を表示するかどã�?�‹æŒ?®šしますã?
768             * 初期値は、true(表示する)ですã?
769             *
770             * @og.rev 4.0.2.0 (2007/12/20) 新規追åŠ?
771             *
772             * @param       lineVisible     Value(縦軸)の線を表示するかどã�?�‹
773             */
774    //      public void setValueLineVisible( final String lineVisible ) {
775    //              boolean flag = StringUtil.nval( getRequestParameter( lineVisible ),true );
776    //              chDataset.setValueLineVisible( flag );
777    //      }
778    
779            /**
780             * 【TAG】Value(縦軸)のラベルを表示するかどã�?�‹を指定しまã�?初期値:true[表示する])ã€?
781             *
782             * @og.tag
783             * ValueAxis にて設定される、縦軸æƒ??の、ラベルを表示するかどã�?�‹æŒ?®šしますã?
784             * 初期値は、true(表示する)ですã?
785             *
786             * @og.rev 4.0.2.0 (2007/12/20) 新規追åŠ?
787             *
788             * @param       labelsVisible   Value(縦軸)のラベルを表示するかどã�?�‹
789             */
790            public void setValueLabelsVisible( final String labelsVisible ) {
791                    boolean flag = StringUtil.nval( getRequestParameter( labelsVisible ),true );
792                    chDataset.setValueLabelsVisible( flag );
793            }
794    
795            /**
796             * 【TAG】Value(縦軸)のマã?カーを表示するかどã�?�‹を指定しまã�?初期値:true[表示する])ã€?
797             *
798             * @og.tag
799             * ValueAxis にて設定される、縦軸æƒ??の、ã?ーカーを表示するかどã�?�‹æŒ?®šしますã?
800             * 初期値は、true(表示する)ですã?
801             *
802             * @og.rev 4.0.2.0 (2007/12/20) 新規追åŠ?
803             *
804             * @param       marksVisible    Value(縦軸)のマã?カーを表示するかどã�?�‹
805             */
806            public void setValueMarksVisible( final String marksVisible ) {
807                    boolean flag = StringUtil.nval( getRequestParameter( marksVisible ),true );
808                    chDataset.setValueMarksVisible( flag );
809            }
810    
811            /**
812             * 【TAG】データの値(itemText)を表示するかどã�?�‹[true/false/last]を指定しまã�?初期値:false[表示しない])ã€?
813             *
814             * @og.tag
815             * CategoryItemRenderer 関連のグラフã?設定å?をグラフ上に表示するかどã�?�‹ã‚?
816             * æŒ?®šしますã?
817             * true に設定したå?合ã?通常の場合ã?、すべてのシリーズにラベル表示されますã?
818             * false に設定すると、表示されませんã€?
819             * last を設定すると、各シリーズのæœ?¾Œã?値のみ表示されますã?
820             * ChartCreate クラスに、seriesPikup が設定されてã�?‚‹場合ã?、指定ã?シリーズ
821             * のみの設定å?を表示しã?他ã?値は、表示しませんã€?
822             * 同様に、dynamicOCNo が指定されてã�?‚‹場å�?動的なマã?カーライン)
823             * æœ?¸‹位ã?シリーズはã€?–¾値として使用されるためã?設定å?は表示されませんã€?
824             * ラベルの表示位置は、表示する線グラフã?傾きに応じてラベルの表示場æ‰?‚’
825             * 変えますã?山形、右坂ã?谷形、左å�?に応じて、上中、下右、下中、上右 に
826             * 位置を設定しますã?右にずらすã?はã€?0 ピクセル固定ですã?
827             * 初期値は、false(表示しなã�?ですã?
828             *
829             * @og.rev 4.1.1.0 (2008/02/04) 新規追åŠ?
830             * @og.rev 4.1.2.0 (2008/03/12) æ–?­—å?のまま、渡すよã�?�«変更
831             *
832             * @param       itemLabelVisible        ãƒ??タの値の表示のさせ方(true,false,last)
833             */
834            public void setItemLabelVisible( final String itemLabelVisible ) {
835    //              boolean flag = StringUtil.nval( getRequestParameter( itemLabelVisible ),false );
836                    String flag = StringUtil.nval( getRequestParameter( itemLabelVisible ),"false" );
837                    chDataset.setItemLabelVisible( flag );
838            }
839    
840            /**
841             * 【TAG】データの値(itemText)の表示に、桁区åˆ?‚Šæ–?­—を使用するかどã�?�‹[true/false]を指定しまã�?初期値:true[使用する])ã€?
842             *
843             * @og.tag
844             * itemLabelVisible=true 時に、表示されるデータ値ラベルでã€?
845             * NumberFormat してã�?�¾すがã€?¼“桁区åˆ?‚Šæ–?­?123,456,789.0) の
846             * 区åˆ?‚Š記号を表示するかどã�?�‹を指定しますã?
847             * true を指定すると、表示しますã?false では、表示しませんã€?
848             * 初期値は、true(使用する)ですã?
849             *
850             * @og.rev 4.1.2.0 (2008/03/12) 新規追åŠ?
851             *
852             * @param       used    ãƒ??タの桁区åˆ?‚Šæ–?­—ã?使用有無
853             */
854            public void setUseItemLabelSep( final String used ) {
855                    boolean useItemLabelSep = StringUtil.nval( getRequestParameter( used ),true );
856                    chDataset.setUseItemLabelSep( useItemLabelSep );
857            }
858    
859            /**
860             * 【TAG】縦軸の表示領域INSET値(double)を指定しますã?
861             *
862             * @og.tag
863             * 縦軸æ–?­—表示領域(NumberAxis)のå¹??追åŠ??を設定しますã?
864             * これはã€??常の表示領域の左側にスペã?スを挿入しますã?
865             * あくまで、追åŠ?�™るå?なので、文字ã?長さã?含まれませんã€?
866             * 何もæŒ?®šしなã�??合ã?、設定しませんã€?
867             *
868             * @og.rev 4.0.3.0 (2008/01/07) 新規追åŠ?
869             *
870             * @param       inset   Value(縦軸)の表示領域INSET値
871             */
872            public void setValueInset( final String inset ) {
873                    String valueInset = StringUtil.nval( getRequestParameter( inset ),null );
874                    chDataset.setValueInset( valueInset );
875            }
876    
877            /**
878             * 【TAG】BOXチャートã?バã?å¹?double)を指定しますã?
879             *
880             * @og.tag
881             * BOXチャートã?バã?å¹?double)を指定しますã?
882             * 設定されるのは、org.jfree.chart.renderer.category.BarRenderer ã‚?
883             * 使用した描画のみですã?
884             * 棒グラフã?バã?å¹?Œ‡定ã?、直接、CategoryItemRendererState に設定してã�?�¾すã?
885             * 通常は、barMaxWidth(0.0??.0)とbarItemMargin(0.0??.0)を用ã�?�¦比率でæŒ?®šしますã?
886             * 何もæŒ?®šしなã�??合ã?、設定しませんã€?
887             *
888             * @og.rev 4.0.3.0 (2008/01/07) 新規追åŠ?
889             *
890             * @param       width   BOXチャートã?バã?å¹?double)
891             */
892            public void setBarWidth( final String width ) {
893                    String barWidth = StringUtil.nval( getRequestParameter( width ),null );
894                    chDataset.setBarWidth( barWidth );
895            }
896    
897            /**
898             * 【TAG】グラフã?書きå?し位置のオフセãƒ?ƒˆを指定しまã�?初期値:0)ã€?
899             *
900             * @og.tag
901             * グラフを重ã?ると、同じ位置から書きå?しが始まりますã?
902             * こã?パラメータを指定する事で、グラフを重ã?たå?合に、少しずつ
903             * ずらして書き始める事が可能になりますã?
904             * これは、シリーズをã?描画するときに、棒グラフã?å¹?‚’åº?�’る事で
905             * 同様ã?効果を得る事が出来ますが、検索条件等が異なるå?合にはã€?
906             * シリーズ化できませんので、こちらã?オフセãƒ?ƒˆを使用しますã?
907             * 初期値はã€?(書きå?し位置は標準ã?まま)ですã?
908             *
909             * @og.rev 4.1.1.0 (2008/02/04) 新規追åŠ?
910             *
911             * @param       chartOffset     書きå?し位置のオフセãƒ?ƒˆ
912             */
913    //      public void setChartOffset( final String chartOffset ) {
914    //              String offset = StringUtil.nval( getRequestParameter( chartOffset ),null );
915    //              if( offset != null ) {
916    //                      chDataset.setChartOffset( Double.parseDouble(offset) );
917    //              }
918    //      }
919    
920            /**
921             * 【TAG】BOXチャートã?バã?å¹??æœ?¤§値(0.0??.0)を指定しますã?
922             *
923             * @og.tag
924             * BOXチャートã?バã?å¹??比率のæœ?¤§値を指定しますã?
925             * 表示領域を1として小数点以下ã?数値で棒ã?å¹?‚’設定しますã?
926             * 設定したå¹?�«無ç�?�Œある時ã?適当なサイズに調整されますã?
927             * (小さくしたときには棒が線ã?ようになã‚?
928             * 設定されるのは、org.jfree.chart.renderer.category.BarRenderer ã‚?
929             * 使用した描画のみですã?
930             * 何もæŒ?®šしなã�??合ã?、設定しませんã€?
931             *
932             * @og.rev 4.0.2.0 (2007/12/20) 新規追åŠ?
933             *
934             * @param       barWidth        BOXチャートã?バã?å¹??æœ?¤§値(0.0??.0)
935             */
936            public void setBarMaxWidth( final String barWidth ) {
937                    String maxBarWidth = StringUtil.nval( getRequestParameter( barWidth ),null );
938                    chDataset.setBarMaxWidth( maxBarWidth );
939            }
940    
941            /**
942             * 【TAG】BOXチャートã?バã?アイãƒ?ƒ のマã?ジン(0.0??.0)を指定しますã?
943             *
944             * @og.tag
945             * BOXチャートã?バã?アイãƒ?ƒ のマã?ジンの比率を指定しますã?
946             * 棒ã?間を表示領域を1として小数点以下ã?数値でå¹?‚’設定しますã?
947             * 無ç�?�Œある時ã?適当なサイズに調整されますã?
948             * barMaxWidth より優先されますã?
949             * 設定されるのは、org.jfree.chart.renderer.category.BarRenderer ã‚?
950             * 使用した描画のみですã?
951             * 何もæŒ?®šしなã�??合ã?、設定しませんã€?
952             *
953             * @og.rev 4.0.2.0 (2007/12/20) 新規追åŠ?
954             *
955             * @param       margin  BOXチャートã?バã?アイãƒ?ƒ のマã?ジン(0.0??.0)
956             */
957            public void setBarItemMargin( final String margin ) {
958                    String itemMargin = StringUtil.nval( getRequestParameter( margin ),null );
959                    chDataset.setBarItemMargin( itemMargin );
960            }
961    
962            /**
963             * 【TAG】表示下限値(これ以下ã?ãƒ??タは未表示)の値(double)を指定しますã?
964             *
965             * @og.tag
966             * HybsLine でのみ使用可能ですã?
967             * こã?設定å?以下ã?ãƒ??タは、存在しなã�?‰±ã�?�¨しますã?
968             * Lineを引くときã?こã?ãƒ??タと、存在してã�?‚‹ãƒ??タ間にラインは引かれませんã€?
969             * 何もæŒ?®šしなã�??合ã?、設定しませんã€?
970             *
971             * @og.rev 4.0.3.0 (2008/01/07) 新規追åŠ?
972             *
973             * @param       limit   表示下限値(これ以下ã?ãƒ??タは未表示)
974             */
975            public void setVisibleLimit( final String limit ) {
976                    String visibleLimit = StringUtil.nval( getRequestParameter( limit ),null );
977                    chDataset.setVisibleLimit( visibleLimit );
978            }
979    
980            /**
981             * 【TAG】グラフã?書きå?し位置の調整比率を指定しますã?
982             *
983             * @og.tag
984             * HybsStackedBar でのみ使用可能ですã?
985             * グラフを描画する場合ã?、書きå?し位置を少しずらしますã?
986             * これは、グラフã?å¹?�«対して、比率でæŒ?®šしますã?
987             * 0.0(初期値)の場合ã?、å?期描画位置である、CategoryAnchor.Middle と
988             * 同じç®?‰€から、書きå?されますã?
989             * 1.0 の場合ã?中å¿?�‹らã?グラフå¹??半å?が加算されã?END位置にå¯?‚Šますã?
990             * 同様にã€?1.0 の場合ã?、グラフå¹??半å?が減算されã?START 位置になりますã?
991             * つまりã?中å¿?�‹らã?グラフå¹??半å?単位で、前方/後方にずらす事が出来ますã?
992             *   書きå?し位置 ??中å¿?Middle) + (domainMargin)?Šå¹???
993             * 初期値はã€?.0(真ん中:MIDDLE)ですã?
994             *
995             * @og.rev 4.1.1.0 (2008/02/14) 新規追åŠ?
996             *
997             * @param   margin double グラフã?書きå?し位置の調整比率
998             */
999            public void setDomainMargin( final String margin ) {
1000                    String domMgn = StringUtil.nval( getRequestParameter( margin ),null );
1001                    if( domMgn != null ) {
1002                            double domainMargin = Double.parseDouble( domMgn );
1003                            chDataset.setDomainMargin( domainMargin ) ;     // double margin
1004                    }
1005            }
1006    
1007            /**
1008             * 【TAG】時刻を表すå?合ã?表現の仕方[E1/E2/E3/H1/H2/H3]を指定しまã�?初期値:null)ã€?
1009             *
1010             * @og.tag
1011             * HybsNumberAxis にオーバã?ライドすã‚?時間を表示する DecimalFormat のå†?ƒ¨クラスを利用するに当たりã?
1012             * 時刻の表示方法をæŒ?®šしますã?
1013             * 外部から与える数字ã?ã€??続してã�?‚‹å¿?¦�があるためã€?¼‘0é?数ですã?
1014             * たとえã?ã€?700 â†?17:00 , 2150 â†?21:30 とã�?�†感じですã?
1015             * 2400 をè¶?�ˆると日付違ã�?�«なりますã?
1016             *
1017             * 英語表è¨?:)と日本語表è¨?æ™?の区別とã€?4時間をè¶?�ˆるå?合ã?表示方法によってã€?¼–種類ã?パターンが存在しますã?
1018             * ã€?1:そã?ままã€?4:00 となりã?åŠ?®—されてã�?��ã€?
1019             * ã€?2:そã?ままã€?:00 に戻るã?(日付ã?無è¦?
1020             * ã€?3:そã?ままã€? 00:00 と日付が付与されるã€?
1021             * ã€?1:そã?ままã€?4æ™?0åˆ?となりã?åŠ?®—されてã�?��ã€?
1022             * ã€?2:そã?ままã€?0æ™?0åˆ?に戻るã?(日付ã?無è¦?
1023             * ã€?3:そã?ままã€?日 00æ™?0åˆ?と日付が付与されるã€?
1024             * 初期値は、使用しなã�?-1)ですã?
1025             *
1026             * @og.rev 5.5.2.1 (2012/05/07) 新規追åŠ?
1027             *
1028             * @param   type 時刻の表示方æ³?E1,E2,E3,H1,H2,H3)
1029             */
1030            public void setTimeFormatType( final String type ) {
1031                    String timeFormatType = StringUtil.nval( getRequestParameter( type ),null );
1032                    chDataset.setTimeFormatType( timeFormatType );
1033            }
1034    
1035            /**
1036             * 【TAG】ラベルの表示向きを縦にするかどã�?�‹[false/true]を指定しまã�?初期値:false[横書き])ã€?
1037             *
1038             * @og.tag
1039             * ChartCreate の rotationLabel は、角度を指定できましたがã?NumberAxis ではã€?
1040             * 縦にするかどã�?�‹のæŒ?®šしかできませんã€?
1041             * ここでは、true を指定するとラベルは、縦書きになりますã?
1042             * 初期値は、false(横書ã�?ですã?
1043             *
1044             * @og.rev 5.5.2.1 (2012/05/07) 新規追åŠ?
1045             *
1046             * @param       useVLavels      ラベルの表示向き [false:横書ã�?true:縦書き]
1047             */
1048            public void setUseVerticalLabels( final String useVLavels ) {
1049                    boolean useVerticalLabels = StringUtil.nval( getRequestParameter( useVLavels ),false );
1050                    chDataset.setUseVerticalLabels( useVerticalLabels );
1051            }
1052    
1053            /**
1054             * シリアライズ用のカスタãƒ?‚·リアライズ書き込みメソãƒ?ƒ‰
1055             *
1056             * @og.rev 4.0.0.0 (2006/09/31) 新規追åŠ?
1057             * @serialData ä¸?ƒ¨のオブジェクãƒ?ChartDataset)は、シリアライズされませんã€?
1058             *
1059             * @param       strm    ObjectOutputStreamオブジェクãƒ?
1060             * @throws IOException  シリアライズに関する入出力エラーが発生したå?å�?
1061             */
1062            private void writeObject( final ObjectOutputStream strm ) throws IOException {
1063                    strm.defaultWriteObject();
1064            }
1065    
1066            /**
1067             * シリアライズ用のカスタãƒ?‚·リアライズ読み込みメソãƒ?ƒ‰
1068             *
1069             * ここでは、transient 宣è¨?�•れたå†?ƒ¨変数のå†??初期化がå¿?¦�なフィールドã?み設定しますã?
1070             *
1071             * @og.rev 4.0.0.0 (2006/09/31) 新規追åŠ?
1072             * @serialData ä¸?ƒ¨のオブジェクãƒ?ChartDataset)は、読み込まれませんã€?
1073             *
1074             * @param       strm    ObjectInputStreamオブジェクãƒ?
1075             * @see #release2()
1076             * @throws IOException  シリアライズに関する入出力エラーが発生したå?å�?
1077             * @throws ClassNotFoundException       クラスを見つけることができなかったå?å�?
1078             */
1079            private void readObject( final ObjectInputStream strm ) throws IOException , ClassNotFoundException {
1080                    strm.defaultReadObject();
1081                    chDataset = new ChartDataset();
1082            }
1083    
1084            /**
1085             * こã?オブジェクトã?æ–?­—å?表現を返しますã?
1086             * 基本çš?�«ãƒ?ƒ�ãƒ?‚°目çš?�«使用しますã?
1087             *
1088             * @return こã?クラスのæ–?­—å?表現
1089             */
1090            @Override
1091            public String toString() {
1092                    StringBuilder rtn = new StringBuilder( HybsSystem.BUFFER_MIDDLE );
1093    
1094                    rtn.append( "[" ).append( this.getClass().getName() ).append( "]" ).append( HybsSystem.CR );
1095                    rtn.append( "dbid        [" ).append( dbid       ).append( "]" ).append( HybsSystem.CR );
1096                    rtn.append( "sql         [" ).append( sql        ).append( "]" ).append( HybsSystem.CR );
1097                    rtn.append( "dataset     [" ).append( chDataset  ).append( "]" ).append( HybsSystem.CR );
1098    
1099                    return rtn.toString();
1100            }
1101    }