jodd.db.orm
Class DbOrmQuery

java.lang.Object
  extended by jodd.db.DbQuery
      extended by 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:


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  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()
           
protected  ResultSetMapper createResultSetMapper(java.sql.ResultSet resultSet)
          Factory for result sets mapper.
 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.


createResultSetMapper

protected ResultSetMapper createResultSetMapper(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()


Copyright © 2003-2011 Jodd Team