org.rhq.plugins.database

Class DatabaseQueryUtility

java.lang.Object

org.rhq.plugins.database.DatabaseQueryUtility

Deprecated.

as of RHQ 4.10, use DatabasePluginUtil instead.

@Deprecated
public class DatabaseQueryUtility
extends Object

Various database (JDBC) query functions.

Author:

Greg Hinkle

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	DatabaseQueryUtility.StatementParameter Deprecated. This class is not used for anything in the codebase of the database plugin. If you are using it in some way or another, move it to your own code, because this class will be removed in future.

Constructor Summary

Constructors

Constructor and Description
DatabaseQueryUtility() Deprecated. instantiating a static utility class doesn't make sense. Don't do it.

Method Summary

Methods

Modifier and Type	Method and Description
static void	close(Statement statement, ResultSet resultSet) Deprecated.
static int	executeUpdate(DatabaseComponent databaseComponent, String query, Object... parameters) Deprecated.
static String[]	getColumns(ResultSetMetaData rsmd) Deprecated.
static List<Map<String,Object>>	getGridValues(DatabaseComponent databaseComponent, String query, Object... parameters) Deprecated.
static Map<String,Double>	getNumericQueryValueMap(DatabaseComponent databaseComponent, String query, Object... parameters) Deprecated.
static Map<String,Double>	getNumericQueryValues(DatabaseComponent databaseComponent, String query, Object... parameters) Deprecated.
static Double	getSingleNumericQueryValue(DatabaseComponent databaseComponent, String query, Object... parameters) Deprecated.

Methods inherited from class java.lang.Object

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

Constructor Detail

DatabaseQueryUtility

@Deprecated
public DatabaseQueryUtility()

Deprecated. instantiating a static utility class doesn't make sense. Don't do it.

Method Detail

executeUpdate

@Deprecated
public static int executeUpdate(DatabaseComponent databaseComponent,
                           String query,
                           Object... parameters)
                         throws SQLException

Deprecated.

Executes a database update.

Parameters:

databaseComponent -

query -

parameters -

Returns:

Throws:

SQLException

getSingleNumericQueryValue

@Deprecated
public static Double getSingleNumericQueryValue(DatabaseComponent databaseComponent,
                                           String query,
                                           Object... parameters)

Deprecated.

Returns the result of a query as a single Double value. Returns Double.NaN if the query fails.

getNumericQueryValues

@Deprecated
public static Map<String,Double> getNumericQueryValues(DatabaseComponent databaseComponent,
                                                  String query,
                                                  Object... parameters)

Deprecated.

Executes a query, returning the results as a map where the keys are the column names and values are the value of that column. Note depending on the database, the column names may be uppercase (Oracle) or lowercase.

Parameters:

databaseComponent -

query - SQL query string

parameters - optional bind parameters

Returns:

a map of query results

getGridValues

@Deprecated
public static List<Map<String,Object>> getGridValues(DatabaseComponent databaseComponent,
                                                String query,
                                                Object... parameters)
                                              throws SQLException

Deprecated.

Returns a list of values, one per row, containing a map of column names to values of that row. Note depending on the database, the column names may be uppercase (Oracle) or lowercase.

Parameters:

databaseComponent - database to query

query - SQL query

parameters - parameters to bind to the query

Throws:

SQLException - if query fails

getNumericQueryValueMap

@Deprecated
public static Map<String,Double> getNumericQueryValueMap(DatabaseComponent databaseComponent,
                                                    String query,
                                                    Object... parameters)

Deprecated.

Returns a mapping of rows as key-value pairs where the key is the first column (a string) and the second column is a value numeric.

Parameters:

databaseComponent - the component to execute on

query - the sql query to run

parameters - any parameters to bind first

Returns:

a Map of the keys against the value

getColumns

@Deprecated
public static String[] getColumns(ResultSetMetaData rsmd)
                           throws SQLException

Deprecated.

Returns an array of strings as upper-case column names.

Throws:

SQLException

close

@Deprecated
public static void close(Statement statement,
                    ResultSet resultSet)

Deprecated.

Closes statements and result sets.