All Libraries   This Library  Package   Class  Use  Tree  Deprecated  Index  Grand Index  Help 
 Foundation 
 PREV CLASS   NEXT CLASS FRAMES    NO FRAMES    
SUMMARY: NESTED | FIELD | CONSTR | METHOD DETAIL: FIELD | CONSTR | METHOD

com.sas.rio
Class MVAResultSet

com.sas.rio.MVAResultSet
All Implemented Interfaces:
java.sql.ResultSet, java.sql.Wrapper
Direct Known Subclasses:
MVAAnnotatedResultSet, MVADualResultSet
public class MVAResultSet
implements java.sql.ResultSet

A ResultSet provides access to a table of data. A ResultSet object is usually generated by executing a Statement.

A ResultSet maintains a cursor pointing to its current row of data. Initially the cursor is positioned before the first row. The 'next' method moves the cursor to the next row.

The getXXX methods retrieve column values for the current row. You can retrieve values either using the index number of the column, or by using the name of the column. In general using the column index will be more efficient. Columns are numbered from 1.

For maximum portability, ResultSet columns within each row should be read in left-to-right order and each column should be read only once.

For the getXXX methods, the JDBC driver attempts to convert the underlying data to the specified Java type and returns a suitable Java value. See the JDBC specification for allowable mappings from SQL types to Java types with the ResultSet.getXXX methods.

Column names used as input to getXXX methods are case insensitive. When performing a getXXX using a column name, if several columns have the same name, then the value of the first matching column will be returned. The column name option is designed to be used when column names are used in the SQL query. For columns that are NOT explicitly named in the query, it is best to use column numbers. If column names were used there is no way for the programmer to guarantee that they actually refer to the intended columns.

A ResultSet is automatically closed by the Statement that generated it when that Statement is closed, re-executed, or is used to retrieve the next result from a sequence of multiple results.

The number, types and properties of a ResultSet's columns are provided by the ResulSetMetaData object returned by the getMetaData method.

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

Field Summary
protected  int _concurrency
           
protected  int _type
           
protected  java.sql.SQLWarning _warnings
           
protected  boolean _wasNull
           
static int CHARACTER
           
static int DATE
           
static int DATETIME
           
protected  int initialFetchSize
           
static int INTEGER
           
protected  int m_columnCount
           
protected  int m_maxRows
           
protected  com.sas.rio.IRowCache m_rowCache
           
protected  MVAStatement m_statement
           
protected static int MAX_FIELD_SIZE
           
static int MAYBE_INTEGER
           
static int NOSUBTYPE
           
static int NUMERIC
           
static int TIME
           
 
Method Summary
 boolean absolute(int rowIndex)
          
 void afterLast()
          
 void beforeFirst()
          JDBC 2.0 Moves to the front of the result set, just before the first row.
 void cancelRowUpdates()
          
 void clearWarnings()
          After this call getWarnings returns null until a new warning is reported for this ResultSet.
 void close()
          Closes the ResultSet.
 void deleteRow()
          
 int findColumn(java.lang.String columnName)
          Maps a Resultset column name to a ResultSet column index.
 boolean first()
          JDBC 2.0 Moves to the first row in the result set.
 java.sql.Array getArray(int i)
          JDBC 2.0 Get an array column.
 java.sql.Array getArray(java.lang.String colName)
          JDBC 2.0 Get an array column.
 java.io.InputStream getAsciiStream(int columnIndex)
          Gets the value of a column in the current row as a Java InputStream.
 java.io.InputStream getAsciiStream(java.lang.String columnName)
          Gets the value of a column in the current row as a Java InputStream.
 java.math.BigDecimal getBigDecimal(int columnIndex)
          
 java.math.BigDecimal getBigDecimal(int columnIndex, int scale)
          Deprecated.  
 java.math.BigDecimal getBigDecimal(java.lang.String columnName)
          
 java.math.BigDecimal getBigDecimal(java.lang.String columnName, int scale)
          Deprecated.  
 java.io.InputStream getBinaryStream(int columnIndex)
          The MVAResultSet implementation of getBinaryStream(int) only supports columns with a SQL type of java.sql.Types.CHAR or java.sql.Types.VARCHAR.
 java.io.InputStream getBinaryStream(java.lang.String columnName)
          Gets the value of a column in the current row as a Java InputStream.
 java.sql.Blob getBlob(int i)
          JDBC 2.0 Get a BLOB column.
 java.sql.Blob getBlob(java.lang.String colName)
          JDBC 2.0 Get a BLOB column.
 boolean getBoolean(int columnIndex)
          Gets the value of a column in the current row as a Java boolean.
 boolean getBoolean(java.lang.String columnName)
          Gets the value of a column in the current row as a Java boolean.
 byte getByte(int columnIndex)
          Gets the value of a column in the current row as a Java byte.
 byte getByte(java.lang.String columnName)
          Gets the value of a column in the current row as a Java byte.
 byte[] getBytes(int columnIndex)
          Gets the value of a column in the current row as a Java byte array.
 byte[] getBytes(java.lang.String columnName)
          Gets the value of a column in the current row as a Java byte array.
protected  com.sas.rio.IRowCache getCache()
           
 java.io.Reader getCharacterStream(int columnIndex)
          JDBC 2.0 Gets the value of a column in the current row as a java.io.Reader.
 java.io.Reader getCharacterStream(int columnIndex, java.lang.String charsetName)
          JDBC 2.0 Proprietary Extension (S0678753) Gets the value of a column in the current row as a java.io.Reader using a specified character set.
 java.io.Reader getCharacterStream(java.lang.String columnName)
          JDBC 2.0 Gets the value of a column in the current row as a java.io.Reader
 java.io.Reader getCharacterStream(java.lang.String columnName, java.lang.String charsetName)
          JDBC 2.0 Proprietary Extension (S0678753) Gets the value of a column in the current row as a java.io.Reader using a specified character set.
 java.sql.Clob getClob(int i)
          JDBC 2.0 Get a CLOB column.
 java.sql.Clob getClob(java.lang.String colName)
          JDBC 2.0 Get a CLOB column.
 int getConcurrency()
          JDBC 2.0 Gets the concurrency of this result set.
 java.lang.String getCursorName()
          Gets the name of the SQL cursor used by this ResultSet.
 java.sql.Date getDate(int columnIndex)
          Gets the value of a column in the current row as a Java java.sql.Date.
 java.sql.Date getDate(int columnIndex, java.util.Calendar cal)
          JDBC 2.0 Gets the value of a column in the current row as a java.sql.Date object.
 java.sql.Date getDate(java.lang.String columnName)
          Gets the value of a column in the current row as a Java java.sql.Date.
 java.sql.Date getDate(java.lang.String columnName, java.util.Calendar cal)
          Gets the value of a column in the current row as a java.sql.Date object.
 double getDouble(int columnIndex)
          Gets the value of a column in the current row as a Java double.
 double getDouble(java.lang.String columnName)
          Gets the value of a column in the current row as a Java double.
 int getFetchDirection()
          The IOM JDBC driver always returns ResultSet.FETCH_FORWARD for the fetch direction, as calls to setFetchDirection(int) are silently ignored.
 int getFetchSize()
          JDBC 2.0 Gets the fetch size.
 float getFloat(int columnIndex)
          Gets the value of a column in the current row as a Java float.
 float getFloat(java.lang.String columnName)
          Gets the value of a column in the current row as a Java float.
 int getHoldability()
          The MVAResultSet version of #getHoldability() always returns ResultSet#CLOSE_CURSORS_AT_COMMIT.
 int getInt(int columnIndex)
          Gets the value of a column in the current row as a Java int.
 int getInt(java.lang.String columnName)
          Gets the value of a column in the current row as a Java int.
 long getLong(int columnIndex)
          Gets the value of a column in the current row as a Java long.
 long getLong(java.lang.String columnName)
          Gets the value of a column in the current row as a Java long.
 java.sql.ResultSetMetaData getMetaData()
          Gets a ResultSetMetaData object that is associated with this ResultSet.
 java.io.Reader getNCharacterStream(int columnIndex)
          Retrieves the value of the designated column in the current row of this ResultSet object as a java.io.Reader object.
 java.io.Reader getNCharacterStream(java.lang.String columnLabel)
          Retrieves the value of the designated column in the current row of this ResultSet object as a java.io.Reader object.
 java.sql.NClob getNClob(int columnIndex)
          Retrieves the value of the designated column in the current row of this ResultSet object as a NClob object in the Java programming language.
 java.sql.NClob getNClob(java.lang.String columnLabel)
          Retrieves the value of the designated column in the current row of this ResultSet object as a NClob object in the Java programming language.
 java.lang.String getNString(int columnIndex)
          Retrieves the value of the designated column in the current row of this ResultSet object as a String in the Java programming language.
 java.lang.String getNString(java.lang.String columnLabel)
          Retrieves the value of the designated column in the current row of this ResultSet object as a String in the Java programming language.
 java.lang.Object getObject(int columnIndex)
          Gets the value of a column in its default Java representation.
 java.lang.Object getObject(int i, java.util.Map<java.lang.String,java.lang.Class<?>> map)
          JDBC 2.0 Returns the value of column i as a Java object.
 java.lang.Object getObject(java.lang.String columnName)
          Gets the value of a column in its default Java representation.
 java.lang.Object getObject(java.lang.String colName, java.util.Map<java.lang.String,java.lang.Class<?>> map)
          JDBC 2.0 Returns the value of column i as a Java object.
 java.sql.Ref getRef(int i)
          JDBC 2.0 Get a REF(<structured-type>) column.
 java.sql.Ref getRef(java.lang.String colName)
          JDBC 2.0 Get a REF(<structured-type>) column.
 int getRow()
          
 java.sql.RowId getRowId(int columnIndex)
          Retrieves the value of the designated column in the current row of this ResultSet object as a java.sql.RowId object in the Java programming language.
 java.sql.RowId getRowId(java.lang.String columnLabel)
          Retrieves the value of the designated column in the current row of this ResultSet object as a java.sql.RowId object in the Java programming language.
 short getShort(int columnIndex)
          Gets the value of a column in the current row as a Java short.
 short getShort(java.lang.String columnName)
          Gets the value of a column in the current row as a Java short.
 java.sql.SQLXML getSQLXML(int columnIndex)
          Retrieves the value of the designated column in the current row of this ResultSet as a java.sql.SQLXML object in the Java programming language.
 java.sql.SQLXML getSQLXML(java.lang.String columnLabel)
          Retrieves the value of the designated column in the current row of this ResultSet as a java.sql.SQLXML object in the Java programming language.
 java.sql.Statement getStatement()
          JDBC 2.0 Return the Statement that produced the ResultSet.
 java.lang.String getString(int columnIndex)
          Gets the value of a column in the current row as a Java String.
 java.lang.String getString(java.lang.String columnName)
          Gets the value of a column in the current row as a Java String.
 java.sql.Time getTime(int columnIndex)
          Gets the value of a column in the current row as a Java java.sql.Time.
 java.sql.Time getTime(int columnIndex, java.util.Calendar cal)
          Gets the value of a column in the current row as a java.sql.Time object.
 java.sql.Time getTime(java.lang.String columnName)
          Gets the value of a column in the current row as a Java java.sql.Time.
 java.sql.Time getTime(java.lang.String columnName, java.util.Calendar cal)
          Gets the value of a column in the current row as a java.sql.Time object.
 java.sql.Timestamp getTimestamp(int columnIndex)
          Gets the value of a column in the current row as a Java java.sql.Timestamp.
 java.sql.Timestamp getTimestamp(int columnIndex, java.util.Calendar cal)
          Gets the value of a column in the current row as a java.sql.Timestamp object.
 java.sql.Timestamp getTimestamp(java.lang.String columnName)
          Gets the value of a column in the current row as a Java java.sql.Timestamp.
 java.sql.Timestamp getTimestamp(java.lang.String columnName, java.util.Calendar cal)
          Gets the value of a column in the current row as a java.sql.Timestamp object.
 int getType()
          JDBC 2.0 Gets the result set type.
 java.io.InputStream getUnicodeStream(int columnIndex)
          The MVAResultSet implementation of getUnicodeStream(int) only supports columns with a SQL type of java.sql.Types.CHAR or java.sql.Types.VARCHAR.
 java.io.InputStream getUnicodeStream(java.lang.String columnName)
          Deprecated.  
 java.net.URL getURL(int columnIndex)
          Retrieves the value of the designated column in the current row of this ResultSet object as a java.net.URL object in the Java programming language.
 java.net.URL getURL(java.lang.String columnName)
          Retrieves the value of the designated column in the current row of this ResultSet object as a java.net.URL object in the Java programming language.
 java.sql.SQLWarning getWarnings()
          Gets the SQLWarnings that are associated with this row.
 void insertRow()
          JDBC 2.0 Insert the contents of the insert row into the result set and the database.
 boolean isAfterLast()
          JDBC 2.0 Determines if the cursor is after the last row in the result set.
 boolean isBeforeFirst()
          JDBC 2.0 Determines if the cursor is before the first row in the result set.
 boolean isClosed()
          Retrieves whether this ResultSet object has been closed.
 boolean isFirst()
          JDBC 2.0 Indicates whether the cursor is on the first row of this ResultSet object.
 boolean isLast()
          
 boolean isWrapperFor(java.lang.Class<?> iface)
          
 boolean last()
          JDBC 2.0 Moves to the last row in the result set.
 void moveToCurrentRow()
          JDBC 2.0 Move the cursor to the remembered cursor position, usually the current row.
 void moveToInsertRow()
          JDBC 2.0 Move to the insert row.
 boolean next()
          Proceeds to the next row in the ResultSet.
 boolean previous()
           
 void refreshRow()
          JDBC 2.0 Refresh the value of the current row with its current value in the database.
 boolean relative(int rows)
          
 boolean rowDeleted()
          JDBC 2.0 Determines if this row has been deleted.
 boolean rowInserted()
          JDBC 2.0 Determines if the current row has been inserted.
 boolean rowUpdated()
          JDBC 2.0 Determine if the current row has been updated.
 void setFetchDirection(int direction)
          The IOM JDBC driver silently ignores the hint to set the fetch direction.
 void setFetchSize(int rows)
          
