jodd.db.orm
Class DbOrmQuery

java.lang.Object
  jodd.db.DbQuery
      jodd.db.orm.DbOrmQuery

public class DbOrmQuery
extends DbQuery

A simple ORM extension for DbQuery.

ORM extension may map results to objects in two ways:

• auto mode - when result set is mapped to provided types, and
• mapped mode - requires explicit mapping definitions.

Field Summary

static int	CLOSE_CURSORS_AT_COMMIT
static int	CONCUR_READ_ONLY
static int	CONCUR_UPDATABLE
protected int	concurrencyType
protected java.sql.Connection	connection
protected DbOrmManager	dbOrmManager
protected boolean	debug
static int	DEFAULT_HOLDABILITY Default holdability.
protected int	fetchSize
protected boolean	forcePreparedStatement If set to true all created statements will be prepared.
protected java.lang.String[]	generatedColumns
protected JoinHintResolver	hintResolver
protected java.lang.String[]	hints
static int	HOLD_CURSORS_OVER_COMMIT
protected int	holdability
protected int	maxRows
protected java.sql.PreparedStatement	preparedStatement
protected jodd.db.DbQueryParser	query
static int	QUERY_CLOSED
static int	QUERY_CREATED
static int	QUERY_INITIALIZED
protected int	queryState
protected java.util.Set<java.sql.ResultSet>	resultSets
protected DbSession	session
protected DbSqlGenerator	sqlgen
protected java.lang.String	sqlString
protected java.sql.Statement	statement
protected static int	totalOpenResultSetCount
protected int	type
static int	TYPE_FORWARD_ONLY
static int	TYPE_SCROLL_INSENSITIVE
static int	TYPE_SCROLL_SENSITIVE

Constructor Summary

DbOrmQuery(java.sql.Connection conn, DbSqlGenerator sqlgen)

DbOrmQuery(java.sql.Connection conn, java.lang.String sqlString)

DbOrmQuery(DbSession session, DbSqlGenerator sqlgen)

DbOrmQuery(DbSession session, java.lang.String sqlString)

DbOrmQuery(DbSqlGenerator sqlgen)

DbOrmQuery(java.lang.String sqlString)

Method Summary

