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