Save This Page
Home » jcommon-1.0.13 » org.jfree » data » jdbc » [javadoc | source]
org.jfree.data.jdbc
public class: JDBCCategoryDataset [javadoc | source]
java.lang.Object
   org.jfree.data.general.AbstractDataset
      org.jfree.data.category.DefaultCategoryDataset
         org.jfree.data.jdbc.JDBCCategoryDataset

All Implemented Interfaces:
    PublicCloneable, CategoryDataset, Serializable, Cloneable, Dataset, ObjectInputValidation

A CategoryDataset implementation over a database JDBC result set. The dataset is populated via a call to #executeQuery(String) with the string SQL query. The SQL query must return at least two columns. The first column will be the category name and remaining columns values (each column represents a series). Subsequent calls to #executeQuery(String) will refresh the dataset.

The database connection is read-only and no write back facility exists.

NOTE: Many people have found this class too restrictive in general use. For the greatest flexibility, please consider writing your own code to read data from a ResultSet and populate a DefaultCategoryDataset directly.
Field Summary
static final  long serialVersionUID    For serialization. 
Constructor:
 public JDBCCategoryDataset(Connection connection) 
    Create a new dataset with the given database connection.
    Parameters:
    connection - the database connection.
 public JDBCCategoryDataset(Connection connection,
    String query) throws SQLException 
    Creates a new dataset with the given database connection, and executes the supplied query to populate the dataset.
    Parameters:
    connection - the connection.
    query - the query.
    Throws:
    SQLException - if there is a problem executing the query.
 public JDBCCategoryDataset(String url,
    String driverName,
    String user,
    String passwd) throws ClassNotFoundException, SQLException 
    Creates a new dataset with a database connection.
    Parameters:
    url - the URL of the database connection.
    driverName - the database driver class name.
    user - the database user.
    passwd - the database user's password.
    Throws:
    ClassNotFoundException - if the driver cannot be found.
    SQLException - if there is an error obtaining a connection to the database.
Method from org.jfree.data.jdbc.JDBCCategoryDataset Summary:
executeQuery,   executeQuery,   getTranspose,   setTranspose
Methods from org.jfree.data.category.DefaultCategoryDataset:
addValue,   addValue,   clear,   clone,   equals,   getColumnCount,   getColumnIndex,   getColumnKey,   getColumnKeys,   getRowCount,   getRowIndex,   getRowKey,   getRowKeys,   getValue,   getValue,   hashCode,   incrementValue,   removeColumn,   removeColumn,   removeRow,   removeRow,   removeValue,   setValue,   setValue
Methods from org.jfree.data.general.AbstractDataset:
addChangeListener,   clone,   fireDatasetChanged,   getGroup,   hasListener,   notifyListeners,   removeChangeListener,   setGroup,   validateObject
Methods from java.lang.Object:
equals,   getClass,   hashCode,   notify,   notifyAll,   toString,   wait,   wait,   wait
Method from org.jfree.data.jdbc.JDBCCategoryDataset Detail:
 public  void executeQuery(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.

 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.

 public boolean getTranspose() 
    Returns a flag that controls whether or not the table values are transposed when added to the dataset.
 public  void setTranspose(boolean transpose) 
    Sets a flag that controls whether or not the table values are transposed when added to the dataset.