<T> T
unwrap(java.lang.Class<T> iface)
          
 void updateArray(int columnIndex, java.sql.Array x)
          Updates the designated column with a java.sql.Array value.
 void updateArray(java.lang.String columnName, java.sql.Array x)
          Updates the designated column with a java.sql.Array value.
 void updateAsciiStream(int columnIndex, java.io.InputStream x)
          Updates the designated column with an ascii stream value.
 void updateAsciiStream(int columnIndex, java.io.InputStream x, int length)
          JDBC 2.0 Update a column with an ASCII stream value.
 void updateAsciiStream(int columnIndex, java.io.InputStream x, long length)
          Updates the designated column with an ascii stream value, which will have the specified number of bytes.
 void updateAsciiStream(java.lang.String columnLabel, java.io.InputStream x)
          Updates the designated column with an ascii stream value.
 void updateAsciiStream(java.lang.String columnName, java.io.InputStream x, int length)
          JDBC 2.0 Update a column with an ascii stream value.
 void updateAsciiStream(java.lang.String columnLabel, java.io.InputStream x, long length)
          Updates the designated column with an ascii stream value, which will have the specified number of bytes.
 void updateBigDecimal(int columnIndex, java.math.BigDecimal x)
          JDBC 2.0 Update a column with a BigDecimal value.
 void updateBigDecimal(java.lang.String columnName, java.math.BigDecimal x)
          JDBC 2.0 Update a column with a BigDecimal value.
 void updateBinaryStream(int columnIndex, java.io.InputStream x)
          Updates the designated column with a binary stream value.
 void updateBinaryStream(int columnIndex, java.io.InputStream x, int length)
          JDBC 2.0 Update a column with a binary stream value.
 void updateBinaryStream(int columnIndex, java.io.InputStream x, long length)
          Updates the designated column with a binary stream value, which will have the specified number of bytes.
 void updateBinaryStream(java.lang.String columnLabel, java.io.InputStream x)
          Updates the designated column with a binary stream value.
 void updateBinaryStream(java.lang.String columnName, java.io.InputStream x, int length)
          JDBC 2.0 Update a column with a binary stream value.
 void updateBinaryStream(java.lang.String columnLabel, java.io.InputStream x, long length)
          Updates the designated column with a binary stream value, which will have the specified number of bytes.
 void updateBlob(int columnIndex, java.sql.Blob x)
          Updates the designated column with a java.sql.Blob value.
 void updateBlob(int columnIndex, java.io.InputStream inputStream)
          Updates the designated column using the given input stream.
 void updateBlob(int columnIndex, java.io.InputStream inputStream, long length)
          Updates the designated column using the given input stream, which will have the specified number of bytes.
 void updateBlob(java.lang.String columnName, java.sql.Blob x)
          Updates the designated column with a java.sql.Blob value.
 void updateBlob(java.lang.String columnLabel, java.io.InputStream inputStream)
          Updates the designated column using the given input stream.
 void updateBlob(java.lang.String columnLabel, java.io.InputStream inputStream, long length)
          Updates the designated column using the given input stream, which will have the specified number of bytes.
 void updateBoolean(int columnIndex, boolean x)
          JDBC 2.0 Update a column with a boolean value.
 void updateBoolean(java.lang.String columnName, boolean x)
          JDBC 2.0 Update a column with a boolean value.
 void updateByte(int columnIndex, byte x)
          JDBC 2.0 Update a column with a byte value.
 void updateByte(java.lang.String columnName, byte x)
          JDBC 2.0 Update a column with a byte value.
 void updateBytes(int columnIndex, byte[] x)
          JDBC 2.0 Update a column with a byte array value.
 void updateBytes(java.lang.String columnName, byte[] x)
          JDBC 2.0 Update a column with a byte array value.
 void updateCharacterStream(int columnIndex, java.io.Reader x)
          Updates the designated column with a character stream value.
 void updateCharacterStream(int columnIndex, java.io.Reader x, int length)
          JDBC 2.0 Update a column with a character stream value.
 void updateCharacterStream(int columnIndex, java.io.Reader x, long length)
          Updates the designated column with a character stream value, which will have the specified number of bytes.
 void updateCharacterStream(java.lang.String columnLabel, java.io.Reader reader)
          Updates the designated column with a character stream value.
 void updateCharacterStream(java.lang.String columnName, java.io.Reader reader, int length)
          JDBC 2.0 Update a column with a character stream value.
 void updateCharacterStream(java.lang.String columnLabel, java.io.Reader reader, long length)
          Updates the designated column with a character stream value, which will have the specified number of bytes.
 void updateClob(int columnIndex, java.sql.Clob x)
          Updates the designated column with a java.sql.Clob value.
 void updateClob(int columnIndex, java.io.Reader reader)
          Updates the designated column using the given Reader object.
 void updateClob(int columnIndex, java.io.Reader reader, long length)
          Updates the designated column using the given Reader object, which is the given number of characters long.
 void updateClob(java.lang.String columnName, java.sql.Clob x)
          Updates the designated column with a java.sql.Clob value.
 void updateClob(java.lang.String columnLabel, java.io.Reader reader)
          Updates the designated column using the given Reader object.
 void updateClob(java.lang.String columnLabel, java.io.Reader reader, long length)
          Updates the designated column using the given Reader object, which is the given number of characters long.
 void updateDate(int columnIndex, java.sql.Date x)
          JDBC 2.0 Update a column with a Date value.
 void updateDate(java.lang.String columnName, java.sql.Date x)
          JDBC 2.0 Update a column with a Date value.
 void updateDouble(int columnIndex, double x)
          JDBC 2.0 Update a column with a Double value.
 void updateDouble(java.lang.String columnName, double x)
          JDBC 2.0 Update a column with a double value.
 void updateFloat(int columnIndex, float x)
          JDBC 2.0 Update a column with a float value.
 void updateFloat(java.lang.String columnName, float x)
          JDBC 2.0 Update a column with a float value.
 void updateInt(int columnIndex, int x)
          JDBC 2.0 Update a column with an integer value.
 void updateInt(java.lang.String columnName, int x)
          JDBC 2.0 Update a column with an integer value.
 void updateLong(int columnIndex, long x)
          JDBC 2.0 Update a column with a long value.
 void updateLong(java.lang.String columnName, long x)
          JDBC 2.0 Update a column with a long value.
 void updateNCharacterStream(int columnIndex, java.io.Reader x)
          Updates the designated column with a character stream value.
 void updateNCharacterStream(int columnIndex, java.io.Reader x, long length)
          Updates the designated column with a character stream value, which will have the specified number of bytes.
 void updateNCharacterStream(java.lang.String columnLabel, java.io.Reader reader)
          Updates the designated column with a character stream value.
 void updateNCharacterStream(java.lang.String columnLabel, java.io.Reader reader, long length)
          Updates the designated column with a character stream value, which will have the specified number of bytes.
 void updateNClob(int columnIndex, java.sql.NClob nClob)
          Updates the designated column with a java.sql.NClob value.
 void updateNClob(int columnIndex, java.io.Reader reader)
          Updates the designated column using the given Reader The data will be read from the stream as needed until end-of-stream is reached.
 void updateNClob(int columnIndex, java.io.Reader reader, long length)
          Updates the designated column using the given Reader object, which is the given number of characters long.
 void updateNClob(java.lang.String columnLabel, java.sql.NClob nClob)
          Updates the designated column with a java.sql.NClob value.
 void updateNClob(java.lang.String columnLabel, java.io.Reader reader)
          Updates the designated column using the given Reader object.
 void updateNClob(java.lang.String columnLabel, java.io.Reader reader, long length)
          Updates the designated column using the given Reader object, which is the given number of characters long.
 void updateNString(int columnIndex, java.lang.String nString)
          Updates the designated column with a String value.
 void updateNString(java.lang.String columnLabel, java.lang.String nString)
          Updates the designated column with a String value.
 void updateNull(int columnIndex)
          JDBC 2.0 Give a nullable column a null value.
 void updateNull(java.lang.String columnName)
          JDBC 2.0 Update a column with a null value.
 void updateObject(int columnIndex, java.lang.Object x)
          JDBC 2.0 Update a column with an Object value.
 void updateObject(int columnIndex, java.lang.Object x, int scale)
          JDBC 2.0 Update a column with an Object value.
 void updateObject(java.lang.String columnName, java.lang.Object x)
          JDBC 2.0 Update a column with an Object value.
 void updateObject(java.lang.String columnName, java.lang.Object x, int scale)
          JDBC 2.0 Update a column with an Object value.
 void updateRef(int columnIndex, java.sql.Ref x)
          Updates the designated column with a java.sql.Ref value Empty method implementation for JDK1.4 compliance.
 void updateRef(java.lang.String columnName, java.sql.Ref x)
          Updates the designated column with a java.sql.Ref value Empty method implementation for JDK1.4 compliance.
 void updateRow()
          JDBC 2.0 Update the underlying database with the new contents of the current row.
 void updateRowId(int columnIndex, java.sql.RowId x)
          Updates the designated column with a RowId value.
 void updateRowId(java.lang.String columnLabel, java.sql.RowId x)
          Updates the designated column with a RowId value.
 void updateShort(int columnIndex, short x)
          JDBC 2.0 Update a column with a short value.
 void updateShort(java.lang.String columnName, short x)
          JDBC 2.0 Update a column with a short value.
 void updateSQLXML(int columnIndex, java.sql.SQLXML xmlObject)
          Updates the designated column with a java.sql.SQLXML value.
 void updateSQLXML(java.lang.String columnLabel, java.sql.SQLXML xmlObject)
          Updates the designated column with a java.sql.SQLXML value.
 void updateString(int columnIndex, java.lang.String x)
          JDBC 2.0 Update a column with a String value.
 void updateString(java.lang.String columnName, java.lang.String x)
          JDBC 2.0 Update a column with a String value.
 void updateTime(int columnIndex, java.sql.Time x)
          JDBC 2.0 Update a column with a Time value.
 void updateTime(java.lang.String columnName, java.sql.Time x)
          JDBC 2.0 Update a column with a Time value.
 void updateTimestamp(int columnIndex, java.sql.Timestamp x)
          JDBC 2.0 Update a column with a Timestamp value.
 void updateTimestamp(java.lang.String columnName, java.sql.Timestamp x)
          JDBC 2.0 Update a column with a Timestamp value.
 boolean wasNull()
          The MVAResultSet implementation of wasNull will return true if the last column read contained a numeric SAS missing value.
 

Field Detail

NOSUBTYPE

public static final int NOSUBTYPE
See Also:
Constant Field Values

DATE

public static final int DATE
See Also:
Constant Field Values

TIME

public static final int TIME
See Also:
Constant Field Values

DATETIME

public static final int DATETIME
See Also:
Constant Field Values

INTEGER

public static final int INTEGER
See Also:
Constant Field Values

MAYBE_INTEGER

public static final int MAYBE_INTEGER
See Also:
Constant Field Values

NUMERIC

public static final int NUMERIC
See Also:
Constant Field Values

CHARACTER

public static final int CHARACTER
See Also:
Constant Field Values

MAX_FIELD_SIZE

protected static final int MAX_FIELD_SIZE
See Also:
Constant Field Values

_warnings

protected java.sql.SQLWarning _warnings

_concurrency

protected final int _concurrency

_type

protected final int _type

m_statement

protected final MVAStatement m_statement

m_rowCache

protected com.sas.rio.IRowCache m_rowCache

_wasNull

protected boolean _wasNull

m_columnCount

protected int m_columnCount

m_maxRows

protected int m_maxRows

initialFetchSize

protected int initialFetchSize
Method Detail

absolute

public boolean absolute(int rowIndex)
                 throws java.sql.SQLException

Specified by:
absolute in interface java.sql.ResultSet
Throws:
java.sql.SQLException

relative

public boolean relative(int rows)
                 throws java.sql.SQLException

Specified by:
relative in interface java.sql.ResultSet
Throws:
java.sql.SQLException

beforeFirst

public void beforeFirst()
                 throws java.sql.SQLException
JDBC 2.0 Moves to the front of the result set, just before the first row. Has no effect if the result set contains no rows.

Specified by:
beforeFirst in interface java.sql.ResultSet
Throws:
java.sql.SQLException - This exception is thrown if the result set type is TYPE_FORWARD_ONLY.

afterLast

public void afterLast()
               throws java.sql.SQLException

Specified by:
afterLast in interface java.sql.ResultSet
Throws:
java.sql.SQLException

first

public boolean first()
              throws java.sql.SQLException
JDBC 2.0 Moves to the first row in the result set.

Specified by:
first in interface java.sql.ResultSet
Returns:
True if on a valid row, False if no rows in the result set.
Throws:
java.sql.SQLException - This exception is thrown if a server error is detected or if the result set type is TYPE_FORWARD_ONLY.

last

public boolean last()
             throws java.sql.SQLException
JDBC 2.0 Moves to the last row in the result set.

Specified by:
last in interface java.sql.ResultSet
Returns:
True if on a valid row, False if no rows in the result set.
Throws:
java.sql.SQLException - This exception is thrown if an MvaException is detected or result set type is TYPE_FORWARD_ONLY.

isBeforeFirst

public boolean isBeforeFirst()
                      throws java.sql.SQLException
JDBC 2.0 Determines if the cursor is before the first row in the result set.

Specified by:
isBeforeFirst in interface java.sql.ResultSet
Returns:
True if before the first row, False otherwise. Returns false when the result set contains no rows.
Throws:
java.sql.SQLException - This exception is required by the interface but it is never thrown.

isAfterLast

public boolean isAfterLast()
                    throws java.sql.SQLException
JDBC 2.0 Determines if the cursor is after the last row in the result set. NOTE: Indicates EOF (status flag from last ReadRecords())

Specified by:
isAfterLast in interface java.sql.ResultSet
Returns:
True if after the last row, False otherwise. Returns false when the result set contains no rows.
Throws:
java.sql.SQLException - This exception is required by the interface but it is never thrown.

isFirst

public boolean isFirst()
                throws java.sql.SQLException
JDBC 2.0 Indicates whether the cursor is on the first row of this ResultSet object.

Specified by:
isFirst in interface java.sql.ResultSet
Returns:
boolean - true if cursor in on first row, false if not.
Throws:
java.sql.SQLException - - If a data access error occurs.

isLast

public boolean isLast()
               throws java.sql.SQLException

Specified by:
isLast in interface java.sql.ResultSet
Throws:
java.sql.SQLException

next

public boolean next()
             throws java.sql.SQLException
Proceeds to the next row in the ResultSet.

Specified by:
next in interface java.sql.ResultSet
Returns:
True if the next row is valid and False if not valid.
Throws:
java.sql.SQLException - This exception is thrown if a server error is detected.

previous

public boolean previous()
                 throws java.sql.SQLException
Specified by:
previous in interface java.sql.ResultSet
Throws:
java.sql.SQLException

close

public void close()
           throws java.sql.SQLException
Closes the ResultSet.

Specified by:
close in interface java.sql.ResultSet
Throws:
java.sql.SQLException - This exception is thrown if a server error is detected.

wasNull

public boolean wasNull()
                throws java.sql.SQLException
The MVAResultSet implementation of wasNull will return true if the last column read contained a numeric SAS missing value. In the case where the last column read contained a character SAS missing value false is always returned.

To determine if the value was character missing you can use the SAS SQL "IS [NOT] MISSING extension to the SQL language. Alternatively, you can call String#trim().length() and check for zero length.

Specified by:
wasNull in interface java.sql.ResultSet
Throws:
java.sql.SQLException

getString

public java.lang.String getString(int columnIndex)
                           throws java.sql.SQLException
Gets the value of a column in the current row as a Java String.

Specified by:
getString in interface java.sql.ResultSet
Parameters:
columnIndex - The first column is 1, the second is 2, and so on.
Returns:
The column value. If the value is SQL NULL, the result is null.
Throws:
java.sql.SQLException - This exception is thrown if the column value is not valid.

getBoolean

public boolean getBoolean(int columnIndex)
                   throws java.sql.SQLException
Gets the value of a column in the current row as a Java boolean.

