ResultSet

Overview

Package

Class

Use

Tree

Deprecated

Index

Help

Build 1.1_r1 (from source)

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

java.sql
Interface ResultSet

All Known Subinterfaces:: RowSet

public interface ResultSet

An interface for an object which represents a database table entry, returned as the result of the query to the database.

ResultSets have a cursor which points to the current data table row. When the ResultSet is created, the cursor's location is one position ahead of the first row. To move the cursor to the first and consecutive rows, use the next method. The next method returns true as long as there are more rows in the ResultSet, otherwise it returns false.

The default type of ResultSet can not be updated and its cursor can only advance forward through the rows of data. This means that it is only possible to read through it once. However, other kinds of ResultSet are implemented: an updatable type and also types where the cursor can be scrolled forward and backward through the rows of data. How such a ResultSet is created is demonstrated in the following example:

Connection con;

Statement aStatement = con.createStatement(
 ResultSet.TYPE_SCROLL_SENSITIVE,

ResultSet.CONCUR_UPDATABLE );

ResultSet theResultSet =
 theStatement.executeQuery("SELECT price, quantity FROM STOCKTABLE");

// theResultSet is both scrollable and updatable

The ResultSet interface provides a series of methods for retrieving data from columns in the current row, such as getDate and getFloat. The columns are retrieved either by their index number (starting at 1) or by their name - there are separate methods for both techniques of column addressing. The column names are case insensitive. If several columns have the same name, then the getter methods use the first matching column. This means that if column names are used, it is not possible to guarantee that the name will retrieve data from the intended column - for certainty it is better to use column indexes. Ideally the columns should be read left-to-right and read once only, since not all databases are optimized to handle other techniques of reading the data.

When reading data via the appropriate getter methods, the JDBC driver maps the SQL data retrieved from the database to the Java type implied by the method invoked by the application. The JDBC specification has a table for the mappings from SQL types to Java types.

There are also methods for writing data into the ResultSet, such as updateInt and updateString. The update methods can be used either to modify the data of an existing row or to insert new data rows into the ResultSet . Modification of existing data involves moving the cursor to the row which needs modification and then using the update methods to modify the data, followed by calling the ResultSet.updateRow method. For insertion of new rows, the cursor is first moved to a special row called the Insert Row, data is added using the update methods, followed by calling the ResultSet.insertRow method.

A ResultSet is closed if the statement which generated it closes, the statement is executed again, or the same statement's next ResultSet is retrieved (if the statement returned of multiple results).

Since:: Android 1.0

Field Summary
`static int`	`CLOSE_CURSORS_AT_COMMIT` A constant used to indicate that a `ResultSet` object must be closed when the method `Connection.commit` is invoked.
`static int`	`CONCUR_READ_ONLY` A constant used to indicate the concurrency mode for a `ResultSet` object that cannot be updated.
`static int`	`CONCUR_UPDATABLE` A constant used to indicate the concurrency mode for a `ResultSet` object that can be updated.
`static int`	`FETCH_FORWARD` A constant used to indicate processing of the rows of a `ResultSet` in the forward direction, first to last.
`static int`	`FETCH_REVERSE` A constant used to indicate processing of the rows of a `ResultSet` in the reverse direction, last to first.
`static int`	`FETCH_UNKNOWN` A constant used to indicate that the order of processing of the rows of a `ResultSet` is unknown.
`static int`	`HOLD_CURSORS_OVER_COMMIT` A constant used to indicate that a `ResultSet` object must not be closed when the method `Connection.commit` is invoked.
`static int`	`TYPE_FORWARD_ONLY` A constant used to indicate a `ResultSet` object whose cursor can only move forward.
`static int`	`TYPE_SCROLL_INSENSITIVE` A constant used to indicate a `ResultSet` object which is scrollable but is insensitive to changes made by others.
`static int`	`TYPE_SCROLL_SENSITIVE` A constant used to indicate a `ResultSet` object which is scrollable and sensitive to changes made by others.

