org.databene.jdbacl

Class DBUtil

java.lang.Object

org.databene.jdbacl.DBUtil

public class DBUtil
extends Object

Provides database related utility methods.

Created: 06.01.2007 19:27:02

Author:

Volker Bergmann

Method Summary

Methods

Modifier and Type	Method and Description
static void	assertAllDbResourcesClosed(boolean critical)
static void	assertNext(ResultSet resultSet, String query)
static void	assertNoNext(ResultSet resultSet, String query)
static boolean	available(String url, String driverClass, String user, String password)
static void	checkReadOnly(String sql, boolean readOnly)
static void	close(Connection connection) Closes a database connection silently
static void	close(ResultSet resultSet)
static void	close(Statement statement)
static void	closeResultSetAndStatement(ResultSet resultSet)
static void	closeResultSetAndStatement(ResultSet resultSet, Statement statement)
static int	columnCount(ResultSet resultSet)
static Connection	connect(JDBCConnectData data, boolean readOnly)
static Connection	connect(String environment, boolean readOnly)
static Connection	connect(String url, String driverClassName, String user, String password, boolean readOnly)
static boolean	containsMandatoryColumn(DBConstraint fk)
static long	countRows(String tableName, Connection connection)
static ResultSet	createLoggingResultSet(ResultSet realResultSet, Statement statement)
static Statement	createLoggingStatementHandler(Statement statement, boolean readOnly)
static List<DBTable>	dependencyOrderedTables(TableHolder tableHolder)
static String	environmentFileName(String environment)
static boolean	equivalent(DBUniqueConstraint uk, DBPrimaryKeyConstraint pk)
static String	escape(String text)
static ResultSet	executeQuery(String query, Connection connection)
static DBExecutionResult	executeScript(String scriptText, char separator, Connection connection, boolean ignoreComments, org.databene.commons.ErrorHandler errorHandler)
static DBExecutionResult	executeScript(String scriptText, Connection connection, boolean ignoreComments, org.databene.commons.ErrorHandler errorHandler)
static DBExecutionResult	executeScriptFile(String scriptUri, String encoding, char separator, Connection connection, boolean ignoreComments, org.databene.commons.ErrorHandler errorHandler)
static DBExecutionResult	executeScriptFile(String scriptUri, String encoding, Connection connection, boolean ignoreComments, org.databene.commons.ErrorHandler errorHandler)
static int	executeUpdate(String sql, Connection connection)
static boolean	existsEnvironment(String environment)
static String	format(ResultSet resultSet)
static JDBCConnectData	getConnectData(String environment)
static Map<String,String>	getEnvironmentData(String environment)
static String[]	getEnvironmentNames()
static int	getOpenConnectionCount()
static int	getOpenPreparedStatementCount()
static int	getOpenResultSetCount()
static int	getOpenStatementCount()
static Statement	getStatement(ResultSet resultSet)
static void	insert(String table, Connection connection, DatabaseDialect dialect, Object... values)
static org.databene.commons.HeavyweightIterator<Object[]>	iterateQueryResults(String query, Connection connection)
static void	logMetaData(Connection connection)
static Object	parseAndSimplifyResultSet(ResultSet resultSet)
protected static Object[]	parseResultRow(ResultSet resultSet)
static List<Object[]>	parseResultSet(ResultSet resultSet)
static PreparedStatement	prepareStatement(Connection connection, String sql, boolean readOnly)
static PreparedStatement	prepareStatement(Connection connection, String sql, boolean readOnly, int resultSetType, int resultSetConcurrency, int resultSetHoldability)
static List<Object[]>	query(String query, Connection connection)
static Object	queryAndSimplify(String query, Connection connection)
static Integer	queryInt(String query, Connection connection)
static Long	queryLong(String query, Connection connection)
static Object	queryScalar(String query, Connection connection)
static <T> T[]	queryScalarRow(String query, Class<T> componentType, Connection connection)
static <T> T[]	queryScalarRowsAsArray(String query, Class<T> componentType, Connection connection)
static Object[]	querySingleRow(String query, Connection connection)
static String	queryString(PreparedStatement statement)
static ResultsWithMetadata	queryWithMetadata(String query, Connection connection)
static void	resetMonitors()
static Connection	wrapWithPooledConnection(Connection connection, boolean readOnly)

Methods inherited from class java.lang.Object

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

Method Detail

getEnvironmentNames

public static String[] getEnvironmentNames()

existsEnvironment

public static boolean existsEnvironment(String environment)

getEnvironmentData

public static Map<String,String> getEnvironmentData(String environment)
                                             throws IOException

Throws:

IOException

getConnectData

public static JDBCConnectData getConnectData(String environment)

environmentFileName

public static String environmentFileName(String environment)
                                  throws IOException

Throws:

IOException

connect

public static Connection connect(String environment,
                 boolean readOnly)
                          throws org.databene.commons.ConnectFailedException

Throws:

org.databene.commons.ConnectFailedException

connect

public static Connection connect(JDBCConnectData data,
                 boolean readOnly)
                          throws org.databene.commons.ConnectFailedException

Throws:

org.databene.commons.ConnectFailedException

connect

public static Connection connect(String url,
                 String driverClassName,
                 String user,
                 String password,
                 boolean readOnly)
                          throws org.databene.commons.ConnectFailedException

Throws:

org.databene.commons.ConnectFailedException

available

public static boolean available(String url,
                String driverClass,
                String user,
                String password)

close

public static void close(Connection connection)

Closes a database connection silently

wrapWithPooledConnection

public static Connection wrapWithPooledConnection(Connection connection,
                                  boolean readOnly)