Specified by:
getBoolean in interface java.sql.ResultSet
Parameters:
columnIndex - The first column is 1, the second is 2, and so on.
Returns:
The column value. If the value is SQL NULL, then the result is FALSE.
Throws:
java.sql.SQLException - This exception is thrown if the column value is not valid or the SQL type cannot be converted to a boolean value.

getByte

public byte getByte(int columnIndex)
             throws java.sql.SQLException
Gets the value of a column in the current row as a Java byte.

Specified by:
getByte in interface java.sql.ResultSet
Parameters:
columnIndex - The first column is 1, the second is 2, and so on.
Returns:
The column value. If the value is SQL NULL, then result is 0.
Throws:
java.sql.SQLException - This exception is thrown if the column value is not valid or the SQL type cannot be converted to byte representation.

getShort

public short getShort(int columnIndex)
               throws java.sql.SQLException
Gets the value of a column in the current row as a Java short.

Specified by:
getShort in interface java.sql.ResultSet
Parameters:
columnIndex - The first column is 1, the second is 2, and so on.
Returns:
The column value. If the value is SQL NULL, then result is 0.
Throws:
java.sql.SQLException - This exception is thrown if the column value is not valid or the SQL type cannot be converted to byte representation.

getInt

public int getInt(int columnIndex)
           throws java.sql.SQLException
Gets the value of a column in the current row as a Java int.

Specified by:
getInt in interface java.sql.ResultSet
Parameters:
columnIndex - The first column is 1, the second column is 2, and so on.
Returns:
The column value. If the value is SQL NULL, then the result is 0.
Throws:
java.sql.SQLException - This exception is thrown if the column value is not valid or the SQL type cannot be converted to a valid int value.

getLong

public long getLong(int columnIndex)
             throws java.sql.SQLException
Gets the value of a column in the current row as a Java long.

Specified by:
getLong in interface java.sql.ResultSet
Parameters:
columnIndex - The first column is 1, the second column is 2, and so on.
Returns:
The column value. If the value is SQL NULL, then the result is 0.
Throws:
java.sql.SQLException - This exception is thrown if the column value is not valid or the SQL type cannot be converted to a valid long value.

getFloat

public float getFloat(int columnIndex)
               throws java.sql.SQLException
Gets the value of a column in the current row as a Java float.

Specified by:
getFloat in interface java.sql.ResultSet
Parameters:
columnIndex - The first column is 1, the second column is 2, and so on.
Returns:
The column value. If the value is SQL NULL, then the result is 0.
Throws:
java.sql.SQLException - This exception is thrown if the column value is not valid or the SQL type cannot be converted to a valid float value.

getDouble

public double getDouble(int columnIndex)
                 throws java.sql.SQLException
Gets the value of a column in the current row as a Java double.

Specified by:
getDouble in interface java.sql.ResultSet
Parameters:
columnIndex - The first column is 1, the second column is 2, and so on.
Returns:
The column value. If the value is SQL NULL, then the result is 0.
Throws:
java.sql.SQLException - This exception is thrown if the column value is not valid or the SQL type cannot be converted to a valid double value.

getBigDecimal

@Deprecated
public java.math.BigDecimal getBigDecimal(int columnIndex,
                                                     int scale)
                                   throws java.sql.SQLException
Deprecated. 

Gets the value of a column in the current row as a Java BigDecimal.

Specified by:
getBigDecimal in interface java.sql.ResultSet
Parameters:
columnIndex - The first column is 1, the second column is 2, and so on.
Returns:
The column value. If the value is SQL NULL, then the result is NULL.
Throws:
java.sql.SQLException - This exception is thrown if the column value is not valid or the SQL type cannot be converted to a valid BigDecimal value.

getBytes

public byte[] getBytes(int columnIndex)
                throws java.sql.SQLException
Gets the value of a column in the current row as a Java byte array. This method is not supported.

Specified by:
getBytes in interface java.sql.ResultSet
Throws:
java.sql.SQLException - This exception is always thrown because SAS software does not support conversions to binary representation.

getDate

public java.sql.Date getDate(int columnIndex)
                      throws java.sql.SQLException
Gets the value of a column in the current row as a Java java.sql.Date.

Specified by:
getDate in interface java.sql.ResultSet
Parameters:
columnIndex - The first column is 1, the second column is 2, and so on.
Returns:
The column value. If the value is SQL NULL, then the result is NULL.
Throws:
java.sql.SQLException - This exception is thrown if the column value is not valid or the SQL type cannot be converted to a valid java.sql.Date value.

getTime

public java.sql.Time getTime(int columnIndex)
                      throws java.sql.SQLException
Gets the value of a column in the current row as a Java java.sql.Time.

Specified by:
getTime in interface java.sql.ResultSet
Parameters:
columnIndex - The first column is 1, the second column is 2, and so on.
Returns:
The column value. If the value is SQL NULL, then the result is NULL.
Throws:
java.sql.SQLException - This exception is thrown if the column value is not valid or the SQL type cannot be converted to a valid java.sql.Time value.

getTimestamp

public java.sql.Timestamp getTimestamp(int columnIndex)
                                throws java.sql.SQLException
Gets the value of a column in the current row as a Java java.sql.Timestamp.

Specified by:
getTimestamp in interface java.sql.ResultSet
Parameters:
columnIndex - The first column is 1, the second column is 2, and so on.
Returns:
The column value. If the value is SQL NULL, then the result is NULL.
Throws:
java.sql.SQLException - This exception is thrown if the column value is not valid or the SQL type cannot be converted to a valid java.sql.Timestamp value.

getAsciiStream

public java.io.InputStream getAsciiStream(int columnIndex)
                                   throws java.sql.SQLException
Gets the value of a column in the current row as a Java InputStream.

Specified by:
getAsciiStream in interface java.sql.ResultSet
Parameters:
columnIndex - The first column is 1, the second column is 2, and so on.
Returns:
The column value.
Throws:
java.sql.SQLException - This exception is thrown if the column value is not valid or the SQL type cannot be converted to a valid java.sql.Type.VARCHAR value. SAS software does not support other conversions.

getUnicodeStream

public java.io.InputStream getUnicodeStream(int columnIndex)
                                     throws java.sql.SQLException
The MVAResultSet implementation of getUnicodeStream(int) only supports columns with a SQL type of java.sql.Types.CHAR or java.sql.Types.VARCHAR.

Specified by:
getUnicodeStream in interface java.sql.ResultSet
Throws:
java.sql.SQLException

getBinaryStream

public java.io.InputStream getBinaryStream(int columnIndex)
                                    throws java.sql.SQLException
The MVAResultSet implementation of getBinaryStream(int) only supports columns with a SQL type of java.sql.Types.CHAR or java.sql.Types.VARCHAR.

Specified by:
getBinaryStream in interface java.sql.ResultSet
Throws:
java.sql.SQLException

getString

public java.lang.String getString(java.lang.String columnName)
                           throws java.sql.SQLException
Gets the value of a column in the current row as a Java String.

Specified by:
getString in interface java.sql.ResultSet
Parameters:
columnName - The name of the column that is returned by the ResultSetMetaData object.
Returns:
The column value. If the value is SQL NULL, then the result is NULL.
Throws:
java.sql.SQLException - This exception is thrown if the column value is not valid.

getBoolean

public boolean getBoolean(java.lang.String columnName)
                   throws java.sql.SQLException
Gets the value of a column in the current row as a Java boolean.

Specified by:
getBoolean in interface java.sql.ResultSet
Parameters:
columnName - The name of the column that is returned by the ResultSetMetaData object.
Returns:
The column value. If the value is SQL NULL, then the result is False.
Throws:
java.sql.SQLException - This exception is thrown if the column value is not valid or the SQL type cannot be converted into a boolean value.

getByte

public byte getByte(java.lang.String columnName)
             throws java.sql.SQLException
Gets the value of a column in the current row as a Java byte.

Specified by:
getByte in interface java.sql.ResultSet
Parameters:
columnName - The name of the column that is returned by the ResultSetMetaData object.
Returns:
The column value. If the value is SQL NULL, then the result is 0.
Throws:
java.sql.SQLException - This exception is thrown if the column value is not valid or the SQL type cannot be converted to byte representation.

getShort

public short getShort(java.lang.String columnName)
               throws java.sql.SQLException
Gets the value of a column in the current row as a Java short.

Specified by:
getShort in interface java.sql.ResultSet
Parameters:
columnName - The name of the column that is returned by the ResultSetMetaData object.
Returns:
The column value. If the value is SQL NULL, then the result is 0.
Throws:
java.sql.SQLException - This exception is thrown if the column value is not valid or the SQL type cannot be converted into a valid short value.

getInt

public int getInt(java.lang.String columnName)
           throws java.sql.SQLException
Gets the value of a column in the current row as a Java int.

Specified by:
getInt in interface java.sql.ResultSet
Parameters:
columnName - The name of the column that is returned by the ResultSetMetaData object.
Returns:
The column value. If the value is SQL NULL, then the result is 0.
Throws:
java.sql.SQLException - This exception is thrown if the column value is not valid or the SQL type cannot be converted into a valid int value.

getLong

public long getLong(java.lang.String columnName)
             throws java.sql.SQLException
Gets the value of a column in the current row as a Java long.

Specified by:
getLong in interface java.sql.ResultSet
Parameters:
columnName - The name of the column that is returned by the ResultSetMetaData object.
Returns:
The column value. If the value is SQL NULL, then the result is 0.
Throws:
java.sql.SQLException - This exception is thrown if the column value is not valid or the SQL type cannot be converted into a valid long value.

getFloat

public float getFloat(java.lang.String columnName)
               throws java.sql.SQLException
Gets the value of a column in the current row as a Java float.

Specified by:
getFloat in interface java.sql.ResultSet
Parameters:
columnName - The name of the column that is returned by the ResultSetMetaData object.
Returns:
The column value. If the value is SQL NULL, then the result is 0.
Throws:
java.sql.SQLException - This exception is thrown if the column value is not valid or the SQL type cannot be converted into a valid float value.

getDouble

public double getDouble(java.lang.String columnName)
                 throws java.sql.SQLException
Gets the value of a column in the current row as a Java double.

Specified by:
getDouble in interface java.sql.ResultSet
Parameters:
columnName - The name of the column that is returned by the ResultSetMetaData object.
Returns:
The column value. If the value is SQL NULL, then the result is 0.
Throws:
java.sql.SQLException - This exception is thrown if the column value is not valid or the SQL type cannot be converted into a valid double value.

getBigDecimal

@Deprecated
public java.math.BigDecimal getBigDecimal(java.lang.String columnName,
                                                     int scale)
                                   throws java.sql.SQLException
Deprecated. 

Gets the value of a column in the current row as a Java BigDecimal.

Specified by:
getBigDecimal in interface java.sql.ResultSet
Parameters:
columnName - The name of the column that is returned by the ResultSetMetaData object.
Returns:
The column value. If the value is SQL NULL, then the result is NULL.
Throws:
java.sql.SQLException - This exception is thrown if the column value is not valid or the SQL type cannot be converted into a valid BigDecimal value.

getBytes

public byte[] getBytes(java.lang.String columnName)
                throws java.sql.SQLException
Gets the value of a column in the current row as a Java byte array. This method is not supported.

Specified by:
getBytes in interface java.sql.ResultSet
Throws:
java.sql.SQLException - This exception is always thrown because SAS software does not support conversions to binary representation.

getDate

public java.sql.Date getDate(java.lang.String columnName)
                      throws java.sql.SQLException
Gets the value of a column in the current row as a Java java.sql.Date.

Specified by:
getDate in interface java.sql.ResultSet
Parameters:
columnName - The name of the column that is returned by the ResultSetMetaData object.
Returns:
The column value. If the value is SQL NULL, then the result is NULL.
Throws:
java.sql.SQLException - This exception is thrown if the column value is not valid or the SQL type cannot be converted into a valid java.sql.Date value.

getTime

public java.sql.Time getTime(java.lang.String columnName)
                      throws java.sql.SQLException
Gets the value of a column in the current row as a Java java.sql.Time.

Specified by:
getTime in interface java.sql.ResultSet
Parameters:
columnName - The name of the column that is returned by the ResultSetMetaData object.
Returns:
The column value. If the value is SQL NULL, then the result is NULL.
Throws:
java.sql.SQLException - This exception is thrown if the column value is not valid or the SQL type cannot be converted into a valid java.sql.Time value.

getTimestamp

public java.sql.Timestamp getTimestamp(java.lang.String columnName)
                                throws java.sql.SQLException
Gets the value of a column in the current row as a Java java.sql.Timestamp.

Specified by:
getTimestamp in interface java.sql.ResultSet
Parameters:
columnName - The name of the column that is returned by the ResultSetMetaData object.
Returns:
The column value. If the value is SQL NULL, then the result is NULL.
Throws:
java.sql.SQLException - This exception is thrown if the column value is not valid or the SQL type cannot be converted into a valid java.sql.Timestamp value.

getAsciiStream

public java.io.InputStream getAsciiStream(java.lang.String columnName)
                                   throws java.sql.SQLException
Gets the value of a column in the current row as a Java InputStream.

Specified by:
getAsciiStream in interface java.sql.ResultSet
Parameters:
columnName - The name of the column that is returned by the ResultSetMetaData object.
Returns:
The column value.
Throws:
java.sql.SQLException - This exception is thrown if the column value is not valid or the value is not java.sql.Type.VARCHAR. No other conversions are supported.

getUnicodeStream

@Deprecated
public java.io.InputStream getUnicodeStream(java.lang.String columnName)
                                     throws java.sql.SQLException
Deprecated. 

Gets the value of a column in the current row as a Java InputStream.

Specified by:
getUnicodeStream in interface java.sql.ResultSet
Parameters:
columnName - The name of the column that is returned by the ResultSetMetaData object.
Returns:
The column value.
Throws:
java.sql.SQLException - This exception is thrown if the column value is not valid or the value is not java.sql.Type.VARCHAR. No other conversions are supported.

getBinaryStream

public java.io.InputStream getBinaryStream(java.lang.String columnName)
                                    throws java.sql.SQLException
Gets the value of a column in the current row as a Java InputStream.

Specified by:
getBinaryStream in interface java.sql.ResultSet
Parameters:
columnName - The name of the column that is returned by the ResultSetMetaData object.
Returns:
The column value. If the value is SQL NULL, then the result is NULL.
Throws:
java.sql.SQLException - This exception is thrown if the column value is not valid or the value is not java.sql.Type.VARCHAR. No other conversions are supported.

getWarnings

public java.sql.SQLWarning getWarnings()
                                throws java.sql.SQLException
Gets the SQLWarnings that are associated with this row.

Specified by:
getWarnings in interface java.sql.ResultSet
Returns:
SQLWarning. All warnings for the current row.
Throws:
java.sql.SQLException - This exception is required by the interface, but it is never thrown.

clearWarnings

public void clearWarnings()
                   throws java.sql.SQLException
After this call getWarnings returns null until a new warning is reported for this ResultSet.

Specified by:
clearWarnings in interface java.sql.ResultSet
Throws:
java.sql.SQLException - This exception is required by the interface, but it is never thrown.

getCursorName