Method Summary
`boolean`	`absolute(int row)` Moves the cursor to a specified row number in the `ResultSet`.
`void`	`afterLast()` Moves the cursor to the end of the `ResultSet`, after the last row.
`void`	`beforeFirst()` Moves the cursor to the start of the `ResultSet`, before the first row.
`void`	`cancelRowUpdates()` Cancels any updates made to the current row in the `ResultSet`.
`void`	`clearWarnings()` Clears all warnings related to this `ResultSet`.
`void`	`close()` Releases this `ResultSet`'s database and JDBC resources.
`void`	`deleteRow()` Deletes the current row from the `ResultSet` and from the underlying database.
`int`	`findColumn(String columnName)` Gets the index number for a column in the `ResultSet` from the provided column name.
`boolean`	`first()` Shifts the cursor position to the first row in the `ResultSet`.
`Array`	`getArray(int columnIndex)` Gets the content of a column specified by column index in the current row of this `ResultSet` as a `java.sql.Array`.
`Array`	`getArray(String colName)` Gets the value of a column specified by column name as a `java.sql.Array`.
`InputStream`	`getAsciiStream(int columnIndex)` Gets the value of a column specified by column index as an ASCII character stream.
`InputStream`	`getAsciiStream(String columnName)` Gets the value of a column specified by column name as an ASCII character stream.
`BigDecimal`	`getBigDecimal(int columnIndex)` Gets the value of a column specified by column index as a `java.math.BigDecimal`.
`BigDecimal`	`getBigDecimal(int columnIndex, int scale)` Deprecated. use `getBigDecimal(int)` or `getBigDecimal(String)`
`BigDecimal`	`getBigDecimal(String columnName)` Gets the value of a column specified by column name, as a `java.math.BigDecimal`.
`BigDecimal`	`getBigDecimal(String columnName, int scale)` Deprecated. use `getBigDecimal(int)` or `getBigDecimal(String)`
`InputStream`	`getBinaryStream(int columnIndex)` Gets the value of a column specified by column index as a binary stream.
`InputStream`	`getBinaryStream(String columnName)` Gets the value of a column specified by column name as a binary stream.
`Blob`	`getBlob(int columnIndex)` Gets the value of a column specified by column index as a `java.sql.Blob` object.
`Blob`	`getBlob(String columnName)` Gets the value of a column specified by column name, as a `java.sql.Blob` object.
`boolean`	`getBoolean(int columnIndex)` Gets the value of a column specified by column index as a `boolean` .
`boolean`	`getBoolean(String columnName)` Gets the value of a column specified by column name, as a `boolean` .
`byte`	`getByte(int columnIndex)` Gets the value of a column specified by column index as a `byte`.
`byte`	`getByte(String columnName)` Gets the value of a column specified by column name as a `byte`.
`byte[]`	`getBytes(int columnIndex)` Gets the value of a column specified by column index as a byte array.
`byte[]`	`getBytes(String columnName)` Gets the value of a column specified by column name as a byte array.
`Reader`	`getCharacterStream(int columnIndex)` Gets the value of a column specified by column index as a `java.io.Reader` object.
`Reader`	`getCharacterStream(String columnName)` Gets the value of a column specified by column name as a `java.io.Reader` object.
`Clob`	`getClob(int columnIndex)` Gets the value of a column specified by column index as a `java.sql.Clob`.
`Clob`	`getClob(String colName)` Gets the value of a column specified by column name as a `java.sql.Clob`.
`int`	`getConcurrency()` Gets the concurrency mode of this `ResultSet`.
`String`	`getCursorName()` Gets the name of the SQL cursor of this `ResultSet`.
`Date`	`getDate(int columnIndex)` Gets the value of a column specified by column index as a `java.sql.Date`.
`Date`	`getDate(int columnIndex, Calendar cal)` Gets the value of a column specified by column index as a `java.sql.Date`.
`Date`	`getDate(String columnName)` Gets the value of a column specified by column name as a `java.sql.Date`.
`Date`	`getDate(String columnName, Calendar cal)` Gets the value of a column specified by column name, as a `java.sql.Date` object.
`double`	`getDouble(int columnIndex)` Gets the value of a column specified by column index as a `double` value.
`double`	`getDouble(String columnName)` Gets the value of a column specified by column name as a `double` value.
`int`	`getFetchDirection()` Gets the direction in which rows are fetched for this `ResultSet` object.
`int`	`getFetchSize()` Gets the fetch size (in number of rows) for this `ResultSet`.
`float`	`getFloat(int columnIndex)` Gets the value of a column specified by column index as a `float` value.
`float`	`getFloat(String columnName)` Gets the value of a column specified by column name as a `float` value.
`int`	`getInt(int columnIndex)` Gets the value of a column specified by column index as an `int` value.
`int`	`getInt(String columnName)` Gets the value of a column specified by column name, as an `int` value.
`long`	`getLong(int columnIndex)` Gets the value of a column specified by column index as a `long` value.
`long`	`getLong(String columnName)` Gets the value of a column specified by column name, as a `long` value.
`ResultSetMetaData`	`getMetaData()` Gets the metadata for this `ResultSet`.
`Object`	`getObject(int columnIndex)` Gets the value of a specified column as a Java `Object`.
`Object`	`getObject(int columnIndex, Map<String,Class<?>> map)` Gets the value of a column specified by column index as a Java `Object`.
`Object`	`getObject(String columnName)` Gets the value of a specified column as a Java `Object`.
`Object`	`getObject(String columnName, Map<String,Class<?>> map)` Gets the value of a column specified by column name as a Java `Object`.
`Ref`	`getRef(int columnIndex)` Gets the value of a column specified by column index as a Java `java.sql.Ref`.
`Ref`	`getRef(String colName)` Gets the value of a column specified by column name as a Java `java.sql.Ref`.
`int`	`getRow()` Gets the number of the current row in the `ResultSet`.
`short`	`getShort(int columnIndex)` Gets the value of a column specified by column index as a short value.
`short`	`getShort(String columnName)` Gets the value of a column specified by column name, as a short value.
`Statement`	`getStatement()` Gets the statement that produced this `ResultSet`.
`String`	`getString(int columnIndex)` Gets the value of a column specified by column index as a String.
`String`	`getString(String columnName)` Gets the value of a column specified by column name, as a String.
`Time`	`getTime(int columnIndex)` Gets the value of a column specified by column index as a `java.sql.Time` value.
`Time`	`getTime(int columnIndex, Calendar cal)` Gets the value of a column specified by column index as a `java.sql.Time` value.
`Time`	`getTime(String columnName)` Gets the value of a column specified by column name, as a `java.sql.Time` value.
`Time`	`getTime(String columnName, Calendar cal)` Gets the value of a column specified by column index, as a `java.sql.Time` value.
`Timestamp`	`getTimestamp(int columnIndex)` Gets the value of a column specified by column index as a `java.sql.Timestamp` value.
`Timestamp`	`getTimestamp(int columnIndex, Calendar cal)` Gets the value of a column specified by column index, as a `java.sql.Timestamp` value.
`Timestamp`	`getTimestamp(String columnName)` Gets the value of a column specified by column name, as a `java.sql.Timestamp` value.
`Timestamp`	`getTimestamp(String columnName, Calendar cal)` Gets the value of a column specified by column name, as a `java.sql.Timestamp` value.
`int`	`getType()` Gets the type of the `ResultSet`.
`InputStream`	`getUnicodeStream(int columnIndex)` Deprecated. Use `getCharacterStream(int)`.
`InputStream`	`getUnicodeStream(String columnName)` Deprecated. Use `getCharacterStream(int)`
`URL`	`getURL(int columnIndex)` Gets the value of a column specified by column index as a `java.net.URL`.
`URL`	`getURL(String columnName)` Gets the value of a column specified by column name as a `java.net.URL` object.
`SQLWarning`	`getWarnings()` Gets the first warning generated by calls on this `ResultSet`.
`void`	`insertRow()` Insert the insert row into the `ResultSet` and into the underlying database.
`boolean`	`isAfterLast()` Gets if the cursor is after the last row of the `ResultSet`.
`boolean`	`isBeforeFirst()` Gets if the cursor is before the first row of the `ResultSet`.
`boolean`	`isFirst()` Gets if the cursor is on the first row of the `ResultSet`.
`boolean`	`isLast()` Gets if the cursor is on the last row of the `ResultSet`
`boolean`	`last()` Shifts the cursor position to the last row of the `ResultSet`.
`void`	`moveToCurrentRow()` Moves the cursor to the remembered position, namely the row that was the current row before a call to `moveToInsertRow`.
`void`	`moveToInsertRow()` Moves the cursor position to the Insert Row.
`boolean`	`next()` Shifts the cursor position down one row in this `ResultSet` object.
`boolean`	`previous()` Relocates the cursor position to the preceding row in this `ResultSet`.
`void`	`refreshRow()` Refreshes the current row with its most up to date value in the database.
`boolean`	`relative(int rows)` Moves the cursor position up or down by a specified number of rows.
`boolean`	`rowDeleted()` Indicates whether a row has been deleted.
`boolean`	`rowInserted()` Indicates whether the current row has had an insertion operation.
`boolean`	`rowUpdated()` Indicates whether the current row has been updated.
`void`	`setFetchDirection(int direction)` Indicates which direction (forward/reverse) will be used to process the rows of this `ResultSet` object.
`void`	`setFetchSize(int rows)` Indicates the number of rows to fetch from the database when extra rows are required for this `ResultSet`.
`void`	`updateArray(int columnIndex, Array x)` Updates a column specified by a column index with a `java.sql.Array` value.
`void`	`updateArray(String columnName, Array x)` Updates a column specified by a column name with a `java.sql.Array` value.
`void`	`updateAsciiStream(int columnIndex, InputStream x, int length)` Updates a column specified by a column index with an ASCII stream value.
`void`	`updateAsciiStream(String columnName, InputStream x, int length)` Updates a column specified by a column name with an Ascii stream value.
`void`	`updateBigDecimal(int columnIndex, BigDecimal x)` Updates a column specified by a column index with a `java.sql.BigDecimal` value.
`void`	`updateBigDecimal(String columnName, BigDecimal x)` Updates a column specified by a column name with a `java.sql.BigDecimal` value.
`void`	`updateBinaryStream(int columnIndex, InputStream x, int length)` Updates a column specified by a column index with a binary stream value.
`void`	`updateBinaryStream(String columnName, InputStream x, int length)` Updates a column specified by a column name with a binary stream value.
`void`	`updateBlob(int columnIndex, Blob x)` Updates a column specified by a column index with a `java.sql.Blob` value.
`void`	`updateBlob(String columnName, Blob x)` Updates a column specified by a column name with a `java.sql.Blob` value.
`void`	`updateBoolean(int columnIndex, boolean x)` Updates a column specified by a column index with a `boolean` value.
`void`	`updateBoolean(String columnName, boolean x)` Updates a column specified by a column name with a `boolean` value.
`void`	`updateByte(int columnIndex, byte x)` Updates a column specified by a column index with a `byte` value.
`void`	`updateByte(String columnName, byte x)` Updates a column specified by a column name with a `byte` value.
`void`	`updateBytes(int columnIndex, byte[] x)` Updates a column specified by a column index with a `byte` array value.
`void`	`updateBytes(String columnName, byte[] x)` Updates a column specified by a column name with a byte array value.
`void`	`updateCharacterStream(int columnIndex, Reader x, int length)` Updates a column specified by a column index with a character stream value.
`void`	`updateCharacterStream(String columnName, Reader reader, int length)` Updates a column specified by a column name with a character stream value.
`void`	`updateClob(int columnIndex, Clob x)` Updates a column specified by a column index with a `java.sql.Clob` value.
`void`	`updateClob(String columnName, Clob x)` Updates a column specified by a column name with a `java.sql.Clob` value.
`void`	`updateDate(int columnIndex, Date x)` Updates a column specified by a column index with a `java.sql.Date` value.
`void`	`updateDate(String columnName, Date x)` Updates a column specified by a column name with a `java.sql.Date` value.
`void`	`updateDouble(int columnIndex, double x)` Updates a column specified by a column index with a `double` value.
`void`	`updateDouble(String columnName, double x)` Updates a column specified by a column name with a `double` value.
`void`	`updateFloat(int columnIndex, float x)` Updates a column specified by a column index with a `float` value.
`void`	`updateFloat(String columnName, float x)` Updates a column specified by a column name with a `float` value.
`void`	`updateInt(int columnIndex, int x)` Updates a column specified by a column index with an `int` value.
`void`	`updateInt(String columnName, int x)` Updates a column specified by a column name with an `int` value.
`void`	`updateLong(int columnIndex, long x)` Updates a column specified by a column index with a `long` value.
`void`	`updateLong(String columnName, long x)` Updates a column specified by a column name with a `long` value.
`void`	`updateNull(int columnIndex)` Updates a column specified by a column index with a `null` value.
`void`	`updateNull(String columnName)` Updates a column specified by a column name with a `null` value.
`void`	`updateObject(int columnIndex, Object x)` Updates a column specified by a column index with an `Object` value.
`void`	`updateObject(int columnIndex, Object x, int scale)` Updates a column specified by a column index with an `Object` value.
`void`	`updateObject(String columnName, Object x)` Updates a column specified by a column name with an `Object` value.
`void`	`updateObject(String columnName, Object x, int scale)` Updates a column specified by a column name with an `Object` value.
`void`	`updateRef(int columnIndex, Ref x)` Updates a column specified by a column index with a `java.sql.Ref` value.
`void`	`updateRef(String columnName, Ref x)` Updates a column specified by a column name with a `java.sql.Ref` value.
`void`	`updateRow()` Updates the database with the new contents of the current row of this `ResultSet` object.
`void`	`updateShort(int columnIndex, short x)` Updates a column specified by a column index with a `short` value.
`void`	`updateShort(String columnName, short x)` Updates a column specified by a column name with a `short` value.
`void`	`updateString(int columnIndex, String x)` Updates a column specified by a column index with a `String` value.
`void`	`updateString(String columnName, String x)` Updates a column specified by a column name with a `String` value.
`void`	`updateTime(int columnIndex, Time x)` Updates a column specified by a column index with a `Time` value.
`void`	`updateTime(String columnName, Time x)` Updates a column specified by a column name with a `Time` value.
`void`	`updateTimestamp(int columnIndex, Timestamp x)` Updates a column specified by a column index with a `Timestamp` value.
`void`	`updateTimestamp(String columnName, Timestamp x)` Updates a column specified by column name with a `Timestamp` value.
`boolean`	`wasNull()` Determines whether the last column read from this `ResultSet` contained SQL `NULL`.

