org.opengion.hayabusa.io

## クラス HybsJDBCCategoryDataset

- java.lang.Object
- - org.jfree.data.general.AbstractDataset
  - - org.jfree.data.category.DefaultCategoryDataset
    - - org.jfree.data.jdbc.JDBCCategoryDataset
      - - org.opengion.hayabusa.io.HybsJDBCCategoryDataset

- すべての実装されたインタフェース:
    ObjectInputValidation, Serializable, Cloneable, org.jfree.data.category.CategoryDataset, org.jfree.data.general.Dataset, org.jfree.data.KeyedValues2D, org.jfree.data.Values2D, org.jfree.util.PublicCloneable

      public class HybsJDBCCategoryDataset
      extends org.jfree.data.jdbc.JDBCCategoryDataset

       HybsJDBCCategoryDataset は、org.jfree.data.jdbc.JDBCCategoryDataset を継承したサブクラスで、
       executeQuery(Connection , String )  をオーバーライドしています。

       series の縦持ち 対応です。

       通常、select category,series1,series2,series3,… from … 形式で、シリーズは、カラムとして使用されます。
       series* には、数値が設定され、カラム名が、series 名になります。
       この、series名を縦持ちで与える形式が、このクラスになります。
       その結果、カラムの位置が、固定になるため、今までできなかった、category に対する色指定が可能になりました。
         形式①：select category,value from …
         形式②：select category,series,value from …
         形式③：select category,series,color,value from …

       必ず、カラムは、category,series,color,value の順番で用意します。value が、一番最後です。
       series がない場合は、category の別名ラベルがseries名になります。（形式①）
       color は、Colorコードです。series が無くても、color を指定する場合は、必ず必要です。（形式③）

       なお、Colorコードは、このクラスで作成しますが、Renderer に与える必要があります。
       通常のRenderer には、categoryにカラーを指定する機能がありませんので、HybsBarRenderer に
       用意します。
       categoryColor を与えるメソッドを作成し、getItemPaint( int,int ) をオーバーライドして、
       categoryに対応したカラーを返すようにします。
       理論的には、カテゴリとシリーズの組み合わせで色指定も可能ですが、今回は、category のみ対象とします。
       処理的には、一番最初に見つかったcategoryに指定された色を採用します。

       参考:JFreeChart : a free chart library for the Java(tm) platform(jfreechart-1.0.6)

  関連項目:
    直列化された形式
  変更履歴:

    3.8.9.2 (2007/07/28) 新規作成
    6.0.2.1 (2014/09/26) 新規復活(categoryにカラーを、指定する機能を用意します)

  バージョン
    0.9.0 2001/05/05
  作成者
    Kazuhiko Hasegawa
  導入されたバージョン:
    JDK1.1,

- - ### コンストラクタのサマリー

    コンストラクタ
    コンストラクタと説明
    `HybsJDBCCategoryDataset(Connection connection, String query)` Creates a new dataset with the given database connection, and executes the supplied query to populate the dataset.

  - ### メソッドのサマリー

    All Methods Instance Methods Concrete Methods
    修飾子とタイプ | メソッドと説明
    --- | ---
    `boolean` | `equals(Object object)` この文字列と指定されたオブジェクトを比較します。
    `void` | `executeQuery(Connection con, String query)` Populates the dataset by executing the supplied query against the existing database connection.
    `Color[]` | `getCategoryColor()` categoryカラー配列を取得します。
    `int` | `hashCode()` このオブジェクトのハッシュコードを取得します。

    - ### クラスから継承されたメソッド org.jfree.data.jdbc.JDBCCategoryDataset

      `executeQuery, getTranspose, setTranspose`

    - ### クラスから継承されたメソッド org.jfree.data.category.DefaultCategoryDataset

      `addValue, addValue, clear, clone, getColumnCount, getColumnIndex, getColumnKey, getColumnKeys, getRowCount, getRowIndex, getRowKey, getRowKeys, getValue, getValue, incrementValue, removeColumn, removeColumn, removeRow, removeRow, removeValue, setValue, setValue`

    - ### クラスから継承されたメソッド org.jfree.data.general.AbstractDataset

      `addChangeListener, fireDatasetChanged, getGroup, getNotify, hasListener, notifyListeners, removeChangeListener, setGroup, setNotify, validateObject`

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

      `finalize, getClass, notify, notifyAll, toString, wait, wait, wait`

    - ### インタフェースから継承されたメソッド org.jfree.data.general.Dataset

      `addChangeListener, getGroup, removeChangeListener, setGroup`

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

    - #### HybsJDBCCategoryDataset

          public HybsJDBCCategoryDataset(Connection connection,
                                         String query)
                                  throws SQLException

      Creates a new dataset with the given database connection, and executes the supplied query to populate the dataset.
      パラメータ:
        `connection` - the connection.
        `query` - the query.
      例外:
        `SQLException` - if there is a problem executing the query.

  - ### メソッドの詳細

    - #### executeQuery

          public void executeQuery(Connection con,
                                   String query)
                            throws SQLException

      Populates the dataset by executing the supplied query against the existing database connection. If no connection exists then no action is taken. The results from the query are extracted and cached locally, thus applying an upper limit on how many rows can be retrieved successfully.
      オーバーライド:
        `executeQuery` クラス内 `org.jfree.data.jdbc.JDBCCategoryDataset`
      パラメータ:
        `con` - the connection.
        `query` - the query.
      例外:
        `SQLException` - if there is a problem executing the query.
      関連項目:
        `JDBCCategoryDataset.executeQuery(Connection , String )`

    - #### getCategoryColor

          public Color[] getCategoryColor()

      categoryカラー配列を取得します。(独自メソッド) このクラスは、series を縦持ちするため、categoryにColorを指定できます。 select文で指定されていなかった場合は、null を返します。 形式③：select category,series,color,value from … なお、Colorコードは、このクラスで作成しますが、Renderer に与える必要があります。 通常のRenderer には、categoryにカラーを指定する機能がありませんので、HybsBarRenderer に 用意します。 categoryColor を与えるメソッドを作成し、getItemPaint( int,int ) をオーバーライドして、 categoryに対応したカラーを返すようにします。 理論的には、カテゴリとシリーズの組み合わせで色指定も可能ですが、今回は、category のみ対象とします。 処理的には、一番最初に見つかったcategoryに指定された色を採用します。
      戻り値:
        categoryカラー配列(なければ null)

    - #### equals

          public boolean equals(Object object)

      この文字列と指定されたオブジェクトを比較します。 親クラスで、equals メソッドが実装されているため、警告がでます。
      オーバーライド:
        `equals` クラス内 `org.jfree.data.category.DefaultCategoryDataset`
      パラメータ:
        `object` - 比較するオブジェクト
      戻り値:
        Objectが等しい場合は true、そうでない場合は false
      変更履歴:

        5.1.8.0 (2010/07/01) findbug対応
        5.1.9.0 (2010/08/01) findbug対応

    - #### hashCode

          public int hashCode()

      このオブジェクトのハッシュコードを取得します。
      オーバーライド:
        `hashCode` クラス内 `org.jfree.data.category.DefaultCategoryDataset`
      戻り値:
        ハッシュコード
      変更履歴:

        5.1.8.0 (2010/07/01) findbug対応
        5.1.9.0 (2010/08/01) findbug対応

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