public java.lang.String getCursorName()
                               throws java.sql.SQLException
Gets the name of the SQL cursor used by this ResultSet.

Specified by:
getCursorName in interface java.sql.ResultSet
Returns:
the ResultSet's SQL cursor name
Throws:
java.sql.SQLException - if a database-access error occurs.

getMetaData

public java.sql.ResultSetMetaData getMetaData()
                                       throws java.sql.SQLException
Gets a ResultSetMetaData object that is associated with this ResultSet.

Specified by:
getMetaData in interface java.sql.ResultSet
Returns:
A MVAResultSetMetaData object.
Throws:
java.sql.SQLException - This exception is thrown if an error condition is detected.

getObject

public java.lang.Object getObject(int columnIndex)
                           throws java.sql.SQLException
Gets the value of a column in its default Java representation.

Specified by:
getObject in interface java.sql.ResultSet
Parameters:
columnIndex - The first column is 1, the second column is 2, and so on.
Returns:
The column value as an Object. If the value is SQL NULL, then the result is NULL.
Throws:
java.sql.SQLException - This exception is thrown if the column index is not valid.

getObject

public java.lang.Object getObject(java.lang.String columnName)
                           throws java.sql.SQLException
Gets the value of a column in its default Java representation.

Specified by:
getObject in interface java.sql.ResultSet
Parameters:
columnName - The name of the column.
Returns:
The column value as an Object. If the value is SQL NULL, then the result is NULL.
Throws:
java.sql.SQLException - This exception is thrown if the column index is not valid.

findColumn

public int findColumn(java.lang.String columnName)
               throws java.sql.SQLException
Maps a Resultset column name to a ResultSet column index.

Specified by:
findColumn in interface java.sql.ResultSet
Parameters:
columnName - The name of the column.
Returns:
The column index.
Throws:
java.sql.SQLException - This exception is thrown if the column name is not valid.

getCharacterStream

public java.io.Reader getCharacterStream(int columnIndex)
                                  throws java.sql.SQLException
JDBC 2.0 Gets the value of a column in the current row as a java.io.Reader.

Specified by:
getCharacterStream in interface java.sql.ResultSet
Parameters:
columnIndex - The first column is 1, the second column is 2, and so on.
Returns:
A java.io.Reader Object. If the value is SQL NULL, then the result is NULL.
Throws:
java.sql.SQLException - This exception is thrown if the column index is not valid.

getCharacterStream

public java.io.Reader getCharacterStream(int columnIndex,
                                         java.lang.String charsetName)
                                  throws java.sql.SQLException
JDBC 2.0 Proprietary Extension (S0678753) Gets the value of a column in the current row as a java.io.Reader using a specified character set.

Parameters:
columnIndex - The first column is 1, the second column is 2, and so on.
charsetName - The name of a supported charset
Returns:
A java.io.Reader Object. If the value is SQL NULL, then the result is NULL.
Throws:
java.sql.SQLException - This exception is thrown if the column index or type, or file encoding is not valid.

getCharacterStream

public java.io.Reader getCharacterStream(java.lang.String columnName,
                                         java.lang.String charsetName)
                                  throws java.sql.SQLException
JDBC 2.0 Proprietary Extension (S0678753) Gets the value of a column in the current row as a java.io.Reader using a specified character set.

Parameters:
columnName - The name of the column.
charsetName - The name of a supported charset
Returns:
A java.io.Reader Object. If the value is SQL NULL, then the result is NULL.
Throws:
java.sql.SQLException - This exception is thrown if the column index is not valid.

getCharacterStream

public java.io.Reader getCharacterStream(java.lang.String columnName)
                                  throws java.sql.SQLException
JDBC 2.0 Gets the value of a column in the current row as a java.io.Reader

Specified by:
getCharacterStream in interface java.sql.ResultSet
Parameters:
columnName - The name of the column.
Returns:
A java.io.Reader Object. If the value is SQL NULL, then the result is NULL.
Throws:
java.sql.SQLException - This exception is thrown if the column index is not valid.

getBigDecimal

public java.math.BigDecimal getBigDecimal(int columnIndex)
                                   throws java.sql.SQLException

Specified by:
getBigDecimal in interface java.sql.ResultSet
Throws:
java.sql.SQLException

getBigDecimal

public java.math.BigDecimal getBigDecimal(java.lang.String columnName)
                                   throws java.sql.SQLException

Specified by:
getBigDecimal in interface java.sql.ResultSet
Throws:
java.sql.SQLException

getRow

public int getRow()
           throws java.sql.SQLException

Specified by:
getRow in interface java.sql.ResultSet
Throws:
java.sql.SQLException

setFetchDirection

public void setFetchDirection(int direction)
                       throws java.sql.SQLException
The IOM JDBC driver silently ignores the hint to set the fetch direction.

Specified by:
setFetchDirection in interface java.sql.ResultSet
Throws:
java.sql.SQLException

getFetchDirection

public int getFetchDirection()
                      throws java.sql.SQLException
The IOM JDBC driver always returns ResultSet.FETCH_FORWARD for the fetch direction, as calls to setFetchDirection(int) are silently ignored.

Specified by:
getFetchDirection in interface java.sql.ResultSet
Throws:
java.sql.SQLException

setFetchSize

public void setFetchSize(int rows)
                  throws java.sql.SQLException

Specified by:
setFetchSize in interface java.sql.ResultSet
Throws:
java.sql.SQLException

getFetchSize

public int getFetchSize()
                 throws java.sql.SQLException
JDBC 2.0 Gets the fetch size.

Specified by:
getFetchSize in interface java.sql.ResultSet
Returns:
An integer value indicating the number of rows fetched for this result set.
Throws:
java.sql.SQLException - This exception is required by the interface but it is never thrown.

getType

public int getType()
            throws java.sql.SQLException
JDBC 2.0 Gets the result set type. The type is determined based on the statement that created the result set.

Specified by:
getType in interface java.sql.ResultSet
Returns:
The result set type, TYPE_SCROLL_INSENSITIVE or TYPE_FORWARD_ONLY based on the Statement object.
Throws:
java.sql.SQLException - This exception is required by the interface but it is never thrown.

getConcurrency

public int getConcurrency()
                   throws java.sql.SQLException
JDBC 2.0 Gets the concurrency of this result set. The concurrency used is determined by the statement that created the result set.

Specified by:
getConcurrency in interface java.sql.ResultSet
Returns:
The concurrency type, CONCUR_UPDATABLE or CONCUR_READ_ONLY based on the Statement object.
Throws:
java.sql.SQLException - This exception is required by the interface but it is never thrown.

rowUpdated

public boolean rowUpdated()
                   throws java.sql.SQLException
JDBC 2.0 Determine if the current row has been updated. This method is not supported.

Specified by:
rowUpdated in interface java.sql.ResultSet
Throws:
java.sql.SQLException - This exception is always thrown because SAS software does not detect row updated.
See Also:
MVADatabaseMetaData.updatesAreDetected(int)

rowInserted

public boolean rowInserted()
                    throws java.sql.SQLException
JDBC 2.0 Determines if the current row has been inserted. This method is not supported.

Specified by:
rowInserted in interface java.sql.ResultSet
Throws:
java.sql.SQLException - This exception is always thrown because SAS software does not detect row inserts.
See Also:
MVADatabaseMetaData.insertsAreDetected(int)

rowDeleted

public boolean rowDeleted()
                   throws java.sql.SQLException
JDBC 2.0 Determines if this row has been deleted. This method is not supported.

Specified by:
rowDeleted in interface java.sql.ResultSet
Throws:
java.sql.SQLException - This exception is always thrown because SAS software does not detect row deletes.
See Also:
MVADatabaseMetaData.deletesAreDetected(int)

updateNull

public void updateNull(int columnIndex)
                throws java.sql.SQLException
JDBC 2.0 Give a nullable column a null value.

Specified by:
updateNull in interface java.sql.ResultSet
Parameters:
columnIndex - the first column is 1, the second is 2, ...
Throws:
java.sql.SQLException - This exception is thrown if the column index is not valid.

updateBoolean

public void updateBoolean(int columnIndex,
                          boolean x)
                   throws java.sql.SQLException
JDBC 2.0 Update a column with a boolean value. The updateXXX() methods are used to update column values in the current row, or the insert row. The updateXXX() methods do not update the underlying database, instead the updateRow() or insertRow() methods are called to update the database.

Specified by:
updateBoolean in interface java.sql.ResultSet
Parameters:
columnIndex - the first column is 1, the second is 2, ...
x - the new column value
Throws:
java.sql.SQLException - This exception is thrown if the column index is not valid.

updateByte

public void updateByte(int columnIndex,
                       byte x)
                throws java.sql.SQLException
JDBC 2.0 Update a column with a byte value. The updateXXX() methods are used to update column values in the current row, or the insert row. The updateXXX() methods do not update the underlying database, instead the updateRow() or insertRow() methods are called to update the database.

Specified by:
updateByte in interface java.sql.ResultSet
Parameters:
columnIndex - the first column is 1, the second is 2, ...
x - the new column value
Throws:
java.sql.SQLException - This exception is thrown if the column index is not valid.

updateShort

public void updateShort(int columnIndex,
                        short x)
                 throws java.sql.SQLException
JDBC 2.0 Update a column with a short value. The updateXXX() methods are used to update column values in the current row, or the insert row. The updateXXX() methods do not update the underlying database, instead the updateRow() or insertRow() methods are called to update the database.

Specified by:
updateShort in interface java.sql.ResultSet
Parameters:
columnIndex - the first column is 1, the second is 2, ...
x - the new column value
Throws:
java.sql.SQLException - This exception is thrown if the column index is not valid.

updateInt

public void updateInt(int columnIndex,
                      int x)
               throws java.sql.SQLException
JDBC 2.0 Update a column with an integer value. The updateXXX() methods are used to update column values in the current row, or the insert row. The updateXXX() methods do not update the underlying database, instead the updateRow() or insertRow() methods are called to update the database.

Specified by:
updateInt in interface java.sql.ResultSet
Parameters:
columnIndex - the first column is 1, the second is 2, ...
x - the new column value
Throws:
java.sql.SQLException - This exception is thrown if the column index is not valid.

updateLong

public void updateLong(int columnIndex,
                       long x)
                throws java.sql.SQLException
JDBC 2.0 Update a column with a long value. Method not yet supported. The updateXXX() methods are used to update column values in the current row, or the insert row. The updateXXX() methods do not update the underlying database, instead the updateRow() or insertRow() methods are called to update the database.

Specified by:
updateLong in interface java.sql.ResultSet
Parameters:
columnIndex - the first column is 1, the second is 2, ...
x - the new column value
Throws:
java.sql.SQLException - This exception is always thrown.

updateFloat

public void updateFloat(int columnIndex,
                        float x)
                 throws java.sql.SQLException
JDBC 2.0 Update a column with a float value. The updateXXX() methods are used to update column values in the current row, or the insert row. The updateXXX() methods do not update the underlying database, instead the updateRow() or insertRow() methods are called to update the database.

Specified by:
updateFloat in interface java.sql.ResultSet
Parameters:
columnIndex - the first column is 1, the second is 2, ...
x - the new column value
Throws:
java.sql.SQLException - This exception is thrown if the column index is not valid.

updateDouble

public void updateDouble(int columnIndex,
                         double x)
                  throws java.sql.SQLException
JDBC 2.0 Update a column with a Double value. The updateXXX() methods are used to update column values in the current row, or the insert row. The updateXXX() methods do not update the underlying database, instead the updateRow() or insertRow() methods are called to update the database.

Specified by:
updateDouble in interface java.sql.ResultSet
Parameters:
columnIndex - the first column is 1, the second is 2, ...
x - the new column value
Throws:
java.sql.SQLException - This exception is thrown if the column index is not valid.

updateBigDecimal

public void updateBigDecimal(int columnIndex,
                             java.math.BigDecimal x)
                      throws java.sql.SQLException
JDBC 2.0 Update a column with a BigDecimal value. The updateXXX() methods are used to update column values in the current row, or the insert row. The updateXXX() methods do not update the underlying database, instead the updateRow() or insertRow() methods are called to update the database.

Specified by:
updateBigDecimal in interface java.sql.ResultSet
Parameters:
columnIndex - the first column is 1, the second is 2, ...
x - the new column value
Throws:
java.sql.SQLException - This exception is thrown if the column index is not valid.

updateString

public void updateString(int columnIndex,
                         java.lang.String x)
                  throws java.sql.SQLException
JDBC 2.0 Update a column with a String value. The updateXXX() methods are used to update column values in the current row, or the insert row. The updateXXX() methods do not update the underlying database, instead the updateRow() or insertRow() methods are called to update the database.

Specified by:
updateString in interface java.sql.ResultSet
Parameters:
columnIndex - the first column is 1, the second is 2, ...
x - the new column value
Throws:
java.sql.SQLException - This exception is thrown if the column index is not valid.

updateBytes

public void updateBytes(int columnIndex,
                        byte[] x)
                 throws java.sql.SQLException
JDBC 2.0 Update a column with a byte array value. The updateXXX() methods are used to update column values in the current row, or the insert row. The updateXXX() methods do not update the underlying database, instead the updateRow() or insertRow() methods are called to update the database.

Specified by:
updateBytes in interface java.sql.ResultSet
Parameters:
columnIndex - the first column is 1, the second is 2, ...
x - the new column value
Throws:
java.sql.SQLException - This exception is thrown if the column index is not valid.

updateDate

public void updateDate(int columnIndex,
                       java.sql.Date x)
                throws java.sql.SQLException
JDBC 2.0 Update a column with a Date value. The updateXXX() methods are used to update column values in the current row, or the insert row. The updateXXX() methods do not update the underlying database, instead the updateRow() or insertRow() methods are called to update the database.

Specified by:
updateDate in interface java.sql.ResultSet
Parameters:
columnIndex - the first column is 1, the second is 2, ...
x - the new column value
Throws:
java.sql.SQLException - This exception is thrown if the column index is not valid.

updateTime

public void updateTime(int columnIndex,
                       java.sql.Time x)
                throws java.sql.SQLException
JDBC 2.0 Update a column with a Time value. The updateXXX() methods are used to update column values in the current row, or the insert row. The updateXXX() methods do not update the underlying database, instead the updateRow() or insertRow() methods are called to update the database.

Specified by:
updateTime in interface java.sql.ResultSet
Parameters:
columnIndex - the first column is 1, the second is 2, ...
x - the new column value
Throws:
java.sql.SQLException - This exception is thrown if the column index is not valid.

updateTimestamp

public void updateTimestamp(int columnIndex,
                            java.sql.Timestamp x)
                     throws java.sql.SQLException
JDBC 2.0 Update a column with a Timestamp value. The updateXXX() methods are used to update column values in the current row, or the insert row. The updateXXX() methods do not update the underlying database, instead the updateRow() or insertRow() methods are called to update the database.

Specified by:
updateTimestamp in interface java.sql.ResultSet
Parameters:
columnIndex - the first column is 1, the second is 2, ...
x - the new column value
Throws:
java.sql.SQLException - This exception is thrown if the column index is not valid.

updateAsciiStream

