com.sybase.jdbcx
Interface SybCursorResultSet


public abstract interface SybCursorResultSet
extends SybResultSet

This subinterface of SybResultSet provides methods for cursor operations.

Methods in this interface are part of the JDBC 2.0 standard, available in jConnect 5.0. However, jConnect 4.1 provides them as Sybase-specific extensions to JDBC 1.0. They can be accessed only by casting the ResultSet object to a SybCursorResultSet.

See Also:
SybResultSet, ResultSet, Statement.executeQuery(java.lang.String), Statement.getResultSet(), ResultSetMetaData

Fields inherited from class com.sybase.jdbcx.SybResultSet
CONCUR_READ_ONLY, CONCUR_UNKNOWN, CONCUR_UPDATABLE, TYPE_FORWARD_ONLY
 
Method Summary
 void cancelRowUpdates()
           JDBC 2.0 API - Cancels the updates made to a row.
 void deleteRow()
           JDBC 2.0 API - Deletes the current row from the underlying database.
 void deleteRow(String table)
           Sybase extension for JDBC 2.0 API - Delete the current row from the underlying database.
 int getConcurrency()
           JDBC 2.0 API - Returns the concurrency of this result set.
 String getCursorName()
           
 int getFetchSize()
           JDBC 2.0 API - Returns the fetch size for this result set.
 int getType()
           JDBC 2.0 API - Returns the type of this result set.
 boolean isLanguageCursor()
           Sybase extension for JDBC 2.0 API - Returns type of cursor declared at the server.
 boolean rowDeleted()
           JDBC 2.0 API Determines if the current row has been deleted.
 boolean rowUpdated()
           JDBC 2.0 API - Determines if the current row has been updated.
 void setFetchSize(int rows)
           JDBC 2.0 API - Sets the number of rows that should be fetched from the database when more rows are needed for this result set.
 void updateAsciiStream(int parameterIndex, InputStream x, int length)
           JDBC 2.0 API - Prepares the column value for an update of the current row.
 void updateAsciiStream(String columnName, InputStream x, int length)
           JDBC 2.0 API - Prepares the column value for an update of the current row.
 void updateBigDecimal(int parameterIndex, BigDecimal x)
           JDBC 2.0 API - Prepares the column value for an update of the current row.
 void updateBigDecimal(String columnName, BigDecimal x)
           JDBC 2.0 API - Prepares the column value for an update of the current row.
 void updateBinaryStream(int parameterIndex, InputStream x, int length)
           JDBC 2.0 API - Prepares the column value for an update of the current row.
 void updateBinaryStream(String columnName, InputStream x, int length)
           JDBC 2.0 API - Prepares the column value for an update of the current row.
 void updateBoolean(int parameterIndex, boolean x)
           JDBC 2.0 API - Prepares the column value for an update of the current row.
 void updateBoolean(String columnName, boolean x)
           JDBC 2.0 API - Prepares the column value for an update of the current row.
 void updateByte(int parameterIndex, byte x)
           JDBC 2.0 API - Prepares the column value for an update of the current row.
 void updateByte(String columnName, byte x)
           JDBC 2.0 API - Prepares the column value for an update of the current row.
 void updateBytes(int parameterIndex, byte[] x)
           JDBC 2.0 API - Prepares the column value for an update of the current row.
 void updateBytes(String columnName, byte[] x)
           JDBC 2.0 API - Prepares the column value for an update of the current row.
 void updateCharacterStream(int parameterIndex, Reader r, int length)
           JDBC 2.0 API - Prepares the column value for an update of the current row.
 void updateCharacterStream(String columnName, Reader r, int length)
           JDBC 2.0 API - Prepares the column value for an update of the current row.
 void updateDate(int parameterIndex, Date x)
           JDBC 2.0 API - Prepares the column value for an update of the current row.
 void updateDate(String columnName, Date x)
           JDBC 2.0 API - Prepares the column value for an update of the current row.
 void updateDouble(int parameterIndex, double x)
           JDBC 2.0 API - Prepares the column value for an update of the current row.
 void updateDouble(String columnName, double x)
           JDBC 2.0 API - Prepares the column value for an update of the current row.
 void updateFloat(int parameterIndex, float x)
           JDBC 2.0 API - Prepares the column value for an update of the current row.
 void updateFloat(String columnName, float x)
           JDBC 2.0 API - Prepares the column value for an update of the current row.
 void updateInt(int parameterIndex, int x)
           JDBC 2.0 API - Prepares the column value for an update of the current row.
 void updateInt(String columnName, int x)
           JDBC 2.0 API - Prepares the column value for an update of the current row.
 void updateLong(int parameterIndex, long x)
           JDBC 2.0 API - Prepares the column value for an update of the current row.
 void updateLong(String columnName, long x)
           JDBC 2.0 API - Prepares the column value for an update of the current row.
 void updateNull(int parameterIndex)
           JDBC 2.0 API - Prepares the column value for an update of the current row.
 void updateNull(String columnName)
           JDBC 2.0 API - Prepares the column value for an update of the current row.
 void updateObject(int parameterIndex, Object x)
           JDBC 2.0 API - Prepares the column value for an update of the current row.
 void updateObject(int parameterIndex, Object x, int scale)
           JDBC 2.0 API - Prepares the column value for an update of the current row.
 void updateObject(String columnName, Object x)
           JDBC 2.0 API - Prepares the column value for an update of the current row.
 void updateObject(String columnName, Object x, int scale)
           JDBC 2.0 API - Prepares the column value for an update of the current row.
 void updateRow()
           JDBC 2.0 API - Updates the underlying database with the new contents prepared for the current row with the updateXXX() methods.
 void updateRow(String table)
           Sybase extension for JDBC 2.0 API - Updates the underlying database with the new contents prepared for the current row with the updateXXX() methods.
 void updateShort(int parameterIndex, short x)
           JDBC 2.0 API - Prepares the column value for an update of the current row.
 void updateShort(String columnName, short x)
           JDBC 2.0 API - Prepares the column value for an update of the current row.
 void updateString(int parameterIndex, String x)
           JDBC 2.0 API - Prepares the column value for an update of the current row.
 void updateString(String columnName, String x)
           JDBC 2.0 API - Prepares the column value for an update of the current row.
 void updateTime(int parameterIndex, Time x)
           JDBC 2.0 API - Prepares the column value for an update of the current row.
 void updateTime(String columnName, Time x)
           JDBC 2.0 API - Prepares the column value for an update of the current row.
 void updateTimestamp(int parameterIndex, Timestamp x)
           JDBC 2.0 API - Prepares the column value for an update of the current row.
 void updateTimestamp(String columnName, Timestamp x)
           JDBC 2.0 API - Prepares the column value for an update of the current row.
 
