jodd.db
Class DbProfiledQuery

java.lang.Object
  jodd.db.DbQuery
      jodd.db.DbProfiledQuery

public class DbProfiledQuery
extends DbQuery

Profiled DbQuery measures query execution time. May be used for debugging purposes.

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 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
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 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

DbProfiledQuery(java.sql.Connection conn, java.lang.String sql)

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

DbProfiledQuery(java.lang.String sqlString)

Method Summary

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.
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.
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.
void	forcePreparedStatement() Forces creation of prepared statements.
int	getConcurrencyType()
long	getExecutionElapsedTime() Returns query execution elapsed time in ms.
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()
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.
protected void	prepareQuery() Prepares the query just after the initialization.
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()

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

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

DbProfiledQuery

public DbProfiledQuery(java.sql.Connection conn,
                       java.lang.String sql)

DbProfiledQuery

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

DbProfiledQuery

public DbProfiledQuery(java.lang.String sqlString)

Method Detail

executeUpdate

public int executeUpdate()

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

See Also:

Statement.executeUpdate(String)

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)

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.

getExecutionElapsedTime

public long getExecutionElapsedTime()

Returns query execution elapsed time in ms. Returns -1 if query is still not executed.

getQueryString

public java.lang.String getQueryString()

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

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.

prepareQuery

protected void prepareQuery()

Prepares the query just after the initialization. Query is fully set and ready.

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)

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)

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.

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()