public void updateAsciiStream(int columnIndex,
                              java.io.InputStream x,
                              int length)
                       throws java.sql.SQLException
JDBC 2.0 Update a column with an ASCII stream value. The updateXXX() methods are used to update column values in the current row, or the insert row. The updateXXX() methods do not update the underlying database, instead the updateRow() or insertRow() methods are called to update the database.

Specified by:
updateAsciiStream in interface java.sql.ResultSet
Parameters:
columnIndex - the first column is 1, the second is 2, ...
x - the new column value
length - the length of the stream
Throws:
java.sql.SQLException - This exception is thrown if the column index is not valid.

updateBinaryStream

public void updateBinaryStream(int columnIndex,
                               java.io.InputStream x,
                               int length)
                        throws java.sql.SQLException
JDBC 2.0 Update a column with a binary stream value. The updateXXX() methods are used to update column values in the current row, or the insert row. The updateXXX() methods do not update the underlying database, instead the updateRow() or insertRow() methods are called to update the database.

Specified by:
updateBinaryStream in interface java.sql.ResultSet
Parameters:
columnIndex - the first column is 1, the second is 2, ...
x - the new column value
length - the length of the stream
Throws:
java.sql.SQLException - This exception is thrown if the column index is not valid.

updateCharacterStream

public void updateCharacterStream(int columnIndex,
                                  java.io.Reader x,
                                  int length)
                           throws java.sql.SQLException
JDBC 2.0 Update a column with a character stream value. The updateXXX() methods are used to update column values in the current row, or the insert row. The updateXXX() methods do not update the underlying database, instead the updateRow() or insertRow() methods are called to update the database.

Specified by:
updateCharacterStream in interface java.sql.ResultSet
Parameters:
columnIndex - the first column is 1, the second is 2, ...
x - the new column value
length - the length of the stream
Throws:
java.sql.SQLException - This exception is thrown if the column index is not valid.

updateObject

public void updateObject(int columnIndex,
                         java.lang.Object x,
                         int scale)
                  throws java.sql.SQLException
JDBC 2.0 Update a column with an Object value. The updateXXX() methods are used to update column values in the current row, or the insert row. The updateXXX() methods do not update the underlying database, instead the updateRow() or insertRow() methods are called to update the database.

Specified by:
updateObject in interface java.sql.ResultSet
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 will be ignored.
Throws:
java.sql.SQLException - This exception is thrown if the column index is not valid.

updateObject

public void updateObject(int columnIndex,
                         java.lang.Object x)
                  throws java.sql.SQLException
JDBC 2.0 Update a column with an Object value. The updateXXX() methods are used to update column values in the current row, or the insert row. The updateXXX() methods do not update the underlying database, instead the updateRow() or insertRow() methods are called to update the database.

Specified by:
updateObject in interface java.sql.ResultSet
Parameters:
columnIndex - the first column is 1, the second is 2, ...
x - the new column value
Throws:
java.sql.SQLException - This exception is thrown if the column index is not valid.

updateNull

public void updateNull(java.lang.String columnName)
                throws java.sql.SQLException
JDBC 2.0 Update a column with a null value. The updateXXX() methods are used to update column values in the current row, or the insert row. The updateXXX() methods do not update the underlying database, instead the updateRow() or insertRow() methods are called to update the database.

Specified by:
updateNull in interface java.sql.ResultSet
Parameters:
columnName - the name of the column
Throws:
java.sql.SQLException - if a database-access error occurs

updateBoolean

public void updateBoolean(java.lang.String columnName,
                          boolean x)
                   throws java.sql.SQLException
JDBC 2.0 Update a column with a boolean value. The updateXXX() methods are used to update column values in the current row, or the insert row. The updateXXX() methods do not update the underlying database, instead the updateRow() or insertRow() methods are called to update the database.

Specified by:
updateBoolean in interface java.sql.ResultSet
Parameters:
columnName - the name of the column
x - the new column value
Throws:
java.sql.SQLException - if a database-access error occurs

updateByte

public void updateByte(java.lang.String columnName,
                       byte x)
                throws java.sql.SQLException
JDBC 2.0 Update a column with a byte value. The updateXXX() methods are used to update column values in the current row, or the insert row. The updateXXX() methods do not update the underlying database, instead the updateRow() or insertRow() methods are called to update the database.

Specified by:
updateByte in interface java.sql.ResultSet
Parameters:
columnName - the name of the column
x - the new column value
Throws:
java.sql.SQLException - if a database-access error occurs

updateShort

public void updateShort(java.lang.String columnName,
                        short x)
                 throws java.sql.SQLException
JDBC 2.0 Update a column with a short value. The updateXXX() methods are used to update column values in the current row, or the insert row. The updateXXX() methods do not update the underlying database, instead the updateRow() or insertRow() methods are called to update the database.

Specified by:
updateShort in interface java.sql.ResultSet
Parameters:
columnName - the name of the column
x - the new column value
Throws:
java.sql.SQLException - if a database-access error occurs

updateInt

public void updateInt(java.lang.String columnName,
                      int x)
               throws java.sql.SQLException
JDBC 2.0 Update a column with an integer value. The updateXXX() methods are used to update column values in the current row, or the insert row. The updateXXX() methods do not update the underlying database, instead the updateRow() or insertRow() methods are called to update the database.

Specified by:
updateInt in interface java.sql.ResultSet
Parameters:
columnName - the name of the column
x - the new column value
Throws:
java.sql.SQLException - if a database-access error occurs

updateLong

public void updateLong(java.lang.String columnName,
                       long x)
                throws java.sql.SQLException
JDBC 2.0 Update a column with a long value. The updateXXX() methods are used to update column values in the current row, or the insert row. The updateXXX() methods do not update the underlying database, instead the updateRow() or insertRow() methods are called to update the database.

Specified by:
updateLong in interface java.sql.ResultSet
Parameters:
columnName - the name of the column
x - the new column value
Throws:
java.sql.SQLException - if a database-access error occurs

updateFloat

public void updateFloat(java.lang.String columnName,
                        float x)
                 throws java.sql.SQLException
JDBC 2.0 Update a column with a float value. The updateXXX() methods are used to update column values in the current row, or the insert row. The updateXXX() methods do not update the underlying database, instead the updateRow() or insertRow() methods are called to update the database.

Specified by:
updateFloat in interface java.sql.ResultSet
Parameters:
columnName - the name of the column
x - the new column value
Throws:
java.sql.SQLException - if a database-access error occurs

updateDouble

public void updateDouble(java.lang.String columnName,
                         double x)
                  throws java.sql.SQLException
JDBC 2.0 Update a column with a double value. The updateXXX() methods are used to update column values in the current row, or the insert row. The updateXXX() methods do not update the underlying database, instead the updateRow() or insertRow() methods are called to update the database.

Specified by:
updateDouble in interface java.sql.ResultSet
Parameters:
columnName - the name of the column
x - the new column value
Throws:
java.sql.SQLException - if a database-access error occurs

updateBigDecimal

public void updateBigDecimal(java.lang.String columnName,
                             java.math.BigDecimal x)
                      throws java.sql.SQLException
JDBC 2.0 Update a column with a BigDecimal value. The updateXXX() methods are used to update column values in the current row, or the insert row. The updateXXX() methods do not update the underlying database, instead the updateRow() or insertRow() methods are called to update the database.

Specified by:
updateBigDecimal in interface java.sql.ResultSet
Parameters:
columnName - the name of the column
x - the new column value
Throws:
java.sql.SQLException - if a database-access error occurs

updateString

public void updateString(java.lang.String columnName,
                         java.lang.String x)
                  throws java.sql.SQLException
JDBC 2.0 Update a column with a String value. The updateXXX() methods are used to update column values in the current row, or the insert row. The updateXXX() methods do not update the underlying database, instead the updateRow() or insertRow() methods are called to update the database.

Specified by:
updateString in interface java.sql.ResultSet
Parameters:
columnName - the name of the column
x - the new column value
Throws:
java.sql.SQLException - if a database-access error occurs

updateBytes

public void updateBytes(java.lang.String columnName,
                        byte[] x)
                 throws java.sql.SQLException
JDBC 2.0 Update a column with a byte array value. The updateXXX() methods are used to update column values in the current row, or the insert row. The updateXXX() methods do not update the underlying database, instead the updateRow() or insertRow() methods are called to update the database.

Specified by:
updateBytes in interface java.sql.ResultSet
Parameters:
columnName - the name of the column
x - the new column value
Throws:
java.sql.SQLException - if a database-access error occurs

updateDate

public void updateDate(java.lang.String columnName,
                       java.sql.Date x)
                throws java.sql.SQLException
JDBC 2.0 Update a column with a Date value. The updateXXX() methods are used to update column values in the current row, or the insert row. The updateXXX() methods do not update the underlying database, instead the updateRow() or insertRow() methods are called to update the database.

Specified by:
updateDate in interface java.sql.ResultSet
Parameters:
columnName - the name of the column
x - the new column value
Throws:
java.sql.SQLException - if a database-access error occurs

updateTime

public void updateTime(java.lang.String columnName,
                       java.sql.Time x)
                throws java.sql.SQLException
JDBC 2.0 Update a column with a Time value. The updateXXX() methods are used to update column values in the current row, or the insert row. The updateXXX() methods do not update the underlying database, instead the updateRow() or insertRow() methods are called to update the database.

Specified by:
updateTime in interface java.sql.ResultSet
Parameters:
columnName - the name of the column
x - the new column value
Throws:
java.sql.SQLException - if a database-access error occurs

updateTimestamp

public void updateTimestamp(java.lang.String columnName,
                            java.sql.Timestamp x)
                     throws java.sql.SQLException
JDBC 2.0 Update a column with a Timestamp value. The updateXXX() methods are used to update column values in the current row, or the insert row. The updateXXX() methods do not update the underlying database, instead the updateRow() or insertRow() methods are called to update the database.

Specified by:
updateTimestamp in interface java.sql.ResultSet
Parameters:
columnName - the name of the column
x - the new column value
Throws:
java.sql.SQLException - if a database-access error occurs

updateAsciiStream

public void updateAsciiStream(java.lang.String columnName,
                              java.io.InputStream x,
                              int length)
                       throws java.sql.SQLException
JDBC 2.0 Update a column with an ascii stream value. The updateXXX() methods are used to update column values in the current row, or the insert row. The updateXXX() methods do not update the underlying database, instead the updateRow() or insertRow() methods are called to update the database.

Specified by:
updateAsciiStream in interface java.sql.ResultSet
Parameters:
columnName - the name of the column
x - the new column value
length - of the stream
Throws:
java.sql.SQLException - if a database-access error occurs

updateBinaryStream

public void updateBinaryStream(java.lang.String columnName,
                               java.io.InputStream x,
                               int length)
                        throws java.sql.SQLException
JDBC 2.0 Update a column with a binary stream value. The updateXXX() methods are used to update column values in the current row, or the insert row. The updateXXX() methods do not update the underlying database, instead the updateRow() or insertRow() methods are called to update the database.

Specified by:
updateBinaryStream in interface java.sql.ResultSet
Parameters:
columnName - the name of the column
x - the new column value
length - of the stream
Throws:
java.sql.SQLException - if a database-access error occurs

updateCharacterStream

public void updateCharacterStream(java.lang.String columnName,
                                  java.io.Reader reader,
                                  int length)
                           throws java.sql.SQLException
JDBC 2.0 Update a column with a character stream value. The updateXXX() methods are used to update column values in the current row, or the insert row. The updateXXX() methods do not update the underlying database, instead the updateRow() or insertRow() methods are called to update the database.

Specified by:
updateCharacterStream in interface java.sql.ResultSet
Parameters:
columnName - the name of the column
reader - the new column value
length - of the stream
Throws:
java.sql.SQLException - if a database-access error occurs

updateObject

public void updateObject(java.lang.String columnName,
                         java.lang.Object x,
                         int scale)
                  throws java.sql.SQLException
JDBC 2.0 Update a column with an Object value. The updateXXX() methods are used to update column values in the current row, or the insert row. The updateXXX() methods do not update the underlying database, instead the updateRow() or insertRow() methods are called to update the database.

Specified by:
updateObject in interface java.sql.ResultSet
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 will be ignored.
Throws:
java.sql.SQLException - if a database-access error occurs

updateObject

public void updateObject(java.lang.String columnName,
                         java.lang.Object x)
                  throws java.sql.SQLException
JDBC 2.0 Update a column with an Object value. The updateXXX() methods are used to update column values in the current row, or the insert row. The updateXXX() methods do not update the underlying database, instead the updateRow() or insertRow() methods are called to update the database.

Specified by:
updateObject in interface java.sql.ResultSet
Parameters:
columnName - the name of the column
x - the new column value
Throws:
java.sql.SQLException - if a database-access error occurs

insertRow

public void insertRow()
               throws java.sql.SQLException
JDBC 2.0 Insert the contents of the insert row into the result set and the database. Must be on the insert row when this method is called. NOTE: SAS software does not support inserts, though inserts might be implemented as append.

Specified by:
insertRow in interface java.sql.ResultSet
Throws:
java.sql.SQLException - This exception is always thrown. This function is available only on ResultSets generated from MVAStatement.getTable()

updateRow

public void updateRow()
               throws java.sql.SQLException
JDBC 2.0 Update the underlying database with the new contents of the current row. Cannot be called when on the insert row.

Specified by:
updateRow in interface java.sql.ResultSet
Throws:
java.sql.SQLException - if a database-access error occurs, or if called when on the insert row This function is available only on ResultSets generated from MVAStatement.getTable()

deleteRow

public void deleteRow()
               throws java.sql.SQLException

Specified by:
deleteRow in interface java.sql.ResultSet
Throws:
java.sql.SQLException

refreshRow

public void refreshRow()
                throws java.sql.SQLException
JDBC 2.0 Refresh the value of the current row with its current value in the database. Cannot be called when on the insert row. The refreshRow() method provides a way for an application to explicitly tell the JDBC driver to refetch a row(s) from the database. An application may want to call refreshRow() when caching or prefetching is being done by the JDBC driver to fetch the latest value of a row from the database. The JDBC driver may actually refresh multiple rows at once if the fetch size is greater than one. All values are refetched subject to the transaction isolation level and cursor sensitivity. If refreshRow() is called after calling updateXXX(), but before calling updateRow() then the updates made to the row are lost. Calling refreshRow() frequently will likely slow performance.

Specified by:
refreshRow in interface java.sql.ResultSet
Throws:
java.sql.SQLException - This exception is thrown if an MvaException is detected.

cancelRowUpdates

public void cancelRowUpdates()
                      throws java.sql.SQLException

Specified by:
cancelRowUpdates in interface java.sql.ResultSet
Throws:
java.sql.SQLException

moveToInsertRow

public void moveToInsertRow()
                     throws java.sql.SQLException
JDBC 2.0 Move to the insert row. The current cursor position is remembered while the cursor is positioned on the insert row. The insert row is a special row associated with an updatable result set. It is essentially a buffer where a new row may be constructed by calling the updateXXX() methods prior to inserting the row into the result set. Only the updateXXX(), getXXX(), and insertRow() methods may be called when the cursor is on the insert row. All of the columns in a result set must be given a value each time this method is called before calling insertRow(). UpdateXXX()must be called before getXXX() on a column. NOTE: SAS software does not support inserts, though inserts might be implemented as append.

