|
|||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||||
java.lang.Object | +--vortex.sql.vortexStatement
A Statement object is used for executing a static SQL statement and obtaining the results produced by it.
Only one ResultSet per Statement can be open at any point in time. Therefore, if the reading of one ResultSet is interleaved with the reading of another, each must have been generated by different Statements.
Connection.createStatement(),
ResultSet| Field Summary | |
protected java.lang.String |
cName
Cursor' name |
protected java.sql.Connection |
conn
Connection object |
protected dbCursor |
lcur
dbCursor object |
protected dbChannel |
ldb
DBChannel object |
protected vortexRecord |
record
Record object |
protected java.sql.ResultSet |
result
ResultSet object |
| Fields inherited from interface java.sql.Statement |
CLOSE_ALL_RESULTS, CLOSE_CURRENT_RESULT, EXECUTE_FAILED, KEEP_CURRENT_RESULT, NO_GENERATED_KEYS, RETURN_GENERATED_KEYS, SUCCESS_NO_INFO |
| Constructor Summary | |
vortexStatement()
|
|
vortexStatement(java.sql.Connection con,
dbChannel db,
int type,
int concurrency)
|
|
| Method Summary | |
void |
addBatch(java.lang.String sql)
Not supported by VORTEXjdbc. |
void |
cancel()
Cancel can be used by one thread to cancel a statement that is being executed by another thread. |
void |
clearBatch()
Not supported by VORTEXjdbc. |
void |
clearWarnings()
After this call getWarnings returns null until a new warning is reported for this Statement. |
void |
close()
In many cases, it is desirable to immediately release a Statements's database and JDBC resources instead of waiting for this to happen when it is automatically closed; the close method provides this immediate release. |
boolean |
execute(java.lang.String sql)
Execute a SQL statement that may return multiple results. |
boolean |
execute(java.lang.String sql,
int auto)
Execute a SQL statement that may return multiple results and signal the driver that the auto-generated keys indicated in the given array should be made available for retrieval. |
boolean |
execute(java.lang.String sql,
int[] indexes)
Execute a SQL statement that may return multiple results and signal the driver that the auto-generated keys indicated in the given array should be made available for retrieval. |
boolean |
execute(java.lang.String sql,
java.lang.String[] names)
Execute a SQL statement that may return multiple results and signal the driver that the auto-generated keys indicated in the given array should be made available for retrieval. |
int[] |
executeBatch()
Not supported by VORTEXjdbc. |
java.sql.ResultSet |
executeQuery(java.lang.String sql)
Execute a SQL statement that returns a single ResultSet. |
int |
executeUpdate(java.lang.String sql)
Execute a SQL INSERT, UPDATE or DELETE statement. |
int |
executeUpdate(java.lang.String sql,
int auto)
Execute a SQL INSERT, UPDATE or DELETE statement and signal the driver with the given flag about whether the auto-generated keys produced by this Statement object should be made available for retrieval. |
int |
executeUpdate(java.lang.String sql,
int[] indexes)
Execute a SQL INSERT, UPDATE or DELETE statement and signal the driver that the auto-generated keys indicated in the given array should be made available for retrieval. |
int |
executeUpdate(java.lang.String sql,
java.lang.String[] names)
Execute a SQL INSERT, UPDATE or DELETE statement and signal the driver that the auto-generated keys indicated in the given array should be made available for retrieval. |
void |
finalize()
|
java.sql.Connection |
getConnection()
Returns the Connection object that produced this Statement object. |
int |
getFetchDirection()
Retrieves the direction for fetching rows from database tables that is the default for result sets generated from this Statement object. |
int |
getFetchSize()
Retrieves the number of result set rows that is the default fetch size for result sets generated from this Statement object. |
java.sql.ResultSet |
getGeneratedKeys()
getGenerateKeys returns any auto-generated keys created as a result of executing this Statement. |
int |
getMaxFieldSize()
This does not apply to VORTEXjdbc |
int |
getMaxRows()
This does not apply to VORTEXjdbc |
boolean |
getMoreResults()
getMoreResults moves to a Statement's next result. |
boolean |
getMoreResults(int current)
getMoreResults moves to this Statements next result, deals with any current ResultSet objects according to the instructions specified by the given flag, and returns true is the next result is a ResultSet object. |
int |
getQueryTimeout()
The queryTimeout limit is the number of seconds the driver will wait for a Statement to execute. |
java.sql.ResultSet |
getResultSet()
getResultSet returns the current result as a ResultSet. |
int |
getResultSetConcurrency()
Retrieves the result set concurrency. |
int |
getResultSetHoldability()
getResultSetHoldability returns the result set holdability. |
int |
getResultSetType()
Determine the result set type. |
int |
getUpdateCount()
getUpdateCount returns the current result, which should be an integer value. |
java.sql.SQLWarning |
getWarnings()
The first warning reported by calls on this Statement is returned. |
void |
setCursorName(java.lang.String name)
setCursorname defines the SQL cursor name that will be used by subsequent Statement execute methods. |
void |
setEscapeProcessing(boolean enable)
This does not apply to VORTEXjdbc |
void |
setFetchDirection(int direction)
Gives the driver a hint as to the direction in which the rows in a result set will be processed. |
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 |
setMaxFieldSize(int max)
This does not apply to VORTEXjdbc |
void |
setMaxRows(int max)
This does not apply to VORTEXjdbc |
void |
setQueryTimeout(int seconds)
The queryTimeout limit is the number of seconds the driver will wait for a Statement to execute. |
| Methods inherited from class java.lang.Object |
clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
| Field Detail |
protected java.lang.String cName
protected java.sql.Connection conn
protected dbChannel ldb
protected dbCursor lcur
protected java.sql.ResultSet result
protected vortexRecord record
| Constructor Detail |
public vortexStatement(java.sql.Connection con,
dbChannel db,
int type,
int concurrency)
throws java.sql.SQLException
public vortexStatement()
throws java.sql.SQLException
| Method Detail |
public java.sql.ResultSet executeQuery(java.lang.String sql)
throws java.sql.SQLException
executeQuery in interface java.sql.Statementsql - typically this is a static SQL SELECT statement
java.sql.SQLException - thrown in the event the dbFetch fails
public int executeUpdate(java.lang.String sql)
throws java.sql.SQLException
executeUpdate in interface java.sql.Statementsql - a SQL INSERT, UPDATE or DELETE statement or a SQL
statement that returns nothing
java.sql.SQLException - thrown in the event the DB action fails
public int executeUpdate(java.lang.String sql,
java.lang.String[] names)
throws java.sql.SQLException
executeUpdate in interface java.sql.Statementsql - a SQL INSERT, UPDATE or DELETE statement or a SQL
statement that returns nothingnames - an array of the names of the columns in the inserted
row that should be made available for retrieval by a call to the method
getGeneratedKeys.
java.sql.SQLException - thrown in the event the DB action fails
public int executeUpdate(java.lang.String sql,
int[] indexes)
throws java.sql.SQLException
executeUpdate in interface java.sql.Statementsql - a SQL INSERT, UPDATE or DELETE statement or a SQL
statement that returns nothingindexes - an array of the indexes of the columns in the inserted
row that should be made available for retrieval by a call to the method
getGeneratedKeys.
java.sql.SQLException - thrown in the event the DB action fails
public int executeUpdate(java.lang.String sql,
int auto)
throws java.sql.SQLException
executeUpdate in interface java.sql.Statementsql - a SQL INSERT, UPDATE or DELETE statement or a SQL
statement that returns nothingauto - a flag indicating whether auto-generated keys should be made
available for retrieval. One of Statement.RETURN_GENERATED_KEYS or
Statement.NO_GENERATED_KEYS.
java.sql.SQLException - thrown in the event the DB action fails
public void close()
throws java.sql.SQLException
Note: A Statement is automatically closed when it is garbage collected. When a Statement is closed its current ResultSet, if one exists, is also closed.
close in interface java.sql.Statementjava.sql.SQLException - Not apply
public int getMaxFieldSize()
throws java.sql.SQLException
The maxFieldSize limit (in bytes) is the maximum amount of data returned for any column value; it only applies to BINARY, VARBINARY, LONGVARBINARY, CHAR, VARCHAR, and LONGVARCHAR columns. If the limit is exceeded, the excess data is silently discarded.
getMaxFieldSize in interface java.sql.Statementjava.sql.SQLException - Not apply
public void setMaxFieldSize(int max)
throws java.sql.SQLException
The maxFieldSize limit (in bytes) is set to limit the size of data that can be returned for any column value; it only applies to BINARY, VARBINARY, LONGVARBINARY, CHAR, VARCHAR, and LONGVARCHAR fields. If the limit is exceeded, the excess data is silently discarded.
setMaxFieldSize in interface java.sql.Statementmax - the new max column size limit; zero means unlimited
java.sql.SQLException - Not apply
public int getMaxRows()
throws java.sql.SQLException
The maxRows limit is the maximum number of rows that a ResultSet can contain. If the limit is exceeded, the excess rows are silently dropped.
getMaxRows in interface java.sql.Statementjava.sql.SQLException - Not apply
public void setMaxRows(int max)
throws java.sql.SQLException
The maxRows limit is set to limit the number of rows that any ResultSet can contain. If the limit is exceeded, the excess rows are silently dropped.
setMaxRows in interface java.sql.Statementmax - the new max rows limit; zero means unlimited
java.sql.SQLException - Not apply
public void setEscapeProcessing(boolean enable)
throws java.sql.SQLException
If escape scanning is on (the default) the driver will do escape substitution before sending the SQL to the database.
setEscapeProcessing in interface java.sql.Statementenable - true to enable; false to disable
java.sql.SQLException - Not apply
public int getQueryTimeout()
throws java.sql.SQLException
The queryTimeout limit is the number of seconds the driver will wait for a Statement to execute. If the limit is exceeded a SQLException is thrown.
getQueryTimeout in interface java.sql.Statementjava.sql.SQLException - Not apply
public void setQueryTimeout(int seconds)
throws java.sql.SQLException
The queryTimeout limit is the number of seconds the driver will wait for a Statement to execute. If the limit is exceeded a SQLException is thrown.
setQueryTimeout in interface java.sql.Statementseconds - the new query timeout limit in seconds; zero means unlimited
java.sql.SQLException - Not apply
public void cancel()
throws java.sql.SQLException
cancel in interface java.sql.Statementjava.sql.SQLException - Not apply
public java.sql.SQLWarning getWarnings()
throws java.sql.SQLException
The warning chain is automatically cleared each time a statement is (re)executed.
Note: If you are processing a ResultSet then any warnings associated with ResultSet reads will be chained on the ResultSet object.
getWarnings in interface java.sql.Statementjava.sql.SQLException - Not apply
public void clearWarnings()
throws java.sql.SQLException
clearWarnings in interface java.sql.Statementjava.sql.SQLException - Not apply
public void setCursorName(java.lang.String name)
throws java.sql.SQLException
Note: By definition, positioned update/delete execution must be done by a different Statement than the one which generated the ResultSet being used for positioning. Also, cursor names must be unique within a Connection.
setCursorName in interface java.sql.Statementname - the new cursor name.
java.sql.SQLException - Not apply
public boolean execute(java.lang.String sql)
throws java.sql.SQLException
execute in interface java.sql.Statementsql - any SQL statement
java.sql.SQLException - threw exceptions on all DB actionsgetResultSet(),
getUpdateCount(),
getMoreResults(int)
public boolean execute(java.lang.String sql,
int auto)
throws java.sql.SQLException
execute in interface java.sql.Statementsql - any SQL statementauto - constant indicating whether auto-generated keys should be made
available for retrieval by a call to the method
getGeneratedKeys. One of Statement.RETURN_GENERATED_KEYS or
Statement.NO_GENERATED_KEYS.
java.sql.SQLException - threw exceptions on all DB actionsgetResultSet(),
getUpdateCount(),
getMoreResults(int)
public boolean execute(java.lang.String sql,
int[] indexes)
throws java.sql.SQLException
execute in interface java.sql.Statementsql - any SQL statement
java.sql.SQLException - threw exceptions on all DB actionsgetResultSet(),
getUpdateCount(),
getMoreResults(int)
public boolean execute(java.lang.String sql,
java.lang.String[] names)
throws java.sql.SQLException
execute in interface java.sql.Statementsql - any SQL statement
java.sql.SQLException - threw exceptions on all DB actionsgetResultSet(),
getUpdateCount(),
getMoreResults(int)
public java.sql.ResultSet getResultSet()
throws java.sql.SQLException
getResultSet in interface java.sql.Statementjava.sql.SQLException - Not applyexecute(java.lang.String)
public boolean getMoreResults(int current)
throws java.sql.SQLException
getMoreResults in interface java.sql.Statementcurrent - one of the following: Statement.CLOSE_CURRENT_RESULT,
Statement.KEEP_CURRENT_RESULT, or Statement.CLOSE_ALL_RESULTS.
java.sql.SQLException - Not apply
public java.sql.ResultSet getGeneratedKeys()
throws java.sql.SQLException
getGeneratedKeys in interface java.sql.Statementjava.sql.SQLException - Not apply
public int getResultSetHoldability()
throws java.sql.SQLException
getResultSetHoldability in interface java.sql.Statementjava.sql.SQLException - Not apply
public int getUpdateCount()
throws java.sql.SQLException
The only way to tell for sure that the result is an update count is to first test to see if it is a ResultSet. If it is not a ResultSet it is an update count.
getUpdateCount in interface java.sql.Statementjava.sql.SQLException - Not applyexecute(java.lang.String)
public boolean getMoreResults()
throws java.sql.SQLException
getMoreResults in interface java.sql.Statementjava.sql.SQLException - throw exception on all DB actionsexecute(java.lang.String)
public void addBatch(java.lang.String sql)
throws java.sql.SQLException
addBatch in interface java.sql.Statementsql - typically this is a static SQL INSERT or UPDATE statement
java.sql.SQLException - if the driver does not support batch statements
public void clearBatch()
throws java.sql.SQLException
clearBatch in interface java.sql.Statementjava.sql.SQLException - if the driver does not support batch statements
public int[] executeBatch()
throws java.sql.SQLException
executeBatch in interface java.sql.Statementjava.sql.SQLException - if the driver does not support batch statements
public java.sql.Connection getConnection()
throws java.sql.SQLException
getConnection in interface java.sql.Statementjava.sql.SQLException
public int getFetchDirection()
throws java.sql.SQLException
getFetchDirection in interface java.sql.Statementjava.sql.SQLException
public void setFetchSize(int rows)
throws java.sql.SQLException
setFetchSize in interface java.sql.Statementrows - the number of rows to fetch
java.sql.SQLException - if the condition 0 <= rows <= this.getMaxRows()
is not satisfied.
public int getFetchSize()
throws java.sql.SQLException
getFetchSize in interface java.sql.Statementjava.sql.SQLException
public int getResultSetConcurrency()
throws java.sql.SQLException
getResultSetConcurrency in interface java.sql.Statementjava.sql.SQLException
public int getResultSetType()
throws java.sql.SQLException
getResultSetType in interface java.sql.Statementjava.sql.SQLException
public void setFetchDirection(int direction)
throws java.sql.SQLException
setFetchDirection in interface java.sql.Statementdirection - the initial direction for processing rows
java.sql.SQLException - if the given direction is not one of
ResultSet.FETCH_FORWARD, ResultSet.FETCH_REVERSE, or
ResultSet.FETCH_UNKNOWNpublic void finalize()
finalize in class java.lang.Object
|
|||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||||