Methods inherited from interface com.sybase.jdbcx.SybResultSet
getBigDecimal, getBigDecimal, getSybTextPointer, getSybTextPointer, updateBigDecimal, updateBigDecimal
 
Methods inherited from interface java.sql.ResultSet
absolute, afterLast, beforeFirst, clearWarnings, close, findColumn, first, getArray, getArray, getAsciiStream, getAsciiStream, getBigDecimal, getBigDecimal, getBinaryStream, getBinaryStream, getBlob, getBlob, getBoolean, getBoolean, getByte, getByte, getBytes, getBytes, getCharacterStream, getCharacterStream, getClob, getClob, getDate, getDate, getDate, getDate, getDouble, getDouble, getFetchDirection, 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, getUnicodeStream, getUnicodeStream, getWarnings, insertRow, isAfterLast, isBeforeFirst, isFirst, isLast, last, moveToCurrentRow, moveToInsertRow, next, previous, refreshRow, relative, rowInserted, setFetchDirection, wasNull
 

Method Detail

getCursorName

public String getCursorName()
                               throws SQLException
See Also:
ResultSet.getCursorName()

isLanguageCursor

public boolean isLanguageCursor()

Sybase extension for JDBC 2.0 API - Returns type of cursor declared at the server.

Returns:
true if cursor is a language cursor, otherwise cursor is a protocol cursor

setFetchSize

public void setFetchSize(int rows)
                  throws SQLException