getOpenConnectionCount

public static int getOpenConnectionCount()

resetMonitors

public static void resetMonitors()

createLoggingStatementHandler

public static Statement createLoggingStatementHandler(Statement statement,
                                      boolean readOnly)

prepareStatement

public static PreparedStatement prepareStatement(Connection connection,
                                 String sql,
                                 boolean readOnly)
                                          throws SQLException

Throws:

SQLException

prepareStatement

public static PreparedStatement prepareStatement(Connection connection,
                                 String sql,
                                 boolean readOnly,
                                 int resultSetType,
                                 int resultSetConcurrency,
                                 int resultSetHoldability)
                                          throws SQLException

Throws:

SQLException

close

public static void close(Statement statement)

getOpenStatementCount

public static int getOpenStatementCount()

getOpenPreparedStatementCount

public static int getOpenPreparedStatementCount()

createLoggingResultSet

public static ResultSet createLoggingResultSet(ResultSet realResultSet,
                               Statement statement)

getStatement

public static Statement getStatement(ResultSet resultSet)

close

public static void close(ResultSet resultSet)

closeResultSetAndStatement

public static void closeResultSetAndStatement(ResultSet resultSet)

closeResultSetAndStatement

public static void closeResultSetAndStatement(ResultSet resultSet,
                              Statement statement)

getOpenResultSetCount

public static int getOpenResultSetCount()

parseAndSimplifyResultSet

public static Object parseAndSimplifyResultSet(ResultSet resultSet)
                                        throws SQLException

Throws:

SQLException

parseResultSet

public static List<Object[]> parseResultSet(ResultSet resultSet)
                                     throws SQLException

Throws:

SQLException

parseResultRow

protected static Object[] parseResultRow(ResultSet resultSet)
                                  throws SQLException

Throws:

SQLException

columnCount

public static int columnCount(ResultSet resultSet)
                       throws SQLException

Throws:

SQLException

countRows

public static long countRows(String tableName,
             Connection connection)

format

public static String format(ResultSet resultSet)
                     throws SQLException

Throws:

SQLException

queryString

public static String queryString(PreparedStatement statement)

queryLong

public static Long queryLong(String query,
             Connection connection)

queryInt

public static Integer queryInt(String query,
               Connection connection)

queryScalar

public static Object queryScalar(String query,
                 Connection connection)

executeScriptFile

public static DBExecutionResult executeScriptFile(String scriptUri,
                                  String encoding,
                                  Connection connection,
                                  boolean ignoreComments,
                                  org.databene.commons.ErrorHandler errorHandler)
                                           throws IOException

Throws:

IOException

executeScriptFile

public static DBExecutionResult executeScriptFile(String scriptUri,
                                  String encoding,
                                  char separator,
                                  Connection connection,
                                  boolean ignoreComments,
                                  org.databene.commons.ErrorHandler errorHandler)
                                           throws IOException

Throws:

IOException

executeScript

public static DBExecutionResult executeScript(String scriptText,
                              Connection connection,
                              boolean ignoreComments,
                              org.databene.commons.ErrorHandler errorHandler)

executeScript

public static DBExecutionResult executeScript(String scriptText,
                              char separator,
                              Connection connection,
                              boolean ignoreComments,
                              org.databene.commons.ErrorHandler errorHandler)

executeUpdate

public static int executeUpdate(String sql,
                Connection connection)
                         throws SQLException

Throws:

SQLException

queryScalarRowsAsArray

public static <T> T[] queryScalarRowsAsArray(String query,
                             Class<T> componentType,
                             Connection connection)

queryScalarRow

public static <T> T[] queryScalarRow(String query,
                     Class<T> componentType,
                     Connection connection)

queryAndSimplify

public static Object queryAndSimplify(String query,
                      Connection connection)
                               throws SQLException

Throws:

SQLException

query

public static List<Object[]> query(String query,
                   Connection connection)
                            throws SQLException

Throws:

SQLException

querySingleRow

public static Object[] querySingleRow(String query,
                      Connection connection)
                               throws SQLException

Throws:

SQLException

assertNoNext

public static void assertNoNext(ResultSet resultSet,
                String query)
                         throws SQLException

Throws:

SQLException

assertNext

public static void assertNext(ResultSet resultSet,
              String query)
                       throws SQLException

Throws:

SQLException

iterateQueryResults

public static org.databene.commons.HeavyweightIterator<Object[]> iterateQueryResults(String query,
                                                                     Connection connection)
                                                                              throws SQLException

Throws:

SQLException

executeQuery

public static ResultSet executeQuery(String query,
                     Connection connection)
                              throws SQLException

Throws:

SQLException

escape

public static String escape(String text)

queryWithMetadata

public static ResultsWithMetadata queryWithMetadata(String query,
                                    Connection connection)
                                             throws SQLException

Throws:

SQLException

checkReadOnly

public static void checkReadOnly(String sql,
                 boolean readOnly)

logMetaData

public static void logMetaData(Connection connection)

dependencyOrderedTables

public static List<DBTable> dependencyOrderedTables(TableHolder tableHolder)

equivalent

public static boolean equivalent(DBUniqueConstraint uk,
                 DBPrimaryKeyConstraint pk)

assertAllDbResourcesClosed

public static void assertAllDbResourcesClosed(boolean critical)

containsMandatoryColumn

public static boolean containsMandatoryColumn(DBConstraint fk)

insert

public static void insert(String table,
          Connection connection,
          DatabaseDialect dialect,
          Object... values)
                   throws SQLException

Throws:

SQLException