org.unitils.database
Class SQLUnitils

java.lang.Object
  org.unitils.database.SQLUnitils

public class SQLUnitils
extends java.lang.Object

Utilities for executing statements and queries.

Author:

Tim Ducheyne, Filip Neven

Constructor Summary

SQLUnitils()

Method Summary

static int	executeUpdate(java.lang.String sql, javax.sql.DataSource dataSource) Executes the given update statement.
static int	executeUpdateQuietly(java.lang.String sql, javax.sql.DataSource dataSource) Executes the given statement ignoring all exceptions.
static long	getItemAsLong(java.lang.String sql, javax.sql.DataSource dataSource) Returns the long extracted from the result of the given query.
static java.lang.String	getItemAsString(java.lang.String sql, javax.sql.DataSource dataSource) Returns the value extracted from the result of the given query.
static java.util.Set<java.lang.String>	getItemsAsStringSet(java.lang.String sql, javax.sql.DataSource dataSource) Returns the items extracted from the result of the given query.
static boolean	isEmpty(java.lang.String tableName, javax.sql.DataSource dataSource) Utility method to check whether the given table is empty.

Methods inherited from class java.lang.Object

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

Constructor Detail

SQLUnitils

public SQLUnitils()

Method Detail

executeUpdate

public static int executeUpdate(java.lang.String sql,
                                javax.sql.DataSource dataSource)

Executes the given update statement.

Parameters:

sql - The sql string for retrieving the items

dataSource - The data source, not null

Returns:

The nr of updates

executeUpdateQuietly

public static int executeUpdateQuietly(java.lang.String sql,
                                       javax.sql.DataSource dataSource)

Executes the given statement ignoring all exceptions.

Parameters:

sql - The sql string for retrieving the items

dataSource - The data source, not null

Returns:

The nr of updates, -1 if not succesful

getItemAsLong

public static long getItemAsLong(java.lang.String sql,
                                 javax.sql.DataSource dataSource)

Returns the long extracted from the result of the given query. If no value is found, a UnitilsException is thrown.

Parameters:

sql - The sql string for retrieving the items

dataSource - The data source, not null

Returns:

The long item value

getItemAsString

public static java.lang.String getItemAsString(java.lang.String sql,
                                               javax.sql.DataSource dataSource)

Returns the value extracted from the result of the given query. If no value is found, a UnitilsException is thrown.

Parameters:

sql - The sql string for retrieving the items

dataSource - The data source, not null

Returns:

The string item value

getItemsAsStringSet

public static java.util.Set<java.lang.String> getItemsAsStringSet(java.lang.String sql,
                                                                  javax.sql.DataSource dataSource)

Returns the items extracted from the result of the given query.

Parameters:

sql - The sql string for retrieving the items

dataSource - The data source, not null

Returns:

The items, not null

isEmpty

public static boolean isEmpty(java.lang.String tableName,
                              javax.sql.DataSource dataSource)

Utility method to check whether the given table is empty.

Parameters:

tableName - The table, not null

dataSource - The data source, not null

Returns:

True if empty