JDBC 2.0 API - Sets the number of rows that should be fetched from the database when more rows are needed for this result set. The fetch size may be changed at any time.

Parameters:
rows - the number of rows to fetch
Throws:
SQLException - if a database-access error occurs
See Also:
ResultSet.setFetchSize(int)

getFetchSize

public int getFetchSize()
                 throws SQLException

JDBC 2.0 API - Returns the fetch size for this result set.

Returns:
the fetch size
Throws:
SQLException - if a database-access error occurs
See Also:
ResultSet.getFetchSize()

getType

public int getType()
            throws SQLException

JDBC 2.0 API - Returns the type of this result set. The type is determined based on the statement that created the result set.

Returns:
TYPE_FORWARD_ONLY, TYPE_SCROLL_INSENSITIVE, or TYPE_SCROLL_SENSITIVE
Throws:
SQLException - if a database-access error occurs
See Also:
ResultSet.getType()

getConcurrency

public int getConcurrency()
                   throws SQLException

JDBC 2.0 API - Returns the concurrency of this result set. The concurrency used is determined by the statement that created the result set.

Returns:
CONCUR_READ_ONLY or CONCUR_UPDATABLE
Throws:
SQLException - if a database-access error occurs
See Also:
ResultSet.getConcurrency()

rowUpdated

public boolean rowUpdated()
                   throws SQLException

JDBC 2.0 API - Determines if the current row has been updated.

Returns:
true if updated
Throws:
SQLException - if a database-access error occurs
See Also:
ResultSet.rowUpdated()

rowDeleted

public boolean rowDeleted()
                   throws SQLException

JDBC 2.0 API Determines if the current row has been deleted.

Returns:
true if deleted
Throws:
SQLException - if a database-access error occurs
See Also:
ResultSet.rowDeleted()

updateNull

public void updateNull(int parameterIndex)
                throws SQLException

JDBC 2.0 API - Prepares the column value for an update of the current row.

Parameters:
columnIndex - the first column is 1, the second is 2, ...
Throws:
SQLException - if a database-access error occurs
See Also:
ResultSet.updateNull(int)

updateBoolean

public void updateBoolean(int parameterIndex,
                          boolean x)
                   throws SQLException

JDBC 2.0 API - Prepares the column value for an update of the current row.

Parameters:
columnIndex - the first column is 1, the second is 2, ...
x - the new column value
Throws:
SQLException - if a database-access error occurs
See Also:
ResultSet.updateBoolean(int, boolean)

updateByte

public void updateByte(int parameterIndex,
                       byte x)
                throws SQLException

JDBC 2.0 API - Prepares the column value for an update of the current row.

Parameters:
columnIndex - the first column is 1, the second is 2, ...
x - the new column value
Throws:
SQLException - if a database-access error occurs
See Also:
ResultSet.updateByte(int, byte)

updateShort

public void updateShort(int parameterIndex,
                        short x)
                 throws SQLException

JDBC 2.0 API - Prepares the column value for an update of the current row.

Parameters:
columnIndex - the first column is 1, the second is 2, ...
x - the new column value
Throws:
SQLException - if a database-access error occurs
See Also:
ResultSet.updateShort(int, short)

updateInt

public void updateInt(int parameterIndex,
                      int x)
               throws SQLException

JDBC 2.0 API - Prepares the column value for an update of the current row.

Parameters:
columnIndex - the first column is 1, the second is 2, ...
x - the new column value
Throws:
SQLException - if a database-access error occurs
See Also:
ResultSet.updateInt(int, int)

updateLong

public void updateLong(int parameterIndex,
                       long x)
                throws SQLException

JDBC 2.0 API - Prepares the column value for an update of the current row.

Parameters:
columnIndex - the first column is 1, the second is 2, ...
x - the new column value
Throws:
SQLException - if a database-access error occurs
See Also:
ResultSet.updateLong(int, long)

updateFloat

public void updateFloat(int parameterIndex,
                        float x)
                 throws SQLException

JDBC 2.0 API - Prepares the column value for an update of the current row.

