org.nuiton.topia

Class TopiaSqlQuery<O>

java.lang.Object

org.nuiton.topia.TopiaSqlQuery<O>

Type Parameters:

O - the type of result data

public abstract class TopiaSqlQuery<O>
extends Object

Wrap a Sql query some object. Implements the prepareResult(ResultSet) to transforma result set row to an object. You can also do some stuff on the result set just after the query was executed using method afterExecuteQuery(ResultSet).

Since:

2.5

Constructor Summary

Constructors

Constructor and Description
TopiaSqlQuery()

Method Summary

Methods

Modifier and Type	Method and Description
protected void	afterExecuteQuery(ResultSet set) A hook to obtain the result set just after the query execute.
protected String[]	getColumnNames(ResultSet set) Obtain the column names of a given result set using his metadata.
protected long	getNbRows(ResultSet set) From a given result set, let's count his number of row.
protected Map<String,Object>	getRowAsMap(String[] columnNames, ResultSet set) Given the column names of the result set, transform the row of the result set to a map with column name as key.
protected abstract PreparedStatement	prepareQuery(Connection connection) Prepare the statement used to do the sql query.
protected abstract O	prepareResult(ResultSet set) given a result set, extract the data.

Methods inherited from class java.lang.Object

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

Constructor Detail

TopiaSqlQuery

public TopiaSqlQuery()

Method Detail

prepareQuery

protected abstract PreparedStatement prepareQuery(Connection connection)
                                           throws SQLException

Prepare the statement used to do the sql query.

Parameters:

connection - jdbc connection to use

Returns:

the statement containing the query to execute

Throws:

SQLException - if any problem

prepareResult

protected abstract O prepareResult(ResultSet set)
                            throws SQLException

given a result set, extract the data.

Parameters:

set - the result set

Returns:

the data extracted from the current set, or null

Throws:

SQLException - if any prob

afterExecuteQuery

protected void afterExecuteQuery(ResultSet set)
                          throws SQLException

A hook to obtain the result set just after the query execute.

Parameters:

set - the result set just obtained

Throws:

SQLException - if any prob

Since:

2.6.4

getColumnNames

protected String[] getColumnNames(ResultSet set)
                           throws SQLException

Obtain the column names of a given result set using his metadata.

Parameters:

set - the result set to inspect

Returns:

the column names of the result set

Throws:

SQLException - if any pb

Since:

2.6.4

getNbRows

protected long getNbRows(ResultSet set)
                  throws SQLException

From a given result set, let's count his number of row.

Note: the result set must be scrollable to go back to before first row.

Parameters:

set - the result set to inspect

Returns:

the number of row of the given result set

Throws:

SQLException - if any pb

Since:

2.6.4

getRowAsMap

protected Map<String,Object> getRowAsMap(String[] columnNames,
                             ResultSet set)
                                  throws SQLException

Given the column names of the result set, transform the row of the result set to a map with column name as key.

Parameters:

columnNames - column names of the result set

set - the set to inspect

Returns:

the map for the given row of the result set

Throws:

SQLException - if any pb

Since:

2.6.4