Specified by:
moveToInsertRow in interface java.sql.ResultSet
Throws:
java.sql.SQLException - This exception is always thrown.

moveToCurrentRow

public void moveToCurrentRow()
                      throws java.sql.SQLException
JDBC 2.0 Move the cursor to the remembered cursor position, usually the current row. Has no effect unless the cursor is on the insert row.

Specified by:
moveToCurrentRow in interface java.sql.ResultSet
Throws:
java.sql.SQLException - if a database-access error occurs, or the result set is not updatable

getStatement

public java.sql.Statement getStatement()
                                throws java.sql.SQLException
JDBC 2.0 Return the Statement that produced the ResultSet.

Specified by:
getStatement in interface java.sql.ResultSet
Returns:
the Statement that produced the result set, or null if the result was produced some other way.
Throws:
java.sql.SQLException - if a database-access error occurs

getObject

public java.lang.Object getObject(int i,
                                  java.util.Map<java.lang.String,java.lang.Class<?>> map)
                           throws java.sql.SQLException
JDBC 2.0 Returns the value of column i as a Java object. Use the map to determine the class from which to construct data of SQL structured and distinct types.

Specified by:
getObject in interface java.sql.ResultSet
Parameters:
i - the first column is 1, the second is 2, ...
map - the mapping from SQL type names to Java classes
Returns:
an object representing the SQL value
Throws:
java.sql.SQLException

getRef

public java.sql.Ref getRef(int i)
                    throws java.sql.SQLException
JDBC 2.0 Get a REF(<structured-type>) column.

Specified by:
getRef in interface java.sql.ResultSet
Parameters:
i - the first column is 1, the second is 2, ...
Returns:
an object representing data of an SQL REF type
Throws:
java.sql.SQLException

getBlob

public java.sql.Blob getBlob(int i)
                      throws java.sql.SQLException
JDBC 2.0 Get a BLOB column.

Specified by:
getBlob in interface java.sql.ResultSet
Parameters:
i - the first column is 1, the second is 2, ...
Returns:
an object representing a BLOB
Throws:
java.sql.SQLException

getClob

public java.sql.Clob getClob(int i)
                      throws java.sql.SQLException
JDBC 2.0 Get a CLOB column.

Specified by:
getClob in interface java.sql.ResultSet
Parameters:
i - the first column is 1, the second is 2, ...
Returns:
an object representing a CLOB
Throws:
java.sql.SQLException

getArray

public java.sql.Array getArray(int i)
                        throws java.sql.SQLException
JDBC 2.0 Get an array column.

Specified by:
getArray in interface java.sql.ResultSet
Parameters:
i - the first column is 1, the second is 2, ...
Returns:
an object representing an SQL array
Throws:
java.sql.SQLException

getObject

public java.lang.Object getObject(java.lang.String colName,
                                  java.util.Map<java.lang.String,java.lang.Class<?>> map)
                           throws java.sql.SQLException
JDBC 2.0 Returns the value of column i as a Java object. Use the map to determine the class from which to construct data of SQL structured and distinct types.

Specified by:
getObject in interface java.sql.ResultSet
Parameters:
colName - the column name
map - the mapping from SQL type names to Java classes
Returns:
an object representing the SQL value
Throws:
java.sql.SQLException

getRef

public java.sql.Ref getRef(java.lang.String colName)
                    throws java.sql.SQLException
JDBC 2.0 Get a REF(<structured-type>) column.

Specified by:
getRef in interface java.sql.ResultSet
Parameters:
colName - the column name
Returns:
an object representing data of an SQL REF type
Throws:
java.sql.SQLException

getBlob

public java.sql.Blob getBlob(java.lang.String colName)
                      throws java.sql.SQLException
JDBC 2.0 Get a BLOB column.

Specified by:
getBlob in interface java.sql.ResultSet
Parameters:
colName - the column name
Returns:
an object representing a BLOB
Throws:
java.sql.SQLException

getClob

public java.sql.Clob getClob(java.lang.String colName)
                      throws java.sql.SQLException
JDBC 2.0 Get a CLOB column.

Specified by:
getClob in interface java.sql.ResultSet
Parameters:
colName - the column name
Returns:
an object representing a CLOB
Throws:
java.sql.SQLException

getArray

public java.sql.Array getArray(java.lang.String colName)
                        throws java.sql.SQLException
JDBC 2.0 Get an array column.

Specified by:
getArray in interface java.sql.ResultSet
Parameters:
colName - the column name
Returns:
an object representing an SQL array
Throws:
java.sql.SQLException

getDate

public java.sql.Date getDate(int columnIndex,
                             java.util.Calendar cal)
                      throws java.sql.SQLException
JDBC 2.0 Gets the value of a column in the current row as a java.sql.Date object. Use the calendar to construct an appropriate millisecond value for the Date, if the underlying database doesn't store timezone information.

Specified by:
getDate in interface java.sql.ResultSet
Parameters:
columnIndex - The first column is 1, the second is 2, and so on.
cal - The calendar to use in constructing the date. Ignored if cal is NULL.
Returns:
The column value. If the value is SQL NULL, then the result is null.
Throws:
java.sql.SQLException - This exception is thrown if the column value is not valid or the SQL type cannot be converted to a valid java.sql.Date value.

getDate

public java.sql.Date getDate(java.lang.String columnName,
                             java.util.Calendar cal)
                      throws java.sql.SQLException
Gets the value of a column in the current row as a java.sql.Date object. Use the calendar to construct an appropriate millisecond value for the Date, if the underlying database doesn't store timezone information.

Specified by:
getDate in interface java.sql.ResultSet
Parameters:
columnName - The name of the column that is returned by the ResultSetMetaData object.
cal - The calendar to use in constructing the date. Ignored if cal is NULL.
Returns:
The column value. If the value is SQL NULL, then the result is NULL.
Throws:
java.sql.SQLException - This exception is thrown if the column value is not valid or the SQL type cannot be converted into a valid java.sql.Date value.

getTime

public java.sql.Time getTime(int columnIndex,
                             java.util.Calendar cal)
                      throws java.sql.SQLException
Gets the value of a column in the current row as a java.sql.Time object. Use the calendar to construct an appropriate millisecond value for the Time, if the underlying database doesn't store timezone information.

Specified by:
getTime in interface java.sql.ResultSet
Parameters:
columnIndex - The first column is 1, the second is 2, and so on.
cal - The calendar to use in constructing the date. Ignored if cal is NULL.
Returns:
The column value. If the value is SQL NULL, then the result is null.
Throws:
java.sql.SQLException - This exception is thrown if the column value is not valid or the SQL type cannot be converted to a valid java.sql.Time value.

getTime

public java.sql.Time getTime(java.lang.String columnName,
                             java.util.Calendar cal)
                      throws java.sql.SQLException
Gets the value of a column in the current row as a java.sql.Time object. Use the calendar to construct an appropriate millisecond value for the Time, if the underlying database doesn't store timezone information.

Specified by:
getTime in interface java.sql.ResultSet
Parameters:
columnName - The name of the column that is returned by the ResultSetMetaData object.
cal - The calendar to use in constructing the date. Ignored if cal is NULL.
Returns:
The column value. If the value is SQL NULL, then the result is NULL.
Throws:
java.sql.SQLException - This exception is thrown if the column value is not valid or the SQL type cannot be converted into a valid java.sql.Time value.

getTimestamp

public java.sql.Timestamp getTimestamp(int columnIndex,
                                       java.util.Calendar cal)
                                throws java.sql.SQLException
Gets the value of a column in the current row as a java.sql.Timestamp object. Use the calendar to construct an appropriate millisecond value for the Timestamp, if the underlying database doesn't store timezone information.

Specified by:
getTimestamp in interface java.sql.ResultSet
Parameters:
columnIndex - The first column is 1, the second is 2, and so on.
cal - The calendar to use in constructing the date. Ignored if cal is NULL.
Returns:
The column value. If the value is SQL NULL, then the result is null.
Throws:
java.sql.SQLException - This exception is thrown if the column value is not valid or the SQL type cannot be converted to a valid java.sql.Timestamp value.

getTimestamp

public java.sql.Timestamp getTimestamp(java.lang.String columnName,
                                       java.util.Calendar cal)
                                throws java.sql.SQLException
Gets the value of a column in the current row as a java.sql.Timestamp object. Use the calendar to construct an appropriate millisecond value for the Timestamp, if the underlying database doesn't store timezone information.

Specified by:
getTimestamp in interface java.sql.ResultSet
Parameters:
columnName - The name of the column that is returned by the ResultSetMetaData object.
cal - The calendar to use in constructing the date. Ignored if cal is NULL.
Returns:
The column value. If the value is SQL NULL, then the result is NULL.
Throws:
java.sql.SQLException - This exception is thrown if the column value is not valid or the SQL type cannot be converted into a valid java.sql.Timestamp value.

getCache

protected com.sas.rio.IRowCache getCache()

getURL

public java.net.URL getURL(int columnIndex)
                    throws java.sql.SQLException
Retrieves the value of the designated column in the current row of this ResultSet object as a java.net.URL object in the Java programming language. Empty method implementation for JDK1.4 compliance.

Specified by:
getURL in interface java.sql.ResultSet
Throws:
java.sql.SQLException - Always thrown, to indicate that this method is not implemented.

getURL

public java.net.URL getURL(java.lang.String columnName)
                    throws java.sql.SQLException
Retrieves the value of the designated column in the current row of this ResultSet object as a java.net.URL object in the Java programming language. Empty method implementation for JDK1.4 compliance.

Specified by:
getURL in interface java.sql.ResultSet
Throws:
java.sql.SQLException - Always thrown, to indicate that this method is not implemented.

updateArray

public void updateArray(int columnIndex,
                        java.sql.Array x)
                 throws java.sql.SQLException
Updates the designated column with a java.sql.Array value. Empty method implementation for JDK1.4 compliance.

Specified by:
updateArray in interface java.sql.ResultSet
Throws:
java.sql.SQLException - Always thrown, to indicate that this method is not implemented.

updateArray

public void updateArray(java.lang.String columnName,
                        java.sql.Array x)
                 throws java.sql.SQLException
Updates the designated column with a java.sql.Array value. Empty method implementation for JDK1.4 compliance.

Specified by:
updateArray in interface java.sql.ResultSet
Throws:
java.sql.SQLException - Always thrown, to indicate that this method is not implemented.

updateBlob

public void updateBlob(int columnIndex,
                       java.sql.Blob x)
                throws java.sql.SQLException
Updates the designated column with a java.sql.Blob value. Empty method implementation for JDK1.4 compliance.

Specified by:
updateBlob in interface java.sql.ResultSet
Throws:
java.sql.SQLException - Always thrown, to indicate that this method is not implemented.

updateBlob

public void updateBlob(java.lang.String columnName,
                       java.sql.Blob x)
                throws java.sql.SQLException
Updates the designated column with a java.sql.Blob value. Empty method implementation for JDK1.4 compliance.

Specified by:
updateBlob in interface java.sql.ResultSet
Throws:
java.sql.SQLException - Always thrown, to indicate that this method is not implemented.

updateClob

public void updateClob(int columnIndex,
                       java.sql.Clob x)
                throws java.sql.SQLException
Updates the designated column with a java.sql.Clob value. Empty method implementation for JDK1.4 compliance.

Specified by:
updateClob in interface java.sql.ResultSet
Throws:
java.sql.SQLException - Always thrown, to indicate that this method is not implemented.

updateClob

public void updateClob(java.lang.String columnName,
                       java.sql.Clob x)
                throws java.sql.SQLException
Updates the designated column with a java.sql.Clob value. Empty method implementation for JDK1.4 compliance.

Specified by:
updateClob in interface java.sql.ResultSet
Throws:
java.sql.SQLException - Always thrown, to indicate that this method is not implemented.

updateRef

public void updateRef(int columnIndex,
                      java.sql.Ref x)
               throws java.sql.SQLException
Updates the designated column with a java.sql.Ref value Empty method implementation for JDK1.4 compliance.

Specified by:
updateRef in interface java.sql.ResultSet
Throws:
java.sql.SQLException - Always thrown, to indicate that this method is not implemented.

updateRef

public void updateRef(java.lang.String columnName,
                      java.sql.Ref x)
               throws java.sql.SQLException
Updates the designated column with a java.sql.Ref value Empty method implementation for JDK1.4 compliance.

Specified by:
updateRef in interface java.sql.ResultSet
Throws:
java.sql.SQLException - Always thrown, to indicate that this method is not implemented.

getRowId

public java.sql.RowId getRowId(int columnIndex)
                        throws java.sql.SQLException
Retrieves the value of the designated column in the current row of this ResultSet object as a java.sql.RowId object in the Java programming language.

Specified by:
getRowId in interface java.sql.ResultSet
Parameters:
columnIndex - the first column is 1, the second 2, ...

Throws:
java.sql.SQLException - Always thrown, to indicate that this method is not implemented.

Since:
1.6

getRowId

public java.sql.RowId getRowId(java.lang.String columnLabel)
                        throws java.sql.SQLException
Retrieves the value of the designated column in the current row of this ResultSet object as a java.sql.RowId object in the Java programming language.

Specified by:
getRowId in interface java.sql.ResultSet
Parameters:
columnLabel - the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the label is the name of the column

Throws:
java.sql.SQLException - Always thrown, to indicate that this method is not implemented.

Since:
1.6

updateRowId

public void updateRowId(int columnIndex,
                        java.sql.RowId x)
                 throws java.sql.SQLException
Updates the designated column with a RowId value. The updater methods are used to update column values in the current row or the insert row. The updater methods do not update the underlying database; instead the updateRow or insertRow methods are called to update the database.

Specified by:
updateRowId in interface java.sql.ResultSet
Parameters:
columnIndex - the first column is 1, the second 2, ...
x - the column value

Throws:
java.sql.SQLException - Always thrown, to indicate that this method is not implemented.

Since:
1.6

updateRowId

public void updateRowId(java.lang.String columnLabel,
                        java.sql.RowId x)
                 throws java.sql.SQLException
Updates the designated column with a RowId value. The updater methods are used to update column values in the current row or the insert row. The updater methods do not update the underlying database; instead the updateRow or insertRow methods are called to update the database.

Specified by:
updateRowId in interface java.sql.ResultSet
Parameters:
columnLabel - the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the label is the name of the column
x - the column value

Throws:
java.sql.SQLException - Always thrown, to indicate that this method is not implemented.

Since:
1.6

getHoldability

public int getHoldability()
                   throws java.sql.SQLException
The MVAResultSet version of #getHoldability() always returns ResultSet#CLOSE_CURSORS_AT_COMMIT. Transactions are not supported by the IOM JDBC driver.

Specified by:
getHoldability in interface java.sql.ResultSet
Throws:
java.sql.SQLException

isClosed

public boolean isClosed()
                 throws java.sql.SQLException
Retrieves whether this ResultSet object has been closed. A ResultSet is closed if the method close has been called on it, or if it is automatically closed.