Parameters:
columnIndex - the first column is 1, the second is 2, ...
x - the new column value
Throws:
SQLException - if a database-access error occurs
See Also:
ResultSet.updateFloat(int, float)

updateDouble

public void updateDouble(int parameterIndex,
                         double x)
                  throws SQLException

JDBC 2.0 API - Prepares the column value for an update of the current row.

Parameters:
columnIndex - the first column is 1, the second is 2, ...
x - the new column value
Throws:
SQLException - if a database-access error occurs
See Also:
ResultSet.updateDouble(int, double)

updateBigDecimal

public void updateBigDecimal(int parameterIndex,
                             BigDecimal x)
                      throws SQLException

JDBC 2.0 API - Prepares the column value for an update of the current row.

Parameters:
columnIndex - the first column is 1, the second is 2, ...
x - the new column value
Throws:
SQLException - if a database-access error occurs
See Also:
ResultSet.updateBigDecimal(int, java.math.BigDecimal)

updateString

public void updateString(int parameterIndex,
                         String x)
                  throws SQLException

JDBC 2.0 API - Prepares the column value for an update of the current row.

Parameters:
columnIndex - the first column is 1, the second is 2, ...
x - the new column value
Throws:
SQLException - if a database-access error occurs
See Also:
ResultSet.updateString(int, java.lang.String)

updateBytes

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

JDBC 2.0 API - Prepares the column value for an update of the current row.

Parameters:
columnIndex - the first column is 1, the second is 2, ...
x - the new column value
Throws:
SQLException - if a database-access error occurs
See Also:
ResultSet.updateBytes(int, byte[])

updateDate

public void updateDate(int parameterIndex,
                       Date x)
                throws SQLException

JDBC 2.0 API - Prepares the column value for an update of the current row.

Parameters:
columnIndex - the first column is 1, the second is 2, ...
x - the new column value
Throws:
SQLException - if a database-access error occurs
See Also:
ResultSet.updateDate(int, java.sql.Date)

updateTime

public void updateTime(int parameterIndex,
                       Time x)
                throws SQLException

JDBC 2.0 API - Prepares the column value for an update of the current row.

Parameters:
columnIndex - the first column is 1, the second is 2, ...
x - the new column value
Throws:
SQLException - if a database-access error occurs
See Also:
ResultSet.updateTime(int, java.sql.Time)

updateTimestamp

public void updateTimestamp(int parameterIndex,
                            Timestamp x)
                     throws SQLException

JDBC 2.0 API - Prepares the column value for an update of the current row.

Parameters:
columnIndex - the first column is 1, the second is 2, ...
x - the new column value
Throws:
SQLException - if a database-access error occurs
See Also:
ResultSet.updateTimestamp(int, java.sql.Timestamp)

updateAsciiStream

public void updateAsciiStream(int parameterIndex,
                              InputStream x,
                              int length)
                       throws SQLException

JDBC 2.0 API - Prepares the column value for an update of the current row.

Parameters:
columnIndex - the first column is 1, the second is 2, ...
x - the new column value
length - the length of the stream
Throws:
SQLException - if a database-access error occurs
See Also:
ResultSet.updateAsciiStream(int, java.io.InputStream, int)

updateBinaryStream

public void updateBinaryStream(int parameterIndex,
                               InputStream x,
                               int length)
                        throws SQLException

JDBC 2.0 API - Prepares the column value for an update of the current row.

Parameters:
columnIndex - the first column is 1, the second is 2, ...
x - the new column value
length - the length of the stream
Throws:
SQLException - if a database-access error occurs
See Also:
ResultSet.updateBinaryStream(int, java.io.InputStream, int)

updateCharacterStream

public void updateCharacterStream(int parameterIndex,
                                  Reader r,
                                  int length)
                           throws SQLException

JDBC 2.0 API - Prepares the column value for an update of the current row.

Parameters:
columnIndex - the first column is 1, the second is 2, ...
x - the new column value
length - the length of the stream
Throws:
SQLException - if a database-access error occurs
See Also:
ResultSet.updateCharacterStream(int, java.io.Reader, int)

updateObject

public void updateObject(int parameterIndex,
                         Object x,
                         int scale)
                  throws SQLException

