org.unitils.core.dbsupport
Interface SQLHandler

All Known Implementing Classes:

DefaultSQLHandler

public interface SQLHandler

Method Summary

void	executeQuery(java.lang.String sql) Executes the given query.
int	executeUpdate(java.lang.String sql) Executes the given statement.
int	executeUpdateAndCommit(java.lang.String sql) Executes the given statement and commits.
boolean	exists(java.lang.String sql) Returns true if the query returned a record.
javax.sql.DataSource	getDataSource()
long	getItemAsLong(java.lang.String sql) Returns the long extracted from the result of the given query.
java.lang.String	getItemAsString(java.lang.String sql) Returns the value extracted from the result of the given query.
java.util.Set<java.lang.String>	getItemsAsStringSet(java.lang.String sql) Returns the items extracted from the result of the given query.
boolean	isDoExecuteUpdates()

Method Detail

executeUpdate

int executeUpdate(java.lang.String sql)

Executes the given statement.

Parameters:

sql - The sql statement

Returns:

The nr of updates

executeQuery

void executeQuery(java.lang.String sql)

Executes the given query. Note that no result is returned: this method is only useful in case you want to execute a query that has some desired side-effect (in fact, this method perfoms an update which is disguised as a query ;-) )

Parameters:

sql - The sql query

executeUpdateAndCommit

int executeUpdateAndCommit(java.lang.String sql)

Executes the given statement and commits.

Parameters:

sql - The sql statement

Returns:

The nr of updates

getItemAsLong

long getItemAsLong(java.lang.String sql)

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

Returns:

The long item value

getItemAsString

java.lang.String getItemAsString(java.lang.String sql)

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

Returns:

The string item value

getItemsAsStringSet

java.util.Set<java.lang.String> getItemsAsStringSet(java.lang.String sql)

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

Parameters:

sql - The sql string for retrieving the items

Returns:

The items, not null

exists

boolean exists(java.lang.String sql)

Returns true if the query returned a record.

Parameters:

sql - The sql string for checking the existence

Returns:

True if a record was returned

getDataSource

javax.sql.DataSource getDataSource()

Returns:

The DataSource

isDoExecuteUpdates

boolean isDoExecuteUpdates()

Returns:

Whether updates are executed on the database or not