Field Detail

CLOSE_CURSORS_AT_COMMIT

static final int CLOSE_CURSORS_AT_COMMIT

A constant used to indicate that a ResultSet object must be closed when the method Connection.commit is invoked.

Since:: Android 1.0
See Also:: Constant Field Values

HOLD_CURSORS_OVER_COMMIT

static final int HOLD_CURSORS_OVER_COMMIT

A constant used to indicate that a ResultSet object must not be closed when the method Connection.commit is invoked.

Since:: Android 1.0
See Also:: Constant Field Values

CONCUR_READ_ONLY

static final int CONCUR_READ_ONLY

A constant used to indicate the concurrency mode for a ResultSet object that cannot be updated.

Since:: Android 1.0
See Also:: Constant Field Values

CONCUR_UPDATABLE

static final int CONCUR_UPDATABLE

A constant used to indicate the concurrency mode for a ResultSet object that can be updated.

Since:: Android 1.0
See Also:: Constant Field Values

FETCH_FORWARD

static final int FETCH_FORWARD

A constant used to indicate processing of the rows of a ResultSet in the forward direction, first to last.

Since:: Android 1.0
See Also:: Constant Field Values

FETCH_REVERSE

static final int FETCH_REVERSE

A constant used to indicate processing of the rows of a ResultSet in the reverse direction, last to first.

Since:: Android 1.0
See Also:: Constant Field Values

FETCH_UNKNOWN

static final int FETCH_UNKNOWN

A constant used to indicate that the order of processing of the rows of a ResultSet is unknown.

Since:: Android 1.0
See Also:: Constant Field Values

TYPE_FORWARD_ONLY

static final int TYPE_FORWARD_ONLY

A constant used to indicate a ResultSet object whose cursor can only move forward.

Since:: Android 1.0
See Also:: Constant Field Values

TYPE_SCROLL_INSENSITIVE

static final int TYPE_SCROLL_INSENSITIVE

A constant used to indicate a ResultSet object which is scrollable but is insensitive to changes made by others.

Since:: Android 1.0
See Also:: Constant Field Values

TYPE_SCROLL_SENSITIVE

static final int TYPE_SCROLL_SENSITIVE

A constant used to indicate a ResultSet object which is scrollable and sensitive to changes made by others.

Since:: Android 1.0
See Also:: Constant Field Values

Method Detail

absolute

boolean absolute(int row)
                 throws SQLException

Moves the cursor to a specified row number in the ResultSet.

Parameters:: row - the index of the row starting at index 1. Index -1 returns the last row.
Returns:: true if the new cursor position is on the ResultSet, false otherwise.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

afterLast

void afterLast()
               throws SQLException

Moves the cursor to the end of the ResultSet, after the last row.

Throws:: SQLException - if a database error happens.
Since:: Android 1.0

beforeFirst

void beforeFirst()
                 throws SQLException

Moves the cursor to the start of the ResultSet, before the first row.

Throws:: SQLException - if a database error happens.
Since:: Android 1.0

cancelRowUpdates

void cancelRowUpdates()
                      throws SQLException

Cancels any updates made to the current row in the ResultSet.

Throws:: SQLException - if a database error happens.
Since:: Android 1.0

clearWarnings

void clearWarnings()
                   throws SQLException

Clears all warnings related to this ResultSet.

Throws:: SQLException - if a database error happens.
Since:: Android 1.0

close

void close()
           throws SQLException

Releases this ResultSet's database and JDBC resources. You are strongly advised to use this method rather than relying on the release being done when the ResultSet's finalize method is called during garbage collection process. Note that the close() method might take some time to complete since it is dependent on the behavior of the connection to the database and the database itself.