protected ResultSetMapper	buildResultSetMapper(java.sql.ResultSet resultSet) Factory for result sets mapper.
protected void	checkCreated() Checks if query is created (and not yet initialized or closed) and throws an exception if it is not.
protected void	checkInitialized() Checks if query is initialized and throws an exception if it is not.
protected void	checkNotClosed() Checks if query is not closed and throws an exception if it is.
void	close() Closes the query and all created results sets and detaches itself from the session.
protected void	close(ResultSetMapper rsm, boolean closeQuery) Closes results set or whole query.
void	closeAllResultSets() Closes all result sets created by this query.
void	closeCursorsAtCommit()
protected java.util.List<java.sql.SQLException>	closeQuery() Closes all assigned result sets and then closes the query.
void	closeResultSet(java.sql.ResultSet rs) Closes single result set that was created by this query, It is not necessary to close result sets explicitly, since DbQueryBase.close() method closes all created result sets.
void	concurReadOnly()
void	concurUpdatable()
java.sql.ResultSet	execute() Executes the query.
protected ResultSetMapper	executeAndBuildResultSetMapper() Executes the query and returns builded ResultSet mapper.
long	executeCount() Special execute() for 'select count(*)' queries.
protected long	executeCount(boolean close) Executes count queries and optionally closes query afterwards.
long	executeCountAndClose() Executes count queries and closes afterwards.
int	executeUpdate() Executes UPDATE, INSERT or DELETE queries.
protected int	executeUpdate(boolean closeQuery) Executes UPDATE, INSERT or DELETE queries and optionally closes the query.
int	executeUpdateAndClose() Executes UPDATE, INSERT or DELETE queries and closes query afterwards.
java.lang.Object	find()
java.lang.Object	find(java.lang.Class... types)
protected java.lang.Object	find(java.lang.Class[] types, boolean close, java.sql.ResultSet resultSet)
java.lang.Object	findAndClose()
java.lang.Object	findAndClose(java.lang.Class... types)
java.lang.Object	findGeneratedColumns(java.lang.Class... types)
<T> T	findGeneratedKey(java.lang.Class<T> type)
java.lang.Object	findOne()
<T> T	findOne(java.lang.Class<T> type)
protected <T> T	findOne(java.lang.Class<T> type, boolean close, java.sql.ResultSet resultSet)
java.lang.Object	findOneAndClose()
<T> T	findOneAndClose(java.lang.Class<T> type)
void	forcePreparedStatement() Forces creation of prepared statements.
int	getConcurrencyType()
int	getFetchSize()
java.lang.String[]	getGeneratedColumnNames() Returns generated column names.
java.sql.ResultSet	getGeneratedColumns() Returns generated columns.
long	getGeneratedKey() Returns generated key i.e. first genereted column as long.
int	getHoldability()
DbOrmManager	getManager() Returns used ORM manager.
int	getMaxRows()
int	getOpenResultSetCount() Returns number of created result sets that are still not explicitly closed.
int	getQueryState() Returns query state.
java.lang.String	getQueryString() Returns query SQL string.
static int	getTotalOpenResultSetCount() Returns total number of open result sets.
int	getType()
void	holdCursorsOverCommit()
void	init() Initializes the query if not already initialized.
protected void	initializeJdbc() Performs JDBC initialization of the query.
boolean	isActive() Returns true if query is active: created and possibly initialized.
boolean	isClosed() Returns true if query is closed.
boolean	isInDebugMode()
boolean	isInitialized() Returns true if query is initialized.
<T> java.util.Iterator<T>	iterate()
<T> java.util.Iterator<T>	iterate(java.lang.Class... types)
protected <T> java.util.Iterator<T>	iterate(java.lang.Class[] types, boolean close)
<T> java.util.Iterator<T>	iterateAndClose()
<T> java.util.Iterator<T>	iterateAndClose(java.lang.Class... types)
<T> java.util.Iterator<T>	iterateOne()
<T> java.util.Iterator<T>	iterateOne(java.lang.Class<T> type)
protected <T> java.util.Iterator<T>	iterateOne(java.lang.Class<T> type, boolean close)
<T> java.util.Iterator<T>	iterateOneAndClose()
<T> java.util.Iterator<T>	iterateOneAndClose(java.lang.Class<T> type)
<T> java.util.List<T>	list()
<T> java.util.List<T>	list(java.lang.Class... types)
protected <T> java.util.List<T>	list(java.lang.Class[] types, int max, boolean close) Iterates result set, maps rows to classes and populates the array list.
<T> java.util.List<T>	list(int max)
<T> java.util.List<T>	list(int max, java.lang.Class... types)
<T> java.util.List<T>	listAndClose()
<T> java.util.List<T>	listAndClose(java.lang.Class... types)
<T> java.util.List<T>	listAndClose(int max)
<T> java.util.List<T>	listAndClose(int max, java.lang.Class... types)
<T> java.util.List<T>	listOne()
<T> java.util.List<T>	listOne(java.lang.Class<T> type)
protected <T> java.util.List<T>	listOne(java.lang.Class<T> type, int max, boolean close) Iterates results set, maps rows to just one class and populates the array list.
<T> java.util.List<T>	listOne(int max)
<T> java.util.List<T>	listOne(int max, java.lang.Class<T> type)
<T> java.util.List<T>	listOneAndClose()
<T> java.util.List<T>	listOneAndClose(java.lang.Class<T> type)
<T> java.util.List<T>	listOneAndClose(int max)
<T> java.util.List<T>	listOneAndClose(int max, java.lang.Class<T> type)
<T> java.util.Set<T>	listSet()
<T> java.util.Set<T>	listSet(java.lang.Class... types)
protected <T> java.util.Set<T>	listSet(java.lang.Class[] types, int max, boolean close)
<T> java.util.Set<T>	listSet(int max)
<T> java.util.Set<T>	listSet(int max, java.lang.Class... types)
<T> java.util.Set<T>	listSetAndClose()
<T> java.util.Set<T>	listSetAndClose(java.lang.Class... types)
<T> java.util.Set<T>	listSetAndClose(int max)
<T> java.util.Set<T>	listSetAndClose(int max, java.lang.Class... types)
<T> java.util.Set<T>	listSetOne()
<T> java.util.Set<T>	listSetOne(java.lang.Class<T> type)
protected <T> java.util.Set<T>	listSetOne(java.lang.Class<T> type, int max, boolean close)
<T> java.util.Set<T>	listSetOne(int max)
<T> java.util.Set<T>	listSetOne(int max, java.lang.Class<T> type)
<T> java.util.Set<T>	listSetOneAndClose()
<T> java.util.Set<T>	listSetOneAndClose(java.lang.Class<T> type)
<T> java.util.Set<T>	listSetOneAndClose(int max)
<T> java.util.Set<T>	listSetOneAndClose(int max, java.lang.Class<T> type)
protected void	prepareQuery() Prepares the query after initialization.
protected java.lang.Object	prepareRow(java.lang.Object[] row) Prepares a row (array of rows mapped object) using hints.
static DbOrmQuery	query(java.sql.Connection conn, DbSqlGenerator sqlgen)
static DbOrmQuery	query(java.sql.Connection conn, java.lang.String sqlString)
static DbOrmQuery	query(DbSession session, DbSqlGenerator sqlgen)
static DbOrmQuery	query(DbSession session, java.lang.String sqlString)
static DbOrmQuery	query(DbSqlGenerator sqlgen)
static DbOrmQuery	query(java.lang.String sqlString)
void	resetGeneratedColumns() Resets creating generated columns.
protected void	saveResultSet(java.sql.ResultSet rs) Stores result set.
void	setConcurrencyType(int concurrencyType)
void	setDebug(boolean debug)
void	setDebugMode()
void	setFetchSize(int rows) Gives the JDBC driver a hint as to the number of rows that should be fetched from the database when more rows are needed.
void	setGeneratedColumns(java.lang.String... columns) Specifies columns which values will be generated by database.
void	setGeneratedKey() Specifies that database will generate some columns values, usually the single id.
void	setHoldability(int holdability)
void	setMaxRows(int maxRows) Sets the limit for the maximum number of rows that any ResultSet object can contain to the given number.
void	setType(int type)
java.lang.String	toString()
void	typeForwardOnly()
void	typeScrollInsensitive()
void	typeScrollSensitive()
DbOrmQuery	withHints(java.lang.String hint) Specifies hints for the query.
DbOrmQuery	withHints(java.lang.String[] hints) Specifies multiple hints for the query.

