org.sqlproc.engine
Interface SqlQuery

All Known Implementing Classes:

JdbcQuery

public interface SqlQuery

The SQL Engine query contract definition. In fact it's an adapter or a proxy to an internal stuff in one of the stacks on top of which the SQL Processor works.

For the concrete implementation please see for example JdbcQuery.

For more info please see the Reference Guide or the tutorials.

Author:

Vladimir Hudec

Method Summary

SqlQuery	addScalar(String columnAlias) Declares a scalar query result, which is an SQL query execution output value.
SqlQuery	addScalar(String columnAlias, Object type) Declares a scalar query result, which is an SQL query execution output value.
int	executeUpdate() Executes the update, delete or insert statement.
Object	getQuery() Returns the internal representation of this query.
List	list() Returns the query results as a List.
SqlQuery	setFirstResult(int firstResult) Sets the first row to retrieve.
SqlQuery	setMaxResults(int maxResults) Sets the maximum number of rows to retrieve.
SqlQuery	setParameter(String name, Object val) Binds a value to a named query parameter.
SqlQuery	setParameter(String name, Object val, Object type) Binds a value to a named query parameter.
SqlQuery	setParameterList(String name, Object[] vals) Binds multiple values to a named query parameter.
SqlQuery	setParameterList(String name, Object[] vals, Object type) Binds multiple values to a named query parameter.
SqlQuery	setTimeout(int timeout) Sets a timeout for the underlying query.
Object	uniqueResult() Convenience method to return a single instance that matches the query, or null if the query returns no results.

Method Detail

getQuery

Object getQuery()

Returns the internal representation of this query. This implementation depends on the stack on top of which the SQL Processor works. It can be for example the Hibernate SQLQuery instance.

Returns:

the internal representation of this query

setTimeout

SqlQuery setTimeout(int timeout)

Sets a timeout for the underlying query.

Parameters:

timeout - the timeout in seconds

Returns:

this instance to enable the methods chaining

setFirstResult

SqlQuery setFirstResult(int firstResult)

Sets the first row to retrieve. If not set, rows will be retrieved beginning from row 0.

Parameters:

firstResult - a row number, numbered from 0

Returns:

this instance to enable the methods chaining

setMaxResults

SqlQuery setMaxResults(int maxResults)

Sets the maximum number of rows to retrieve. If not set, there is no limit to the number of rows retrieved.

Parameters:

maxResults - the maximum number of rows

Returns:

this instance to enable the methods chaining

list

List list()
          throws SqlProcessorException

Returns the query results as a List. If the query contains multiple results pre row, the results are returned in an instance of Object[].

Returns:

the result list

Throws:

SqlProcessorException - in the case of any problem in ORM or JDBC stack

uniqueResult

Object uniqueResult()
                    throws SqlProcessorException

Convenience method to return a single instance that matches the query, or null if the query returns no results.

Returns:

the single result or null

Throws:

SqlProcessorException - in the case of any problem in ORM or JDBC stack

executeUpdate

int executeUpdate()
                  throws SqlProcessorException

Executes the update, delete or insert statement.

Returns:

the number of affected rows

Throws:

SqlProcessorException - in the case of any problem in ORM or JDBC stack

addScalar

SqlQuery addScalar(String columnAlias)

Declares a scalar query result, which is an SQL query execution output value.

Parameters:

columnAlias - the name of the database column or the alias in the result set

Returns:

this instance to enable the methods chaining

addScalar

SqlQuery addScalar(String columnAlias,
                   Object type)

Declares a scalar query result, which is an SQL query execution output value.

Parameters:

columnAlias - the name of the database column or the alias in the result set

type - the (META) type of the parameter

Returns:

this instance to enable the methods chaining

setParameter

SqlQuery setParameter(String name,
                      Object val)
                      throws SqlProcessorException

Binds a value to a named query parameter.

Parameters:

name - the name of the parameter

val - the not-null parameter value

Returns:

this instance to enable the methods chaining

Throws:

SqlProcessorException - in the case of any problem in ORM or JDBC stack

setParameter

SqlQuery setParameter(String name,
                      Object val,
                      Object type)
                      throws SqlProcessorException

Binds a value to a named query parameter.

Parameters:

name - the name of the parameter

val - the possibly-null parameter value

type - the (META) type of the parameter

Returns:

this instance to enable the methods chaining

Throws:

SqlProcessorException - in the case of any problem in ORM or JDBC stack

setParameterList

SqlQuery setParameterList(String name,
                          Object[] vals)
                          throws SqlProcessorException

Binds multiple values to a named query parameter. This is useful for binding a list of values to the query fragment in (:value_list).

Parameters:

name - the name of the parameter

vals - a collection of values

Returns:

this instance to enable the methods chaining

Throws:

SqlProcessorException - in the case of any problem in ORM or JDBC stack

setParameterList

SqlQuery setParameterList(String name,
                          Object[] vals,
                          Object type)
                          throws SqlProcessorException

Binds multiple values to a named query parameter. This is useful for binding a list of values to the query fragment in (:value_list).

Parameters:

name - the name of the parameter

vals - a collection of values

type - the (META) type of the parameter

Returns:

this instance to enable the methods chaining

Throws:

SqlProcessorException - in the case of any problem in ORM or JDBC stack