Throws:: SQLException - if a database error happens.
Since:: Android 1.0

deleteRow

void deleteRow()
               throws SQLException

Deletes the current row from the ResultSet and from the underlying database.

Throws:: SQLException - if a database error happens.
Since:: Android 1.0

findColumn

int findColumn(String columnName)
               throws SQLException

Gets the index number for a column in the ResultSet from the provided column name.

Parameters:: columnName - the column name.
Returns:: the column's index in the ResultSet identified by column name.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

first

boolean first()
              throws SQLException

Shifts the cursor position to the first row in the ResultSet.

Returns:: true if the position is in a legitimate row, false if the ResultSet contains no rows.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

getArray

Array getArray(int columnIndex)
               throws SQLException

Gets the content of a column specified by column index in the current row of this ResultSet as a java.sql.Array.

Parameters:: columnIndex - the index of the column to read
Returns:: a java.sql.Array with the data from the column.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

getArray

Array getArray(String colName)
               throws SQLException

Gets the value of a column specified by column name as a java.sql.Array.

Parameters:: colName - the name of the column to read.
Returns:: a java.sql.Array with the data from the specified column.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

getAsciiStream

InputStream getAsciiStream(int columnIndex)
                           throws SQLException

Gets the value of a column specified by column index as an ASCII character stream.

Parameters:: columnIndex - the index of the column to read.
Returns:: an InputStream with the data from the column.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

getAsciiStream

InputStream getAsciiStream(String columnName)
                           throws SQLException

Gets the value of a column specified by column name as an ASCII character stream.

Parameters:: columnName - the name of the column to read
Returns:: an InputStream with the data from the column.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

getBigDecimal

BigDecimal getBigDecimal(int columnIndex)
                         throws SQLException

Gets the value of a column specified by column index as a java.math.BigDecimal.

Parameters:: columnIndex - the index of the column to read.
Returns:: a BigDecimal with the value of the column.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

getBigDecimal

@Deprecated
BigDecimal getBigDecimal(int columnIndex,
                                    int scale)
                         throws SQLException

Deprecated. use getBigDecimal(int) or getBigDecimal(String)

Gets the value of a column specified by column index as a java.math.BigDecimal.

Parameters:: columnIndex - the index of the column to read.; scale - the number of digits after the decimal point
Returns:: a BigDecimal with the value of the column.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

getBigDecimal

BigDecimal getBigDecimal(String columnName)
                         throws SQLException

Gets the value of a column specified by column name, as a java.math.BigDecimal.

Parameters:: columnName - the name of the column to read.
Returns:: a BigDecimal with value of the column.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

getBigDecimal

@Deprecated
BigDecimal getBigDecimal(String columnName,
                                    int scale)
                         throws SQLException

Deprecated. use getBigDecimal(int) or getBigDecimal(String)

Gets the value of a column specified by column name, as a java.math.BigDecimal.

Parameters:: columnName - the name of the column to read.; scale - the number of digits after the decimal point
Returns:: a BigDecimal with value of the column.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

getBinaryStream

InputStream getBinaryStream(int columnIndex)
                            throws SQLException

Gets the value of a column specified by column index as a binary stream.

This method can be used to read LONGVARBINARY values. All of the data in the InputStream should be read before getting data from any other column. A further call to a getter method will implicitly close the InputStream.

Parameters:: columnIndex - the index of the column to read.
Returns:: an InputStream with the data from the column. If the column value is SQL NULL, null is returned.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

getBinaryStream

InputStream getBinaryStream(String columnName)
                            throws SQLException

Gets the value of a column specified by column name as a binary stream.

Parameters:: columnName - the name of the column to read.
Returns:: an InputStream with the data from the column if the column value is SQL NULL, null is returned.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

getBlob

Blob getBlob(int columnIndex)
             throws SQLException

Gets the value of a column specified by column index as a java.sql.Blob object.

Parameters:: columnIndex - the index of the column to read.
Returns:: a java.sql.Blob with the value of the column.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

getBlob

Blob getBlob(String columnName)
             throws SQLException

Gets the value of a column specified by column name, as a java.sql.Blob object.

Parameters:: columnName - the name of the column to read.
Returns:: a java.sql.Blob with the value of the column.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

getBoolean

boolean getBoolean(int columnIndex)
                   throws SQLException

Gets the value of a column specified by column index as a boolean .

Parameters:: columnIndex - the index of the column to read.
Returns:: a boolean value from the column. If the column is SQL NULL, false is returned.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

getBoolean

boolean getBoolean(String columnName)
                   throws SQLException

Gets the value of a column specified by column name, as a boolean .

Parameters:: columnName - the name of the column to read.
Returns:: a boolean value from the column. If the column is SQL NULL, false is returned.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

getByte

byte getByte(int columnIndex)
             throws SQLException

Gets the value of a column specified by column index as a byte.

Parameters:: columnIndex - the index of the column to read.
Returns:: a byte equal to the value of the column. 0 if the value is SQL NULL.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

getByte

byte getByte(String columnName)
             throws SQLException

Gets the value of a column specified by column name as a byte.

Parameters:: columnName - the name of the column to read.
Returns:: a byte equal to the value of the column. 0 if the value is SQL NULL.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

getBytes

byte[] getBytes(int columnIndex)
                throws SQLException

Gets the value of a column specified by column index as a byte array.

Parameters:: columnIndex - the index of the column to read.
Returns:: a byte array containing the value of the column. null if the column contains SQL NULL.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

getBytes

byte[] getBytes(String columnName)
                throws SQLException

Gets the value of a column specified by column name as a byte array.

Parameters:: columnName - the name of the column to read.
Returns:: a byte array containing the value of the column. null if the column contains SQL NULL.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

getCharacterStream

Reader getCharacterStream(int columnIndex)
                          throws SQLException

Gets the value of a column specified by column index as a java.io.Reader object.

Parameters:: columnIndex - the index of the column to read.
Returns:: a Reader holding the value of the column. null if the column value is SQL NULL.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0
See Also:: Reader

getCharacterStream

Reader getCharacterStream(String columnName)
                          throws SQLException

Gets the value of a column specified by column name as a java.io.Reader object.

Parameters:: columnName - the name of the column to read.
Returns:: a Reader holding the value of the column. null if the column value is SQL NULL.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

getClob

Clob getClob(int columnIndex)
             throws SQLException

Gets the value of a column specified by column index as a java.sql.Clob.

Parameters:: columnIndex - the index of the column to read.
Returns:: a Clob object representing the value in the column. null if the value is SQL NULL.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

getClob

Clob getClob(String colName)
             throws SQLException

Gets the value of a column specified by column name as a java.sql.Clob.

Parameters:: colName - the name of the column to read.
Returns:: a Clob object representing the value in the column. null if the value is SQL NULL.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

getConcurrency

int getConcurrency()
                   throws SQLException

Gets the concurrency mode of this ResultSet.

Returns:: the concurrency mode - one of: ResultSet.CONCUR_READ_ONLY , ResultSet.CONCUR_UPDATABLE.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

getCursorName

String getCursorName()
                     throws SQLException

Gets the name of the SQL cursor of this ResultSet.

Returns:: the SQL cursor name.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

getDate

Date getDate(int columnIndex)
             throws SQLException

Gets the value of a column specified by column index as a java.sql.Date.

Parameters:: columnIndex - the index of the column to read.
Returns:: a java.sql.Date matching the column value. null if the column is SQL NULL.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

getDate