Methods inherited from class jodd.db.DbQuery

clearParameters, setArray, setArray, setAsciiStream, setAsciiStream, setAsciiStream, setAsciiStream, setBean, setBigDecimal, setBigDecimal, setBigInteger, setBigInteger, setBlob, setBlob, setBoolean, setBoolean, setBoolean, setBoolean, setByte, setByte, setByte, setByte, setBytes, setBytes, setCharacterStream, setCharacterStream, setClob, setClob, setDate, setDate, setDouble, setDouble, setDouble, setDouble, setFloat, setFloat, setFloat, setFloat, setInteger, setInteger, setInteger, setInteger, setLong, setLong, setLong, setLong, setMap, setNull, setNull, setNull, setNull, setObject, setObject, setObject, setObject, setObject, setObject, setObjects, setObjects, setRef, setRef, setShort, setShort, setShort, setShort, setString, setString, setTime, setTime, setTimestamp, setTimestamp, setURL, setURL

Methods inherited from class java.lang.Object

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

Field Detail

sqlgen

protected DbSqlGenerator sqlgen

dbOrmManager

protected DbOrmManager dbOrmManager

hints

protected java.lang.String[] hints

hintResolver

protected JoinHintResolver hintResolver

QUERY_CREATED

public static final int QUERY_CREATED