Specified by:
isClosed in interface java.sql.ResultSet
Throws:
java.sql.SQLException - Always thrown, to indicate that this method is not implemented.

Since:
1.6

updateNString

public void updateNString(int columnIndex,
                          java.lang.String nString)
                   throws java.sql.SQLException
Updates the designated column with a String value. It is intended for use when updating NCHAR,NVARCHAR and LONGNVARCHAR columns. The updater methods are used to update column values in the current row or the insert row. The updater methods do not update the underlying database; instead the updateRow or insertRow methods are called to update the database.

Specified by:
updateNString in interface java.sql.ResultSet
Parameters:
columnIndex - the first column is 1, the second 2, ...
nString - the value for the column to be updated

Throws:
java.sql.SQLException - Always thrown, to indicate that this method is not implemented.

Since:
1.6

updateNString

public void updateNString(java.lang.String columnLabel,
                          java.lang.String nString)
                   throws java.sql.SQLException
Updates the designated column with a String value. It is intended for use when updating NCHAR,NVARCHAR and LONGNVARCHAR columns. The updater methods are used to update column values in the current row or the insert row. The updater methods do not update the underlying database; instead the updateRow or insertRow methods are called to update the database.

Specified by:
updateNString in interface java.sql.ResultSet
Parameters:
columnLabel - the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the label is the name of the column
nString - the value for the column to be updated

Throws:
java.sql.SQLException - Always thrown, to indicate that this method is not implemented.

Since:
1.6

updateNClob

public void updateNClob(int columnIndex,
                        java.sql.NClob nClob)
                 throws java.sql.SQLException
Updates the designated column with a java.sql.NClob value. The updater methods are used to update column values in the current row or the insert row. The updater methods do not update the underlying database; instead the updateRow or insertRow methods are called to update the database.

Specified by:
updateNClob in interface java.sql.ResultSet
Parameters:
columnIndex - the first column is 1, the second 2, ...
nClob - the value for the column to be updated

Throws:
java.sql.SQLException - Always thrown, to indicate that this method is not implemented.

Since:
1.6

updateNClob

public void updateNClob(java.lang.String columnLabel,
                        java.sql.NClob nClob)
                 throws java.sql.SQLException
Updates the designated column with a java.sql.NClob value. The updater methods are used to update column values in the current row or the insert row. The updater methods do not update the underlying database; instead the updateRow or insertRow methods are called to update the database.

Specified by:
updateNClob in interface java.sql.ResultSet
Parameters:
columnLabel - the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the label is the name of the column
nClob - the value for the column to be updated

Throws:
java.sql.SQLException - Always thrown, to indicate that this method is not implemented.

Since:
1.6

getNClob

public java.sql.NClob getNClob(int columnIndex)
                        throws java.sql.SQLException
Retrieves the value of the designated column in the current row of this ResultSet object as a NClob object in the Java programming language.

Specified by:
getNClob in interface java.sql.ResultSet
Parameters:
columnIndex - the first column is 1, the second is 2, ...

Throws:
java.sql.SQLException - Always thrown, to indicate that this method is not implemented.

Since:
1.6

getNClob

public java.sql.NClob getNClob(java.lang.String columnLabel)
                        throws java.sql.SQLException
Retrieves the value of the designated column in the current row of this ResultSet object as a NClob object in the Java programming language.

Specified by:
getNClob in interface java.sql.ResultSet
Parameters:
columnLabel - the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the label is the name of the column

Throws:
java.sql.SQLException - Always thrown, to indicate that this method is not implemented.

Since:
1.6

getSQLXML

public java.sql.SQLXML getSQLXML(int columnIndex)
                          throws java.sql.SQLException
Retrieves the value of the designated column in the current row of this ResultSet as a java.sql.SQLXML object in the Java programming language.

Specified by:
getSQLXML in interface java.sql.ResultSet
Parameters:
columnIndex - the first column is 1, the second is 2, ...

Throws:
java.sql.SQLException - Always thrown, to indicate that this method is not implemented.

Since:
1.6

getSQLXML

public java.sql.SQLXML getSQLXML(java.lang.String columnLabel)
                          throws java.sql.SQLException
Retrieves the value of the designated column in the current row of this ResultSet as a java.sql.SQLXML object in the Java programming language.

Specified by:
getSQLXML in interface java.sql.ResultSet
Parameters:
columnLabel - the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the label is the name of the column

Throws:
java.sql.SQLException - Always thrown, to indicate that this method is not implemented.

Since:
1.6

updateSQLXML

public void updateSQLXML(int columnIndex,
                         java.sql.SQLXML xmlObject)
                  throws java.sql.SQLException
Updates the designated column with a java.sql.SQLXML value. The updater methods are used to update column values in the current row or the insert row. The updater methods do not update the underlying database; instead the updateRow or insertRow methods are called to update the database.

Specified by:
updateSQLXML in interface java.sql.ResultSet
Parameters:
columnIndex - the first column is 1, the second 2, ...
xmlObject - the value for the column to be updated

Throws:
java.sql.SQLException - Always thrown, to indicate that this method is not implemented.

Since:
1.6

updateSQLXML

public void updateSQLXML(java.lang.String columnLabel,
                         java.sql.SQLXML xmlObject)
                  throws java.sql.SQLException
Updates the designated column with a java.sql.SQLXML value. The updater methods are used to update column values in the current row or the insert row. The updater methods do not update the underlying database; instead the updateRow or insertRow methods are called to update the database.

Specified by:
updateSQLXML in interface java.sql.ResultSet
Parameters:
columnLabel - the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the label is the name of the column
xmlObject - the column value

Throws:
java.sql.SQLException - Always thrown, to indicate that this method is not implemented.

Since:
1.6

getNString

public java.lang.String getNString(int columnIndex)
                            throws java.sql.SQLException
Retrieves the value of the designated column in the current row of this ResultSet object as a String in the Java programming language. It is intended for use when accessing NCHAR,NVARCHAR and LONGNVARCHAR columns.

Specified by:
getNString in interface java.sql.ResultSet
Parameters:
columnIndex - the first column is 1, the second is 2, ...
Returns:
the column value; if the value is SQL NULL, the value returned is null

Throws:
java.sql.SQLException - Always thrown, to indicate that this method is not implemented.

Since:
1.6

getNString

public java.lang.String getNString(java.lang.String columnLabel)
                            throws java.sql.SQLException
Retrieves the value of the designated column in the current row of this ResultSet object as a String in the Java programming language. It is intended for use when accessing NCHAR,NVARCHAR and LONGNVARCHAR columns.

Specified by:
getNString in interface java.sql.ResultSet
Parameters:
columnLabel - the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the label is the name of the column
Returns:
the column value; if the value is SQL NULL, the value returned is null

Throws:
java.sql.SQLException - Always thrown, to indicate that this method is not implemented.

Since:
1.6

getNCharacterStream

public java.io.Reader getNCharacterStream(int columnIndex)
                                   throws java.sql.SQLException
Retrieves the value of the designated column in the current row of this ResultSet object as a java.io.Reader object. It is intended for use when accessing NCHAR, NVARCHAR and LONGNVARCHAR columns.

Specified by:
getNCharacterStream in interface java.sql.ResultSet
Parameters:
columnIndex - the first column is 1, the second is 2, ...

Returns:
a java.io.Reader object that contains the column value; if the value is SQL NULL, the value returned is null in the Java programming language.
Throws:
java.sql.SQLException - Always thrown, to indicate that this method is not implemented.

Since:
1.6

getNCharacterStream

public java.io.Reader getNCharacterStream(java.lang.String columnLabel)
                                   throws java.sql.SQLException
Retrieves the value of the designated column in the current row of this ResultSet object as a java.io.Reader object. It is intended for use when accessing NCHAR, NVARCHAR and LONGNVARCHAR columns.

Specified by:
getNCharacterStream in interface java.sql.ResultSet
Parameters:
columnLabel - the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the label is the name of the column
Returns:
a java.io.Reader object that contains the column value; if the value is SQL NULL, the value returned is null in the Java programming language

Throws:
java.sql.SQLException - Always thrown, to indicate that this method is not implemented.

Since:
1.6

updateNCharacterStream

public void updateNCharacterStream(int columnIndex,
                                   java.io.Reader x,
                                   long length)
                            throws java.sql.SQLException
Updates the designated column with a character stream value, which will have the specified number of bytes. The driver does the necessary conversion from Java character format to the national character set in the database. It is intended for use when updating NCHAR, NVARCHAR and LONGNVARCHAR columns.

The updater methods are used to update column values in the current row or the insert row. The updater methods do not update the underlying database; instead the updateRow or insertRow methods are called to update the database.

Specified by:
updateNCharacterStream in interface java.sql.ResultSet
Parameters:
columnIndex - the first column is 1, the second is 2, ...
x - the new column value
length - the length of the stream

Throws:
java.sql.SQLException - Always thrown, to indicate that this method is not implemented.

Since:
1.6

updateNCharacterStream

public void updateNCharacterStream(java.lang.String columnLabel,
                                   java.io.Reader reader,
                                   long length)
                            throws java.sql.SQLException
Updates the designated column with a character stream value, which will have the specified number of bytes. The driver does the necessary conversion from Java character format to the national character set in the database. It is intended for use when updating NCHAR, NVARCHAR and LONGNVARCHAR columns.

The updater methods are used to update column values in the current row or the insert row. The updater methods do not update the underlying database; instead the updateRow or insertRow methods are called to update the database.

Specified by:
updateNCharacterStream in interface java.sql.ResultSet
Parameters:
columnLabel - the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the label is the name of the column.
reader - the java.io.Reader object containing the new column value
length - the length of the stream

Throws:
java.sql.SQLException - Always thrown, to indicate that this method is not implemented.

Since:
1.6

updateAsciiStream

public void updateAsciiStream(int columnIndex,
                              java.io.InputStream x,
                              long length)
                       throws java.sql.SQLException
Updates the designated column with an ascii stream value, which will have the specified number of bytes.

The updater methods are used to update column values in the current row or the insert row. The updater methods do not update the underlying database; instead the updateRow or insertRow methods are called to update the database.

Specified by:
updateAsciiStream in interface java.sql.ResultSet
Parameters:
columnIndex - the first column is 1, the second is 2, ...
x - the new column value
length - the length of the stream

Throws:
java.sql.SQLException - Always thrown, to indicate that this method is not implemented.

Since:
1.6

updateBinaryStream

public void updateBinaryStream(int columnIndex,
                               java.io.InputStream x,
                               long length)
                        throws java.sql.SQLException
Updates the designated column with a binary stream value, which will have the specified number of bytes.

The updater methods are used to update column values in the current row or the insert row. The updater methods do not update the underlying database; instead the updateRow or insertRow methods are called to update the database.

Specified by:
updateBinaryStream in interface java.sql.ResultSet
Parameters:
columnIndex - the first column is 1, the second is 2, ...
x - the new column value
length - the length of the stream

Throws:
java.sql.SQLException - Always thrown, to indicate that this method is not implemented.

Since:
1.6

updateCharacterStream

public void updateCharacterStream(int columnIndex,
                                  java.io.Reader x,
                                  long length)
                           throws java.sql.SQLException
Updates the designated column with a character stream value, which will have the specified number of bytes.

The updater methods are used to update column values in the current row or the insert row. The updater methods do not update the underlying database; instead the updateRow or insertRow methods are called to update the database.

Specified by:
updateCharacterStream in interface java.sql.ResultSet
Parameters:
columnIndex - the first column is 1, the second is 2, ...
x - the new column value
length - the length of the stream

Throws:
java.sql.SQLException - Always thrown, to indicate that this method is not implemented.

Since:
1.6

updateAsciiStream

public void updateAsciiStream(java.lang.String columnLabel,
                              java.io.InputStream x,
                              long length)
                       throws java.sql.SQLException
Updates the designated column with an ascii stream value, which will have the specified number of bytes.

The updater methods are used to update column values in the current row or the insert row. The updater methods do not update the underlying database; instead the updateRow or insertRow methods are called to update the database.

Specified by:
updateAsciiStream in interface java.sql.ResultSet
Parameters:
columnLabel - the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the label is the name of the column
x - the new column value
length - the length of the stream

Throws:
java.sql.SQLException - Always thrown, to indicate that this method is not implemented.

Since:
1.6

updateBinaryStream

public void updateBinaryStream(java.lang.String columnLabel,
                               java.io.InputStream x,
                               long length)
                        throws java.sql.SQLException
Updates the designated column with a binary stream value, which will have the specified number of bytes.

The updater methods are used to update column values in the current row or the insert row. The updater methods do not update the underlying database; instead the updateRow or insertRow methods are called to update the database.

Specified by:
updateBinaryStream in interface java.sql.ResultSet
Parameters:
columnLabel - the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the label is the name of the column
x - the new column value
length - the length of the stream

Throws:
java.sql.SQLException - Always thrown, to indicate that this method is not implemented.

Since:
1.6

updateCharacterStream

public void updateCharacterStream(java.lang.String columnLabel,
                                  java.io.Reader reader,
                                  long length)
                           throws java.sql.SQLException
Updates the designated column with a character stream value, which will have the specified number of bytes.

The updater methods are used to update column values in the current row or the insert row. The updater methods do not update the underlying database; instead the updateRow or insertRow methods are called to update the database.

Specified by:
updateCharacterStream in interface java.sql.ResultSet
Parameters:
columnLabel - the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the label is the name of the column
reader - the java.io.Reader object containing the new column value
length - the length of the stream

Throws:
java.sql.SQLException - Always thrown, to indicate that this method is not implemented.

Since:
1.6

updateBlob

public void updateBlob(int columnIndex,
                       java.io.InputStream inputStream,
                       long length)
                throws java.sql.SQLException
Updates the designated column using the given input stream, which will have the specified number of bytes.

The updater methods are used to update column values in the current row or the insert row. The updater methods do not update the underlying database; instead the updateRow or insertRow methods are called to update the database.

Specified by:
updateBlob in interface java.sql.ResultSet
Parameters:
columnIndex - the first column is 1, the second is 2, ...
inputStream - An object that contains the data to set the parameter value to.
length - the number of bytes in the parameter data.

Throws:
java.sql.SQLException - Always thrown, to indicate that this method is not implemented.

Since:
1.6

updateBlob

public void updateBlob(java.lang.String columnLabel,
                       java.io.InputStream inputStream,
                       long length)
                throws java.sql.SQLException
Updates the designated column using the given input stream, which will have the specified number of bytes.

The updater methods are used to update column values in the current row or the insert row. The updater methods do not update the underlying database; instead the updateRow or insertRow methods are called to update the database.

Specified by:
updateBlob in interface java.sql.ResultSet
Parameters:
columnLabel - the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the label is the name of the column
inputStream - An object that contains the data to set the parameter value to.
length - the number of bytes in the parameter data.

Throws:
java.sql.SQLException - Always thrown, to indicate that this method is not implemented.

Since:
1.6

updateClob

public void updateClob(int columnIndex,
                       java.io.Reader reader,
                       long length)
                throws java.sql.SQLException