JDBC 2.0 API - Prepares the column value for an update of the current row.

Parameters:
columnIndex - the first column is 1, the second is 2, ...
x - the new column value
scale - 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 is ignored.
Throws:
SQLException - if a database-access error occurs
See Also:
ResultSet.updateObject(int, java.lang.Object)

updateObject

public void updateObject(int parameterIndex,
                         Object x)
                  throws SQLException

JDBC 2.0 API - Prepares the column value for an update of the current row.

Parameters:
columnIndex - the first column is 1, the second is 2, ...
x - the new column value
Throws:
SQLException - if a database-access error occurs
See Also:
ResultSet.updateObject(int, java.lang.Object)

updateNull

public void updateNull(String columnName)
                throws SQLException

JDBC 2.0 API - Prepares the column value for an update of the current row.

Parameters:
columnName - the name of the column
Throws:
SQLException - if a database-access error occurs
See Also:
ResultSet.updateNull(int)

updateBoolean

public void updateBoolean(String columnName,
                          boolean x)
                   throws SQLException

JDBC 2.0 API - Prepares the column value for an update of the current row.

Parameters:
columnName - the name of the column
x - the new column value
Throws:
SQLException - if a database-access error occurs
See Also:
ResultSet.updateBoolean(int, boolean)

updateByte

public void updateByte(String columnName,
                       byte x)
                throws SQLException

JDBC 2.0 API - Prepares the column value for an update of the current row.

Parameters:
columnName - the name of the column
x - the new column value
Throws:
SQLException - if a database-access error occurs
See Also:
ResultSet.updateByte(int, byte)

updateShort

public void updateShort(String columnName,
                        short x)
                 throws SQLException

JDBC 2.0 API - Prepares the column value for an update of the current row.

Parameters:
columnName - the name of the column
x - the new column value
Throws:
SQLException - if a database-access error occurs
See Also:
ResultSet.updateShort(int, short)

updateInt

public void updateInt(String columnName,
                      int x)
               throws SQLException

JDBC 2.0 API - Prepares the column value for an update of the current row.

Parameters:
columnName - the name of the column
x - the new column value
Throws:
SQLException - if a database-access error occurs
See Also:
ResultSet.updateInt(int, int)

updateLong

public void updateLong(String columnName,
                       long x)
                throws SQLException

JDBC 2.0 API - Prepares the column value for an update of the current row.

Parameters:
columnName - the name of the column
x - the new column value
Throws:
SQLException - if a database-access error occurs
See Also:
ResultSet.updateLong(int, long)

updateFloat

public void updateFloat(String columnName,
                        float x)
                 throws SQLException

JDBC 2.0 API - Prepares the column value for an update of the current row.

Parameters:
columnName - the name of the column
x - the new column value
Throws:
SQLException - if a database-access error occurs
See Also:
ResultSet.updateFloat(int, float)

updateDouble

public void updateDouble(String columnName,
                         double x)
                  throws SQLException

JDBC 2.0 API - Prepares the column value for an update of the current row.

Parameters:
columnName - the name of the column
x - the new column value
Throws:
SQLException - if a database-access error occurs
See Also:
ResultSet.updateDouble(int, double)

updateBigDecimal

public void updateBigDecimal(String columnName,
                             BigDecimal x)
                      throws SQLException

JDBC 2.0 API - Prepares the column value for an update of the current row.

Parameters:
columnName - the name of the column
x - the new column value
Throws:
SQLException - if a database-access error occurs
See Also:
ResultSet.updateBigDecimal(int, java.math.BigDecimal)

updateString

public void updateString(String columnName,
                         String x)
                  throws SQLException

JDBC 2.0 API - Prepares the column value for an update of the current row.

Parameters:
columnName - the name of the column
x - the new column value
Throws:
SQLException - if a database-access error occurs
See Also:
ResultSet.updateString(int, java.lang.String)

updateBytes

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

JDBC 2.0 API - Prepares the column value for an update of the current row.

Parameters:
columnName - the name of the column
x - the new column value
Throws:
SQLException - if a database-access error occurs
See Also:
ResultSet.updateBytes(int, byte[])