See Also:

Constant Field Values

QUERY_INITIALIZED

public static final int QUERY_INITIALIZED

See Also:

Constant Field Values

QUERY_CLOSED

public static final int QUERY_CLOSED

See Also:

Constant Field Values

queryState

protected int queryState

connection

protected java.sql.Connection connection

session

protected DbSession session

sqlString

protected java.lang.String sqlString

statement

protected java.sql.Statement statement

preparedStatement

protected java.sql.PreparedStatement preparedStatement

resultSets

protected java.util.Set<java.sql.ResultSet> resultSets

query

protected jodd.db.DbQueryParser query

forcePreparedStatement

protected boolean forcePreparedStatement

If set to true all created statements will be prepared.

TYPE_FORWARD_ONLY

public static final int TYPE_FORWARD_ONLY

See Also:

ResultSet.TYPE_FORWARD_ONLY, Constant Field Values

TYPE_SCROLL_SENSITIVE

public static final int TYPE_SCROLL_SENSITIVE

See Also:

ResultSet.TYPE_SCROLL_SENSITIVE, Constant Field Values

TYPE_SCROLL_INSENSITIVE

public static final int TYPE_SCROLL_INSENSITIVE

See Also:

ResultSet.TYPE_SCROLL_INSENSITIVE, Constant Field Values

type

protected int type

CONCUR_READ_ONLY

public static final int CONCUR_READ_ONLY

See Also:

ResultSet.CONCUR_READ_ONLY, Constant Field Values

CONCUR_UPDATABLE

public static final int CONCUR_UPDATABLE

See Also:

ResultSet.CONCUR_UPDATABLE, Constant Field Values

concurrencyType

protected int concurrencyType

DEFAULT_HOLDABILITY

public static final int DEFAULT_HOLDABILITY

Default holdability. JDBC specification does not specifies default value for holdability.

See Also:

Constant Field Values

CLOSE_CURSORS_AT_COMMIT

public static final int CLOSE_CURSORS_AT_COMMIT

See Also:

ResultSet.CLOSE_CURSORS_AT_COMMIT, Constant Field Values

HOLD_CURSORS_OVER_COMMIT

public static final int HOLD_CURSORS_OVER_COMMIT

See Also:

ResultSet.HOLD_CURSORS_OVER_COMMIT, Constant Field Values

holdability

protected int holdability

debug

protected boolean debug

generatedColumns

protected java.lang.String[] generatedColumns

fetchSize

protected int fetchSize

maxRows

protected int maxRows

totalOpenResultSetCount

protected static int totalOpenResultSetCount

Constructor Detail

DbOrmQuery

public DbOrmQuery(java.sql.Connection conn,
                  java.lang.String sqlString)

DbOrmQuery

public DbOrmQuery(DbSession session,
                  java.lang.String sqlString)

DbOrmQuery

public DbOrmQuery(java.lang.String sqlString)

DbOrmQuery

public DbOrmQuery(java.sql.Connection conn,
                  DbSqlGenerator sqlgen)

DbOrmQuery

public DbOrmQuery(DbSession session,
                  DbSqlGenerator sqlgen)

DbOrmQuery

public DbOrmQuery(DbSqlGenerator sqlgen)

Method Detail

query

public static DbOrmQuery query(java.sql.Connection conn,
                               java.lang.String sqlString)

query

public static DbOrmQuery query(DbSession session,
                               java.lang.String sqlString)

query

public static DbOrmQuery query(java.lang.String sqlString)

query

public static DbOrmQuery query(java.sql.Connection conn,
                               DbSqlGenerator sqlgen)

query

public static DbOrmQuery query(DbSession session,
                               DbSqlGenerator sqlgen)

query

public static DbOrmQuery query(DbSqlGenerator sqlgen)

getManager

public DbOrmManager getManager()

Returns used ORM manager.

prepareQuery

protected void prepareQuery()