Updates the designated column using the given Reader object, which is the given number of characters long. When a very large UNICODE value is input to a LONGVARCHAR parameter, it may be more practical to send it via a java.io.Reader object. The JDBC driver will do any necessary conversion from UNICODE to the database char format.

The updater methods are used to update column values in the current row or the insert row. The updater methods do not update the underlying database; instead the updateRow or insertRow methods are called to update the database.

Specified by:
updateClob in interface java.sql.ResultSet
Parameters:
columnIndex - the first column is 1, the second is 2, ...
reader - An object that contains the data to set the parameter value to.
length - the number of characters in the parameter data.

Throws:
java.sql.SQLException - Always thrown, to indicate that this method is not implemented.

Since:
1.6

updateClob

public void updateClob(java.lang.String columnLabel,
                       java.io.Reader reader,
                       long length)
                throws java.sql.SQLException
Updates the designated column using the given Reader object, which is the given number of characters long. When a very large UNICODE value is input to a LONGVARCHAR parameter, it may be more practical to send it via a java.io.Reader object. The JDBC driver will do any necessary conversion from UNICODE to the database char format.

The updater methods are used to update column values in the current row or the insert row. The updater methods do not update the underlying database; instead the updateRow or insertRow methods are called to update the database.

Specified by:
updateClob in interface java.sql.ResultSet
Parameters:
columnLabel - the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the label is the name of the column
reader - An object that contains the data to set the parameter value to.
length - the number of characters in the parameter data.

Throws:
java.sql.SQLException - Always thrown, to indicate that this method is not implemented.

Since:
1.6

updateNClob

public void updateNClob(int columnIndex,
                        java.io.Reader reader,
                        long length)
                 throws java.sql.SQLException
Updates the designated column using the given Reader object, which is the given number of characters long. When a very large UNICODE value is input to a LONGVARCHAR parameter, it may be more practical to send it via a java.io.Reader object. The JDBC driver will do any necessary conversion from UNICODE to the database char format.

The updater methods are used to update column values in the current row or the insert row. The updater methods do not update the underlying database; instead the updateRow or insertRow methods are called to update the database.

Specified by:
updateNClob in interface java.sql.ResultSet
Parameters:
columnIndex - the first column is 1, the second 2, ...
reader - An object that contains the data to set the parameter value to.
length - the number of characters in the parameter data.

Throws:
java.sql.SQLException - Always thrown, to indicate that this method is not implemented.

Since:
1.6

updateNClob

public void updateNClob(java.lang.String columnLabel,
                        java.io.Reader reader,
                        long length)
                 throws java.sql.SQLException
Updates the designated column using the given Reader object, which is the given number of characters long. When a very large UNICODE value is input to a LONGVARCHAR parameter, it may be more practical to send it via a java.io.Reader object. The JDBC driver will do any necessary conversion from UNICODE to the database char format.

The updater methods are used to update column values in the current row or the insert row. The updater methods do not update the underlying database; instead the updateRow or insertRow methods are called to update the database.

Specified by:
updateNClob in interface java.sql.ResultSet
Parameters:
columnLabel - the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the label is the name of the column
reader - An object that contains the data to set the parameter value to.
length - the number of characters in the parameter data.

Throws:
java.sql.SQLException - Always thrown, to indicate that this method is not implemented.

Since:
1.6

updateNCharacterStream

public void updateNCharacterStream(int columnIndex,
                                   java.io.Reader x)
                            throws java.sql.SQLException
Updates the designated column with a character stream value. The data will be read from the stream as needed until end-of-stream is reached. The driver does the necessary conversion from Java character format to the national character set in the database. It is intended for use when updating NCHAR,NVARCHAR and LONGNVARCHAR columns.

The updater methods are used to update column values in the current row or the insert row. The updater methods do not update the underlying database; instead the updateRow or insertRow methods are called to update the database.

Note: Consult your JDBC driver documentation to determine if it might be more efficient to use a version of updateNCharacterStream which takes a length parameter.

Specified by:
updateNCharacterStream in interface java.sql.ResultSet
Parameters:
columnIndex - the first column is 1, the second is 2, ...
x - the new column value

Throws:
java.sql.SQLException - Always thrown, to indicate that this method is not implemented.

Since:
1.6

updateNCharacterStream

public void updateNCharacterStream(java.lang.String columnLabel,
                                   java.io.Reader reader)
                            throws java.sql.SQLException
Updates the designated column with a character stream value. The data will be read from the stream as needed until end-of-stream is reached. The driver does the necessary conversion from Java character format to the national character set in the database. It is intended for use when updating NCHAR,NVARCHAR and LONGNVARCHAR columns.

The updater methods are used to update column values in the current row or the insert row. The updater methods do not update the underlying database; instead the updateRow or insertRow methods are called to update the database.

Note: Consult your JDBC driver documentation to determine if it might be more efficient to use a version of updateNCharacterStream which takes a length parameter.

Specified by:
updateNCharacterStream in interface java.sql.ResultSet
Parameters:
columnLabel - the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the label is the name of the column
reader - the java.io.Reader object containing the new column value

Throws:
java.sql.SQLException - Always thrown, to indicate that this method is not implemented.

Since:
1.6

updateAsciiStream

public void updateAsciiStream(int columnIndex,
                              java.io.InputStream x)
                       throws java.sql.SQLException
Updates the designated column with an ascii stream value. The data will be read from the stream as needed until end-of-stream is reached.

The updater methods are used to update column values in the current row or the insert row. The updater methods do not update the underlying database; instead the updateRow or insertRow methods are called to update the database.

Note: Consult your JDBC driver documentation to determine if it might be more efficient to use a version of updateAsciiStream which takes a length parameter.

Specified by:
updateAsciiStream in interface java.sql.ResultSet
Parameters:
columnIndex - the first column is 1, the second is 2, ...
x - the new column value

Throws:
java.sql.SQLException - Always thrown, to indicate that this method is not implemented.

Since:
1.6

updateBinaryStream

public void updateBinaryStream(int columnIndex,
                               java.io.InputStream x)
                        throws java.sql.SQLException
Updates the designated column with a binary stream value. The data will be read from the stream as needed until end-of-stream is reached.

The updater methods are used to update column values in the current row or the insert row. The updater methods do not update the underlying database; instead the updateRow or insertRow methods are called to update the database.

Note: Consult your JDBC driver documentation to determine if it might be more efficient to use a version of updateBinaryStream which takes a length parameter.

Specified by:
updateBinaryStream in interface java.sql.ResultSet
Parameters:
columnIndex - the first column is 1, the second is 2, ...
x - the new column value

Throws:
java.sql.SQLException - Always thrown, to indicate that this method is not implemented.

Since:
1.6

updateCharacterStream

public void updateCharacterStream(int columnIndex,
                                  java.io.Reader x)
                           throws java.sql.SQLException
Updates the designated column with a character stream value. The data will be read from the stream as needed until end-of-stream is reached.

The updater methods are used to update column values in the current row or the insert row. The updater methods do not update the underlying database; instead the updateRow or insertRow methods are called to update the database.

Note: Consult your JDBC driver documentation to determine if it might be more efficient to use a version of updateCharacterStream which takes a length parameter.

Specified by:
updateCharacterStream in interface java.sql.ResultSet
Parameters:
columnIndex - the first column is 1, the second is 2, ...
x - the new column value

Throws:
java.sql.SQLException - Always thrown, to indicate that this method is not implemented.

Since:
1.6

updateAsciiStream

public void updateAsciiStream(java.lang.String columnLabel,
                              java.io.InputStream x)
                       throws java.sql.SQLException
Updates the designated column with an ascii stream value. The data will be read from the stream as needed until end-of-stream is reached.

The updater methods are used to update column values in the current row or the insert row. The updater methods do not update the underlying database; instead the updateRow or insertRow methods are called to update the database.

Note: Consult your JDBC driver documentation to determine if it might be more efficient to use a version of updateAsciiStream which takes a length parameter.

Specified by:
updateAsciiStream in interface java.sql.ResultSet
Parameters:
columnLabel - the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the label is the name of the column
x - the new column value

Throws:
java.sql.SQLException - Always thrown, to indicate that this method is not implemented.

Since:
1.6

updateBinaryStream

public void updateBinaryStream(java.lang.String columnLabel,
                               java.io.InputStream x)
                        throws java.sql.SQLException
Updates the designated column with a binary stream value. The data will be read from the stream as needed until end-of-stream is reached.

The updater methods are used to update column values in the current row or the insert row. The updater methods do not update the underlying database; instead the updateRow or insertRow methods are called to update the database.

Note: Consult your JDBC driver documentation to determine if it might be more efficient to use a version of updateBinaryStream which takes a length parameter.

Specified by:
updateBinaryStream in interface java.sql.ResultSet
Parameters:
columnLabel - the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the label is the name of the column
x - the new column value

Throws:
java.sql.SQLException - Always thrown, to indicate that this method is not implemented.

Since:
1.6

updateCharacterStream

public void updateCharacterStream(java.lang.String columnLabel,
                                  java.io.Reader reader)
                           throws java.sql.SQLException
Updates the designated column with a character stream value. The data will be read from the stream as needed until end-of-stream is reached.

The updater methods are used to update column values in the current row or the insert row. The updater methods do not update the underlying database; instead the updateRow or insertRow methods are called to update the database.

Note: Consult your JDBC driver documentation to determine if it might be more efficient to use a version of updateCharacterStream which takes a length parameter.

Specified by:
updateCharacterStream in interface java.sql.ResultSet
Parameters:
columnLabel - the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the label is the name of the column
reader - the java.io.Reader object containing the new column value

Throws:
java.sql.SQLException - Always thrown, to indicate that this method is not implemented.

Since:
1.6

updateBlob

public void updateBlob(int columnIndex,
                       java.io.InputStream inputStream)
                throws java.sql.SQLException
Updates the designated column using the given input stream. The data will be read from the stream as needed until end-of-stream is reached.

The updater methods are used to update column values in the current row or the insert row. The updater methods do not update the underlying database; instead the updateRow or insertRow methods are called to update the database.

Note: Consult your JDBC driver documentation to determine if it might be more efficient to use a version of updateBlob which takes a length parameter.

Specified by:
updateBlob in interface java.sql.ResultSet
Parameters:
columnIndex - the first column is 1, the second is 2, ...
inputStream - An object that contains the data to set the parameter value to.

Throws:
java.sql.SQLException - Always thrown, to indicate that this method is not implemented.

Since:
1.6

updateBlob

public void updateBlob(java.lang.String columnLabel,
                       java.io.InputStream inputStream)
                throws java.sql.SQLException
Updates the designated column using the given input stream. The data will be read from the stream as needed until end-of-stream is reached.

The updater methods are used to update column values in the current row or the insert row. The updater methods do not update the underlying database; instead the updateRow or insertRow methods are called to update the database.

Note: Consult your JDBC driver documentation to determine if it might be more efficient to use a version of updateBlob which takes a length parameter.

Specified by:
updateBlob in interface java.sql.ResultSet
Parameters:
columnLabel - the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the label is the name of the column
inputStream - An object that contains the data to set the parameter value to.

Throws:
java.sql.SQLException - Always thrown, to indicate that this method is not implemented.

Since:
1.6

updateClob

public void updateClob(int columnIndex,
                       java.io.Reader reader)
                throws java.sql.SQLException
Updates the designated column using the given Reader object. The data will be read from the stream as needed until end-of-stream is reached. The JDBC driver will do any necessary conversion from UNICODE to the database char format.

The updater methods are used to update column values in the current row or the insert row. The updater methods do not update the underlying database; instead the updateRow or insertRow methods are called to update the database.

Note: Consult your JDBC driver documentation to determine if it might be more efficient to use a version of updateClob which takes a length parameter.

Specified by:
updateClob in interface java.sql.ResultSet
Parameters:
columnIndex - the first column is 1, the second is 2, ...
reader - An object that contains the data to set the parameter value to.

Throws:
java.sql.SQLException - Always thrown, to indicate that this method is not implemented.

Since:
1.6

updateClob

public void updateClob(java.lang.String columnLabel,
                       java.io.Reader reader)
                throws java.sql.SQLException
Updates the designated column using the given Reader object. The data will be read from the stream as needed until end-of-stream is reached. The JDBC driver will do any necessary conversion from UNICODE to the database char format.

The updater methods are used to update column values in the current row or the insert row. The updater methods do not update the underlying database; instead the updateRow or insertRow methods are called to update the database.

Note: Consult your JDBC driver documentation to determine if it might be more efficient to use a version of updateClob which takes a length parameter.

Specified by:
updateClob in interface java.sql.ResultSet
Parameters:
columnLabel - the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the label is the name of the column
reader - An object that contains the data to set the parameter value to.

Throws:
java.sql.SQLException - Always thrown, to indicate that this method is not implemented.

Since:
1.6

updateNClob

public void updateNClob(int columnIndex,
                        java.io.Reader reader)
                 throws java.sql.SQLException
Updates the designated column using the given Reader The data will be read from the stream as needed until end-of-stream is reached. The JDBC driver will do any necessary conversion from UNICODE to the database char format.

The updater methods are used to update column values in the current row or the insert row. The updater methods do not update the underlying database; instead the updateRow or insertRow methods are called to update the database.

Note: Consult your JDBC driver documentation to determine if it might be more efficient to use a version of updateNClob which takes a length parameter.

Specified by:
updateNClob in interface java.sql.ResultSet
Parameters:
columnIndex - the first column is 1, the second 2, ...
reader - An object that contains the data to set the parameter value to.

Throws:
java.sql.SQLException - Always thrown, to indicate that this method is not implemented.

Since:
1.6

updateNClob

public void updateNClob(java.lang.String columnLabel,
                        java.io.Reader reader)
                 throws java.sql.SQLException
Updates the designated column using the given Reader object. The data will be read from the stream as needed until end-of-stream is reached. The JDBC driver will do any necessary conversion from UNICODE to the database char format.

The updater methods are used to update column values in the current row or the insert row. The updater methods do not update the underlying database; instead the updateRow or insertRow methods are called to update the database.

Note: Consult your JDBC driver documentation to determine if it might be more efficient to use a version of updateNClob which takes a length parameter.

Specified by:
updateNClob in interface java.sql.ResultSet
Parameters:
columnLabel - the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the label is the name of the column
reader - An object that contains the data to set the parameter value to.

Throws:
java.sql.SQLException - Always thrown, to indicate that this method is not implemented.

Since:
1.6

unwrap

public <T> T unwrap(java.lang.Class<T> iface)
         throws java.sql.SQLException

Specified by:
unwrap in interface java.sql.Wrapper
Throws:
java.sql.SQLException

isWrapperFor

public boolean isWrapperFor(java.lang.Class<?> iface)
                     throws java.sql.SQLException

Specified by:
isWrapperFor in interface java.sql.Wrapper
Throws:
java.sql.SQLException
 All Libraries   This Library  Package   Class  Use  Tree  Deprecated  Index  Grand Index  Help 
 Foundation 
 PREV CLASS   NEXT CLASS FRAMES    NO FRAMES    
SUMMARY: NESTED | FIELD | CONSTR | METHOD DETAIL: FIELD | CONSTR | METHOD

Copyright © 2009 SAS Institute Inc. All Rights Reserved.