Date getDate(int columnIndex,
             Calendar cal)
             throws SQLException

Gets the value of a column specified by column index as a java.sql.Date. This method uses a supplied calendar to compute the Date.

Parameters:: columnIndex - the index of the column to read.; cal - a java.util.Calendar to use in constructing the Date.
Returns:: a java.sql.Date matching the column value. null if the column is SQL NULL.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

getDate

Date getDate(String columnName)
             throws SQLException

Gets the value of a column specified by column name as a java.sql.Date.

Parameters:: columnName - the name of the column to read.
Returns:: a java.sql.Date matching the column value. null if the column is SQL NULL.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

getDate

Date getDate(String columnName,
             Calendar cal)
             throws SQLException

Gets the value of a column specified by column name, as a java.sql.Date object.

Parameters:: columnName - the name of the column to read.; cal - java.util.Calendar to use in constructing the Date.
Returns:: a java.sql.Date matching the column value. null if the column is SQL NULL.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

getDouble

double getDouble(int columnIndex)
                 throws SQLException

Gets the value of a column specified by column index as a double value.

Parameters:: columnIndex - the index of the column to read.
Returns:: a double equal to the column value. 0.0 if the column is SQL NULL.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

getDouble

double getDouble(String columnName)
                 throws SQLException

Gets the value of a column specified by column name as a double value.

Parameters:: columnName - the name of the column to read.
Returns:: a double equal to the column value. 0.0 if the column is SQL NULL.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

getFetchDirection

int getFetchDirection()
                      throws SQLException

Gets the direction in which rows are fetched for this ResultSet object.

Returns:

the fetch direction. Will be one of:

ResultSet.FETCH_FORWARD
ResultSet.FETCH_REVERSE
ResultSet.FETCH_UNKNOWN

Throws:

SQLException - if a database error happens.

Since:

Android 1.0

getFetchSize

int getFetchSize()
                 throws SQLException

Gets the fetch size (in number of rows) for this ResultSet.

Returns:: the fetch size as an int
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

getFloat

float getFloat(int columnIndex)
               throws SQLException

Gets the value of a column specified by column index as a float value.

Parameters:: columnIndex - the index of the column to read.
Returns:: a float equal to the column value. 0.0 if the column is SQL NULL.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

getFloat

float getFloat(String columnName)
               throws SQLException

Gets the value of a column specified by column name as a float value.

Parameters:: columnName - the name of the column to read.
Returns:: a float equal to the column value. 0.0 if the column is SQL NULL.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

getInt

int getInt(int columnIndex)
           throws SQLException

Gets the value of a column specified by column index as an int value.

Parameters:: columnIndex - the index of the column to read.
Returns:: an int equal to the column value. 0 if the column is SQL NULL.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

getInt

int getInt(String columnName)
           throws SQLException

Gets the value of a column specified by column name, as an int value.

Parameters:: columnName - the name of the column to read.
Returns:: an int equal to the column value. 0 if the column is SQL NULL.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

getLong

long getLong(int columnIndex)
             throws SQLException

Gets the value of a column specified by column index as a long value.

Parameters:: columnIndex - the index of the column to read.
Returns:: a long equal to the column value. 0 if the column is SQL NULL.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

getLong

long getLong(String columnName)
             throws SQLException

Gets the value of a column specified by column name, as a long value.

Parameters:: columnName - the name of the column to read.
Returns:: a long equal to the column value. 0 if the column is SQL NULL.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

getMetaData

ResultSetMetaData getMetaData()
                              throws SQLException

Gets the metadata for this ResultSet. This defines the number, types and properties of the columns in the ResultSet.

Returns:: a ResultSetMetaData object with information about this ResultSet.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

getObject

Object getObject(int columnIndex)
                 throws SQLException

Gets the value of a specified column as a Java Object. The type of the returned object will be the default according to the column's SQL type, following the JDBC specification for built-in types.

For SQL User Defined Types, if a column value is Structured or Distinct, this method behaves the same as a call to: getObject(columnIndex,this.getStatement().getConnection().getTypeMap())

Parameters:: columnIndex - the index of the column to read.
Returns:: an Object containing the value of the column. null if the column value is SQL NULL.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

getObject

Object getObject(int columnIndex,
                 Map<String,Class<?>> map)
                 throws SQLException

Gets the value of a column specified by column index as a Java Object.

The type of the Java object will be determined by the supplied Map to perform the mapping of SQL Struct or Distinct types into Java objects.

Parameters:: columnIndex - the index of the column to read.; map - a java.util.Map containing a mapping from SQL Type names to Java classes.
Returns:: an Object containing the value of the column. null if the column value is SQL NULL.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

getObject

Object getObject(String columnName)
                 throws SQLException

Gets the value of a specified column as a Java Object. The type of the returned object will be the default according to the column's SQL type, following the JDBC specification for built-in types.

For SQL User Defined Types, if a column value is structured or distinct, this method behaves the same as a call to: getObject(columnIndex,this.getStatement().getConnection().getTypeMap())

Parameters:: columnName - the name of the column to read.
Returns:: an Object containing the value of the column. null if the column value is SQL NULL.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

getObject

Object getObject(String columnName,
                 Map<String,Class<?>> map)
                 throws SQLException

Gets the value of a column specified by column name as a Java Object.

The type of the Java object will be determined by the supplied Map to perform the mapping of SQL Struct or Distinct types into Java objects.

Parameters:: columnName - the name of the column to read.; map - a java.util.Map containing a mapping from SQL Type names to Java classes.
Returns:: an Object containing the value of the column. null if the column value is SQL NULL.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

getRef

Ref getRef(int columnIndex)
           throws SQLException

Gets the value of a column specified by column index as a Java java.sql.Ref.

Parameters:: columnIndex - the index of the column to read.
Returns:: a Ref representing the value of the SQL REF in the column
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

getRef

Ref getRef(String colName)
           throws SQLException

Gets the value of a column specified by column name as a Java java.sql.Ref.

Parameters:: colName - the name of the column to read.
Returns:: a Ref representing the value of the SQL REF in the column
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

getRow

int getRow()
           throws SQLException

Gets the number of the current row in the ResultSet. Row numbers start at 1 for the first row.

Returns:: the index number of the current row. 0 is returned if there is no current row.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

getShort

short getShort(int columnIndex)
               throws SQLException

Gets the value of a column specified by column index as a short value.

Parameters:: columnIndex - the index of the column to read.
Returns:: a short value equal to the value of the column. 0 if the value is SQL NULL.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

getShort

short getShort(String columnName)
               throws SQLException

Gets the value of a column specified by column name, as a short value.

Parameters:: columnName - the name of the column to read.
Returns:: a short value equal to the value of the column. 0 if the value is SQL NULL.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

getStatement

Statement getStatement()
                       throws SQLException

Gets the statement that produced this ResultSet. If the ResultSet was not created by a statement (i.e. because it was returned from one of the DatabaseMetaData methods), null is returned.

Returns:: the Statement which produced this ResultSet, or null if the ResultSet was not created by a Statement.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

getString

String getString(int columnIndex)
                 throws SQLException

Gets the value of a column specified by column index as a String.

Parameters:: columnIndex - the index of the column to read.
Returns:: the String representing the value of the column, null if the column is SQL NULL.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

getString

String getString(String columnName)
                 throws SQLException

Gets the value of a column specified by column name, as a String.

Parameters:: columnName - the name of the column to read.
Returns:: the String representing the value of the column, null if the column is SQL NULL.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