Prepares the query after initialization. Besides default work, it checks if sql generator is used, and if so, generator hints and query parameters will be used for this query. Note regarding hints: since hints can be added manually, generators hints will be ignored if there exists some manually set hints.

withHints

public DbOrmQuery withHints(java.lang.String hint)

Specifies hints for the query.

withHints

public DbOrmQuery withHints(java.lang.String[] hints)

Specifies multiple hints for the query.

prepareRow

protected java.lang.Object prepareRow(java.lang.Object[] row)

Prepares a row (array of rows mapped object) using hints. Returns either single object or objects array.

executeAndBuildResultSetMapper

protected ResultSetMapper executeAndBuildResultSetMapper()

Executes the query and returns builded ResultSet mapper.

buildResultSetMapper

protected ResultSetMapper buildResultSetMapper(java.sql.ResultSet resultSet)

Factory for result sets mapper.

iterateOne

public <T> java.util.Iterator<T> iterateOne(java.lang.Class<T> type)

iterateOneAndClose

public <T> java.util.Iterator<T> iterateOneAndClose(java.lang.Class<T> type)

iterateOne

public <T> java.util.Iterator<T> iterateOne()

iterateOneAndClose

public <T> java.util.Iterator<T> iterateOneAndClose()

iterateOne

protected <T> java.util.Iterator<T> iterateOne(java.lang.Class<T> type,
                                               boolean close)

iterate

public <T> java.util.Iterator<T> iterate(java.lang.Class... types)

iterateAndClose

public <T> java.util.Iterator<T> iterateAndClose(java.lang.Class... types)

iterate

public <T> java.util.Iterator<T> iterate()

iterateAndClose

public <T> java.util.Iterator<T> iterateAndClose()

iterate

protected <T> java.util.Iterator<T> iterate(java.lang.Class[] types,
                                            boolean close)

listOne

public <T> java.util.List<T> listOne(java.lang.Class<T> type)

listOneAndClose

public <T> java.util.List<T> listOneAndClose(java.lang.Class<T> type)

listOne

public <T> java.util.List<T> listOne()

listOneAndClose

public <T> java.util.List<T> listOneAndClose()

listOne

public <T> java.util.List<T> listOne(int max,
                                     java.lang.Class<T> type)

listOneAndClose

public <T> java.util.List<T> listOneAndClose(int max,
                                             java.lang.Class<T> type)

listOne

public <T> java.util.List<T> listOne(int max)

listOneAndClose

public <T> java.util.List<T> listOneAndClose(int max)

listOne

protected <T> java.util.List<T> listOne(java.lang.Class<T> type,
                                        int max,
                                        boolean close)

Iterates results set, maps rows to just one class and populates the array list.

Parameters:

type - target type

max - max number of rows to collect, 0 for all

close - true if query is closed at the end, otherwise false

Returns:

list of mapped entities

list

public <T> java.util.List<T> list(java.lang.Class... types)

listAndClose

public <T> java.util.List<T> listAndClose(java.lang.Class... types)

list

public <T> java.util.List<T> list()

listAndClose

public <T> java.util.List<T> listAndClose()

list

public <T> java.util.List<T> list(int max,
                                  java.lang.Class... types)

listAndClose

public <T> java.util.List<T> listAndClose(int max,
                                          java.lang.Class... types)

list

public <T> java.util.List<T> list(int max)

listAndClose

public <T> java.util.List<T> listAndClose(int max)

list

protected <T> java.util.List<T> list(java.lang.Class[] types,
                                     int max,
                                     boolean close)

Iterates result set, maps rows to classes and populates the array list.

Parameters:

types - mapping types

max - max number of rows to collect, 0 for all

close - true if query is closed at the end, otherwise false

Returns:

list of mapped entities

listSetOne

public <T> java.util.Set<T> listSetOne(java.lang.Class<T> type)

listSetOneAndClose

public <T> java.util.Set<T> listSetOneAndClose(java.lang.Class<T> type)

listSetOne

public <T> java.util.Set<T> listSetOne()

listSetOneAndClose

public <T> java.util.Set<T> listSetOneAndClose()

