org.opengion.hayabusa.taglib

## クラス ChartDatasetTag

- java.lang.Object
- - javax.servlet.jsp.tagext.TagSupport
  - - javax.servlet.jsp.tagext.BodyTagSupport
    - - org.opengion.hayabusa.taglib.CommonTagSupport
      - - org.opengion.hayabusa.taglib.ChartDatasetTag

- すべての実装されたインタフェース:
    Serializable, BodyTag, IterationTag, JspTag, Tag, TryCatchFinally

      public class ChartDatasetTag
      extends CommonTagSupport

  BODY部に指定のSQLの検索結果をグラフ(円、棒、線)で表示するタグです。 グラフ化には、JFreeChart (http://www.jfree.org/jfreechart/) を使用しています。 chartType 属性には、ChartFactoryクラスで定義された変換表に基づく、チャートの 種類を指定します。このキーから、レンデラーやデータセットクラスを求めます。 それぞれのクラス毎に細かい設定値がありますが、初期レベルとしましては、主要チャートの 主要属性のみサポートします。また、指定の chartType では使用しない属性を指定した場合でも 単に無視するだけで、警告等はありませんので、ご注意ください。 各属性は、{@XXXX} 変数が使用できます。 これは、ServletRequest から、XXXX をキーに値を取り出し,この変数に割り当てます。 つまり、このXXXXをキーにリクエストすれば、この変数に値をセットすることができます。 useTableData="false"(初期値)の場合は、BODY部に書かれた SQL 文を実行してデータを取得します。 useTableData="true" にすると、その前の query タグ等で作成した DBTableModel を利用して グラフ化します。その場合は、BODY部の SQL 文は、無視されます。 利用する DBTableModel は、tableId と scope 属性から取得します。
  関連項目:
    直列化された形式
  形式サンプル:

         ●形式：<og:chartDataset renderer="…" … />
         ●body：あり(EVAL_BODY_BUFFERED:BODYを評価し、{@XXXX} を解析します)

         ●Tag定義：
           <og:chartDataset
               chartType        ○【TAG】ChartDataset のデータタイプを指定します(必須)。
               dbid               【TAG】(通常は使いません)Datasetオブジェクトを作成する時のDB接続IDを指定します
               useTableData       【TAG】グラフ化するデータを DBTableModel から作成するかどうか(初期値:false)
               tableId            【TAG】(通常使いません)sessionから所得する DBTableModelオブジェクトの ID (初期値:HybsSystem#TBL_MDL_KEY[=h_tblmdl])
               scope              【TAG】キャッシュする場合のスコープ[request/page/session/applicaton]を指定します(初期値:session)
               baseLegend         【TAG】シリーズ単位の凡例 の表示可否を設定します
               valueLabel         【TAG】縦軸の表示名称を指定します
               markValues         【TAG】マーカーラインの設定値をカンマ区切り形式で複数指定します
               markColors         【TAG】マーカーラインの色をカンマ区切り形式で複数指定します
               markOverColors     【TAG】マーカーラインの超過時のShape色をカンマ区切り形式で複数指定します
               dynamicOCNo        【TAG】動的なマーカーラインの基準シリーズ番号を設定します(初期値:null)
               useMarkAnchor      【TAG】マーカーライン描画時に、その設定値を表示します
               lowerBound         【TAG】チャートの縦軸の最小値をセットします(初期値:自動計算)
               upperBound         【TAG】チャートの縦軸の最大値をセットします(初期値:自動計算)
               tickSize           【TAG】チャートの縦軸の目盛の幅をセットします(初期値:自動計算)
               useGradient        【TAG】バーチャートのグラデーション処理を行うかどうか[true/false]をセットします(初期値:false)
               shapesVisible      【TAG】ラインチャートのポイントを四角表示するかどうかを指定します(初期値:true)
               shapeColors        【TAG】データ毎にShapeを切り替える時の色の繰返しパターンを文字列配列で指定します
               shapeScale         【TAG】shapeの大きさを倍率指定で変更します(初期値:null)
               useDottedLine      【TAG】ラインチャートの線をドットラインにするかどうか[true/false]を指定します(初期値:false 線分)
               seriesColors       【TAG】複数チャート描画時のチャート色の繰返しパターンをCVS形式で複数指定します
               valueLabelsVisible 【TAG】Value(縦軸)のラベルを表示するかどうかを指定します(初期値:true[表示する])
               valueMarksVisible  【TAG】Value(縦軸)のマーカーを表示するかどうかを指定します(初期値:true[表示する])
               itemLabelVisible   【TAG】データの値(itemText)を表示するかどうか[true/false/last]を指定します(初期値:false[表示しない])
               useItemLabelSep    【TAG】データの値(itemText)の表示に、桁区切り文字を使用するかどうか[true/false]を指定します(初期値:true[使用する])
               valueInset         【TAG】縦軸の表示領域INSET値(double)を指定します
               barMaxWidth        【TAG】BOXチャートのバー幅の最大値(0.0～1.0)を指定します
               barItemMargin      【TAG】BOXチャートのバーアイテムのマージン(0.0～1.0)を指定します
               barWidth           【TAG】BOXチャートのバー幅(double)を指定します
               visibleLimit       【TAG】表示下限値(これ以下のデータは未表示)の値(double)を指定します
               domainMargin       【TAG】グラフの書き出し位置の調整比率を指定します
               timeFormatType     【TAG】時刻を表す場合の表現の仕方[E1/E2/E3/H1/H2/H3]を指定します(初期値:null)
               useVerticalLabels  【TAG】ラベルの表示向きを縦にするかどうか[false/true]を指定します(初期値:false)
               debug              【TAG】デバッグ情報を出力するかどうか[true/false]を指定します(初期値:false)
           >   ... Body ...
           </og:chartDataset>

         ●使用例
              <og:chartCreate
                  command     = "{@command}"
                  title       = "{@title}"
                  domainLabel = "{@domainLabel}"
                  width       = "{@width}"
                  height      = "{@height}"
                  rectangleEdge   = "{@rectangleEdge}"
                  plotOrientation = "{@plotOrientation}"
                  chartBackColor  = "{@chartBackColor}"
                  plotBackColor   = "{@plotBackColor}"
                  domainMarker    = "{@domainMarker}"
                  useMarkerLabel  = "{@useMarkerLabel}" >
                      <og:chartDataset
                          chartType   = "[Bar|LineAndShape|･･･]"      チャートの種類
                          baseLegend  = "[true|false]"                シリーズ単位の凡例 の表示可否
                          valueLabel  = "縦軸"                        縦軸のラベル
                          lowerBound  = "0"                           下限値
                          upperBound  = "5000"                        上限値
                          tickSize    = "1000"                        縦軸の目盛の幅
                          markValues  = "2500,2800"                   縦軸設定値(横棒)
                          markColors  = "RED,GREEN"                   縦軸設定ライン色
                          markOverColors = "BLUE,YELLOW,RED"          マーカーラインの超過時のShape色
                          dynamicOCNo   = "2"                         動的なマーカーラインの基準シリーズ番号
                          useMarkAnchor = "[true|false]"              縦軸設定値(横棒)を表示するかどうか
                          useGradient   = "[false|true]"              バーチャートのグラデーション処理
                          shapesVisible = "[true|false]"              ラインの四角表示
                          shapeColors   = "RED,GREEN,BLUE"            データ毎のShapeの色
                          shapeScale    = "0.8"                       shapeの大きさの倍率(double)
                          useDottedLine = "[false|true]"              点線使用有無
                          seriesColors  = "RED,GREEN,BLUE"            シリーズの色サイクル指定
                          valueLabelsVisible = "[true|false]"         縦軸のラベルの表示有無
                          valueMarksVisible  = "[true|false]"         縦軸のマーカーの表示有無
                          itemLabelVisible   = "[false|true|last]"    データの値の表示有無
                          useItemLabelSep    = "[true|false]"         データの桁区切り文字の使用有無
                          valueInset         = "15"                   縦軸の表示領域INSET値
                          barMaxWidth        = "[0.0～1.0]"           バー幅の最大値(0.0～1.0)
                          barItemMargin      = "[0.0～1.0]"           バーアイテムのマージン(0.0～1.0)
                          barWidth           = "10"                   バー幅の実幅(double)
                          visibleLimit       = "0"                    表示下限値(これ以下のデータは未表示))
                          domainMargin       = "1.0"                  グラフの書き出し位置の調整比率
                          useTableData       = "[false|true]"         SQLではなく、DBTableModelからグラフを作成するかどうか
                          timeFormatType     = "[1|2]"                時間軸の設定(00:00表示)
                          useVerticalLabels  = "[false|true]"         時間軸の設定(ラベルの縦書き)
                          tableId            = "AAA"                  useTableData="true"の場合のDBTableModelの取得先ID
                          scope              = "[session|request]"    useTableData="true"の場合のDBTableModelの取得先scope
                      >
                                 {@SQL}
                      </og:chartDataset>
              </og:chartCreate>

            複数のグラフを重ね合わせる場合は、chartDataset タグを chartCreate のBODY部に
            複数記述します。
              <og:chartCreate
                  title       = "{@title}"
                  domainLabel = "{@domainLabel}"
                  width       = "{@width}"
                  height      = "{@height}" >
                  rectangleEdge   = "{@rectangleEdge}" >
                  plotOrientation = "{@plotOrientation}" >
                      <og:chartDataset
                          chartType   = "{@chartType1}"
                          valueLabel  = "{@valueLabel1}"
                          lowerBound  = "{@lowerBound1}"
                          upperBound  = "{@upperBound1}"
                          markValues  = "{@markValues1}"
                          markColors  = "{@markColors1}"
                      >
                                 {@SQL1}
                      </og:chartDataset>
                      <og:chartDataset
                          chartType   = "{@chartType2}"
                          valueLabel  = "{@valueLabel2}"
                          lowerBound  = "{@lowerBound2}"
                          upperBound  = "{@upperBound2}"
                          markValues  = "{@markValues2}"
                          markColors  = "{@markColors2}"
                      >
                                 {@SQL2}
                      </og:chartDataset>
              </og:chartCreate>

            chartType属性 は、チャートの種類を指定する、固有IDです。
            [chartType属性]
              Area            , Bar               , Bar3D          , BoxAndWhisker    , CategoryStep  ,
              Gantt           , GroupedStackedBar , IntervalBar    , LayeredBar       , Level         ,
              LineAndShape    , Line3D            , MinMax         , StackedArea      , StackedBar    ,
              StackedBar3D    , WaterfallBar      , CyclicXYItem   , HighLow          , StackedXYArea ,
              StackedXYArea2  , StandardXYItem    , XYBubble       , XYDifference     , XYDot         ,
              XYError         , XYLine3D          , XYLineAndShape , XYStepArea       , XYStep        ,
              Meter           , MultiplePie       , Pie            , Pie3D            , Ring          ,
              SpiderWeb       , Thermometer

            markColors属性 は、マーカーラインの色を指定します
            java.awt.Color クラスのstatic フィールド名の文字列で指定します。
            [renderer属性]
              BLACK   , BLUE   , CYAN , DARK_GRAY , GRAY  , GREEN , LIGHT_GRAY ,
              MAGENTA , ORANGE , PINK , RED       , WHITE , YELLOW
              #XXXXXX形式の16bitRGB表記

  機能分類
    画面表示
  バージョン
    0.9.0 2007/06/19
  作成者
    Nakamura
  導入されたバージョン:
    JDK1.4,

- - ### フィールドの概要

    - ### クラスから継承されたフィールド javax.servlet.jsp.tagext.BodyTagSupport

      `bodyContent`

    - ### クラスから継承されたフィールド javax.servlet.jsp.tagext.TagSupport

      `id, pageContext`

    - ### インタフェースから継承されたフィールド javax.servlet.jsp.tagext.BodyTag

      `EVAL_BODY_BUFFERED, EVAL_BODY_TAG`

    - ### インタフェースから継承されたフィールド javax.servlet.jsp.tagext.IterationTag

      `EVAL_BODY_AGAIN`

    - ### インタフェースから継承されたフィールド javax.servlet.jsp.tagext.Tag

      `EVAL_BODY_INCLUDE, EVAL_PAGE, SKIP_BODY, SKIP_PAGE`

  - ### コンストラクタの概要

    コンストラクタ
    コンストラクタと説明
    `ChartDatasetTag()`

  - ### メソッドの概要

    メソッド
    修飾子とタイプ | メソッドと説明
    --- | ---
    `int` | `doAfterBody()` Taglibのタグ本体を処理する doAfterBody() を オーバーライドします。
    `int` | `doEndTag()` Taglibの終了タグが見つかったときに処理する doEndTag() を オーバーライドします。
    `int` | `doStartTag()` Taglibの開始タグが見つかったときに処理する doStartTag() を オーバーライドします。
    `protected void` | `release2()` タグリブオブジェクトをリリースします。
    `void` | `setBarItemMargin(String margin)` 【TAG】BOXチャートのバーアイテムのマージン(0.0～1.0)を指定します。
    `void` | `setBarMaxWidth(String barWidth)` 【TAG】BOXチャートのバー幅の最大値(0.0～1.0)を指定します。
    `void` | `setBarWidth(String width)` 【TAG】BOXチャートのバー幅(double)を指定します。
    `void` | `setBaseLegend(String baseLegend)` 【TAG】シリーズ単位の凡例 の表示可否を設定します。
    `void` | `setChartType(String chartType)` 【TAG】ChartDataset のデータタイプを指定します。
    `void` | `setDbid(String id)` 【TAG】(通常は使いません)Datasetオブジェクトを作成する時のDB接続IDを指定します。
    `void` | `setDomainMargin(String margin)` 【TAG】グラフの書き出し位置の調整比率を指定します。
    `void` | `setDynamicOCNo(String dynamicOCNo)` 【TAG】動的なマーカーラインの基準シリーズ番号を設定します(初期値:null)。
    `void` | `setItemLabelVisible(String itemLabelVisible)` 【TAG】データの値(itemText)を表示するかどうか[true/false/last]を指定します(初期値:false[表示しない])。
    `void` | `setLowerBound(String lowerBound)` 【TAG】チャートの縦軸の最小値をセットします(初期値:自動計算)。
    `void` | `setMarkColors(String markColors)` 【TAG】マーカーラインの色をカンマ区切り形式で複数指定します。
    `void` | `setMarkOverColors(String overColors)` 【TAG】マーカーラインの超過時のShape色をカンマ区切り形式で複数指定します。
    `void` | `setMarkValues(String markValues)` 【TAG】マーカーラインの設定値をカンマ区切り形式で複数指定します。
    `void` | `setSeriesColors(String colors)` 【TAG】複数チャート描画時のチャート色の繰返しパターンをCVS形式で複数指定します。
    `void` | `setShapeColors(String colors)` 【TAG】データ毎にShapeを切り替える時の色の繰返しパターンを文字列配列で指定します。
    `void` | `setShapeScale(String scale)` 【TAG】shapeの大きさを倍率指定で変更します(初期値:null)。
    `void` | `setShapesVisible(String shapesVisible)` 【TAG】ラインチャートのポイントを四角表示するかどうかを指定します(初期値:true)。
    `void` | `setTableId(String id)` 【TAG】(通常は使いません)結果のDBTableModelを、sessionに登録するときのキーを指定します (初期値:HybsSystem#TBL_MDL_KEY[=h_tblmdl])。
    `void` | `setTickSize(String size)` 【TAG】チャートの縦軸の目盛の幅をセットします(初期値:自動計算)。
    `void` | `setTimeFormatType(String type)` 【TAG】時刻を表す場合の表現の仕方[E1/E2/E3/H1/H2/H3]を指定します(初期値:null)。
    `void` | `setUpperBound(String upperBound)` 【TAG】チャートの縦軸の最大値をセットします(初期値:自動計算)。
    `void` | `setUseDottedLine(String useDottedLine)` 【TAG】ラインチャートの線をドットラインにするかどうか[true/false]を指定します(初期値:false[線分])。
    `void` | `setUseGradient(String useGradient)` 【TAG】バーチャートのグラデーション処理を行うかどうか[true/false]をセットします(初期値:false)。
    `void` | `setUseItemLabelSep(String used)` 【TAG】データの値(itemText)の表示に、桁区切り文字を使用するかどうか[true/false]を指定します(初期値:true[使用する])。
    `void` | `setUseMarkAnchor(String useAnchor)` 【TAG】マーカーライン描画時に、その設定値を表示します。
    `void` | `setUseTableData(String flag)` 【TAG】グラフ化するデータを DBTableModel から作成するかどうか(初期値:false)。
    `void` | `setUseVerticalLabels(String useVLavels)` 【TAG】ラベルの表示向きを縦にするかどうか[false/true]を指定します(初期値:false[横書き])。
    `void` | `setValueInset(String inset)` 【TAG】縦軸の表示領域INSET値(double)を指定します。
    `void` | `setValueLabel(String valueLabel)` 【TAG】縦軸の表示名称を指定します。
    `void` | `setValueLabelsVisible(String labelsVisible)` 【TAG】Value(縦軸)のラベルを表示するかどうかを指定します(初期値:true[表示する])。
    `void` | `setValueMarksVisible(String marksVisible)` 【TAG】Value(縦軸)のマーカーを表示するかどうかを指定します(初期値:true[表示する])。
    `void` | `setVisibleLimit(String limit)` 【TAG】表示下限値(これ以下のデータは未表示)の値(double)を指定します。
    `String` | `toString()` このオブジェクトの文字列表現を返します。

    - ### クラスから継承されたメソッド org.opengion.hayabusa.taglib.CommonTagSupport

      `add, add, addEventColumn, addEventColumn, check, check, commitTableObject, debugPrint, doCatch, doFinally, get, getApplicationInfo, getAttributes, getBodyRawString, getBodyString, getContextAttribute, getContextPath, getCookie, getCSVParameter, getDataCondition, getDateFormat, getDBColumn, getDBFunctionName, getDocumentLink, getGUIInfo, getGUIInfoAttri, getHostName, getLabel, getLabelInterface, getLanguage, getLASTAttri, getLongLabel, getMsglbl, getNVLAttri, getObject, getParameterNames, getParameterRows, getRequest, getRequestAttribute, getRequestCacheData, getRequestParameter, getRequestParameterValues, getRequestValue, getRequestValue, getRequestValues, getReservedParameter, getReservedValue, getResource, getSanitizedBodyString, getScope, getSessionAttribute, getTagName, getUser, getUserEditInfo, getUserInfo, isAjaxSubmitRequest, isDebug, isNoTransitionRequest, isNull, jspPrint, removeContextAttribute, removeObject, removeRequestAttribute, removeSessionAttribute, set, setAjaxSubmitRequest, setCaseKey, setCaseNN, setCaseNull, setCaseVal, setContextAttribute, setCookie, setDebug, setLanguage, setLbl, setNoTransitionRequest, setObject, setObject, setParameterNames, setParameterRows, setRequestAttribute, setRequestCacheData, setScope, setSessionAttribute, setUserInfo, startQueryTransaction, sys, sysBool, sysInt, useMainTrans, useQuotCheck, useTag, useXssCheck`

    - ### クラスから継承されたメソッド javax.servlet.jsp.tagext.BodyTagSupport

      `doInitBody, getBodyContent, getPreviousOut, release, setBodyContent`

    - ### クラスから継承されたメソッド javax.servlet.jsp.tagext.TagSupport

      `findAncestorWithClass, getId, getParent, getValue, getValues, removeValue, setId, setPageContext, setParent, setValue`

    - ### クラスから継承されたメソッド java.lang.Object

      `clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait`

    - ### インタフェースから継承されたメソッド javax.servlet.jsp.tagext.Tag

      `getParent, setPageContext, setParent`

- - ### コンストラクタの詳細

    - #### ChartDatasetTag

          public ChartDatasetTag()

  - ### メソッドの詳細

    - #### doStartTag

          public int doStartTag()

      Taglibの開始タグが見つかったときに処理する doStartTag() を オーバーライドします。
      定義:
        `doStartTag` インタフェース内 `Tag`
      オーバーライド:
        `doStartTag` クラス内 `CommonTagSupport`
      戻り値:
        後続処理の指示( EVAL_BODY_BUFFERED )
      変更履歴:

        5.3.0.0 (2010/12/01) useTableDataによるデータ取得方法の機能追加

    - #### doAfterBody

          public int doAfterBody()

      Taglibのタグ本体を処理する doAfterBody() を オーバーライドします。
      定義:
        `doAfterBody` インタフェース内 `IterationTag`
      オーバーライド:
        `doAfterBody` クラス内 `CommonTagSupport`
      戻り値:
        後続処理の指示(SKIP_BODY)
      変更履歴:

        5.3.0.0 (2010/12/01) データベース検索処理を、doEndTag() メソッドから移動

    - #### doEndTag

          public int doEndTag()

      Taglibの終了タグが見つかったときに処理する doEndTag() を オーバーライドします。
      定義:
        `doEndTag` インタフェース内 `Tag`
      オーバーライド:
        `doEndTag` クラス内 `CommonTagSupport`
      戻り値:
        後続処理の指示
      変更履歴:

        4.0.0.1 (2007/12/03) try ～ catch ～ finally をきちんと行う。
        5.2.1.0 (2010/10/01) debugPrint() メソッド追加
        5.3.0.0 (2010/12/01) データベース検索処理を、doAfterBody() へ移動

    - #### release2

          protected void release2()

      タグリブオブジェクトをリリースします。 キャッシュされて再利用されるので、フィールドの初期設定を行います。
      オーバーライド:
        `release2` クラス内 `CommonTagSupport`
      変更履歴:

        4.0.0.0 (2007/10/10) dbid の初期値を、"DEFAULT" から null に変更
        5.3.0.0 (2010/12/01) useTableData,tableId 属性追加

    - #### setDbid

          public void setDbid(String id)

      【TAG】(通常は使いません)Datasetオブジェクトを作成する時のDB接続IDを指定します。
      パラメータ:
        `id` - データベース接続ID
      説明:

             Datasetオブジェクトを作成する時のDB接続IDを指定します。
             これは、システムリソースで、DEFAULT_DB_URL 等で指定している データベース接続先
             情報に、XX_DB_URL を定義することで、 dbid="XX" とすると、この 接続先を使用して
             データベースにアクセスできます。

    - #### setChartType

          public void setChartType(String chartType)

      【TAG】ChartDataset のデータタイプを指定します。
      パラメータ:
        `chartType` - チャートタイプ
      関連項目:
        `CategoryItemRenderer`, `XYItemRenderer`
      説明:

             チャートタイプ は、外部からチャートを指定するのに便利なように、キー化
             されています。このキーに基づいて、ChartFactory クラスの
             チャートタイプ変換表に基づいて、レンデラーや、データセットを作成します。
             基本的には、チャートタイプ は、この、レンデラー名称から決定しています。

               各種オブジェクトの組み合わせ一覧
                チャートタイプ           レンデラー(org.jfree.chart.renderer.)     Dataset
                HybsLine                 HybsLineRenderer                          Category
                LineAndShape             category.LineAndShapeRenderer             Category
                Line3D                   category.LineRenderer3D                   Category
                StatisticalLineAndShape  category.StatisticalLineAndShapeRenderer  Category
                HybsBar                  HybsBarRenderer                           Category
                Bar                      category.BarRenderer                      Category
                Bar3D                    category.BarRenderer3D                    Category
                Area                     category.AreaRenderer                     Category
                HybsStackedBar           HybsStackedBarRenderer                    Category
                StackedBar               category.StackedBarRenderer               Category
                StackedBar3D             category.StackedBarRenderer3D             Category
                StackedArea              category.StackedAreaRenderer              Category
                GroupedStackedBar        category.GroupedStackedBarRenderer        Category
                LayeredBar               category.LayeredBarRenderer               Category
                CategoryStep             category.CategoryStepRenderer             Category
                Level                    category.LevelRenderer                    Category
                MinMax                   category.MinMaxCategoryRenderer           Category
                WaterfallBar             category.WaterfallBarRenderer             Category
                MultiplePie              null                                      Category
                SpiderWeb                null                                      Category
                Pie                      null                                      Pie
                Pie3D                    null                                      Pie
                Ring                     null                                      Pie
                XYArea                   xy.XYAreaRenderer                         XY
                XYArea2                  xy.XYAreaRenderer2                        XY
                XYBlock                  xy.XYBlockRenderer                        XY
                CyclicXYItem             xy.CyclicXYItemRenderer                   XY
                HighLow                  xy.HighLowRenderer                        XY
                StackedXYArea            xy.StackedXYAreaRenderer                  XY
                StackedXYArea2           xy.StackedXYAreaRenderer2                 XY
                StandardXYItem           xy.StandardXYItemRenderer                 XY
                XYBubble                 xy.XYBubbleRenderer                       XY
                XYDifference             xy.XYDifferenceRenderer                   XY
                XYDot                    xy.XYDotRenderer                          XY
                XYError                  xy.XYErrorRenderer                        XY
                XYLine3D                 xy.XYLine3DRenderer                       XY
                XYLineAndShape           xy.XYLineAndShapeRenderer                 XY
                XYStepArea               xy.XYStepAreaRenderer                     XY
                XYStep                   xy.XYStepRenderer                         XY
                PolarItem                DefaultPolarItemRenderer                  XY
                Meter                    null                                      Value
                Thermometer              null                                      Value
                Compass                  null                                      Value
                Gantt                    category.GanttRenderer                    TaskSeries
                XYBarV                   xy.XYBarRenderer                          TimeSeries
                ClusteredXYBarV          xy.ClusteredXYBarRenderer                 TimeSeries
                YIntervalV               xy.YIntervalRenderer                      TimeSeries
                DeviationV               xy.DeviationRenderer                      TimeSeries
                TimeSeriesLineV          xy.StandardXYItemRenderer                 TimeSeries
                TimeSeriesLineH          xy.StandardXYItemRenderer                 TimeSeries
                TimeSeriesBarV           xy.XYBarRenderer                          TimeSeries
                TimeSeriesBarH           xy.XYBarRenderer                          TimeSeries
                StackedTimeSeriesLineV   xy.StandardXYItemRenderer                 TimeSeries
                StackedTimeSeriesLineH   xy.StandardXYItemRenderer                 TimeSeries

             Meter と Compass は、さらに、needleType が指定できます。
             これは、Meter_PIE や、Compass_Arrow などとすることで、形状を指定できます。
             Meter には、CHORD,CIRCLE(初期値),PIE
             Compass には、Arrow,Line,Long,Pin,Plum,Pointer(初期値),Ship,Wind,Arrow,MiddlePin が指定できます。

      変更履歴:

        5.7.8.0 (2014/07/04) needleType 対応

    - #### setUseTableData

          public void setUseTableData(String flag)

      【TAG】グラフ化するデータを DBTableModel から作成するかどうか(初期値:false)。
      パラメータ:
        `flag` - データをDBTableModelを利用する場合、true
      説明:

             useTableData="false"(初期値)の場合は、BODY部に書かれた SQL 文を実行してデータを取得します。
             useTableData="true" にすると、その前の query タグ等で作成した DBTableModel を利用して
             グラフ化します。その場合は、BODY部の SQL 文は、無視されます。
             利用する DBTableModel は、tableId と scope 属性から取得します。

      変更履歴:

        5.3.0.0 (2010/12/01) 新規追加

    - #### setTableId

          public void setTableId(String id)

      【TAG】(通常は使いません)結果のDBTableModelを、sessionに登録するときのキーを指定します (初期値:HybsSystem#TBL_MDL_KEY[=h_tblmdl])。
      パラメータ:
        `id` - sessionに登録する時の ID
      説明:

             検索結果より、DBTableModelオブジェクトを作成します。これを、下流のviewタグ等に
             渡す場合に、通常は、session を利用します。その場合の登録キーです。
             query タグを同時に実行して、結果を求める場合、同一メモリに配置される為、
             この tableId 属性を利用して、メモリ空間を分けます。
            		(初期値:HybsSystem#TBL_MDL_KEY[={@og.value org.opengion.hayabusa.common.HybsSystem#TBL_MDL_KEY}])。

    - #### setBaseLegend

          public void setBaseLegend(String baseLegend)

      【TAG】シリーズ単位の凡例 の表示可否を設定します。
      パラメータ:
        `baseLegend` - シリーズ単位の凡例 の表示可否
      説明:

             シリーズ単位の凡例 の表示可否を設定します。

    - #### setValueLabel

          public void setValueLabel(String valueLabel)

      【TAG】縦軸の表示名称を指定します。
      パラメータ:
        `valueLabel` - 縦軸の表示名称
      説明:

             縦軸の表示名称を指定します。

    - #### setMarkValues

          public void setMarkValues(String markValues)

      【TAG】マーカーラインの設定値をカンマ区切り形式で複数指定します。
      パラメータ:
        `markValues` - マーカーラインの設定値(CSV形式)
      関連項目:
        `setMarkColors( String )`
      説明:

             指定の値にマーカーラインを引きます。
             色は、setMarkColors( String ) で指定します。
             markColors と、個数をあわせて設定する必要があります。
             どちらかが、指定されていない場合は、マーカー表示されません。
             dynamicOCNo を使用する場合は、そのValues の並びの箇所に、
             "G"  という文字列を設定して下さい。
             例：2000,G  基準１は、2000の直線、基準２は、グラフ という意味。

    - #### setUseMarkAnchor

          public void setUseMarkAnchor(String useAnchor)

      【TAG】マーカーライン描画時に、その設定値を表示します。
      パラメータ:
        `useAnchor` - true:設定値を表示する。
      説明:

             マーカーラインの縦軸の設定値(markValues)に、設定値をラベル表示します。
             位置は、TextAnchor.BASELINE_LEFT 固定です。
             初期値は、表示する(true)です。

      変更履歴:

        4.1.1.0 (2008/02/04) 新規追加

    - #### setMarkColors

          public void setMarkColors(String markColors)

      【TAG】マーカーラインの色をカンマ区切り形式で複数指定します。
      パラメータ:
        `markColors` - マーカーラインの色(CSV形式)
      関連項目:
        `Color.BLACK`, `setMarkValues( String )`
      説明:

             マーカーラインとは、縦軸設定のラインの事で、縦軸の設定値(markValues)に
             横方向にラインを付与します。このラインの色を、カンマ区切り形式で
             指定します。
             markValues と、あわせて設定する必要があります。
             個数が異なる場合は、markValues が優先され、無指定の場合は、Color.REDで
             表示されます。

             指定文字列は、java.awt.Color クラスのstatic フィールド名で指定します。
             BLACK , BLUE , CYAN , DARK_GRAY , GRAY , GREEN , LIGHT_GRAY ,
             MAGENTA , ORANGE , PINK , RED , WHITE , YELLOW , (PURPLE) が指定できます。
             また、#XXXXXX形式の16bitRGB表記 でも指定可能です。

                  BLACK   , BLUE   , CYAN , DARK_GRAY , GRAY  , GREEN , LIGHT_GRAY ,
                  MAGENTA , ORANGE , PINK , RED       , WHITE , YELLOW , (PURPLE)
                  #XXXXXX形式の16bitRGB表記 でも指定可能です。

    - #### setMarkOverColors

          public void setMarkOverColors(String overColors)

      【TAG】マーカーラインの超過時のShape色をカンマ区切り形式で複数指定します。
      パラメータ:
        `overColors` - マーカーラインの超過時のShape色(CSV形式)
      関連項目:
        `Color.BLACK`
      説明:

             HybsLine でのみ使用可能です。
             マーカーラインを使用する場合に、そのラインを超えない色、超える色を指定します。
             この色の指定は、マーカーラインの色やマーカーラインの設定値の個数＋１に
             なります。つまり、色１：設定値１：色２：設定値２：色３ となります。
             色１は、設定値１より小さい場合に使用され、色２は、設定値１より大きく、
             設定値２より小さい場合、色３は、設定値２より大きい場合になります。

             指定文字列は、java.awt.Color クラスのstatic フィールド名で指定します。
             BLACK , BLUE , CYAN , DARK_GRAY , GRAY , GREEN , LIGHT_GRAY ,
             MAGENTA , ORANGE , PINK , RED , WHITE , YELLOW , (PURPLE) が指定できます。
             また、#XXXXXX形式の16bitRGB表記 でも指定可能です。
             markValues と、あわせて設定する必要があります。
             どちらかが、指定されていない場合は、マーカー表示されません。

                  BLACK   , BLUE   , CYAN , DARK_GRAY , GRAY  , GREEN , LIGHT_GRAY ,
                  MAGENTA , ORANGE , PINK , RED       , WHITE , YELLOW , (PURPLE)
                  #XXXXXX形式の16bitRGB表記 でも指定可能です。

      変更履歴:

        4.0.3.0 (2008/01/07) 新規追加

    - #### setDynamicOCNo

          public void setDynamicOCNo(String dynamicOCNo)

      【TAG】動的なマーカーラインの基準シリーズ番号を設定します(初期値:null)。
      パラメータ:
        `dynamicOCNo` - true:動的なマーカーラインの基準シリーズ番号
      説明:

             動的なマーカーラインを使用する場合は、基準値となるシリーズ番号を指定します。

             マーカーラインの最下位閾値に相当します。これは、グラフ化されますが、
             Shape は自動的に削除されます。
             この設定を使用する場合、最初のデータには、必ずShapeが付きます。それ以外の
             データに、Shape を付けるかどうかは、shapesVisible 属性で指定します。
             この線の色は、markColors で指定した、最下位の色になります。また、
             markValues で指定した、最下位の値は、使用されません。ただし、色指定の
             関係上、設定しておく必要があります。
             また、isValueVisible == true で、設定値の値表示を行う場合も、最下位の
             値は表示しないようにします。
             初期値は、使用しない(null)です。

      変更履歴:

        4.1.1.0 (2008/02/04) 新規追加
        4.1.1.0 (2008/02/19) setUseDynamicOC ⇒ setDynamicOCNo

    - #### setLowerBound

          public void setLowerBound(String lowerBound)

      【TAG】チャートの縦軸の最小値をセットします(初期値:自動計算)。
      パラメータ:
        `lowerBound` - 縦軸の最小値
      説明:

             何も指定しない場合は、データの最小値から、自動的に計算します。

    - #### setUpperBound

          public void setUpperBound(String upperBound)

      【TAG】チャートの縦軸の最大値をセットします(初期値:自動計算)。
      パラメータ:
        `upperBound` - 縦軸の最大値
      説明:

             何も指定しない場合は、データの最大値から、自動的に計算します。

    - #### setTickSize

          public void setTickSize(String size)

      【TAG】チャートの縦軸の目盛の幅をセットします(初期値:自動計算)。
      パラメータ:
        `size` - 縦軸のチック(目盛)の幅
      説明:

             何も指定しない場合は、データの範囲から、自動的に計算します。

      変更履歴:

        4.0.3.0 (2008/01/07) 新規追加

    - #### setUseGradient

          public void setUseGradient(String useGradient)

      【TAG】バーチャートのグラデーション処理を行うかどうか[true/false]をセットします(初期値:false)。
      パラメータ:
        `useGradient` - グラデーション処理 [true:する/false:しない]
      説明:

             通常のバーチャートは、単一色表示で表されますが、これにグラデーション効果を
             付加するかどうかを指定します。
             通常のバーチャートが、少しきれいに見えます。
             初期値は、false(使用しない)です。

    - #### setShapesVisible

          public void setShapesVisible(String shapesVisible)

      【TAG】ラインチャートのポイントを四角表示するかどうかを指定します(初期値:true)。
      パラメータ:
        `shapesVisible` - ポイントを四角表示するかどうか
      説明:

             ラインチャートは、通常、線分で表され、各ポイントについても、線分で接続されます。
             shapesVisible を true に設定すると、各ポイントが、線上に四角く表示され、
             そのポイントの位置を、容易に判断出来るようになります。
             初期値は、true( LineAndShape )です。

    - #### setShapeColors

          public void setShapeColors(String colors)

      【TAG】データ毎にShapeを切り替える時の色の繰返しパターンを文字列配列で指定します。
      パラメータ:
        `colors` - データ毎の色の繰返しパターン(文字列配列)
      関連項目:
        `Color.BLACK`
      説明:

             HybsLine でのみ使用可能です。
             これは、データそのものが、繰返し性のある場合に、その繰返し性に対応した
             形状のShape を表示させる場合に使用します。
             繰返しShapeの形状は、JFreeChart のシリーズ毎の繰返し標準形状を使用します。
             現在のバージョンでは、１０個までの繰返しに対応可能です。
             繰返し色を、指定した分だけ、順に使用されていきます。

             指定文字列は、java.awt.Color クラスのstatic フィールド名で指定します。
             BLACK , BLUE , CYAN , DARK_GRAY , GRAY , GREEN , LIGHT_GRAY ,
             MAGENTA , ORANGE , PINK , RED , WHITE , YELLOW , (PURPLE) が指定できます。
             また、#XXXXXX形式の16bitRGB表記 でも指定可能です。

      変更履歴:

        4.0.3.0 (2008/01/07) 新規追加

    - #### setShapeScale

          public void setShapeScale(String scale)

      【TAG】shapeの大きさを倍率指定で変更します(初期値:null)。
      パラメータ:
        `scale` - shapeの大きさの倍率
      説明:

             ラインチャートのShape(各グラフのポイントのマーカー)の大きさは、通常は、
             自動設定されます。
             この大きさを、倍率指定で、変更可能です。
             指定は、double 型です。
             初期値は、null は、スケール変更しません(自動設定のままの大きさ)

      変更履歴:

        4.1.1.0 (2008/02/04) 新規追加

    - #### setUseDottedLine

          public void setUseDottedLine(String useDottedLine)

      【TAG】ラインチャートの線をドットラインにするかどうか[true/false]を指定します(初期値:false[線分])。
      パラメータ:
        `useDottedLine` - ドットラインにするかどうか [true:点線/false:線分]
      説明:

             ラインチャートは、通常、線分で表されます。
             これに、点線で表すことで、グラフの違いを、色だけでなく形状でも識別
             しやすくすることが可能です。
             初期値は、false(線分)です。

    - #### setSeriesColors

          public void setSeriesColors(String colors)

      【TAG】複数チャート描画時のチャート色の繰返しパターンをCVS形式で複数指定します。
      パラメータ:
        `colors` - チャート色の繰返しパターン(CVS形式)
      関連項目:
        `Color.BLACK`
      説明:

             通常、複数のチャートを同時に表示させる場合は、縦軸が共通であれば、
             １回のSelect分で複数データを取得します。
             この、データをシリーズと呼んでおり、これを区別する為に、色を分けます。
             初期値は、JFreeChart が自動で割り振ります。
             これを、外部からCVS形式で、カンマ区切りで色コードを指定します。
             指定データが多い場合は、多い分の色は使用されません。少ない場合は、
             順番に繰り返して使用されます。
             例えば、１色だけ指定した場合は、すべてのシリーズが同じ色で表されます。

             指定文字列は、java.awt.Color クラスのstatic フィールド名で指定します。
             BLACK , BLUE , CYAN , DARK_GRAY , GRAY , GREEN , LIGHT_GRAY ,
             MAGENTA , ORANGE , PINK , RED , WHITE , YELLOW , (PURPLE) が指定できます。

             また、#XXXXXX形式の16bitRGB表記 でも指定可能です。

    - #### setValueLabelsVisible

          public void setValueLabelsVisible(String labelsVisible)

      【TAG】Value(縦軸)のラベルを表示するかどうかを指定します(初期値:true[表示する])。
      パラメータ:
        `labelsVisible` - Value(縦軸)のラベルを表示するかどうか
      説明:

             ValueAxis にて設定される、縦軸情報の、ラベルを表示するかどうか指定します。
             初期値は、true(表示する)です。

      変更履歴:

        4.0.2.0 (2007/12/20) 新規追加

    - #### setValueMarksVisible

          public void setValueMarksVisible(String marksVisible)

      【TAG】Value(縦軸)のマーカーを表示するかどうかを指定します(初期値:true[表示する])。
      パラメータ:
        `marksVisible` - Value(縦軸)のマーカーを表示するかどうか
      説明:

             ValueAxis にて設定される、縦軸情報の、マーカーを表示するかどうか指定します。
             初期値は、true(表示する)です。

      変更履歴:

        4.0.2.0 (2007/12/20) 新規追加

    - #### setItemLabelVisible

          public void setItemLabelVisible(String itemLabelVisible)

      【TAG】データの値(itemText)を表示するかどうか[true/false/last]を指定します(初期値:false[表示しない])。
      パラメータ:
        `itemLabelVisible` - データの値の表示のさせ方(true,false,last)
      説明:

             CategoryItemRenderer 関連のグラフの設定値をグラフ上に表示するかどうかを
             指定します。
             true に設定した場合、通常の場合は、すべてのシリーズにラベル表示されます。
             false に設定すると、表示されません。
             last を設定すると、各シリーズの最後の値のみ表示されます。
             ChartCreate クラスに、seriesPikup が設定されている場合は、指定のシリーズ
             のみの設定値を表示し、他の値は、表示しません。
             同様に、dynamicOCNo が指定されている場合(動的なマーカーライン)
             最下位のシリーズは、閾値として使用されるため、設定値は表示されません。
             ラベルの表示位置は、表示する線グラフの傾きに応じてラベルの表示場所を
             変えます。山形、右坂、谷形、左坂 に応じて、上中、下右、下中、上右 に
             位置を設定します。右にずらすのは、10 ピクセル固定です。
             初期値は、false(表示しない)です。

      変更履歴:

        4.1.1.0 (2008/02/04) 新規追加
        4.1.2.0 (2008/03/12) 文字列のまま、渡すように変更

    - #### setUseItemLabelSep

          public void setUseItemLabelSep(String used)

      【TAG】データの値(itemText)の表示に、桁区切り文字を使用するかどうか[true/false]を指定します(初期値:true[使用する])。
      パラメータ:
        `used` - データの桁区切り文字の使用有無
      説明:

             itemLabelVisible=true 時に、表示されるデータ値ラベルで、
             NumberFormat していますが、３桁区切り文字(123,456,789.0) の
             区切り記号を表示するかどうかを指定します。
             true を指定すると、表示します。false では、表示しません。
             初期値は、true(使用する)です。

      変更履歴:

        4.1.2.0 (2008/03/12) 新規追加

    - #### setValueInset

          public void setValueInset(String inset)

      【TAG】縦軸の表示領域INSET値(double)を指定します。
      パラメータ:
        `inset` - Value(縦軸)の表示領域INSET値
      説明:

             縦軸文字表示領域(NumberAxis)の幅の追加値を設定します。
             これは、通常の表示領域の左側にスペースを挿入します。
             あくまで、追加する値なので、文字の長さは含まれません。
             何も指定しない場合は、設定しません。

      変更履歴:

        4.0.3.0 (2008/01/07) 新規追加

    - #### setBarWidth

          public void setBarWidth(String width)

      【TAG】BOXチャートのバー幅(double)を指定します。
      パラメータ:
        `width` - BOXチャートのバー幅(double)
      説明:

             BOXチャートのバー幅(double)を指定します。
             設定されるのは、org.jfree.chart.renderer.category.BarRenderer を
             使用した描画のみです。
             棒グラフのバー幅指定は、直接、CategoryItemRendererState に設定しています。
             通常は、barMaxWidth(0.0～1.0)とbarItemMargin(0.0～1.0)を用いて比率で指定します。
             何も指定しない場合は、設定しません。

      変更履歴:

        4.0.3.0 (2008/01/07) 新規追加

    - #### setBarMaxWidth

          public void setBarMaxWidth(String barWidth)

      【TAG】BOXチャートのバー幅の最大値(0.0～1.0)を指定します。
      パラメータ:
        `barWidth` - BOXチャートのバー幅の最大値(0.0～1.0)
      説明:

             BOXチャートのバー幅の比率の最大値を指定します。
             表示領域を１として小数点以下の数値で棒の幅を設定します。
             設定した幅に無理がある時は適当なサイズに調整されます。
             (小さくしたときには棒が線のようになる)
             設定されるのは、org.jfree.chart.renderer.category.BarRenderer を
             使用した描画のみです。
             何も指定しない場合は、設定しません。

      変更履歴:

        4.0.2.0 (2007/12/20) 新規追加

    - #### setBarItemMargin

          public void setBarItemMargin(String margin)

      【TAG】BOXチャートのバーアイテムのマージン(0.0～1.0)を指定します。
      パラメータ:
        `margin` - BOXチャートのバーアイテムのマージン(0.0～1.0)
      説明:

             BOXチャートのバーアイテムのマージンの比率を指定します。
             棒の間を表示領域を１として小数点以下の数値で幅を設定します。
             無理がある時は適当なサイズに調整されます。
             barMaxWidth より優先されます。
             設定されるのは、org.jfree.chart.renderer.category.BarRenderer を
             使用した描画のみです。
             何も指定しない場合は、設定しません。

      変更履歴:

        4.0.2.0 (2007/12/20) 新規追加

    - #### setVisibleLimit

          public void setVisibleLimit(String limit)

      【TAG】表示下限値(これ以下のデータは未表示)の値(double)を指定します。
      パラメータ:
        `limit` - 表示下限値(これ以下のデータは未表示)
      説明:

             HybsLine でのみ使用可能です。
             この設定値以下のデータは、存在しない扱いとします。
             Lineを引くとき、このデータと、存在しているデータ間にラインは引かれません。
             何も指定しない場合は、設定しません。

      変更履歴:

        4.0.3.0 (2008/01/07) 新規追加

    - #### setDomainMargin

          public void setDomainMargin(String margin)

      【TAG】グラフの書き出し位置の調整比率を指定します。
      パラメータ:
        `margin` - double グラフの書き出し位置の調整比率
      説明:

             HybsStackedBar でのみ使用可能です。
             グラフを描画する場合の、書き出し位置を少しずらします。
             これは、グラフの幅に対して、比率で指定します。
             0.0(初期値)の場合は、初期描画位置である、CategoryAnchor.Middle と
             同じ箇所から、書き出されます。
             1.0 の場合、中心から、グラフ幅の半分が加算され、END位置に寄ります。
             同様に、-1.0 の場合は、グラフ幅の半分が減算され、START 位置になります。
             つまり、中心から、グラフ幅の半分単位で、前方/後方にずらす事が出来ます。
               書き出し位置 ＝ 中心(Middle) + (domainMargin)＊幅/２
             初期値は、0.0(真ん中:MIDDLE)です。

      変更履歴:

        4.1.1.0 (2008/02/14) 新規追加

    - #### setTimeFormatType

          public void setTimeFormatType(String type)

      【TAG】時刻を表す場合の表現の仕方[E1/E2/E3/H1/H2/H3]を指定します(初期値:null)。
      パラメータ:
        `type` - 時刻の表示方法(E1,E2,E3,H1,H2,H3)
      説明:

             HybsNumberAxis にオーバーライドする 時間を表示する DecimalFormat の内部クラスを利用するに当たり、
             時刻の表示方法を指定します。
             外部から与える数字は、連続している必要があるため、１０進数です。
             たとえば、1700 → 17:00 , 2150 → 21:30 という感じです。
             2400 を超えると日付違いになります。

             英語表記(:)と日本語表記(時)の区別と、24時間を超える場合の表示方法によって、６種類のパターンが存在します。
             　E1:そのまま、24:00 となり、加算されていく。
             　E2:そのまま、0:00 に戻る。(日付は無視)
             　E3:そのまま、1 00:00 と日付が付与される。
             　H1:そのまま、24時00分 となり、加算されていく。
             　H2:そのまま、00時00分 に戻る。(日付は無視)
             　H3:そのまま、1日 00時00分 と日付が付与される。
             初期値は、使用しない(-1)です。

      変更履歴:

        5.5.2.1 (2012/05/07) 新規追加

    - #### setUseVerticalLabels

          public void setUseVerticalLabels(String useVLavels)

      【TAG】ラベルの表示向きを縦にするかどうか[false/true]を指定します(初期値:false[横書き])。
      パラメータ:
        `useVLavels` - ラベルの表示向き [false:横書き/true:縦書き]
      説明:

             ChartCreate の rotationLabel は、角度を指定できましたが、NumberAxis では、
             縦にするかどうかの指定しかできません。
             ここでは、true を指定するとラベルは、縦書きになります。
             初期値は、false(横書き)です。

      変更履歴:

        5.5.2.1 (2012/05/07) 新規追加

    - #### toString

          public String toString()

      このオブジェクトの文字列表現を返します。 基本的にデバッグ目的に使用します。
      オーバーライド:
        `toString` クラス内 `CommonTagSupport`
      戻り値:
        このクラスの文字列表現

Webアプリケーションフレームワーク openGion
Copyright (c) 2009 The openGion Project.