getTime

Time getTime(int columnIndex)
             throws SQLException

Gets the value of a column specified by column index as a java.sql.Time value.

Parameters:: columnIndex - the index of the column to read.
Returns:: a Time representing the column value, null if the column value is SQL NULL.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

getTime

Time getTime(int columnIndex,
             Calendar cal)
             throws SQLException

Gets the value of a column specified by column index as a java.sql.Time value. The supplied Calendar is used to map the SQL Time value to a Java Time value.

Parameters:: columnIndex - the index of the column to read.; cal - a Calendar to use in creating the Java Time value.
Returns:: a Time representing the column value, null if the column value is SQL NULL.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

getTime

Time getTime(String columnName)
             throws SQLException

Gets the value of a column specified by column name, as a java.sql.Time value.

Parameters:: columnName - the name of the column to read.
Returns:: the column value, null if the column value is SQL NULL.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

getTime

Time getTime(String columnName,
             Calendar cal)
             throws SQLException

Gets the value of a column specified by column index, as a java.sql.Time value. The supplied Calendar is used to map the SQL Time value to a Java Time value.

Parameters:: columnName - the name of the column to read.; cal - a Calendar to use in creating the Java time value.
Returns:: a Time representing the column value, null if the column value is SQL NULL.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

getTimestamp

Timestamp getTimestamp(int columnIndex)
                       throws SQLException

Gets the value of a column specified by column index as a java.sql.Timestamp value.

Parameters:: columnIndex - the index of the column to read.
Returns:: a timestamp representing the column value, null if the column value is SQL NULL.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

getTimestamp

Timestamp getTimestamp(int columnIndex,
                       Calendar cal)
                       throws SQLException

Gets the value of a column specified by column index, as a java.sql.Timestamp value. The supplied Calendar is used when mapping the SQL Timestamp value to a Java Timestamp value.

Parameters:: columnIndex - the index of the column to read.; cal - Calendar to use in creating the Java timestamp value.
Returns:: a timestamp representing the column value, null if the column value is SQL NULL.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

getTimestamp

Timestamp getTimestamp(String columnName)
                       throws SQLException

Gets the value of a column specified by column name, as a java.sql.Timestamp value.

Parameters:: columnName - the name of the column to read.
Returns:: a timestamp representing the column value, null if the column value is SQL NULL.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

getTimestamp

Timestamp getTimestamp(String columnName,
                       Calendar cal)
                       throws SQLException

Gets the value of a column specified by column name, as a java.sql.Timestamp value. The supplied Calendar is used when mapping the SQL Timestamp value to a Java Timestamp value.

Parameters:: columnName - the name of the column to read.; cal - Calendar to use in creating the Java Timestamp value.
Returns:: a timestamp representing the column value, null if the column value is SQL NULL.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

getType

int getType()
            throws SQLException

Gets the type of the ResultSet.

Returns:

The ResultSet type, one of:

ResultSet.TYPE_FORWARD_ONLY
ResultSet.TYPE_SCROLL_INSENSITIVE
ResultSet.TYPE_SCROLL_SENSITIVE

Throws:

SQLException - if there is a database error.

Since:

Android 1.0

getUnicodeStream

@Deprecated
InputStream getUnicodeStream(int columnIndex)
                             throws SQLException

Deprecated. Use getCharacterStream(int).

Gets the value of the column as an InputStream of unicode characters.

Parameters:: columnIndex - the index of the column to read.
Returns:: an InputStream holding the value of the column. null if the column value is SQL NULL.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

getUnicodeStream

@Deprecated
InputStream getUnicodeStream(String columnName)
                             throws SQLException

Deprecated. Use getCharacterStream(int)

Gets the value of the column as an InputStream of Unicode characters.

Parameters:: columnName - the name of the column to read.
Returns:: an InputStream holding the value of the column. null if the column value is SQL NULL.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

getURL

URL getURL(int columnIndex)
           throws SQLException

Gets the value of a column specified by column index as a java.net.URL.

Parameters:: columnIndex - the index of the column to read.
Returns:: a URL. null if the column value is SQL NULL.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

getURL

URL getURL(String columnName)
           throws SQLException

Gets the value of a column specified by column name as a java.net.URL object.

Parameters:: columnName - the name of the column to read.
Returns:: the column vaule as a URL. null if the column value is SQL NULL.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

getWarnings

SQLWarning getWarnings()
                       throws SQLException

Gets the first warning generated by calls on this ResultSet. Subsequent warnings on this ResultSet are chained to the first one.

The warnings are cleared when a new Row is read from the ResultSet. The warnings returned by this method are only the warnings generated by ResultSet method calls - warnings generated by Statement methods are held by the Statement.

An SQLException is generated if this method is called on a closed ResultSet.

Returns:: an SQLWarning which is the first warning for this ResultSet. null if there are no warnings.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

insertRow

void insertRow()
               throws SQLException

Insert the insert row into the ResultSet and into the underlying database. The cursor must be set to the Insert Row before this method is invoked.

Throws:: SQLException - if a database error happens. Particular cases include the cursor not being on the Insert Row or if any columns in the row do not have a value where the column is declared as not-nullable.
Since:: Android 1.0

isAfterLast

boolean isAfterLast()
                    throws SQLException

Gets if the cursor is after the last row of the ResultSet.

Returns:: true if the cursor is after the last row in the ResultSet, false if the cursor is at any other position in the ResultSet.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

isBeforeFirst

boolean isBeforeFirst()
                      throws SQLException

Gets if the cursor is before the first row of the ResultSet.

Returns:: true if the cursor is before the first row in the ResultSet, false if the cursor is at any other position in the ResultSet.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

isFirst

boolean isFirst()
                throws SQLException

Gets if the cursor is on the first row of the ResultSet.

Returns:: true if the cursor is on the first row in the ResultSet, false if the cursor is at any other position in the ResultSet.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

isLast

boolean isLast()
               throws SQLException

Gets if the cursor is on the last row of the ResultSet

Returns:: true if the cursor is on the last row in the ResultSet, false if the cursor is at any other position in the ResultSet.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

last

boolean last()
             throws SQLException

Shifts the cursor position to the last row of the ResultSet.

Returns:: true if the new position is in a legitimate row, false if the ResultSet contains no rows.
Throws:: SQLException - if there is a database error.
Since:: Android 1.0

moveToCurrentRow

void moveToCurrentRow()
                      throws SQLException

Moves the cursor to the remembered position, namely the row that was the current row before a call to moveToInsertRow. This only applies if the cursor is on the Insert Row.

Throws:: SQLException - if a database error happens.
Since:: Android 1.0

moveToInsertRow

void moveToInsertRow()
                     throws SQLException

Moves the cursor position to the Insert Row. The current position is remembered and the cursor is positioned at the Insert Row. The columns in the Insert Row should be filled in with the appropriate update methods, before calling insertRow to insert the new row into the database.

Throws:: SQLException - if a database error happens.
Since:: Android 1.0

boolean next()
             throws SQLException

Shifts the cursor position down one row in this ResultSet object.

Any input streams associated with the current row are closed and any warnings are cleared.

Returns:: true if the updated cursor position is pointing to a valid row, false otherwise (i.e. when the cursor is after the last row in the ResultSet).
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

boolean previous()
                 throws SQLException

Relocates the cursor position to the preceding row in this ResultSet.

Returns:: true if the new position is in a legitimate row, false if the cursor is now before the first row.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

refreshRow