listSetOne

public <T> java.util.Set<T> listSetOne(int max,
                                       java.lang.Class<T> type)

listSetOneAndClose

public <T> java.util.Set<T> listSetOneAndClose(int max,
                                               java.lang.Class<T> type)

listSetOne

public <T> java.util.Set<T> listSetOne(int max)

listSetOneAndClose

public <T> java.util.Set<T> listSetOneAndClose(int max)

listSetOne

protected <T> java.util.Set<T> listSetOne(java.lang.Class<T> type,
                                          int max,
                                          boolean close)

listSet

public <T> java.util.Set<T> listSet(java.lang.Class... types)

listSetAndClose

public <T> java.util.Set<T> listSetAndClose(java.lang.Class... types)

listSet

public <T> java.util.Set<T> listSet()

listSetAndClose

public <T> java.util.Set<T> listSetAndClose()

listSet

public <T> java.util.Set<T> listSet(int max,
                                    java.lang.Class... types)

listSetAndClose

public <T> java.util.Set<T> listSetAndClose(int max,
                                            java.lang.Class... types)

listSet

public <T> java.util.Set<T> listSet(int max)

listSetAndClose

public <T> java.util.Set<T> listSetAndClose(int max)

listSet

protected <T> java.util.Set<T> listSet(java.lang.Class[] types,
                                       int max,
                                       boolean close)

findOne

public <T> T findOne(java.lang.Class<T> type)

findOneAndClose

public <T> T findOneAndClose(java.lang.Class<T> type)

findOne

public java.lang.Object findOne()

findOneAndClose

public java.lang.Object findOneAndClose()

findOne

protected <T> T findOne(java.lang.Class<T> type,
                        boolean close,
                        java.sql.ResultSet resultSet)

find

public java.lang.Object find(java.lang.Class... types)

findAndClose

public java.lang.Object findAndClose(java.lang.Class... types)

find

public java.lang.Object find()

findAndClose

public java.lang.Object findAndClose()

find

protected java.lang.Object find(java.lang.Class[] types,
                                boolean close,
                                java.sql.ResultSet resultSet)

findGeneratedKey

public <T> T findGeneratedKey(java.lang.Class<T> type)

findGeneratedColumns

public java.lang.Object findGeneratedColumns(java.lang.Class... types)

close

protected void close(ResultSetMapper rsm,
                     boolean closeQuery)

Closes results set or whole query.

getQueryState

public int getQueryState()

Returns query state.

checkNotClosed

protected void checkNotClosed()

Checks if query is not closed and throws an exception if it is.

checkCreated

protected void checkCreated()

Checks if query is created (and not yet initialized or closed) and throws an exception if it is not.

checkInitialized

protected void checkInitialized()

Checks if query is initialized and throws an exception if it is not.

isClosed

public boolean isClosed()

Returns true if query is closed.

isActive

public boolean isActive()

Returns true if query is active: created and possibly initialized. Opened query may be not initialized.

isInitialized

public boolean isInitialized()

Returns true if query is initialized. Initialized query is the one that has created JDBC statements.

saveResultSet

protected void saveResultSet(java.sql.ResultSet rs)

Stores result set.

forcePreparedStatement

public void forcePreparedStatement()

Forces creation of prepared statements.

init

public final void init()

Initializes the query if not already initialized. Usually, user doesn't have to invoke it at all, since it will be called before all methods that deals directly with JDBC statement. Throws an exception if called on closed query.

initializeJdbc

protected void initializeJdbc()

Performs JDBC initialization of the query. Obtains connection, parses the SQL query string and creates statements. Initialization is performed only once, when switching to initialized state.

closeAllResultSets

public void closeAllResultSets()

Closes all result sets created by this query. Query remains active.

closeQuery

protected java.util.List<java.sql.SQLException> closeQuery()

Closes all assigned result sets and then closes the query. Query becomes closed.

close

public void close()

Closes the query and all created results sets and detaches itself from the session.

closeResultSet

public void closeResultSet(java.sql.ResultSet rs)

