java.lang.AutoCloseable
, java.lang.Comparable
, java.sql.ResultSet
, java.sql.Wrapper
, EngineResultSet
EmbedResultSet42
public class EmbedResultSet extends ConnectionChild implements EngineResultSet, java.lang.Comparable
Modifier and Type | Field | Description |
---|---|---|
protected static int |
ABSOLUTE |
|
protected static int |
AFTERLAST |
|
private java.sql.Statement |
applicationStmt |
Statement object the application used to
create this ResultSet.
|
protected static int |
BEFOREFIRST |
|
private boolean[] |
columnGotUpdated |
|
private boolean[] |
columnUsedFlags |
Indicates which columns have been fetched as a stream or as a LOB for a
row.
|
private int |
concurrencyOfThisResultSet |
|
private ExecRow |
currentRow |
The currentRow contains the data of the current row of the resultset.
|
private boolean |
currentRowHasBeenUpdated |
|
private java.lang.Object |
currentStream |
|
private int |
fetchDirection |
|
private static long |
fetchedRowBase |
For use in debugging setLargeMaxRows() method added by JDBC 4.2
|
private int |
fetchSize |
|
protected static int |
FIRST |
|
private boolean |
forMetaData |
|
private boolean |
isAtomic |
|
(package private) boolean |
isClosed |
Set if this ResultSet is definitely closed.
|
private boolean |
isOnInsertRow |
|
protected static int |
LAST |
|
private int |
maxFieldSize |
|
private long |
maxRows |
|
protected static int |
NEXT |
|
private long |
NumberofFetchedRows |
|
(package private) int |
order |
|
private EmbedStatement |
owningStmt |
The statement that currently owns this ResultSet.
|
protected static int |
PREVIOUS |
|
protected static int |
RELATIVE |
|
private ResultDescription |
resultDescription |
|
(package private) Activation |
singleUseActivation |
This activation is set by EmbedStatement
for a single execution Activation.
|
private EmbedStatement |
stmt |
The statement object that originally created us.
|
private ResultSet |
theResults |
|
private long |
timeoutMillis |
|
private java.sql.SQLWarning |
topWarning |
|
private ExecRow |
updateRow |
|
protected boolean |
wasNull |
factory, localConn
Constructor | Description |
---|---|
EmbedResultSet(EmbedConnection conn,
ResultSet resultsToWrap,
boolean forMetaData,
EmbedStatement stmt,
boolean isAtomic) |
This class provides the glue between the Derby
resultset and the JDBC resultset, mapping calls-to-calls.
|
Modifier and Type | Method | Description |
---|---|---|
boolean |
absolute(int row) |
JDBC 2.0
|
private void |
addWarning(java.sql.SQLWarning w) |
Adds a warning to the end of the warning chain.
|
protected void |
adjustScale(int columnIndex,
int scale) |
Adjust the scale of a type.
|
void |
afterLast() |
JDBC 2.0
|
void |
beforeFirst() |
JDBC 2.0
|
void |
cancelRowUpdates() |
JDBC 2.0
The cancelRowUpdates() method may be called after calling an
updateXXX() method(s) and before calling updateRow() to rollback
the updates made to a row.
|
(package private) void |
checkExecIfClosed(java.lang.String operation) |
Throw an exception if this ResultSet is closed or its
Connection has been closed.
|
(package private) void |
checkIfClosed(java.lang.String operation) |
Throw an exception if this ResultSet is closed.
|
private void |
checkLOBMultiCall(int columnIndex) |
Checks if a stream or a LOB object has already been created for the
specified LOB column.
|
private void |
checkNotOnInsertRow() |
|
protected void |
checkOnRow() |
|
private boolean |
checkRowPosition(int position,
java.lang.String positionText) |
|
protected void |
checksBeforeInsert() |
|
private void |
checksBeforeUpdateAsciiStream(int columnIndex) |
Check whether it is OK to update a column using
updateAsciiStream() . |
private void |
checksBeforeUpdateBinaryStream(int columnIndex) |
Check whether it is OK to update a column using
updateBinaryStream() . |
private void |
checksBeforeUpdateCharacterStream(int columnIndex) |
Check whether it is OK to update a column using
updateCharacterStream() . |
protected void |
checksBeforeUpdateOrDelete(java.lang.String methodName,
int columnIndex) |
|
protected void |
checksBeforeUpdateXXX(java.lang.String methodName,
int columnIndex) |
|
private void |
checkScrollCursor(java.lang.String methodName) |
Checks if the result set has a scrollable cursor.
|
private void |
checkUpdatableCursor(java.lang.String operation) |
|
void |
clearWarnings() |
After this call getWarnings returns null until a new warning is
reported for this ResultSet.
|
void |
close() |
In some cases, it is desirable to immediately release a
ResultSet's database and JDBC resources instead of waiting for
this to happen when it is automatically closed; the close
method provides this immediate release.
|
private void |
closeCurrentStream() |
Documented behaviour for streams is that they are implicitly closed on
the next get*() method call.
|
(package private) java.sql.SQLException |
closeOnTransactionError(java.lang.Throwable thrownException) |
|
int |
compareTo(java.lang.Object other) |
|
private java.sql.SQLException |
dataTypeConversion(int column,
java.lang.String targetType) |
|
private java.sql.SQLException |
dataTypeConversion(java.lang.String targetType,
int column) |
|
void |
deleteRow() |
JDBC 2.0
Delete the current row from the result set and the underlying
database.
|
int |
findColumn(java.lang.String columnName) |
Map a Resultset column name to a ResultSet column index.
|
protected int |
findColumnName(java.lang.String columnName) |
Map a Resultset column name to a ResultSet column index.
|
boolean |
first() |
JDBC 2.0
|
java.sql.Array |
getArray(int i) |
JDBC 2.0
Get an array column.
|
java.sql.Array |
getArray(java.lang.String colName) |
JDBC 2.0
Get an array column.
|
java.io.InputStream |
getAsciiStream(int columnIndex) |
Pushes a converter on top of getCharacterStream().
|
java.io.InputStream |
getAsciiStream(java.lang.String columnName) |
A column value can be retrieved as a stream of ASCII characters
and then read in chunks from the stream.
|
java.math.BigDecimal |
getBigDecimal(int columnIndex) |
|
java.math.BigDecimal |
getBigDecimal(int columnIndex,
int scale) |
Deprecated.
|
java.math.BigDecimal |
getBigDecimal(java.lang.String columnName) |
JDBC 2.0
Get the value of a column in the current row as a java.math.BigDecimal
object.
|
java.math.BigDecimal |
getBigDecimal(java.lang.String columnName,
int scale) |
Deprecated.
|
java.io.InputStream |
getBinaryStream(int columnIndex) |
Get the column as an InputStream.
|
java.io.InputStream |
getBinaryStream(java.lang.String columnName) |
A column value can be retrieved as a stream of uninterpreted bytes
and then read in chunks from the stream.
|
java.sql.Blob |
getBlob(int columnIndex) |
JDBC 2.0
Get a BLOB column.
|
java.sql.Blob |
getBlob(java.lang.String columnName) |
JDBC 2.0
Get a BLOB column.
|
boolean |
getBoolean(int columnIndex) |
Get the value of a column in the current row as a Java boolean.
|
boolean |
getBoolean(java.lang.String columnName) |
Get the value of a column in the current row as a Java boolean.
|
byte |
getByte(int columnIndex) |
Get the value of a column in the current row as a Java byte.
|
byte |
getByte(java.lang.String columnName) |
Get the value of a column in the current row as a Java byte.
|
byte[] |
getBytes(int columnIndex) |
Get the value of a column in the current row as a Java byte array.
|
byte[] |
getBytes(java.lang.String columnName) |
Get the value of a column in the current row as a Java byte array.
|
java.io.Reader |
getCharacterStream(int columnIndex) |
JDBC 2.0
|
java.io.Reader |
getCharacterStream(java.lang.String columnName) |
JDBC 2.0
|
java.sql.Clob |
getClob(int columnIndex) |
JDBC 2.0
Get a CLOB column.
|
java.sql.Clob |
getClob(java.lang.String columnName) |
JDBC 2.0
Get a CLOB column.
|
protected DataValueDescriptor |
getColumn(int columnIndex) |
Get the column value for a getXXX() call.
|
(package private) java.lang.String |
getColumnSQLType(int column) |
|
(package private) int |
getColumnType(int columnIndex) |
Check the column is in range *and* return the JDBC type of the column.
|
int |
getConcurrency() |
JDBC 2.0
Return the concurrency of this result set.
|
java.lang.String |
getCursorName() |
Get the name of the SQL cursor used by this ResultSet.
|
java.sql.Date |
getDate(int columnIndex) |
Get the value of a column in the current row as a java.sql.Date object.
|
java.sql.Date |
getDate(int columnIndex,
java.util.Calendar cal) |
JDBC 2.0
Get the value of a column in the current row as a java.sql.Date
object.
|
java.sql.Date |
getDate(java.lang.String columnName) |
Get the value of a column in the current row as a java.sql.Date object.
|
java.sql.Date |
getDate(java.lang.String columnName,
java.util.Calendar cal) |
JDBC 2.0
Get the value of a column in the current row as a java.sql.Date
object.
|
double |
getDouble(int columnIndex) |
Get the value of a column in the current row as a Java double.
|
double |
getDouble(java.lang.String columnName) |
Get the value of a column in the current row as a Java double.
|
protected DataValueDescriptor |
getDVDforColumnToBeUpdated(int columnIndex,
java.lang.String updateMethodName) |
|
int |
getFetchDirection() |
JDBC 2.0
Return the fetch direction for this result set.
|
int |
getFetchSize() |
JDBC 2.0
Return the fetch size for this result set.
|
float |
getFloat(int columnIndex) |
Get the value of a column in the current row as a Java float.
|
float |
getFloat(java.lang.String columnName) |
Get the value of a column in the current row as a Java float.
|
private java.lang.String |
getFullBaseTableName(ExecCursorTableReference targetTable) |
|
int |
getHoldability() |
JDBC 4.0
|
int |
getInt(int columnIndex) |
Get the value of a column in the current row as a Java int.
|
int |
getInt(java.lang.String columnName) |
Get the value of a column in the current row as a Java int.
|
int |
getLength(int columnIndex) |
Return the length of the designated columnIndex data value.
|
long |
getLong(int columnIndex) |
Get the value of a column in the current row as a Java long.
|
long |
getLong(java.lang.String columnName) |
Get the value of a column in the current row as a Java long.
|
private int |
getMaxColumnWidth(int columnIndex) |
Return the user-defined maximum size of the column.
|
java.sql.ResultSetMetaData |
getMetaData() |
The number, types and properties of a ResultSet's columns
are provided by the getMetaData method.
|
java.io.Reader |
getNCharacterStream(int columnIndex) |
|
java.io.Reader |
getNCharacterStream(java.lang.String columnName) |
|
java.sql.NClob |
getNClob(int i) |
|
java.sql.NClob |
getNClob(java.lang.String colName) |
|
java.lang.String |
getNString(int columnIndex) |
|
java.lang.String |
getNString(java.lang.String columnName) |
|
java.lang.Object |
getObject(int columnIndex) |
Get the value of a column in the current row as a Java object.
|
<T> T |
getObject(int columnIndex,
java.lang.Class<T> type) |
Retrieve the column as an object of the desired type.
|
java.lang.Object |
getObject(int columnIndex,
java.util.Map<java.lang.String,java.lang.Class<?>> map) |
JDBC 2.0
Returns the value of column
i as a Java object. |
java.lang.Object |
getObject(java.lang.String columnName) |
Get the value of a column in the current row as a Java object.
|
<T> T |
getObject(java.lang.String columnName,
java.lang.Class<T> type) |
|
java.lang.Object |
getObject(java.lang.String colName,
java.util.Map<java.lang.String,java.lang.Class<?>> map) |
JDBC 2.0
Returns the value of column
i as a Java object. |
protected ParameterValueSet |
getParameterValueSet() |
Try to see if we can fish the pvs out of the local statement.
|
java.sql.Ref |
getRef(int i) |
JDBC 2.0
Get a REF(<structured-type>) column.
|
java.sql.Ref |
getRef(java.lang.String colName) |
JDBC 2.0
Get a REF(<structured-type>) column.
|
int |
getRow() |
JDBC 2.0
|
java.sql.RowId |
getRowId(int columnIndex) |
|
java.sql.RowId |
getRowId(java.lang.String columnName) |
|
short |
getShort(int columnIndex) |
Get the value of a column in the current row as a Java short.
|
short |
getShort(java.lang.String columnName) |
Get the value of a column in the current row as a Java short.
|
protected java.lang.String |
getSQLText() |
Try to see if we can fish the SQL Statement out of the local statement.
|
java.sql.SQLXML |
getSQLXML(int columnIndex) |
|
java.sql.SQLXML |
getSQLXML(java.lang.String colName) |
|
java.sql.Statement |
getStatement() |
JDBC 2.0
Return the Statement that produced the ResultSet.
|
java.lang.String |
getString(int columnIndex) |
Get the value of a column in the current row as a Java String.
|
java.lang.String |
getString(java.lang.String columnName) |
Get the value of a column in the current row as a Java String.
|
java.sql.Time |
getTime(int columnIndex) |
Get the value of a column in the current row as a java.sql.Time object.
|
java.sql.Time |
getTime(int columnIndex,
java.util.Calendar cal) |
JDBC 2.0
Get the value of a column in the current row as a java.sql.Time
object.
|
java.sql.Time |
getTime(java.lang.String columnName) |
Get the value of a column in the current row as a java.sql.Time object.
|
java.sql.Time |
getTime(java.lang.String columnName,
java.util.Calendar cal) |
JDBC 2.0
Get the value of a column in the current row as a java.sql.Time
object.
|
java.sql.Timestamp |
getTimestamp(int columnIndex) |
Get the value of a column in the current row as a java.sql.Timestamp object.
|
java.sql.Timestamp |
getTimestamp(int columnIndex,
java.util.Calendar cal) |
JDBC 2.0
Get the value of a column in the current row as a java.sql.Timestamp
object.
|
java.sql.Timestamp |
getTimestamp(java.lang.String columnName) |
Get the value of a column in the current row as a java.sql.Timestamp object.
|
java.sql.Timestamp |
getTimestamp(java.lang.String columnName,
java.util.Calendar cal) |
JDBC 2.0
Get the value of a column in the current row as a java.sql.Timestamp
object.
|
int |
getType() |
JDBC 2.0
Return the type of this result set.
|
java.io.InputStream |
getUnicodeStream(int columnIndex) |
Deprecated.
|
java.io.InputStream |
getUnicodeStream(java.lang.String columnName) |
Deprecated.
|
java.net.URL |
getURL(int columnIndex) |
JDBC 3.0
Retrieves the value of the designated column in the current row of this
ResultSet object as a java.net.URL object in the Java programming
language.
|
java.net.URL |
getURL(java.lang.String columnName) |
JDBC 3.0
Retrieves the value of the designated column in the current row of this
ResultSet object as a java.net.URL object in the Java programming
language.
|
java.sql.SQLWarning |
getWarnings() |
The first warning reported by calls on this ResultSet is
returned.
|
private void |
initializeUpdateRowModifiers() |
Initializes the currentRowHasBeenUpdated and columnGotUpdated fields
|
void |
insertRow() |
JDBC 2.0
Insert the contents of the insert row into the result set and the
database.
|
boolean |
isAfterLast() |
JDBC 2.0
|
boolean |
isBeforeFirst() |
JDBC 2.0
|
boolean |
isClosed() |
JDBC 4.0
|
boolean |
isFirst() |
JDBC 2.0
|
boolean |
isForUpdate() |
* Is this result set from a select for update statement?
|
boolean |
isLast() |
JDBC 2.0
|
private static boolean |
isMaxFieldSizeType(int colType) |
|
boolean |
isNull(int columnIndex) |
Is the designated columnIndex a null data value?
|
boolean |
isWrapperFor(java.lang.Class<?> interfaces) |
Returns false unless
interfaces is implemented |
boolean |
last() |
JDBC 2.0
|
private void |
markClosed() |
Mark this ResultSet as closed and trigger the closing of the Statement
if necessary.
|
private java.sql.SQLException |
mismatchException(java.lang.String targetTypeName,
int columnIndex) |
|
protected boolean |
movePosition(int position,
int row,
java.lang.String positionText) |
|
protected boolean |
movePosition(int position,
java.lang.String positionText) |
|
void |
moveToCurrentRow() |
JDBC 2.0
Move the cursor to the remembered cursor position, usually the current
row.
|
void |
moveToInsertRow() |
JDBC 2.0
Move to the insert row.
|
boolean |
next() |
A ResultSet is initially positioned before its first row; the
first call to next makes the first row the current row; the
second call makes the second row the current row, etc.
|
(package private) static java.sql.SQLException |
noStateChangeException(java.lang.Throwable thrownException) |
An exception on many method calls to JDBC objects does not change the state
of the transaction or statement, or even the underlying object.
|
boolean |
previous() |
JDBC 2.0
|
void |
refreshRow() |
JDBC 2.0
Refresh the value of the current row with its current value in the
database.
|
boolean |
relative(int row) |
JDBC 2.0
|
boolean |
rowDeleted() |
JDBC 2.0
Determine if this row has been deleted.
|
boolean |
rowInserted() |
JDBC 2.0
Determine if the current row has been inserted.
|
boolean |
rowUpdated() |
JDBC 2.0
Determine if the current row has been updated.
|
void |
setApplicationStatement(java.sql.Statement applicationStmt) |
Set the application Statement object that created this ResultSet.
|
(package private) void |
setDynamicResultSet(EmbedStatement owningStmt) |
A dynamic result was created in a procedure by a nested connection.
|
void |
setFetchDirection(int direction) |
JDBC 2.0
Give a hint as to the direction in which the rows in this result set will
be processed.
|
static void |
setFetchedRowBase(long newBase) |
Debug method used to test the setLargeMaxRows() method added by JDBC 4.2.
|
void |
setFetchSize(int rows) |
JDBC 2.0
Give the JDBC driver a hint as to the number of rows that should be
fetched from the database when more rows are needed for this result set.
|
<T> T |
unwrap(java.lang.Class<T> interfaces) |
Returns
this if this class implements the interface |
void |
updateArray(int columnIndex,
java.sql.Array x) |
JDBC 3.0
Updates the designated column with a java.sql.Array value.
|
void |
updateArray(java.lang.String columnName,
java.sql.Array x) |
JDBC 3.0
Updates the designated column with a java.sql.Array value.
|
void |
updateAsciiStream(int columnIndex,
java.io.InputStream x) |
Updates the designated column with a character stream value.
|
void |
updateAsciiStream(int columnIndex,
java.io.InputStream x,
int length) |
JDBC 2.0
Update a column with an ascii stream value.
|
void |
updateAsciiStream(int columnIndex,
java.io.InputStream x,
long length) |
Update a column with an ascii stream value.
|
void |
updateAsciiStream(java.lang.String columnName,
java.io.InputStream x) |
Updates the designated column with a character stream value.
|
void |
updateAsciiStream(java.lang.String columnName,
java.io.InputStream x,
int length) |
JDBC 2.0
Update a column with an ascii stream value.
|
void |
updateAsciiStream(java.lang.String columnName,
java.io.InputStream x,
long length) |
JDBC 4.0
Update a column with an ascii stream value.
|
void |
updateBigDecimal(int columnIndex,
java.math.BigDecimal x) |
|
void |
updateBigDecimal(java.lang.String columnName,
java.math.BigDecimal x) |
JDBC 2.0
Update a column with a BigDecimal value.
|
void |
updateBinaryStream(int columnIndex,
java.io.InputStream x) |
Updates the designated column with a binary stream value.
|
void |
updateBinaryStream(int columnIndex,
java.io.InputStream x,
int length) |
JDBC 2.0
Update a column with a binary stream value.
|
void |
updateBinaryStream(int columnIndex,
java.io.InputStream x,
long length) |
Update a column with a binary stream value.
|
void |
updateBinaryStream(java.lang.String columnName,
java.io.InputStream x) |
Updates the designated column with a binary stream value.
|
void |
updateBinaryStream(java.lang.String columnName,
java.io.InputStream x,
int length) |
JDBC 2.0
Update a column with a binary stream value.
|
void |
updateBinaryStream(java.lang.String columnName,
java.io.InputStream x,
long length) |
JDBC 4.0
Update a column with a binary stream value.
|
private void |
updateBinaryStreamInternal(int columnIndex,
java.io.InputStream x,
boolean lengthLess,
long length,
java.lang.String updateMethodName) |
Set the given binary stream for the specified parameter.
|
void |
updateBlob(int columnIndex,
java.io.InputStream x) |
Updates the designated column using the given input stream.
|
void |
updateBlob(int columnIndex,
java.io.InputStream x,
long length) |
JDBC 4.0
Updates the designated column with a java.sql.Blob value.
|
void |
updateBlob(int columnIndex,
java.sql.Blob x) |
JDBC 3.0
Updates the designated column with a java.sql.Blob value.
|
void |
updateBlob(java.lang.String columnName,
java.io.InputStream x) |
Updates the designated column using the given input stream.
|
void |
updateBlob(java.lang.String columnName,
java.io.InputStream x,
long length) |
JDBC 4.0
Updates the designated column with a java.sql.Blob value.
|
void |
updateBlob(java.lang.String columnName,
java.sql.Blob x) |
JDBC 3.0
Updates the designated column with a java.sql.Blob value.
|
void |
updateBoolean(int columnIndex,
boolean x) |
JDBC 2.0
Update a column with a boolean value.
|
void |
updateBoolean(java.lang.String columnName,
boolean x) |
JDBC 2.0
Update a column with a boolean value.
|
void |
updateByte(int columnIndex,
byte x) |
JDBC 2.0
Update a column with a byte value.
|
void |
updateByte(java.lang.String columnName,
byte x) |
JDBC 2.0
Update a column with a byte value.
|
void |
updateBytes(int columnIndex,
byte[] x) |
JDBC 2.0
Update a column with a byte array value.
|
void |
updateBytes(java.lang.String columnName,
byte[] x) |
JDBC 2.0
Update a column with a byte array value.
|
void |
updateCharacterStream(int columnIndex,
java.io.Reader x) |
Updates the designated column with a character stream value.
|
void |
updateCharacterStream(int columnIndex,
java.io.Reader x,
int length) |
JDBC 2.0
Update a column with a character stream value.
|
void |
updateCharacterStream(int columnIndex,
java.io.Reader x,
long length) |
JDBC 4.0
Update a column with a character stream value.
|
void |
updateCharacterStream(java.lang.String columnName,
java.io.Reader reader) |
Updates the designated column with a character stream value.
|
void |
updateCharacterStream(java.lang.String columnName,
java.io.Reader reader,
int length) |
JDBC 2.0
Update a column with a character stream value.
|
void |
updateCharacterStream(java.lang.String columnName,
java.io.Reader reader,
long length) |
JDBC 4.0
Update a column with a character stream value.
|
private void |
updateCharacterStreamInternal(int columnIndex,
java.io.Reader reader,
boolean lengthLess,
long length,
java.lang.String updateMethodName) |
Set the given character stream for the specified parameter.
|
void |
updateClob(int columnIndex,
java.io.Reader x) |
Updates the designated column using the given
Reader
object. |
void |
updateClob(int columnIndex,
java.io.Reader x,
long length) |
JDBC 4.0
Updates the designated column with a java.sql.Clob value.
|
void |
updateClob(int columnIndex,
java.sql.Clob x) |
JDBC 3.0
Updates the designated column with a java.sql.Clob value.
|
void |
updateClob(java.lang.String columnName,
java.io.Reader x) |
Updates the designated column using the given
Reader
object. |
void |
updateClob(java.lang.String columnName,
java.io.Reader x,
long length) |
JDBC 4.0
Updates the designated column with a java.sql.Clob value.
|
void |
updateClob(java.lang.String columnName,
java.sql.Clob x) |
JDBC 3.0
Updates the designated column with a java.sql.Clob value.
|
void |
updateDate(int columnIndex,
java.sql.Date x) |
JDBC 2.0
Update a column with a Date value.
|
void |
updateDate(java.lang.String columnName,
java.sql.Date x) |
JDBC 2.0
Update a column with a Date value.
|
void |
updateDouble(int columnIndex,
double x) |
JDBC 2.0
Update a column with a Double value.
|
void |
updateDouble(java.lang.String columnName,
double x) |
JDBC 2.0
Update a column with a double value.
|
void |
updateFloat(int columnIndex,
float x) |
JDBC 2.0
Update a column with a float value.
|
void |
updateFloat(java.lang.String columnName,
float x) |
JDBC 2.0
Update a column with a float value.
|
void |
updateInt(int columnIndex,
int x) |
JDBC 2.0
Update a column with an integer value.
|
void |
updateInt(java.lang.String columnName,
int x) |
JDBC 2.0
Update a column with an integer value.
|
void |
updateLong(int columnIndex,
long x) |
JDBC 2.0
Update a column with a long value.
|
void |
updateLong(java.lang.String columnName,
long x) |
JDBC 2.0
Update a column with a long value.
|
void |
updateNCharacterStream(int columnIndex,
java.io.Reader x) |
|
void |
updateNCharacterStream(int columnIndex,
java.io.Reader x,
long length) |
|
void |
updateNCharacterStream(java.lang.String columnName,
java.io.Reader x) |
|
void |
updateNCharacterStream(java.lang.String columnName,
java.io.Reader x,
long length) |
|
void |
updateNClob(int columnIndex,
java.io.Reader reader) |
|
void |
updateNClob(int columnIndex,
java.io.Reader x,
long length) |
Updates the designated column using the given Reader object, which is the
given number of characters long.
|
void |
updateNClob(int columnIndex,
java.sql.NClob nClob) |
|
void |
updateNClob(java.lang.String columnName,
java.io.Reader reader) |
|
void |
updateNClob(java.lang.String columnName,
java.io.Reader x,
long length) |
Updates the designated column using the given Reader object, which is the
given number of characters long.
|
void |
updateNClob(java.lang.String columnName,
java.sql.NClob nClob) |
|
void |
updateNString(int columnIndex,
java.lang.String nString) |
|
void |
updateNString(java.lang.String columnName,
java.lang.String nString) |
|
void |
updateNull(int columnIndex) |
JDBC 2.0
Give a nullable column a null value.
|
void |
updateNull(java.lang.String columnName) |
JDBC 2.0
Update a column with a null value.
|
void |
updateObject(int columnIndex,
java.lang.Object x) |
JDBC 2.0
Update a column with an Object value.
|
void |
updateObject(int columnIndex,
java.lang.Object x,
int scale) |
JDBC 2.0
Update a column with an Object value.
|
void |
updateObject(java.lang.String columnName,
java.lang.Object x) |
JDBC 2.0
Update a column with an Object value.
|
void |
updateObject(java.lang.String columnName,
java.lang.Object x,
int scale) |
JDBC 2.0
Update a column with an Object value.
|
void |
updateRef(int columnIndex,
java.sql.Ref x) |
JDBC 3.0
Updates the designated column with a java.sql.Ref value.
|
void |
updateRef(java.lang.String columnName,
java.sql.Ref x) |
JDBC 3.0
Updates the designated column with a java.sql.Ref value.
|
void |
updateRow() |
JDBC 2.0
Update the underlying database with the new contents of the
current row.
|
void |
updateRowId(int columnIndex,
java.sql.RowId x) |
|
void |
updateRowId(java.lang.String columnName,
java.sql.RowId x) |
|
void |
updateShort(int columnIndex,
short x) |
JDBC 2.0
Update a column with a short value.
|
void |
updateShort(java.lang.String columnName,
short x) |
JDBC 2.0
Update a column with a short value.
|
void |
updateSQLXML(int columnIndex,
java.sql.SQLXML xmlObject) |
|
void |
updateSQLXML(java.lang.String columnName,
java.sql.SQLXML xmlObject) |
|
void |
updateString(int columnIndex,
java.lang.String x) |
JDBC 2.0
Update a column with a String value.
|
void |
updateString(java.lang.String columnName,
java.lang.String x) |
JDBC 2.0
Update a column with a String value.
|
void |
updateTime(int columnIndex,
java.sql.Time x) |
JDBC 2.0
Update a column with a Time value.
|
void |
updateTime(java.lang.String columnName,
java.sql.Time x) |
JDBC 2.0
Update a column with a Time value.
|
void |
updateTimestamp(int columnIndex,
java.sql.Timestamp x) |
JDBC 2.0
Update a column with a Timestamp value.
|
void |
updateTimestamp(java.lang.String columnName,
java.sql.Timestamp x) |
JDBC 2.0
Update a column with a Timestamp value.
|
(package private) void |
useStreamOrLOB(int columnIndex) |
Mark a column as already having a stream or LOB accessed from it.
|
boolean |
wasNull() |
A column may have the value of SQL NULL; wasNull reports whether
the last column read had this special value.
|
commitIfAutoCommit, commitIfNeeded, getCal, getConnectionSynchronization, getEmbedConnection, getLanguageConnectionContext, getLCC, handleException, needCommit, newSQLException, restoreContextStack, restoreIntrFlagIfSeen, setupContextStack
private static long fetchedRowBase
protected static final int FIRST
protected static final int NEXT
protected static final int LAST
protected static final int PREVIOUS
protected static final int BEFOREFIRST
protected static final int AFTERLAST
protected static final int ABSOLUTE
protected static final int RELATIVE
private ExecRow currentRow
protected boolean wasNull
boolean isClosed
private boolean isOnInsertRow
private java.lang.Object currentStream
private ResultSet theResults
private boolean forMetaData
private java.sql.SQLWarning topWarning
Activation singleUseActivation
final int order
private final ResultDescription resultDescription
private long maxRows
private final int maxFieldSize
private long NumberofFetchedRows
private final EmbedStatement stmt
private EmbedStatement owningStmt
private java.sql.Statement applicationStmt
private final long timeoutMillis
private final boolean isAtomic
private final int concurrencyOfThisResultSet
private final ExecRow updateRow
private boolean[] columnGotUpdated
private boolean currentRowHasBeenUpdated
private int fetchDirection
private int fetchSize
private boolean[] columnUsedFlags
public EmbedResultSet(EmbedConnection conn, ResultSet resultsToWrap, boolean forMetaData, EmbedStatement stmt, boolean isAtomic) throws java.sql.SQLException
java.sql.SQLException
public static void setFetchedRowBase(long newBase)
private void checkNotOnInsertRow() throws java.sql.SQLException
java.sql.SQLException
protected final void checkOnRow() throws java.sql.SQLException
java.sql.SQLException
private void initializeUpdateRowModifiers()
final int getColumnType(int columnIndex) throws java.sql.SQLException
java.sql.SQLException
- ResultSet is not on a row or columnIndex is out of range.public boolean next() throws java.sql.SQLException
If an input stream from the previous row is open, it is implicitly closed. The ResultSet's warning chain is cleared when a new row is read.
next
in interface java.sql.ResultSet
java.sql.SQLException
- thrown on failure.protected boolean movePosition(int position, java.lang.String positionText) throws java.sql.SQLException
java.sql.SQLException
protected boolean movePosition(int position, int row, java.lang.String positionText) throws java.sql.SQLException
java.sql.SQLException
public void close() throws java.sql.SQLException
Note: A ResultSet is automatically closed by the Statement that generated it when that Statement is closed, re-executed, or is used to retrieve the next result from a sequence of multiple results. A ResultSet is also automatically closed when it is garbage collected.
close
in interface java.lang.AutoCloseable
close
in interface java.sql.ResultSet
java.sql.SQLException
- thrown on failure.private void markClosed()
public final boolean wasNull() throws java.sql.SQLException
we take the least exception approach and simply return false if no column has been read yet.
wasNull
in interface java.sql.ResultSet
java.sql.SQLException
- Thrown if this ResultSet is closedpublic final java.lang.String getString(int columnIndex) throws java.sql.SQLException
getString
in interface java.sql.ResultSet
columnIndex
- the first column is 1, the second is 2, ...java.sql.SQLException
- thrown on failure.public final boolean getBoolean(int columnIndex) throws java.sql.SQLException
getBoolean
in interface java.sql.ResultSet
columnIndex
- the first column is 1, the second is 2, ...java.sql.SQLException
- thrown on failure.public final byte getByte(int columnIndex) throws java.sql.SQLException
getByte
in interface java.sql.ResultSet
columnIndex
- the first column is 1, the second is 2, ...java.sql.SQLException
- thrown on failure.public final short getShort(int columnIndex) throws java.sql.SQLException
getShort
in interface java.sql.ResultSet
columnIndex
- the first column is 1, the second is 2, ...java.sql.SQLException
- thrown on failure.public final int getInt(int columnIndex) throws java.sql.SQLException
getInt
in interface java.sql.ResultSet
columnIndex
- the first column is 1, the second is 2, ...java.sql.SQLException
- thrown on failure.public final long getLong(int columnIndex) throws java.sql.SQLException
getLong
in interface java.sql.ResultSet
columnIndex
- the first column is 1, the second is 2, ...java.sql.SQLException
- thrown on failure.public final float getFloat(int columnIndex) throws java.sql.SQLException
getFloat
in interface java.sql.ResultSet
columnIndex
- the first column is 1, the second is 2, ...java.sql.SQLException
- thrown on failure.public final double getDouble(int columnIndex) throws java.sql.SQLException
getDouble
in interface java.sql.ResultSet
columnIndex
- the first column is 1, the second is 2, ...java.sql.SQLException
- thrown on failure.public final byte[] getBytes(int columnIndex) throws java.sql.SQLException
getBytes
in interface java.sql.ResultSet
columnIndex
- the first column is 1, the second is 2, ...java.sql.SQLException
- thrown on failure.public final java.sql.Date getDate(int columnIndex) throws java.sql.SQLException
getDate
in interface java.sql.ResultSet
columnIndex
- the first column is 1, the second is 2, ...java.sql.SQLException
- thrown on failure.public final java.sql.Time getTime(int columnIndex) throws java.sql.SQLException
getTime
in interface java.sql.ResultSet
columnIndex
- the first column is 1, the second is 2, ...java.sql.SQLException
- thrown on failure.public final java.sql.Timestamp getTimestamp(int columnIndex) throws java.sql.SQLException
getTimestamp
in interface java.sql.ResultSet
columnIndex
- the first column is 1, the second is 2, ...java.sql.SQLException
- thrown on failure.public java.sql.Date getDate(int columnIndex, java.util.Calendar cal) throws java.sql.SQLException
getDate
in interface java.sql.ResultSet
columnIndex
- the first column is 1, the second is 2, ...cal
- the calendar to use in constructing the datejava.sql.SQLException
- if a database-access error occurs.public java.sql.Date getDate(java.lang.String columnName, java.util.Calendar cal) throws java.sql.SQLException
getDate
in interface java.sql.ResultSet
columnName
- is the SQL name of the columncal
- the calendar to use in constructing the datejava.sql.SQLException
- if a database-access error occurs.public java.sql.Time getTime(int columnIndex, java.util.Calendar cal) throws java.sql.SQLException
getTime
in interface java.sql.ResultSet
columnIndex
- the first column is 1, the second is 2, ...cal
- the calendar to use in constructing the timejava.sql.SQLException
- if a database-access error occurs.public java.sql.Time getTime(java.lang.String columnName, java.util.Calendar cal) throws java.sql.SQLException
getTime
in interface java.sql.ResultSet
columnName
- is the SQL name of the columncal
- the calendar to use in constructing the timejava.sql.SQLException
- if a database-access error occurs.public java.sql.Timestamp getTimestamp(java.lang.String columnName, java.util.Calendar cal) throws java.sql.SQLException
getTimestamp
in interface java.sql.ResultSet
columnName
- is the SQL name of the columncal
- the calendar to use in constructing the timestampjava.sql.SQLException
- if a database-access error occurs.public java.sql.Timestamp getTimestamp(int columnIndex, java.util.Calendar cal) throws java.sql.SQLException
getTimestamp
in interface java.sql.ResultSet
columnIndex
- the first column is 1, the second is 2, ...cal
- the calendar to use in constructing the timestampjava.sql.SQLException
- if a database-access error occurs.public final java.io.Reader getCharacterStream(int columnIndex) throws java.sql.SQLException
Get the value of a column in the current row as a java.io.Reader.
getCharacterStream
in interface java.sql.ResultSet
java.sql.SQLException
- database error.public final java.io.InputStream getAsciiStream(int columnIndex) throws java.sql.SQLException
getAsciiStream
in interface java.sql.ResultSet
columnIndex
- the first column is 1, the second is 2, ...java.sql.SQLException
- thrown on failure.public final java.io.InputStream getBinaryStream(int columnIndex) throws java.sql.SQLException
getBinaryStream
in interface java.sql.ResultSet
columnIndex
- the first column is 1, the second is 2, ...java.sql.SQLException
- thrown on failure.public final java.lang.String getString(java.lang.String columnName) throws java.sql.SQLException
getString
in interface java.sql.ResultSet
columnName
- is the SQL name of the columnjava.sql.SQLException
- thrown on failure.public final boolean getBoolean(java.lang.String columnName) throws java.sql.SQLException
getBoolean
in interface java.sql.ResultSet
columnName
- is the SQL name of the columnjava.sql.SQLException
- thrown on failure.public final byte getByte(java.lang.String columnName) throws java.sql.SQLException
getByte
in interface java.sql.ResultSet
columnName
- is the SQL name of the columnjava.sql.SQLException
- thrown on failure.public final short getShort(java.lang.String columnName) throws java.sql.SQLException
getShort
in interface java.sql.ResultSet
columnName
- is the SQL name of the columnjava.sql.SQLException
- thrown on failure.public final int getInt(java.lang.String columnName) throws java.sql.SQLException
getInt
in interface java.sql.ResultSet
columnName
- is the SQL name of the columnjava.sql.SQLException
- thrown on failure.public final long getLong(java.lang.String columnName) throws java.sql.SQLException
getLong
in interface java.sql.ResultSet
columnName
- is the SQL name of the columnjava.sql.SQLException
- thrown on failure.public final float getFloat(java.lang.String columnName) throws java.sql.SQLException
getFloat
in interface java.sql.ResultSet
columnName
- is the SQL name of the columnjava.sql.SQLException
- thrown on failure.public final double getDouble(java.lang.String columnName) throws java.sql.SQLException
getDouble
in interface java.sql.ResultSet
columnName
- is the SQL name of the columnjava.sql.SQLException
- thrown on failure.@Deprecated public final java.math.BigDecimal getBigDecimal(int columnIndex, int scale) throws java.sql.SQLException
getBigDecimal
in interface java.sql.ResultSet
columnIndex
- the first column is 1, the second is 2, ...scale
- the number of digits to the right of the decimaljava.sql.SQLException
- thrown on failure.public final java.math.BigDecimal getBigDecimal(int columnIndex) throws java.sql.SQLException
getBigDecimal
in interface java.sql.ResultSet
java.sql.SQLException
@Deprecated public final java.math.BigDecimal getBigDecimal(java.lang.String columnName, int scale) throws java.sql.SQLException
getBigDecimal
in interface java.sql.ResultSet
columnName
- is the SQL name of the columnscale
- the number of digits to the right of the decimaljava.sql.SQLException
- thrown on failure.public final java.math.BigDecimal getBigDecimal(java.lang.String columnName) throws java.sql.SQLException
getBigDecimal
in interface java.sql.ResultSet
java.sql.SQLException
public final byte[] getBytes(java.lang.String columnName) throws java.sql.SQLException
getBytes
in interface java.sql.ResultSet
columnName
- is the SQL name of the columnjava.sql.SQLException
- thrown on failure.public final java.sql.Date getDate(java.lang.String columnName) throws java.sql.SQLException
getDate
in interface java.sql.ResultSet
columnName
- is the SQL name of the columnjava.sql.SQLException
- thrown on failure.public final java.sql.Time getTime(java.lang.String columnName) throws java.sql.SQLException
getTime
in interface java.sql.ResultSet
columnName
- is the SQL name of the columnjava.sql.SQLException
- thrown on failure.public final java.sql.Timestamp getTimestamp(java.lang.String columnName) throws java.sql.SQLException
getTimestamp
in interface java.sql.ResultSet
columnName
- is the SQL name of the columnjava.sql.SQLException
- thrown on failure.public final java.io.Reader getCharacterStream(java.lang.String columnName) throws java.sql.SQLException
Get the value of a column in the current row as a java.io.Reader.
getCharacterStream
in interface java.sql.ResultSet
java.sql.SQLException
- Feature not implemented for now.public final java.io.InputStream getAsciiStream(java.lang.String columnName) throws java.sql.SQLException
Note: All the data in the returned stream must be read prior to getting the value of any other column. The next call to a get method implicitly closes the stream.
getAsciiStream
in interface java.sql.ResultSet
columnName
- is the SQL name of the columnjava.sql.SQLException
- thrown on failure.public final java.io.InputStream getBinaryStream(java.lang.String columnName) throws java.sql.SQLException
Note: All the data in the returned stream must be read prior to getting the value of any other column. The next call to a get method implicitly closes the stream.
getBinaryStream
in interface java.sql.ResultSet
columnName
- is the SQL name of the columnjava.sql.SQLException
- thrown on failure.@Deprecated public final java.io.InputStream getUnicodeStream(int columnIndex) throws java.sql.SQLException
getUnicodeStream
in interface java.sql.ResultSet
java.sql.SQLException
- thrown on failure.@Deprecated public final java.io.InputStream getUnicodeStream(java.lang.String columnName) throws java.sql.SQLException
getUnicodeStream
in interface java.sql.ResultSet
java.sql.SQLException
- thrown on failure.public java.net.URL getURL(int columnIndex) throws java.sql.SQLException
getURL
in interface java.sql.ResultSet
columnIndex
- -
the first column is 1, the second is 2java.sql.SQLException
- Feature not implemented for now.public java.net.URL getURL(java.lang.String columnName) throws java.sql.SQLException
getURL
in interface java.sql.ResultSet
columnName
- -
the SQL name of the columnjava.sql.SQLException
- Feature not implemented for now.public final java.sql.SQLWarning getWarnings() throws java.sql.SQLException
The first warning reported by calls on this ResultSet is returned. Subsequent ResultSet warnings will be chained to this SQLWarning.
The warning chain is automatically cleared each time a new row is read.
Note: This warning chain only covers warnings caused by ResultSet methods. Any warning caused by statement methods (such as reading OUT parameters) will be chained on the Statement object.
getWarnings
in interface java.sql.ResultSet
java.sql.SQLException
- Thrown if this ResultSet is closedpublic final void clearWarnings() throws java.sql.SQLException
clearWarnings
in interface java.sql.ResultSet
java.sql.SQLException
- Thrown if this ResultSet is closedpublic final java.lang.String getCursorName() throws java.sql.SQLException
In SQL, a result table is retrieved through a cursor that is named. The current row of a result can be updated or deleted using a positioned update/delete statement that references the cursor name.
JDBC supports this SQL feature by providing the name of the SQL cursor used by a ResultSet. The current row of a ResultSet is also the current row of this SQL cursor.
Note: If positioned update is not supported a SQLException is thrown
getCursorName
in interface java.sql.ResultSet
java.sql.SQLException
- thrown on failure.public final java.sql.ResultSetMetaData getMetaData() throws java.sql.SQLException
getMetaData
in interface java.sql.ResultSet
java.sql.SQLException
- thrown on failure.public final int getHoldability() throws java.sql.SQLException
Retrieves the holdability for this ResultSet
object.
getHoldability
in interface java.sql.ResultSet
ResultSet.HOLD_CURSORS_OVER_COMMIT
or ResultSet.CLOSE_CURSORS_AT_COMMIT
java.sql.SQLException
- if a database error occurspublic final java.lang.Object getObject(int columnIndex) throws java.sql.SQLException
Get the value of a column in the current row as a Java object.
This method will return the value of the given column as a Java object. The type of the Java object will be the default Java Object type corresponding to the column's SQL type, following the mapping specified in the JDBC spec.
This method may also be used to read datatabase specific abstract data types. JDBC 2.0 New behavior for getObject(). The behavior of method getObject() is extended to materialize data of SQL user-defined types. When the column @columnIndex is a structured or distinct value, the behavior of this method is as if it were a call to: getObject(columnIndex, this.getStatement().getConnection().getTypeMap()).
getObject
in interface java.sql.ResultSet
columnIndex
- the first column is 1, the second is 2, ...java.sql.SQLException
- thrown on failure.public final java.lang.Object getObject(java.lang.String columnName) throws java.sql.SQLException
Get the value of a column in the current row as a Java object.
This method will return the value of the given column as a Java object. The type of the Java object will be the default Java Object type corresponding to the column's SQL type, following the mapping specified in the JDBC spec.
This method may also be used to read datatabase specific abstract data types. JDBC 2.0 New behavior for getObject(). The behavior of method getObject() is extended to materialize data of SQL user-defined types. When the column @columnName is a structured or distinct value, the behavior of this method is as if it were a call to: getObject(columnName, this.getStatement().getConnection().getTypeMap()).
getObject
in interface java.sql.ResultSet
columnName
- is the SQL name of the columnjava.sql.SQLException
- thrown on failure.public java.lang.Object getObject(int columnIndex, java.util.Map<java.lang.String,java.lang.Class<?>> map) throws java.sql.SQLException
i
as a Java object. Use the param map
to determine the class from which to construct data of SQL structured and
distinct types.getObject
in interface java.sql.ResultSet
columnIndex
- the first column is 1, the second is 2, ...map
- the mapping from SQL type names to Java classesjava.sql.SQLException
- Feature not implemented for now.public java.lang.Object getObject(java.lang.String colName, java.util.Map<java.lang.String,java.lang.Class<?>> map) throws java.sql.SQLException
i
as a Java object. Use the param map
to determine the class from which to construct data of SQL structured and
distinct types.getObject
in interface java.sql.ResultSet
colName
- the column namemap
- the mapping from SQL type names to Java classesjava.sql.SQLException
- Feature not implemented for now.public final int findColumn(java.lang.String columnName) throws java.sql.SQLException
findColumn
in interface java.sql.ResultSet
columnName
- the name of the columnjava.sql.SQLException
- thrown on failure.public final java.sql.Statement getStatement() throws java.sql.SQLException
getStatement
in interface java.sql.ResultSet
java.sql.SQLException
- if a database error occurs or the
result set is closedpublic final void setApplicationStatement(java.sql.Statement applicationStmt)
public final java.sql.Ref getRef(int i) throws java.sql.SQLException
getRef
in interface java.sql.ResultSet
i
- the first column is 1, the second is 2, ...java.sql.SQLException
- Feature not implemented for now.public final java.sql.Array getArray(int i) throws java.sql.SQLException
getArray
in interface java.sql.ResultSet
i
- the first column is 1, the second is 2, ...java.sql.SQLException
- Feature not implemented for now.public final java.sql.Ref getRef(java.lang.String colName) throws java.sql.SQLException
getRef
in interface java.sql.ResultSet
colName
- the column namejava.sql.SQLException
- Feature not implemented for now.public final java.sql.Array getArray(java.lang.String colName) throws java.sql.SQLException
getArray
in interface java.sql.ResultSet
colName
- the column namejava.sql.SQLException
- Feature not implemented for now.public boolean isBeforeFirst() throws java.sql.SQLException
Determine if the cursor is before the first row in the result set.
isBeforeFirst
in interface java.sql.ResultSet
java.sql.SQLException
- Thrown on error.public boolean isAfterLast() throws java.sql.SQLException
Determine if the cursor is after the last row in the result set.
isAfterLast
in interface java.sql.ResultSet
java.sql.SQLException
- Thrown on error.public boolean isFirst() throws java.sql.SQLException
Determine if the cursor is on the first row of the result set.
isFirst
in interface java.sql.ResultSet
java.sql.SQLException
- Thrown on error.public boolean isLast() throws java.sql.SQLException
Determine if the cursor is on the last row of the result set. Note: Calling isLast() may be expensive since the JDBC driver might need to fetch ahead one row in order to determine whether the current row is the last row in the result set.
isLast
in interface java.sql.ResultSet
java.sql.SQLException
- Thrown on error.public void beforeFirst() throws java.sql.SQLException
Moves to the front of the result set, just before the first row. Has no effect if the result set contains no rows.
beforeFirst
in interface java.sql.ResultSet
java.sql.SQLException
- if a database-access error occurs, or result set type is
TYPE_FORWARD_ONLYpublic void afterLast() throws java.sql.SQLException
Moves to the end of the result set, just after the last row. Has no effect if the result set contains no rows.
afterLast
in interface java.sql.ResultSet
java.sql.SQLException
- if a database-access error occurs, or result set type is
TYPE_FORWARD_ONLY.public boolean first() throws java.sql.SQLException
Moves to the first row in the result set.
first
in interface java.sql.ResultSet
java.sql.SQLException
- if a database-access error occurs, or result set type is
TYPE_FORWARD_ONLY.public boolean last() throws java.sql.SQLException
Moves to the last row in the result set.
last
in interface java.sql.ResultSet
java.sql.SQLException
- if a database-access error occurs, or result set type is
TYPE_FORWARD_ONLY.public int getRow() throws java.sql.SQLException
Determine the current row number. The first row is number 1, the second number 2, etc.
getRow
in interface java.sql.ResultSet
java.sql.SQLException
- if a database-access error occurs.public boolean absolute(int row) throws java.sql.SQLException
Move to an absolute row number in the result set.
If row is positive, moves to an absolute row with respect to the beginning of the result set. The first row is row 1, the second is row 2, etc.
If row is negative, moves to an absolute row position with respect to the end of result set. For example, calling absolute(-1) positions the cursor on the last row, absolute(-2) indicates the next-to-last row, etc.
An attempt to position the cursor beyond the first/last row in the result set, leaves the cursor before/after the first/last row, respectively.
Note: Calling absolute(1) is the same as calling first(). Calling absolute(-1) is the same as calling last().
absolute
in interface java.sql.ResultSet
java.sql.SQLException
- if a database-access error occurs, or row is 0, or result
set type is TYPE_FORWARD_ONLY.public boolean relative(int row) throws java.sql.SQLException
Moves a relative number of rows, either positive or negative. Attempting to move beyond the first/last row in the result set positions the cursor before/after the the first/last row. Calling relative(0) is valid, but does not change the cursor position.
Note: Calling relative(1) is different than calling next() since is makes sense to call next() when there is no current row, for example, when the cursor is positioned before the first row or after the last row of the result set.
relative
in interface java.sql.ResultSet
java.sql.SQLException
- if a database-access error occurs, or there is no current
row, or result set type is TYPE_FORWARD_ONLY.public boolean previous() throws java.sql.SQLException
Moves to the previous row in the result set.
Note: previous() is not the same as relative(-1) since it makes sense to call previous() when there is no current row.
previous
in interface java.sql.ResultSet
java.sql.SQLException
- if a database-access error occurs, or result set type is
TYPE_FORWAR_DONLY.public void setFetchDirection(int direction) throws java.sql.SQLException
setFetchDirection
in interface java.sql.ResultSet
java.sql.SQLException
- if a database-access error occurs, or the result set type
is TYPE_FORWARD_ONLY and direction is not FETCH_FORWARD.public int getFetchDirection() throws java.sql.SQLException
getFetchDirection
in interface java.sql.ResultSet
java.sql.SQLException
- if a database-access error occurspublic void setFetchSize(int rows) throws java.sql.SQLException
setFetchSize
in interface java.sql.ResultSet
rows
- the number of rows to fetchjava.sql.SQLException
- if a database-access error occurs, or the condition 0 <=
rows is not satisfied.public int getFetchSize() throws java.sql.SQLException
getFetchSize
in interface java.sql.ResultSet
java.sql.SQLException
- if a database-access error occurspublic int getType() throws java.sql.SQLException
getType
in interface java.sql.ResultSet
java.sql.SQLException
- if a database-access error occurspublic int getConcurrency() throws java.sql.SQLException
getConcurrency
in interface java.sql.ResultSet
java.sql.SQLException
- if a database-access error occurspublic boolean rowUpdated() throws java.sql.SQLException
rowUpdated
in interface java.sql.ResultSet
java.sql.SQLException
- if a database-access error occursEmbedDatabaseMetaData.updatesAreDetected(int)
public boolean rowInserted() throws java.sql.SQLException
rowInserted
in interface java.sql.ResultSet
java.sql.SQLException
- if a database-access error occursEmbedDatabaseMetaData.insertsAreDetected(int)
public boolean rowDeleted() throws java.sql.SQLException
rowDeleted
in interface java.sql.ResultSet
java.sql.SQLException
- if a database-access error occursEmbedDatabaseMetaData.deletesAreDetected(int)
protected void checksBeforeUpdateXXX(java.lang.String methodName, int columnIndex) throws java.sql.SQLException
java.sql.SQLException
protected void checksBeforeUpdateOrDelete(java.lang.String methodName, int columnIndex) throws java.sql.SQLException
java.sql.SQLException
protected DataValueDescriptor getDVDforColumnToBeUpdated(int columnIndex, java.lang.String updateMethodName) throws StandardException, java.sql.SQLException
StandardException
java.sql.SQLException
protected void checksBeforeInsert() throws java.sql.SQLException
java.sql.SQLException
private void checksBeforeUpdateAsciiStream(int columnIndex) throws java.sql.SQLException
updateAsciiStream()
.columnIndex
- the column index (first column is 1)java.sql.SQLException
- if the column could not be updated with
updateAsciiStream()
private void checksBeforeUpdateBinaryStream(int columnIndex) throws java.sql.SQLException
updateBinaryStream()
.columnIndex
- the column index (first column is 1)java.sql.SQLException
- if the column could not be updated with
updateBinaryStream()
private void checksBeforeUpdateCharacterStream(int columnIndex) throws java.sql.SQLException
updateCharacterStream()
.columnIndex
- the column index (first column is 1)java.sql.SQLException
- if the column could not be updated with
updateCharacterStream()
public void updateNull(int columnIndex) throws java.sql.SQLException
updateNull
in interface java.sql.ResultSet
columnIndex
- the first column is 1, the second is 2, ...java.sql.SQLException
- if a database-access error occurspublic void updateBoolean(int columnIndex, boolean x) throws java.sql.SQLException
updateBoolean
in interface java.sql.ResultSet
columnIndex
- the first column is 1, the second is 2, ...x
- the new column valuejava.sql.SQLException
- if a database-access error occurspublic void updateByte(int columnIndex, byte x) throws java.sql.SQLException
updateByte
in interface java.sql.ResultSet
columnIndex
- the first column is 1, the second is 2, ...x
- the new column valuejava.sql.SQLException
- if a database-access error occurspublic void updateShort(int columnIndex, short x) throws java.sql.SQLException
updateShort
in interface java.sql.ResultSet
columnIndex
- the first column is 1, the second is 2, ...x
- the new column valuejava.sql.SQLException
- if a database-access error occurspublic void updateInt(int columnIndex, int x) throws java.sql.SQLException
updateInt
in interface java.sql.ResultSet
columnIndex
- the first column is 1, the second is 2, ...x
- the new column valuejava.sql.SQLException
- if a database-access error occurspublic void updateLong(int columnIndex, long x) throws java.sql.SQLException
updateLong
in interface java.sql.ResultSet
columnIndex
- the first column is 1, the second is 2, ...x
- the new column valuejava.sql.SQLException
- if a database-access error occurspublic void updateFloat(int columnIndex, float x) throws java.sql.SQLException
updateFloat
in interface java.sql.ResultSet
columnIndex
- the first column is 1, the second is 2, ...x
- the new column valuejava.sql.SQLException
- if a database-access error occurspublic void updateDouble(int columnIndex, double x) throws java.sql.SQLException
updateDouble
in interface java.sql.ResultSet
columnIndex
- the first column is 1, the second is 2, ...x
- the new column valuejava.sql.SQLException
- if a database-access error occurspublic void updateBigDecimal(int columnIndex, java.math.BigDecimal x) throws java.sql.SQLException
updateBigDecimal
in interface java.sql.ResultSet
java.sql.SQLException
public void updateBigDecimal(java.lang.String columnName, java.math.BigDecimal x) throws java.sql.SQLException
updateBigDecimal
in interface java.sql.ResultSet
columnName
- the name of the columnx
- the new column valuejava.sql.SQLException
- if a database-access error occurspublic void updateString(int columnIndex, java.lang.String x) throws java.sql.SQLException
updateString
in interface java.sql.ResultSet
columnIndex
- the first column is 1, the second is 2, ...x
- the new column valuejava.sql.SQLException
- if a database-access error occurspublic void updateBytes(int columnIndex, byte[] x) throws java.sql.SQLException
updateBytes
in interface java.sql.ResultSet
columnIndex
- the first column is 1, the second is 2, ...x
- the new column valuejava.sql.SQLException
- if a database-access error occurspublic void updateDate(int columnIndex, java.sql.Date x) throws java.sql.SQLException
updateDate
in interface java.sql.ResultSet
columnIndex
- the first column is 1, the second is 2, ...x
- the new column valuejava.sql.SQLException
- if a database-access error occurspublic void updateTime(int columnIndex, java.sql.Time x) throws java.sql.SQLException
updateTime
in interface java.sql.ResultSet
columnIndex
- the first column is 1, the second is 2, ...x
- the new column valuejava.sql.SQLException
- if a database-access error occurspublic void updateTimestamp(int columnIndex, java.sql.Timestamp x) throws java.sql.SQLException
updateTimestamp
in interface java.sql.ResultSet
columnIndex
- the first column is 1, the second is 2, ...x
- the new column valuejava.sql.SQLException
- if a database-access error occurspublic void updateAsciiStream(int columnIndex, java.io.InputStream x, long length) throws java.sql.SQLException
updateAsciiStream
in interface java.sql.ResultSet
columnIndex
- the first column is 1, the second is 2, ...x
- the new column valuelength
- the length of the streamjava.sql.SQLException
- if a database-access error occurspublic void updateAsciiStream(int columnIndex, java.io.InputStream x) throws java.sql.SQLException
updateRow
or insertRow
methods are called to update the database.updateAsciiStream
in interface java.sql.ResultSet
columnIndex
- the first column is 1, the second is 2, ...x
- the new column valuejava.sql.SQLException
- if the columnIndex is not valid; if a database
access error occurs; the result set concurrency is
CONCUR_READ_ONLY
or this method is called on a closed
result setpublic void updateBinaryStream(int columnIndex, java.io.InputStream x, long length) throws java.sql.SQLException
updateBinaryStream
in interface java.sql.ResultSet
columnIndex
- the first column is 1, the second is 2, ...x
- the new column valuelength
- the length of the streamjava.sql.SQLException
- if a database-access error occurspublic void updateBinaryStream(int columnIndex, java.io.InputStream x) throws java.sql.SQLException
updateRow
or insertRow
methods are called to update the database.updateBinaryStream
in interface java.sql.ResultSet
columnIndex
- the first column is 1, the second is 2, ...x
- the new column valuejava.sql.SQLException
- if the columnLabel is not valid; if a database
access error occurs; the result set concurrency is
CONCUR_READ_ONLY
or this method is called on a closed
result setprivate void updateBinaryStreamInternal(int columnIndex, java.io.InputStream x, boolean lengthLess, long length, java.lang.String updateMethodName) throws java.sql.SQLException
lengthLess
is true
, the following
conditions are either not checked or verified at the execution time
of updateRow
/insertRow
:
lengthLess
variable was added to differentiate between
streams with invalid lengths and streams without known lengths.columnIndex
- the 1-based index of the parameter to set.x
- the data.lengthLess
- tells whether we know the length of the data or not.length
- the length of the data. Ignored if lengthLess
is true
.updateMethodName
- the name of the method calling us. Used in
error messages.java.sql.SQLException
- if reading the data fails, or one of the data
checks fails.public void updateCharacterStream(int columnIndex, java.io.Reader x, long length) throws java.sql.SQLException
updateCharacterStream
in interface java.sql.ResultSet
columnIndex
- the first column is 1, the second is 2, ...x
- the new column valuelength
- the length of the streamjava.sql.SQLException
- if a database-access error occurspublic void updateCharacterStream(int columnIndex, java.io.Reader x) throws java.sql.SQLException
updateRow
or insertRow
methods are called to update the database.updateCharacterStream
in interface java.sql.ResultSet
columnIndex
- the first column is 1, the second is 2, ...x
- the new column valuejava.sql.SQLException
- if the columnIndex is not valid; if a database
access error occurs; the result set concurrency is
CONCUR_READ_ONLY
or this method is called on a closed
result setprivate void updateCharacterStreamInternal(int columnIndex, java.io.Reader reader, boolean lengthLess, long length, java.lang.String updateMethodName) throws java.sql.SQLException
lengthLess
is true
, the following
conditions are either not checked or verified at the execution time
of the prepared statement:
lengthLess
variable was added to differentiate between
streams with invalid lengths and streams without known lengths.columnIndex
- the 1-based index of the parameter to set.reader
- the data.lengthLess
- tells whether we know the length of the data or not.length
- the length of the data. Ignored if lengthLess
is true
.java.sql.SQLException
- if reading the data fails, or one of the data
checks fails.public void updateObject(int columnIndex, java.lang.Object x, int scale) throws java.sql.SQLException
updateObject
in interface java.sql.ResultSet
columnIndex
- the first column is 1, the second is 2, ...x
- the new column valuescale
- For java.sql.Types.DECIMAL or java.sql.Types.NUMERIC types
this is the number of digits after the decimal. For all other
types this value will be ignored.java.sql.SQLException
- if a database-access error occursprotected void adjustScale(int columnIndex, int scale) throws java.sql.SQLException
Adjust the scale of a type.
java.sql.SQLException
public void updateObject(int columnIndex, java.lang.Object x) throws java.sql.SQLException
updateObject
in interface java.sql.ResultSet
columnIndex
- the first column is 1, the second is 2, ...x
- the new column valuejava.sql.SQLException
- if a database-access error occurspublic void updateNull(java.lang.String columnName) throws java.sql.SQLException
updateNull
in interface java.sql.ResultSet
columnName
- the name of the columnjava.sql.SQLException
- if a database-access error occurspublic void updateBoolean(java.lang.String columnName, boolean x) throws java.sql.SQLException
updateBoolean
in interface java.sql.ResultSet
columnName
- the name of the columnx
- the new column valuejava.sql.SQLException
- if a database-access error occurspublic void updateByte(java.lang.String columnName, byte x) throws java.sql.SQLException
updateByte
in interface java.sql.ResultSet
columnName
- the name of the columnx
- the new column valuejava.sql.SQLException
- if a database-access error occurspublic void updateShort(java.lang.String columnName, short x) throws java.sql.SQLException
updateShort
in interface java.sql.ResultSet
columnName
- the name of the columnx
- the new column valuejava.sql.SQLException
- if a database-access error occurspublic void updateInt(java.lang.String columnName, int x) throws java.sql.SQLException
updateInt
in interface java.sql.ResultSet
columnName
- the name of the columnx
- the new column valuejava.sql.SQLException
- if a database-access error occurspublic void updateLong(java.lang.String columnName, long x) throws java.sql.SQLException
updateLong
in interface java.sql.ResultSet
columnName
- the name of the columnx
- the new column valuejava.sql.SQLException
- if a database-access error occurspublic void updateFloat(java.lang.String columnName, float x) throws java.sql.SQLException
updateFloat
in interface java.sql.ResultSet
columnName
- the name of the columnx
- the new column valuejava.sql.SQLException
- if a database-access error occurspublic void updateDouble(java.lang.String columnName, double x) throws java.sql.SQLException
updateDouble
in interface java.sql.ResultSet
columnName
- the name of the columnx
- the new column valuejava.sql.SQLException
- if a database-access error occurspublic void updateString(java.lang.String columnName, java.lang.String x) throws java.sql.SQLException
updateString
in interface java.sql.ResultSet
columnName
- the name of the columnx
- the new column valuejava.sql.SQLException
- if a database-access error occurspublic void updateBytes(java.lang.String columnName, byte[] x) throws java.sql.SQLException
updateBytes
in interface java.sql.ResultSet
columnName
- the name of the columnx
- the new column valuejava.sql.SQLException
- if a database-access error occurspublic void updateDate(java.lang.String columnName, java.sql.Date x) throws java.sql.SQLException
updateDate
in interface java.sql.ResultSet
columnName
- the name of the columnx
- the new column valuejava.sql.SQLException
- if a database-access error occurspublic void updateTime(java.lang.String columnName, java.sql.Time x) throws java.sql.SQLException
updateTime
in interface java.sql.ResultSet
columnName
- the name of the columnx
- the new column valuejava.sql.SQLException
- if a database-access error occurspublic void updateTimestamp(java.lang.String columnName, java.sql.Timestamp x) throws java.sql.SQLException
updateTimestamp
in interface java.sql.ResultSet
columnName
- the name of the columnx
- the new column valuejava.sql.SQLException
- if a database-access error occurspublic void updateAsciiStream(java.lang.String columnName, java.io.InputStream x, int length) throws java.sql.SQLException
updateAsciiStream
in interface java.sql.ResultSet
columnName
- the name of the columnx
- the new column valuelength
- of the streamjava.sql.SQLException
- if a database-access error occurspublic void updateBinaryStream(java.lang.String columnName, java.io.InputStream x, int length) throws java.sql.SQLException
updateBinaryStream
in interface java.sql.ResultSet
columnName
- the name of the columnx
- the new column valuelength
- of the streamjava.sql.SQLException
- if a database-access error occurspublic void updateCharacterStream(java.lang.String columnName, java.io.Reader reader, int length) throws java.sql.SQLException
updateCharacterStream
in interface java.sql.ResultSet
columnName
- the name of the columnreader
- the new column valuelength
- length of the streamjava.sql.SQLException
- if a database-access error occurspublic void updateObject(java.lang.String columnName, java.lang.Object x, int scale) throws java.sql.SQLException
updateObject
in interface java.sql.ResultSet
columnName
- the name of the columnx
- the new column valuescale
- For java.sql.Types.DECIMAL or java.sql.Types.NUMERIC types
this is the number of digits after the decimal. For all other
types this value will be ignored.java.sql.SQLException
- if a database-access error occurspublic void updateObject(java.lang.String columnName, java.lang.Object x) throws java.sql.SQLException
updateObject
in interface java.sql.ResultSet
columnName
- the name of the columnx
- the new column valuejava.sql.SQLException
- if a database-access error occurspublic void insertRow() throws java.sql.SQLException
insertRow
in interface java.sql.ResultSet
java.sql.SQLException
- if a database-access error occurs, if called when not on
the insert row, or if all non-nullable columns in the
insert row have not been given a valuepublic void updateRow() throws java.sql.SQLException
updateRow
in interface java.sql.ResultSet
java.sql.SQLException
- if a database-access error occurs, or
if called when on the insert rowpublic void deleteRow() throws java.sql.SQLException
deleteRow
in interface java.sql.ResultSet
java.sql.SQLException
- if a database-access error occurs, or if
called when on the insert row.private java.lang.String getFullBaseTableName(ExecCursorTableReference targetTable)
public void refreshRow() throws java.sql.SQLException
refreshRow
in interface java.sql.ResultSet
java.sql.SQLException
- if a database-access error occurs, or if called when on
the insert row.public void cancelRowUpdates() throws java.sql.SQLException
cancelRowUpdates
in interface java.sql.ResultSet
java.sql.SQLException
- if a database-access error occurs, or if
called when on the insert row.public void moveToInsertRow() throws java.sql.SQLException
moveToInsertRow
in interface java.sql.ResultSet
java.sql.SQLException
- if a database-access error occurs, or the result set is
not updatablepublic void moveToCurrentRow() throws java.sql.SQLException
moveToCurrentRow
in interface java.sql.ResultSet
java.sql.SQLException
- if a database-access error occurs, or the result set is
not updatablepublic java.sql.Blob getBlob(int columnIndex) throws java.sql.SQLException
getBlob
in interface java.sql.ResultSet
columnIndex
- the first column is 1, the second is 2, ...java.sql.SQLException
public final java.sql.Clob getClob(int columnIndex) throws java.sql.SQLException
getClob
in interface java.sql.ResultSet
columnIndex
- the first column is 1, the second is 2, ...java.sql.SQLException
public final java.sql.Blob getBlob(java.lang.String columnName) throws java.sql.SQLException
getBlob
in interface java.sql.ResultSet
columnName
- the column namejava.sql.SQLException
public final java.sql.Clob getClob(java.lang.String columnName) throws java.sql.SQLException
getClob
in interface java.sql.ResultSet
columnName
- the column namejava.sql.SQLException
- Feature not implemented for now.public void updateBlob(int columnIndex, java.sql.Blob x) throws java.sql.SQLException
updateBlob
in interface java.sql.ResultSet
columnIndex
- -
the first column is 1, the second is 2x
- -
the new column valuejava.sql.SQLException
- Feature not implemented for now.public void updateBlob(java.lang.String columnName, java.sql.Blob x) throws java.sql.SQLException
updateBlob
in interface java.sql.ResultSet
columnName
- -
the SQL name of the columnx
- -
the new column valuejava.sql.SQLException
- Feature not implemented for now.public void updateClob(int columnIndex, java.sql.Clob x) throws java.sql.SQLException
updateClob
in interface java.sql.ResultSet
columnIndex
- -
the first column is 1, the second is 2x
- -
the new column valuejava.sql.SQLException
- Feature not implemented for now.public void updateClob(java.lang.String columnName, java.sql.Clob x) throws java.sql.SQLException
updateClob
in interface java.sql.ResultSet
columnName
- -
the SQL name of the columnx
- -
the new column valuejava.sql.SQLException
- Feature not implemented for now.protected int findColumnName(java.lang.String columnName) throws java.sql.SQLException
columnName
- the name of the columnjava.sql.SQLException
- thrown on failure.private final void closeCurrentStream()
final void checkIfClosed(java.lang.String operation) throws java.sql.SQLException
operation
- The operation the caller is trying to performjava.sql.SQLException
- Thrown if this ResultSet is closed.final void checkExecIfClosed(java.lang.String operation) throws java.sql.SQLException
java.sql.SQLException
protected java.lang.String getSQLText()
protected ParameterValueSet getParameterValueSet()
private static boolean isMaxFieldSizeType(int colType)
final java.sql.SQLException closeOnTransactionError(java.lang.Throwable thrownException) throws java.sql.SQLException
java.sql.SQLException
protected final DataValueDescriptor getColumn(int columnIndex) throws java.sql.SQLException, StandardException
java.sql.SQLException
StandardException
static final java.sql.SQLException noStateChangeException(java.lang.Throwable thrownException)
void setDynamicResultSet(EmbedStatement owningStmt)
public final int compareTo(java.lang.Object other)
compareTo
in interface java.lang.Comparable
private void checkScrollCursor(java.lang.String methodName) throws java.sql.SQLException
methodName
- name of the method which requests the checkjava.sql.SQLException
- if the result set is closed or its type
is TYPE_FORWARD_ONLY
private void checkUpdatableCursor(java.lang.String operation) throws java.sql.SQLException
java.sql.SQLException
private boolean checkRowPosition(int position, java.lang.String positionText) throws java.sql.SQLException
java.sql.SQLException
public final boolean isForUpdate()
isForUpdate
in interface EngineResultSet
final java.lang.String getColumnSQLType(int column)
private final int getMaxColumnWidth(int columnIndex)
columnIndex
- the 1-based index of the columnprivate final java.sql.SQLException dataTypeConversion(java.lang.String targetType, int column)
private final java.sql.SQLException dataTypeConversion(int column, java.lang.String targetType)
final void useStreamOrLOB(int columnIndex) throws java.sql.SQLException
columnIndex
- 1-based column indexjava.sql.SQLException
- if the column has already been accessedprivate void checkLOBMultiCall(int columnIndex) throws java.sql.SQLException
Accessing a LOB column more than once is not forbidden by the JDBC specification, but the Java API states that for maximum portability, result set columns within each row should be read in left-to-right order, and each column should be read only once. The restriction was implemented in Derby due to complexities with the positioning of store streams when the user was given multiple handles to the stream.
columnIndex
- 1-based index of the LOB columnjava.sql.SQLException
- if the column has already been accessedpublic final boolean isClosed() throws java.sql.SQLException
Checks whether this ResultSet
object has been
closed, either automatically or because close()
has been called.
isClosed
in interface java.sql.ResultSet
true
if the ResultSet
is
closed, false
otherwisejava.sql.SQLException
- if a database error occursprivate void addWarning(java.sql.SQLWarning w)
w
- The warning to add to the warning chain.public void updateAsciiStream(int columnIndex, java.io.InputStream x, int length) throws java.sql.SQLException
updateAsciiStream
in interface java.sql.ResultSet
columnIndex
- the first column is 1, the second is 2, ...x
- the new column valuelength
- the length of the streamjava.sql.SQLException
- if a database-access error occurspublic void updateBinaryStream(int columnIndex, java.io.InputStream x, int length) throws java.sql.SQLException
updateBinaryStream
in interface java.sql.ResultSet
columnIndex
- the first column is 1, the second is 2, ...x
- the new column valuelength
- the length of the streamjava.sql.SQLException
- if a database-access error occurspublic void updateCharacterStream(int columnIndex, java.io.Reader x, int length) throws java.sql.SQLException
updateCharacterStream
in interface java.sql.ResultSet
columnIndex
- the first column is 1, the second is 2, ...x
- the new column valuelength
- the length of the streamjava.sql.SQLException
- if a database-access error occurspublic void updateAsciiStream(java.lang.String columnName, java.io.InputStream x, long length) throws java.sql.SQLException
updateAsciiStream
in interface java.sql.ResultSet
columnName
- the name of the columnx
- the new column valuelength
- of the streamjava.sql.SQLException
- if a database-access error occurspublic void updateAsciiStream(java.lang.String columnName, java.io.InputStream x) throws java.sql.SQLException
updateRow
or insertRow
methods are called to update the database.updateAsciiStream
in interface java.sql.ResultSet
columnName
- the label for the column specified with the SQL AS
clause. If the SQL AS clause was not specified, then the label is
the name of the columnx
- the new column valuejava.sql.SQLException
- if the columnIndex is not valid; if a database
access error occurs; the result set concurrency is
CONCUR_READ_ONLY
or this method is called on a closed
result setpublic void updateBinaryStream(java.lang.String columnName, java.io.InputStream x, long length) throws java.sql.SQLException
updateBinaryStream
in interface java.sql.ResultSet
columnName
- the name of the columnx
- the new column valuelength
- of the streamjava.sql.SQLException
- if a database-access error occurspublic void updateBinaryStream(java.lang.String columnName, java.io.InputStream x) throws java.sql.SQLException
updateRow
or insertRow
methods are called to update the database.updateBinaryStream
in interface java.sql.ResultSet
columnName
- the label for the column specified with the SQL AS
clause. If the SQL AS clause was not specified, then the label is
the name of the columnx
- the new column valuejava.sql.SQLException
- if the columnLabel is not valid; if a database
access error occurs; the result set concurrency is
CONCUR_READ_ONLY
or this method is called on a closed
result setpublic void updateCharacterStream(java.lang.String columnName, java.io.Reader reader, long length) throws java.sql.SQLException
updateCharacterStream
in interface java.sql.ResultSet
columnName
- the name of the columnreader
- the new column valuelength
- length of the streamjava.sql.SQLException
- if a database-access error occurspublic void updateCharacterStream(java.lang.String columnName, java.io.Reader reader) throws java.sql.SQLException
updateRow
or insertRow
methods are called to update the database.updateCharacterStream
in interface java.sql.ResultSet
columnName
- the label for the column specified with the SQL AS
clause. If the SQL AS clause was not specified, then the label is
the name of the columnreader
- the new column valuejava.sql.SQLException
- if the columnIndex is not valid; if a database
access error occurs; the result set concurrency is
CONCUR_READ_ONLY
or this method is called on a closed
result setpublic void updateBlob(int columnIndex, java.io.InputStream x, long length) throws java.sql.SQLException
updateBlob
in interface java.sql.ResultSet
columnIndex
- -
the first column is 1, the second is 2x
- -
the new column valuelength
- -
the length of the Blob datatypejava.sql.SQLException
public void updateBlob(int columnIndex, java.io.InputStream x) throws java.sql.SQLException
updateBlob
in interface java.sql.ResultSet
columnIndex
- the first column is 1, the second is 2, ...x
- an object that contains the data to set the
parameter value to.java.sql.SQLException
- if the columnIndex is not valid; if a database
access error occurs; the result set concurrency is
CONCUR_READ_ONLY
or this method is called on a closed
result setpublic void updateBlob(java.lang.String columnName, java.io.InputStream x, long length) throws java.sql.SQLException
updateBlob
in interface java.sql.ResultSet
columnName
- -
the name of the column to be updatedx
- -
the new column valuelength
- -
the length of the Blob datatypejava.sql.SQLException
public void updateBlob(java.lang.String columnName, java.io.InputStream x) throws java.sql.SQLException
updateBlob
in interface java.sql.ResultSet
columnName
- the label for the column specified with the SQL AS
clause. If the SQL AS clause was not specified, then the label is
the name of the columnx
- an object that contains the data to set the
parameter value to.java.sql.SQLException
- if the columnIndex is not valid; if a database
access error occurs; the result set concurrency is
CONCUR_READ_ONLY
or this method is called on a closed
result setpublic void updateClob(int columnIndex, java.io.Reader x, long length) throws java.sql.SQLException
updateClob
in interface java.sql.ResultSet
columnIndex
- -
the first column is 1, the second is 2x
- -
the new column valuejava.sql.SQLException
- Feature not implemented for now.public void updateClob(int columnIndex, java.io.Reader x) throws java.sql.SQLException
Reader
object.
The data will be read from the stream as needed until end-of-stream is
reached. The JDBC driver will do any necessary conversion from
UNICODE
to the database char format.
The updater methods are used to update column values in the current row
or the insert row. The updater methods do not update the underlying
database; instead the updateRow
or insertRow
methods are called to update the database.updateClob
in interface java.sql.ResultSet
columnIndex
- the first column is 1, the second is 2, ...x
- an object that contains the data to set the parameter
value tojava.sql.SQLException
- if the columnIndex is not valid; if a database
access error occurs; the result set concurrency is
CONCUR_READ_ONLY
or this method is called on a closed
result setpublic void updateClob(java.lang.String columnName, java.io.Reader x, long length) throws java.sql.SQLException
updateClob
in interface java.sql.ResultSet
columnName
- -
the name of the Clob columnx
- -
the new column valuejava.sql.SQLException
- Feature not implemented for now.public void updateClob(java.lang.String columnName, java.io.Reader x) throws java.sql.SQLException
Reader
object.
The data will be read from the stream as needed until end-of-stream is
reached. The JDBC driver will do any necessary conversion from
UNICODE
to the database char format.
The updater methods are used to update column values in the current row
or the insert row. The updater methods do not update the underlying
database; instead the updateRow
or insertRow
methods are called to update the database.updateClob
in interface java.sql.ResultSet
columnName
- the label for the column specified with the SQL AS
clause. If the SQL AS clause was not specified, then the label is
the name of the columnx
- an object that contains the data to set the parameter
value tojava.sql.SQLException
- if the columnIndex is not valid; if a database
access error occurs; the result set concurrency is
CONCUR_READ_ONLY
or this method is called on a closed
result setpublic void updateRef(int columnIndex, java.sql.Ref x) throws java.sql.SQLException
updateRef
in interface java.sql.ResultSet
columnIndex
- - the first column is 1, the second is 2x
- - the new column valuejava.sql.SQLException
- Feature not implemented for now.public void updateRef(java.lang.String columnName, java.sql.Ref x) throws java.sql.SQLException
updateRef
in interface java.sql.ResultSet
columnName
- - the SQL name of the columnx
- - the new column valuejava.sql.SQLException
- Feature not implemented for now.public void updateArray(int columnIndex, java.sql.Array x) throws java.sql.SQLException
updateArray
in interface java.sql.ResultSet
columnIndex
- - the first column is 1, the second is 2x
- - the new column valuejava.sql.SQLException
- Feature not implemented for now.public void updateArray(java.lang.String columnName, java.sql.Array x) throws java.sql.SQLException
updateArray
in interface java.sql.ResultSet
columnName
- - the SQL name of the columnx
- - the new column valuejava.sql.SQLException
- Feature not implemented for now.public java.sql.RowId getRowId(int columnIndex) throws java.sql.SQLException
getRowId
in interface java.sql.ResultSet
java.sql.SQLException
public java.sql.RowId getRowId(java.lang.String columnName) throws java.sql.SQLException
getRowId
in interface java.sql.ResultSet
java.sql.SQLException
public void updateNCharacterStream(int columnIndex, java.io.Reader x) throws java.sql.SQLException
updateNCharacterStream
in interface java.sql.ResultSet
java.sql.SQLException
public void updateNCharacterStream(int columnIndex, java.io.Reader x, long length) throws java.sql.SQLException
updateNCharacterStream
in interface java.sql.ResultSet
java.sql.SQLException
public void updateNCharacterStream(java.lang.String columnName, java.io.Reader x) throws java.sql.SQLException
updateNCharacterStream
in interface java.sql.ResultSet
java.sql.SQLException
public void updateNCharacterStream(java.lang.String columnName, java.io.Reader x, long length) throws java.sql.SQLException
updateNCharacterStream
in interface java.sql.ResultSet
java.sql.SQLException
public void updateNString(int columnIndex, java.lang.String nString) throws java.sql.SQLException
updateNString
in interface java.sql.ResultSet
java.sql.SQLException
public void updateNString(java.lang.String columnName, java.lang.String nString) throws java.sql.SQLException
updateNString
in interface java.sql.ResultSet
java.sql.SQLException
public void updateNClob(int columnIndex, java.sql.NClob nClob) throws java.sql.SQLException
updateNClob
in interface java.sql.ResultSet
java.sql.SQLException
public void updateNClob(int columnIndex, java.io.Reader reader) throws java.sql.SQLException
updateNClob
in interface java.sql.ResultSet
java.sql.SQLException
public void updateNClob(java.lang.String columnName, java.sql.NClob nClob) throws java.sql.SQLException
updateNClob
in interface java.sql.ResultSet
java.sql.SQLException
public void updateNClob(java.lang.String columnName, java.io.Reader reader) throws java.sql.SQLException
updateNClob
in interface java.sql.ResultSet
java.sql.SQLException
public java.io.Reader getNCharacterStream(int columnIndex) throws java.sql.SQLException
getNCharacterStream
in interface java.sql.ResultSet
java.sql.SQLException
public java.io.Reader getNCharacterStream(java.lang.String columnName) throws java.sql.SQLException
getNCharacterStream
in interface java.sql.ResultSet
java.sql.SQLException
public java.sql.NClob getNClob(int i) throws java.sql.SQLException
getNClob
in interface java.sql.ResultSet
java.sql.SQLException
public java.sql.NClob getNClob(java.lang.String colName) throws java.sql.SQLException
getNClob
in interface java.sql.ResultSet
java.sql.SQLException
public java.lang.String getNString(int columnIndex) throws java.sql.SQLException
getNString
in interface java.sql.ResultSet
java.sql.SQLException
public java.lang.String getNString(java.lang.String columnName) throws java.sql.SQLException
getNString
in interface java.sql.ResultSet
java.sql.SQLException
public void updateRowId(int columnIndex, java.sql.RowId x) throws java.sql.SQLException
updateRowId
in interface java.sql.ResultSet
java.sql.SQLException
public void updateRowId(java.lang.String columnName, java.sql.RowId x) throws java.sql.SQLException
updateRowId
in interface java.sql.ResultSet
java.sql.SQLException
public java.sql.SQLXML getSQLXML(int columnIndex) throws java.sql.SQLException
getSQLXML
in interface java.sql.ResultSet
java.sql.SQLException
public java.sql.SQLXML getSQLXML(java.lang.String colName) throws java.sql.SQLException
getSQLXML
in interface java.sql.ResultSet
java.sql.SQLException
public void updateSQLXML(int columnIndex, java.sql.SQLXML xmlObject) throws java.sql.SQLException
updateSQLXML
in interface java.sql.ResultSet
java.sql.SQLException
public void updateSQLXML(java.lang.String columnName, java.sql.SQLXML xmlObject) throws java.sql.SQLException
updateSQLXML
in interface java.sql.ResultSet
java.sql.SQLException
public boolean isWrapperFor(java.lang.Class<?> interfaces) throws java.sql.SQLException
interfaces
is implementedisWrapperFor
in interface java.sql.Wrapper
interfaces
- a Class defining an interface.java.sql.SQLException
- if an error occurs while determining
whether this is a wrapper for an object with the given interface.public <T> T unwrap(java.lang.Class<T> interfaces) throws java.sql.SQLException
this
if this class implements the interfaceunwrap
in interface java.sql.Wrapper
interfaces
- a Class defining an interfacejava.sql.SQLException
- if no object if found that implements the
interfacepublic void updateNClob(int columnIndex, java.io.Reader x, long length) throws java.sql.SQLException
updateNClob
in interface java.sql.ResultSet
columnIndex
- - the first column is 1, the second is 2x
- - the new column valuelength
- - the length of the streamjava.sql.SQLException
- Feature not implemented for now.public void updateNClob(java.lang.String columnName, java.io.Reader x, long length) throws java.sql.SQLException
updateNClob
in interface java.sql.ResultSet
columnName
- - the Name of the column to be updatedx
- - the new column valuelength
- - the length of the streamjava.sql.SQLException
- Feature not implemented for now.public <T> T getObject(int columnIndex, java.lang.Class<T> type) throws java.sql.SQLException
getObject
in interface java.sql.ResultSet
java.sql.SQLException
private java.sql.SQLException mismatchException(java.lang.String targetTypeName, int columnIndex) throws java.sql.SQLException
java.sql.SQLException
public <T> T getObject(java.lang.String columnName, java.lang.Class<T> type) throws java.sql.SQLException
getObject
in interface java.sql.ResultSet
java.sql.SQLException
public boolean isNull(int columnIndex) throws java.sql.SQLException
EngineResultSet
isNull
in interface EngineResultSet
java.sql.SQLException
public int getLength(int columnIndex) throws java.sql.SQLException
EngineResultSet
getLength
in interface EngineResultSet
columnIndex
- column to accessjava.sql.SQLException
DataValueDescriptor.getLength()
Apache Derby V10.14 Internals - Copyright © 2004,2018 The Apache Software Foundation. All Rights Reserved.