void refreshRow()
                throws SQLException

Refreshes the current row with its most up to date value in the database. Must not be called when the cursor is on the Insert Row.

If any columns in the current row have been updated but the updateRow has not been called, then the updates are lost when this method is called.

Throws:: SQLException - if a database error happens., including if the current row is the Insert row.
Since:: Android 1.0

relative

boolean relative(int rows)
                 throws SQLException

Moves the cursor position up or down by a specified number of rows. If the new position is beyond the start row (or end row), the cursor position is set before the first row (or, respectively, after the last row).

Parameters:: rows - a number of rows to move the cursor - may be positive or negative
Returns:: true if the new cursor position is on a row, false otherwise
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

rowDeleted

boolean rowDeleted()
                   throws SQLException

Indicates whether a row has been deleted. This method depends on whether the JDBC driver and database can detect deletions.

Returns:: true if a row has been deleted and if deletions are detected, false otherwise.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

rowInserted

boolean rowInserted()
                    throws SQLException

Indicates whether the current row has had an insertion operation. This method depends on whether the JDBC driver and database can detect insertions.

Returns:: true if a row has been inserted and if insertions are detected, false otherwise.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

rowUpdated

boolean rowUpdated()
                   throws SQLException

Indicates whether the current row has been updated. This method depends on whether the JDBC driver and database can detect updates.

Returns:: true if the current row has been updated and if updates can be detected, false otherwise.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

setFetchDirection

void setFetchDirection(int direction)
                       throws SQLException

Indicates which direction (forward/reverse) will be used to process the rows of this ResultSet object. This is treated as a hint by the JDBC driver.

Parameters:: direction - can be ResultSet.FETCH_FORWARD, ResultSet.FETCH_REVERSE, or ResultSet.FETCH_UNKNOWN
Throws:: SQLException - if there is a database error.
Since:: Android 1.0

setFetchSize

void setFetchSize(int rows)
                  throws SQLException

Indicates the number of rows to fetch from the database when extra rows are required for this ResultSet. This used as a hint to the JDBC driver.

Parameters:: rows - the number of rows to fetch. 0 implies that the JDBC driver can make its own decision about the fetch size. The number should not be greater than the maximum number of rows established by the statement that generated the ResultSet.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

updateArray

void updateArray(int columnIndex,
                 Array x)
                 throws SQLException

Updates a column specified by a column index with a java.sql.Array value.

Parameters:: columnIndex - the index of the column to update.; x - the new value for the specified column.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

updateArray

void updateArray(String columnName,
                 Array x)
                 throws SQLException

Updates a column specified by a column name with a java.sql.Array value.

Parameters:: columnName - the name of the column to update.; x - the new value for the specified column.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

updateAsciiStream

void updateAsciiStream(int columnIndex,
                       InputStream x,
                       int length)
                       throws SQLException

Updates a column specified by a column index with an ASCII stream value.

Parameters:: columnIndex - the index of the column to update.; x - the new value for the specified column.; length - the length of the data to write from the stream
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

updateAsciiStream

void updateAsciiStream(String columnName,
                       InputStream x,
                       int length)
                       throws SQLException

Updates a column specified by a column name with an Ascii stream value.

Parameters:: columnName - the name of the column to update.; x - the new value for the specified column.; length - the length of the data to write from the stream
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

updateBigDecimal

void updateBigDecimal(int columnIndex,
                      BigDecimal x)
                      throws SQLException

Updates a column specified by a column index with a java.sql.BigDecimal value.

Parameters:: columnIndex - the index of the column to update.; x - the new value for the specified column.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

updateBigDecimal

void updateBigDecimal(String columnName,
                      BigDecimal x)
                      throws SQLException

Updates a column specified by a column name with a java.sql.BigDecimal value.

Parameters:: columnName - the name of the column to update.; x - the new value for the specified column.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

updateBinaryStream

void updateBinaryStream(int columnIndex,
                        InputStream x,
                        int length)
                        throws SQLException

Updates a column specified by a column index with a binary stream value.

Parameters:: columnIndex - the index of the column to update.; x - the new value for the specified column.; length - the number of bytes to be read from the the stream.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

updateBinaryStream

void updateBinaryStream(String columnName,
                        InputStream x,
                        int length)
                        throws SQLException

Updates a column specified by a column name with a binary stream value.

Parameters:: columnName - the name of the column to update.; x - the new value for the specified column.; length - he number of bytes to be read from the the stream.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

updateBlob

void updateBlob(int columnIndex,
                Blob x)
                throws SQLException

Updates a column specified by a column index with a java.sql.Blob value.

Parameters:: columnIndex - the index of the column to update.; x - the new value for the specified column.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

updateBlob

void updateBlob(String columnName,
                Blob x)
                throws SQLException

Updates a column specified by a column name with a java.sql.Blob value.

Parameters:: columnName - the name of the column to update.; x - the new value for the specified column.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

updateBoolean

void updateBoolean(int columnIndex,
                   boolean x)
                   throws SQLException

Updates a column specified by a column index with a boolean value.

Parameters:: columnIndex - the index of the column to update.; x - the new value for the specified column.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

updateBoolean

void updateBoolean(String columnName,
                   boolean x)
                   throws SQLException

Updates a column specified by a column name with a boolean value.

Parameters:: columnName - the name of the column to update.; x - the new value for the specified column.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

updateByte

void updateByte(int columnIndex,
                byte x)
                throws SQLException

Updates a column specified by a column index with a byte value.

Parameters:: columnIndex - the index of the column to update.; x - the new value for the specified column.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

updateByte

void updateByte(String columnName,
                byte x)
                throws SQLException

Updates a column specified by a column name with a byte value.

Parameters:: columnName - the name of the column to update.; x - the new value for the specified column.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

updateBytes

void updateBytes(int columnIndex,
                 byte[] x)
                 throws SQLException

Updates a column specified by a column index with a byte array value.

Parameters:: columnIndex - the index of the column to update.; x - the new value for the specified column.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

updateBytes

void updateBytes(String columnName,
                 byte[] x)
                 throws SQLException

Updates a column specified by a column name with a byte array value.

Parameters:: columnName - the name of the column to update.; x - the new value for the specified column.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

updateCharacterStream

void updateCharacterStream(int columnIndex,
                           Reader x,
                           int length)
                           throws SQLException

Updates a column specified by a column index with a character stream value.

Parameters:: columnIndex - the index of the column to update.; x - the new value for the specified column.; length - the length of data to write from the stream
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

updateCharacterStream

void updateCharacterStream(String columnName,
                           Reader reader,
                           int length)
                           throws SQLException

Updates a column specified by a column name with a character stream value.

Parameters:: columnName - the name of the column to update.; reader - the new value for the specified column.; length - the length of data to write from the Reader
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

updateClob

void updateClob(int columnIndex,
                Clob x)
                throws SQLException

Updates a column specified by a column index with a java.sql.Clob value.

Parameters:: columnIndex - the index of the column to update.; x - the new value for the specified column.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

updateClob

void updateClob(String columnName,
                Clob x)
                throws SQLException

Updates a column specified by a column name with a java.sql.Clob value.

Parameters:: columnName - the name of the column to update.; x - the new value for the specified column.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

updateDate

void updateDate(int columnIndex,
                Date x)
                throws SQLException

Updates a column specified by a column index with a java.sql.Date value.

Parameters:: columnIndex - the index of the column to update.; x - the new value for the specified column.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

updateDate

void updateDate(String columnName,
                Date x)
                throws SQLException