updateDate

public void updateDate(String columnName,
                       Date x)
                throws SQLException

JDBC 2.0 API - Prepares the column value for an update of the current row.

Parameters:
columnName - the name of the column
x - the new column value
Throws:
SQLException - if a database-access error occurs
See Also:
ResultSet.updateDate(int, java.sql.Date)

updateTime

public void updateTime(String columnName,
                       Time x)
                throws SQLException

JDBC 2.0 API - Prepares the column value for an update of the current row.

Parameters:
columnName - the name of the column
x - the new column value
Throws:
SQLException - if a database-access error occurs
See Also:
ResultSet.updateTime(int, java.sql.Time)

updateTimestamp

public void updateTimestamp(String columnName,
                            Timestamp x)
                     throws SQLException

JDBC 2.0 API - Prepares the column value for an update of the current row.

Parameters:
columnName - the name of the column
x - the new column value
Throws:
SQLException - if a database-access error occurs
See Also:
ResultSet.updateTimestamp(int, java.sql.Timestamp)

updateAsciiStream

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

JDBC 2.0 API - Prepares the column value for an update of the current row.

Parameters:
columnName - the name of the column
x - the new column value
length - of the stream
Throws:
SQLException - if a database-access error occurs
See Also:
ResultSet.updateAsciiStream(int, java.io.InputStream, int)

updateBinaryStream

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

JDBC 2.0 API - Prepares the column value for an update of the current row.

Parameters:
columnName - the name of the column
x - the new column value
length - of the stream
Throws:
SQLException - if a database-access error occurs
See Also:
ResultSet.updateBinaryStream(int, java.io.InputStream, int)

updateCharacterStream

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

JDBC 2.0 API - Prepares the column value for an update of the current row.

Parameters:
columnName - the name of the column
x - the new column value
length - of the stream
Throws:
SQLException - if a database-access error occurs
See Also:
ResultSet.updateCharacterStream(int, java.io.Reader, int)

updateObject

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

JDBC 2.0 API - Prepares the column value for an update of the current row.

Parameters:
columnName - the name of the column
x - the new column value
scale - 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 is ignored.
Throws:
SQLException - if a database-access error occurs
See Also:
ResultSet.updateObject(int, java.lang.Object)

updateObject

public void updateObject(String columnName,
                         Object x)
                  throws SQLException

JDBC 2.0 API - Prepares the column value for an update of the current row.

Parameters:
columnName - the name of the column
x - the new column value
Throws:
SQLException - if a database-access error occurs
See Also:
ResultSet.updateObject(int, java.lang.Object)

cancelRowUpdates

public void cancelRowUpdates()
                      throws SQLException

JDBC 2.0 API - Cancels the updates made to a row. When called after calling an updateXXX() method and before calling the updateRow() method, the updates made to a row are rolled back. If no updates have been made or the updateRow() method has already been called, then this method has no effect.

Throws:
SQLException - if a database-access error occurs
See Also:
ResultSet.cancelRowUpdates()

deleteRow

public void deleteRow()
               throws SQLException

JDBC 2.0 API - Deletes the current row from the underlying database.

Throws:
SQLException - if a database-access error occurs
See Also:
ResultSet.deleteRow()

deleteRow

public void deleteRow(String table)
               throws SQLException

Sybase extension for JDBC 2.0 API - Delete the current row from the underlying database.

Parameters:
table - name of the table from which the row is to be deleted
Throws:
SQLException - if a database-access error occurs
See Also:
ResultSet.deleteRow()

updateRow

public void updateRow()
               throws SQLException

JDBC 2.0 API - Updates the underlying database with the new contents prepared for the current row with the updateXXX() methods.

Throws:
SQLException - if a database-access error occurs
See Also:
ResultSet.updateRow()

updateRow

public void updateRow(String table)
               throws SQLException

Sybase extension for JDBC 2.0 API - Updates the underlying database with the new contents prepared for the current row with the updateXXX() methods.

Parameters:
table - table name where the row is to be updated
Throws:
SQLException - if a database-access error occurs
See Also:
ResultSet.updateRow()