Closes single result set that was created by this query, It is not necessary to close result sets explicitly, since DbQueryBase.close() method closes all created result sets. Query remains active.

getType

public int getType()

setType

public void setType(int type)

typeForwardOnly

public void typeForwardOnly()

typeScrollSensitive

public void typeScrollSensitive()

typeScrollInsensitive

public void typeScrollInsensitive()

getConcurrencyType

public int getConcurrencyType()

setConcurrencyType

public void setConcurrencyType(int concurrencyType)

concurReadOnly

public void concurReadOnly()

concurUpdatable

public void concurUpdatable()

getHoldability

public int getHoldability()

setHoldability

public void setHoldability(int holdability)

holdCursorsOverCommit

public void holdCursorsOverCommit()

closeCursorsAtCommit

public void closeCursorsAtCommit()

isInDebugMode

public boolean isInDebugMode()

setDebug

public void setDebug(boolean debug)

setDebugMode

public void setDebugMode()

getGeneratedColumnNames

public java.lang.String[] getGeneratedColumnNames()

Returns generated column names.

setGeneratedColumns

public void setGeneratedColumns(java.lang.String... columns)

Specifies columns which values will be generated by database.

setGeneratedKey

public void setGeneratedKey()

Specifies that database will generate some columns values, usually the single id.

resetGeneratedColumns

public void resetGeneratedColumns()

Resets creating generated columns.

getFetchSize

public int getFetchSize()

setFetchSize

public void setFetchSize(int rows)

Gives the JDBC driver a hint as to the number of rows that should be fetched from the database when more rows are needed. The number of rows specified affects only result sets created using this statement. If the value specified is zero, then the hint is ignored. The default value is zero.

See Also:

Statement.setFetchSize(int)

getMaxRows

public int getMaxRows()

setMaxRows

public void setMaxRows(int maxRows)

Sets the limit for the maximum number of rows that any ResultSet object can contain to the given number. If the limit is exceeded, the excess rows are silently dropped. Zero means there is no limit.

See Also:

Statement.setMaxRows(int)

execute

public java.sql.ResultSet execute()

Executes the query. If this method is invoked at least once, the query or all created ResultSets must be explicitly closed at the end of query usage. This can be done explicitly by calling DbQueryBase.closeResultSet(ResultSet) оr implicitly, during DbQueryBase.close().

See Also:

Statement.execute(String)

executeUpdate

public int executeUpdate()

Executes UPDATE, INSERT or DELETE queries. Query is not closed afterwards.

See Also:

Statement.executeUpdate(String)

executeUpdateAndClose

public int executeUpdateAndClose()

Executes UPDATE, INSERT or DELETE queries and closes query afterwards.

See Also:

Statement.executeUpdate(String)

executeUpdate

protected int executeUpdate(boolean closeQuery)

Executes UPDATE, INSERT or DELETE queries and optionally closes the query.

See Also:

Statement.executeUpdate(String)

executeCount

public long executeCount()

Special execute() for 'select count(*)' queries. Query is not closed after the execution. It doesn't check if query is really a count query. If result set returns zero rows, (what is very unlikely), it returns -1.

executeCountAndClose

public long executeCountAndClose()

Executes count queries and closes afterwards.

executeCount

protected long executeCount(boolean close)

Executes count queries and optionally closes query afterwards.

getGeneratedColumns

public java.sql.ResultSet getGeneratedColumns()

Returns generated columns.

getGeneratedKey

public long getGeneratedKey()

Returns generated key i.e. first genereted column as long.

getQueryString

public java.lang.String getQueryString()

Returns query SQL string. For prepared statements, returned sql string with quick-and-dirty replaced values.

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

See Also:

getQueryString()

getTotalOpenResultSetCount

public static int getTotalOpenResultSetCount()

Returns total number of open result sets.

See Also:

getOpenResultSetCount()

getOpenResultSetCount

public int getOpenResultSetCount()

Returns number of created result sets that are still not explicitly closed.

See Also:

getTotalOpenResultSetCount()