Updates a column specified by a column name with a java.sql.Date value.

Parameters:: columnName - the name of the column to update.; x - the new value for the specified column.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

updateDouble

void updateDouble(int columnIndex,
                  double x)
                  throws SQLException

Updates a column specified by a column index with a double value.

Parameters:: columnIndex - the index of the column to update.; x - the new value for the specified column.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

updateDouble

void updateDouble(String columnName,
                  double x)
                  throws SQLException

Updates a column specified by a column name with a double value.

Parameters:: columnName - the name of the column to update.; x - the new value for the specified column.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

updateFloat

void updateFloat(int columnIndex,
                 float x)
                 throws SQLException

Updates a column specified by a column index with a float value.

Parameters:: columnIndex - the index of the column to update.; x - the new value for the specified column.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

updateFloat

void updateFloat(String columnName,
                 float x)
                 throws SQLException

Updates a column specified by a column name with a float value.

Parameters:: columnName - the name of the column to update.; x - the new value for the specified column.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

updateInt

void updateInt(int columnIndex,
               int x)
               throws SQLException

Updates a column specified by a column index with an int value.

Parameters:: columnIndex - the index of the column to update.; x - the new value for the specified column.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

updateInt

void updateInt(String columnName,
               int x)
               throws SQLException

Updates a column specified by a column name with an int value.

Parameters:: columnName - the name of the column to update.; x - the new value for the specified column.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

updateLong

void updateLong(int columnIndex,
                long x)
                throws SQLException

Updates a column specified by a column index with a long value.

Parameters:: columnIndex - the index of the column to update.; x - the new value for the specified column..
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

updateLong

void updateLong(String columnName,
                long x)
                throws SQLException

Updates a column specified by a column name with a long value.

Parameters:: columnName - the name of the column to update.; x - the new value for the specified column.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

updateNull

void updateNull(int columnIndex)
                throws SQLException

Updates a column specified by a column index with a null value.

Parameters:: columnIndex - the index of the column to update.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

updateNull

void updateNull(String columnName)
                throws SQLException

Updates a column specified by a column name with a null value.

Parameters:: columnName - the name of the column to update.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

updateObject

void updateObject(int columnIndex,
                  Object x)
                  throws SQLException

Updates a column specified by a column index with an Object value.

Parameters:: columnIndex - the index of the column to update.; x - the new value for the specified column.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

updateObject

void updateObject(int columnIndex,
                  Object x,
                  int scale)
                  throws SQLException

Updates a column specified by a column index with an Object value.

Parameters:: columnIndex - the index of the column to update.; x - the new value for the specified column.; scale - for the types java.sql.Types.DECIMAL or java.sql.Types.NUMERIC, this specifies the number of digits after the decimal point.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

updateObject

void updateObject(String columnName,
                  Object x)
                  throws SQLException

Updates a column specified by a column name with an Object value.

Parameters:: columnName - the name of the column to update.; x - the new value for the specified column.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

updateObject

void updateObject(String columnName,
                  Object x,
                  int scale)
                  throws SQLException

Updates a column specified by a column name with an Object value.

Parameters:: columnName - the name of the column to update.; x - the new value for the specified column.; scale - for the types java.sql.Types.DECIMAL or java.sql.Types.NUMERIC, this specifies the number of digits after the decimal point.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

updateRef

void updateRef(int columnIndex,
               Ref x)
               throws SQLException

Updates a column specified by a column index with a java.sql.Ref value.

Parameters:: columnIndex - the index of the column to update.; x - the new value for the specified column.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

updateRef

void updateRef(String columnName,
               Ref x)
               throws SQLException

Updates a column specified by a column name with a java.sql.Ref value.

Parameters:: columnName - the name of the column to update.; x - the new value for the specified column.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

updateRow

void updateRow()
               throws SQLException

Updates the database with the new contents of the current row of this ResultSet object.

Throws:: SQLException - if a database error happens.
Since:: Android 1.0

updateShort

void updateShort(int columnIndex,
                 short x)
                 throws SQLException

Updates a column specified by a column index with a short value.

Parameters:: columnIndex - the index of the column to update.; x - the new value for the specified column.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

updateShort

void updateShort(String columnName,
                 short x)
                 throws SQLException

Updates a column specified by a column name with a short value.

Parameters:: columnName - the name of the column to update.; x - the new value for the specified column.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

updateString

void updateString(int columnIndex,
                  String x)
                  throws SQLException

Updates a column specified by a column index with a String value.

Parameters:: columnIndex - the index of the column to update.; x - the new value for the specified column.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

updateString

void updateString(String columnName,
                  String x)
                  throws SQLException

Updates a column specified by a column name with a String value.

Parameters:: columnName - the name of the column to update.; x - the new value for the specified column.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

updateTime

void updateTime(int columnIndex,
                Time x)
                throws SQLException

Updates a column specified by a column index with a Time value.

Parameters:: columnIndex - the index of the column to update.; x - the new value for the specified column.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

updateTime

void updateTime(String columnName,
                Time x)
                throws SQLException

Updates a column specified by a column name with a Time value.

Parameters:: columnName - the name of the column to update.; x - the new value for the specified column.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

updateTimestamp

void updateTimestamp(int columnIndex,
                     Timestamp x)
                     throws SQLException

Updates a column specified by a column index with a Timestamp value.

Parameters:: columnIndex - the index of the column to update.; x - the new timestamp value for the specified column.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

updateTimestamp

void updateTimestamp(String columnName,
                     Timestamp x)
                     throws SQLException

Updates a column specified by column name with a Timestamp value.

Parameters:: columnName - the name of the column to update.; x - the new timestamp value for the specified column.
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

wasNull

boolean wasNull()
                throws SQLException

Determines whether the last column read from this ResultSet contained SQL NULL.

Returns:: {@code true} if the last column contained SQL {@code NULL}, {@code false} otherwise
Throws:: SQLException - if a database error happens.
Since:: Android 1.0

Overview

Package

Class

Use

Tree

Deprecated

Index

Help

Build 1.1_r1 (from source)

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

Please submit a feedback, bug or feature

java.sql Interface ResultSet

CLOSE_CURSORS_AT_COMMIT

HOLD_CURSORS_OVER_COMMIT

CONCUR_READ_ONLY

CONCUR_UPDATABLE

FETCH_FORWARD

FETCH_REVERSE

FETCH_UNKNOWN

TYPE_FORWARD_ONLY

TYPE_SCROLL_INSENSITIVE

TYPE_SCROLL_SENSITIVE

absolute

afterLast

beforeFirst

cancelRowUpdates

clearWarnings

close

deleteRow

findColumn

first

getArray

getArray

getAsciiStream

getAsciiStream

getBigDecimal

getBigDecimal

getBigDecimal

getBigDecimal

getBinaryStream

getBinaryStream

getBlob

getBlob

getBoolean

getBoolean

getByte

getByte

getBytes

getBytes

getCharacterStream

getCharacterStream

getClob

getClob

getConcurrency

getCursorName

getDate

getDate

getDate

getDate

getDouble

getDouble

getFetchDirection

getFetchSize

getFloat

getFloat

getInt

getInt

getLong

getLong

getMetaData

getObject

getObject

getObject

getObject

getRef

getRef

getRow

getShort

getShort

getStatement

getString

getString

getTime

getTime

getTime

getTime

getTimestamp

getTimestamp

getTimestamp

getTimestamp

getType

java.sql
Interface ResultSet