Added in API level 1

RowSet

interface RowSet : ResultSet

javax.sql.RowSet

The interface that adds support to the JDBC API for the JavaBeansTM component model. A rowset, which can be used as a JavaBeans component in a visual Bean development environment, can be created and configured at design time and executed at run time.

The RowSet interface provides a set of JavaBeans properties that allow a RowSet instance to be configured to connect to a JDBC data source and read some data from the data source. A group of setter methods (setInt, setBytes, setString, and so on) provide a way to pass input parameters to a rowset's command property. This command is the SQL query the rowset uses when it gets its data from a relational database, which is generally the case.

The RowSet interface supports JavaBeans events, allowing other components in an application to be notified when an event occurs on a rowset, such as a change in its value.

The RowSet interface is unique in that it is intended to be implemented using the rest of the JDBC API. In other words, a RowSet implementation is a layer of software that executes "on top" of a JDBC driver. Implementations of the RowSet interface can be provided by anyone, including JDBC driver vendors who want to provide a RowSet implementation as part of their JDBC products.

A RowSet object may make a connection with a data source and maintain that connection throughout its life cycle, in which case it is called a connected rowset. A rowset may also make a connection with a data source, get data from it, and then close the connection. Such a rowset is called a disconnected rowset. A disconnected rowset may make changes to its data while it is disconnected and then send the changes back to the original source of the data, but it must reestablish a connection to do so.

A disconnected rowset may have a reader (a RowSetReader object) and a writer (a RowSetWriter object) associated with it. The reader may be implemented in many different ways to populate a rowset with data, including getting data from a non-relational data source. The writer can also be implemented in many different ways to propagate changes made to the rowset's data back to the underlying data source.

Rowsets are easy to use. The RowSet interface extends the standard java.sql.ResultSet interface. The RowSetMetaData interface extends the java.sql.ResultSetMetaData interface. Thus, developers familiar with the JDBC API will have to learn a minimal number of new APIs to use rowsets. In addition, third-party software tools that work with JDBC ResultSet objects will also easily be made to work with rowsets.

Summary

Inherited constants

From class ResultSet Int CLOSE_CURSORS_AT_COMMIT The constant indicating that open ResultSet objects with this holdability will be closed when the current transaction is commited. Int CONCUR_READ_ONLY The constant indicating the concurrency mode for a ResultSet object that may NOT be updated. Int CONCUR_UPDATABLE The constant indicating the concurrency mode for a ResultSet object that may be updated. Int FETCH_FORWARD The constant indicating that the rows in a result set will be processed in a forward direction; first-to-last. This constant is used by the method setFetchDirection as a hint to the driver, which the driver may ignore. Int FETCH_REVERSE The constant indicating that the rows in a result set will be processed in a reverse direction; last-to-first. This constant is used by the method setFetchDirection as a hint to the driver, which the driver may ignore. Int FETCH_UNKNOWN The constant indicating that the order in which rows in a result set will be processed is unknown. This constant is used by the method setFetchDirection as a hint to the driver, which the driver may ignore. Int HOLD_CURSORS_OVER_COMMIT The constant indicating that open ResultSet objects with this holdability will remain open when the current transaction is commited. Int TYPE_FORWARD_ONLY The constant indicating the type for a ResultSet object whose cursor may move only forward. Int TYPE_SCROLL_INSENSITIVE The constant indicating the type for a ResultSet object that is scrollable but generally not sensitive to changes to the data that underlies the ResultSet. Int TYPE_SCROLL_SENSITIVE The constant indicating the type for a ResultSet object that is scrollable and generally sensitive to changes to the data that underlies the ResultSet.

Public methods
abstract Unit	addRowSetListener(listener: RowSetListener!) Registers the given listener so that it will be notified of events that occur on this RowSet object.
abstract Unit	clearParameters() Clears the parameters set for this RowSet object's command.
abstract Unit	execute() Fills this RowSet object with data.
abstract String!	getCommand() Retrieves this RowSet object's command property.
abstract String!	getDataSourceName() Retrieves the logical name that identifies the data source for this RowSet object.
abstract Boolean	getEscapeProcessing() Retrieves whether escape processing is enabled for this RowSet object.
abstract Int	getMaxFieldSize() Retrieves the maximum number of bytes that may be returned for certain column values.
abstract Int	getMaxRows() Retrieves the maximum number of rows that this RowSet object can contain.
abstract String!	getPassword() Retrieves the password used to create a database connection.
abstract Int	getQueryTimeout() Retrieves the maximum number of seconds the driver will wait for a statement to execute.
abstract Int	getTransactionIsolation() Retrieves the transaction isolation level set for this RowSet object.
abstract MutableMap<String!, Class<*>!>!	getTypeMap() Retrieves the Map object associated with this RowSet object, which specifies the custom mapping of SQL user-defined types, if any.
abstract String!	getUrl() Retrieves the url property this RowSet object will use to create a connection if it uses the DriverManager instead of a DataSource object to establish the connection.
abstract String!	getUsername() Retrieves the username used to create a database connection for this RowSet object.
abstract Boolean	isReadOnly() Retrieves whether this RowSet object is read-only.
abstract Unit	removeRowSetListener(listener: RowSetListener!) Removes the specified listener from the list of components that will be notified when an event occurs on this RowSet object.
abstract Unit	setArray(i: Int, x: Array!) Sets the designated parameter in this RowSet object's command with the given Array value.
abstract Unit	setAsciiStream(parameterIndex: Int, x: InputStream!) Sets the designated parameter in this RowSet object's command to the given input stream.
abstract Unit	setAsciiStream(parameterIndex: Int, x: InputStream!, length: Int) Sets the designated parameter in this RowSet object's command to the given java.io.InputStream value.
abstract Unit	setAsciiStream(parameterName: String!, x: InputStream!) Sets the designated parameter to the given input stream.
abstract Unit	setAsciiStream(parameterName: String!, x: InputStream!, length: Int) Sets the designated parameter to the given input stream, which will have the specified number of bytes.
abstract Unit	setBigDecimal(parameterIndex: Int, x: BigDecimal!) Sets the designated parameter in this RowSet object's command to the given java.math.BigDeciaml value.
abstract Unit	setBigDecimal(parameterName: String!, x: BigDecimal!) Sets the designated parameter to the given java.math.BigDecimal value.
abstract Unit	setBinaryStream(parameterIndex: Int, x: InputStream!) Sets the designated parameter in this RowSet object's command to the given input stream.
abstract Unit	setBinaryStream(parameterIndex: Int, x: InputStream!, length: Int) Sets the designated parameter in this RowSet object's command to the given java.io.InputStream value.
abstract Unit	setBinaryStream(parameterName: String!, x: InputStream!) Sets the designated parameter to the given input stream.
abstract Unit	setBinaryStream(parameterName: String!, x: InputStream!, length: Int) Sets the designated parameter to the given input stream, which will have the specified number of bytes.
abstract Unit	setBlob(parameterIndex: Int, inputStream: InputStream!) Sets the designated parameter to a InputStream object.
abstract Unit	setBlob(parameterIndex: Int, inputStream: InputStream!, length: Long) Sets the designated parameter to a InputStream object.
abstract Unit	setBlob(i: Int, x: Blob!) Sets the designated parameter in this RowSet object's command with the given Blob value.
abstract Unit	setBlob(parameterName: String!, inputStream: InputStream!) Sets the designated parameter to a InputStream object.
abstract Unit	setBlob(parameterName: String!, inputStream: InputStream!, length: Long) Sets the designated parameter to a InputStream object.
abstract Unit	setBlob(parameterName: String!, x: Blob!) Sets the designated parameter to the given java.sql.Blob object.
abstract Unit	setBoolean(parameterIndex: Int, x: Boolean) Sets the designated parameter in this RowSet object's command to the given Java boolean value.
abstract Unit	setBoolean(parameterName: String!, x: Boolean) Sets the designated parameter to the given Java boolean value.
abstract Unit	setByte(parameterIndex: Int, x: Byte) Sets the designated parameter in this RowSet object's command to the given Java byte value.
abstract Unit	setByte(parameterName: String!, x: Byte) Sets the designated parameter to the given Java byte value.
abstract Unit	setBytes(parameterIndex: Int, x: ByteArray!) Sets the designated parameter in this RowSet object's command to the given Java array of byte values.
abstract Unit	setBytes(parameterName: String!, x: ByteArray!) Sets the designated parameter to the given Java array of bytes.
abstract Unit	setCharacterStream(parameterIndex: Int, reader: Reader!) Sets the designated parameter in this RowSet object's command to the given Reader object.
abstract Unit	setCharacterStream(parameterIndex: Int, reader: Reader!, length: Int) Sets the designated parameter in this RowSet object's command to the given java.io.Reader value.
abstract Unit	setCharacterStream(parameterName: String!, reader: Reader!) Sets the designated parameter to the given Reader object.
abstract Unit	setCharacterStream(parameterName: String!, reader: Reader!, length: Int) Sets the designated parameter to the given Reader object, which is the given number of characters long.
abstract Unit	setClob(parameterIndex: Int, reader: Reader!) Sets the designated parameter to a Reader object.
abstract Unit	setClob(parameterIndex: Int, reader: Reader!, length: Long) Sets the designated parameter to a Reader object.
abstract Unit	setClob(i: Int, x: Clob!) Sets the designated parameter in this RowSet object's command with the given Clob value.
abstract Unit	setClob(parameterName: String!, reader: Reader!) Sets the designated parameter to a Reader object.
abstract Unit	setClob(parameterName: String!, reader: Reader!, length: Long) Sets the designated parameter to a Reader object.
abstract Unit	setClob(parameterName: String!, x: Clob!) Sets the designated parameter to the given java.sql.Clob object.
abstract Unit	setCommand(cmd: String!) Sets this RowSet object's command property to the given SQL query.
abstract Unit	setConcurrency(concurrency: Int) Sets the concurrency of this RowSet object to the given concurrency level.
abstract Unit	setDataSourceName(name: String!) Sets the data source name property for this RowSet object to the given String.
abstract Unit	setDate(parameterIndex: Int, x: Date!) Sets the designated parameter in this RowSet object's command to the given java.sql.Date value.
abstract Unit	setDate(parameterIndex: Int, x: Date!, cal: Calendar!) Sets the designated parameter in this RowSet object's command with the given java.sql.Date value.
abstract Unit	setDate(parameterName: String!, x: Date!) Sets the designated parameter to the given java.sql.Date value using the default time zone of the virtual machine that is running the application.
abstract Unit	setDate(parameterName: String!, x: Date!, cal: Calendar!) Sets the designated parameter to the given java.sql.Date value, using the given Calendar object.
abstract Unit	setDouble(parameterIndex: Int, x: Double) Sets the designated parameter in this RowSet object's command to the given Java double value.
abstract Unit	setDouble(parameterName: String!, x: Double) Sets the designated parameter to the given Java double value.
abstract Unit	setEscapeProcessing(enable: Boolean) Sets escape processing for this RowSet object on or off.
abstract Unit	setFloat(parameterIndex: Int, x: Float) Sets the designated parameter in this RowSet object's command to the given Java float value.
abstract Unit	setFloat(parameterName: String!, x: Float) Sets the designated parameter to the given Java float value.
abstract Unit	setInt(parameterIndex: Int, x: Int) Sets the designated parameter in this RowSet object's command to the given Java int value.
abstract Unit	setInt(parameterName: String!, x: Int) Sets the designated parameter to the given Java int value.
abstract Unit	setLong(parameterIndex: Int, x: Long) Sets the designated parameter in this RowSet object's command to the given Java long value.
abstract Unit	setLong(parameterName: String!, x: Long) Sets the designated parameter to the given Java long value.
abstract Unit	setMaxFieldSize(max: Int) Sets the maximum number of bytes that can be returned for a column value to the given number of bytes.
abstract Unit	setMaxRows(max: Int) Sets the maximum number of rows that this RowSet object can contain to the specified number.
abstract Unit	setNCharacterStream(parameterIndex: Int, value: Reader!) Sets the designated parameter in this RowSet object's command to a Reader object.
abstract Unit	setNCharacterStream(parameterIndex: Int, value: Reader!, length: Long) Sets the designated parameter to a Reader object.
abstract Unit	setNCharacterStream(parameterName: String!, value: Reader!) Sets the designated parameter to a Reader object.
abstract Unit	setNCharacterStream(parameterName: String!, value: Reader!, length: Long) Sets the designated parameter to a Reader object.
abstract Unit	setNClob(parameterIndex: Int, reader: Reader!) Sets the designated parameter to a Reader object.
abstract Unit	setNClob(parameterIndex: Int, reader: Reader!, length: Long) Sets the designated parameter to a Reader object.
abstract Unit	setNClob(parameterIndex: Int, value: NClob!) Sets the designated parameter to a java.sql.NClob object.
abstract Unit	setNClob(parameterName: String!, reader: Reader!) Sets the designated parameter to a Reader object.
abstract Unit	setNClob(parameterName: String!, reader: Reader!, length: Long) Sets the designated parameter to a Reader object.
abstract Unit	setNClob(parameterName: String!, value: NClob!) Sets the designated parameter to a java.sql.NClob object.
abstract Unit	setNString(parameterIndex: Int, value: String!) Sets the designated paramter to the given String object.
abstract Unit	setNString(parameterName: String!, value: String!) Sets the designated paramter to the given String object.
abstract Unit	setNull(parameterIndex: Int, sqlType: Int) Sets the designated parameter in this RowSet object's SQL command to SQL NULL.
abstract Unit	setNull(paramIndex: Int, sqlType: Int, typeName: String!) Sets the designated parameter in this RowSet object's SQL command to SQL NULL.
abstract Unit	setNull(parameterName: String!, sqlType: Int) Sets the designated parameter to SQL NULL.
abstract Unit	setNull(parameterName: String!, sqlType: Int, typeName: String!) Sets the designated parameter to SQL NULL.
abstract Unit	setObject(parameterIndex: Int, x: Any!) Sets the designated parameter in this RowSet object's command with a Java Object.
abstract Unit	setObject(parameterIndex: Int, x: Any!, targetSqlType: Int) Sets the designated parameter in this RowSet object's command with a Java Object.
abstract Unit	setObject(parameterIndex: Int, x: Any!, targetSqlType: Int, scaleOrLength: Int) Sets the designated parameter in this RowSet object's command with the given Java Object.
abstract Unit	setObject(parameterName: String!, x: Any!) Sets the value of the designated parameter with the given object.
abstract Unit	setObject(parameterName: String!, x: Any!, targetSqlType: Int) Sets the value of the designated parameter with the given object.
abstract Unit	setObject(parameterName: String!, x: Any!, targetSqlType: Int, scale: Int) Sets the value of the designated parameter with the given object.
abstract Unit	setPassword(password: String!) Sets the database password for this RowSet object to the given String.
abstract Unit	setQueryTimeout(seconds: Int) Sets the maximum time the driver will wait for a statement to execute to the given number of seconds.
abstract Unit	setReadOnly(value: Boolean) Sets whether this RowSet object is read-only to the given boolean.
abstract Unit	setRef(i: Int, x: Ref!) Sets the designated parameter in this RowSet object's command with the given Ref value.
abstract Unit	setRowId(parameterIndex: Int, x: RowId!) Sets the designated parameter to the given java.sql.RowId object.
abstract Unit	setRowId(parameterName: String!, x: RowId!) Sets the designated parameter to the given java.sql.RowId object.
abstract Unit	setSQLXML(parameterIndex: Int, xmlObject: SQLXML!) Sets the designated parameter to the given java.sql.SQLXML object.
abstract Unit	setSQLXML(parameterName: String!, xmlObject: SQLXML!) Sets the designated parameter to the given java.sql.SQLXML object.
abstract Unit	setShort(parameterIndex: Int, x: Short) Sets the designated parameter in this RowSet object's command to the given Java short value.
abstract Unit	setShort(parameterName: String!, x: Short) Sets the designated parameter to the given Java short value.
abstract Unit	setString(parameterIndex: Int, x: String!) Sets the designated parameter in this RowSet object's command to the given Java String value.
abstract Unit	setString(parameterName: String!, x: String!) Sets the designated parameter to the given Java String value.
abstract Unit	setTime(parameterIndex: Int, x: Time!) Sets the designated parameter in this RowSet object's command to the given java.sql.Time value.
abstract Unit	setTime(parameterIndex: Int, x: Time!, cal: Calendar!) Sets the designated parameter in this RowSet object's command with the given java.sql.Time value.
abstract Unit	setTime(parameterName: String!, x: Time!) Sets the designated parameter to the given java.sql.Time value.
abstract Unit	setTime(parameterName: String!, x: Time!, cal: Calendar!) Sets the designated parameter to the given java.sql.Time value, using the given Calendar object.
abstract Unit	setTimestamp(parameterIndex: Int, x: Timestamp!) Sets the designated parameter in this RowSet object's command to the given java.sql.Timestamp value.
abstract Unit	setTimestamp(parameterIndex: Int, x: Timestamp!, cal: Calendar!) Sets the designated parameter in this RowSet object's command with the given java.sql.Timestamp value.
abstract Unit	setTimestamp(parameterName: String!, x: Timestamp!) Sets the designated parameter to the given java.sql.Timestamp value.
abstract Unit	setTimestamp(parameterName: String!, x: Timestamp!, cal: Calendar!) Sets the designated parameter to the given java.sql.Timestamp value, using the given Calendar object.
abstract Unit	setTransactionIsolation(level: Int) Sets the transaction isolation level for this RowSet obejct.
abstract Unit	setType(type: Int) Sets the type of this RowSet object to the given type.
abstract Unit	setTypeMap(map: MutableMap<String!, Class<*>!>!) Installs the given java.util.Map object as the default type map for this RowSet object.
abstract Unit	setURL(parameterIndex: Int, x: URL!) Sets the designated parameter to the given java.net.URL value.
abstract Unit	setUrl(url: String!) Sets the URL this RowSet object will use when it uses the DriverManager to create a connection.
abstract Unit	setUsername(name: String!) Sets the username property for this RowSet object to the given String.

Inherited functions
From class ResultSet Boolean absolute(row: Int) Moves the cursor to the given row number in this ResultSet object. If the row number is positive, the cursor moves to the given row number with respect to the beginning of the result set. The first row is row 1, the second is row 2, and so on. If the given row number is negative, the cursor moves to an absolute row position with respect to the end of the result set. For example, calling the method absolute(-1) positions the cursor on the last row; calling the method absolute(-2) moves the cursor to the next-to-last row, and so on. If the row number specified is zero, the cursor is moved to before the first row. An attempt to position the cursor beyond the first/last row in the result set leaves the cursor before the first row or after the last row. Note: Calling absolute(1) is the same as calling first(). Calling absolute(-1) is the same as calling last(). Unit afterLast() Moves the cursor to the end of this ResultSet object, just after the last row. This method has no effect if the result set contains no rows. Unit beforeFirst() Moves the cursor to the front of this ResultSet object, just before the first row. This method has no effect if the result set contains no rows. Unit cancelRowUpdates() Cancels the updates made to the current row in this ResultSet object. This method may be called after calling an updater method(s) and before calling the method updateRow to roll back the updates made to a row. If no updates have been made or updateRow has already been called, this method has no effect. Unit clearWarnings() Clears all warnings reported on this ResultSet object. After this method is called, the method getWarnings returns null until a new warning is reported for this ResultSet object. Unit close() Releases this ResultSet object's database and JDBC resources immediately instead of waiting for this to happen when it is automatically closed. The closing of a ResultSet object does not close the Blob, Clob or NClob objects created by the ResultSet. Blob, Clob or NClob objects remain valid for at least the duration of the transaction in which they are creataed, unless their free method is invoked. When a ResultSet is closed, any ResultSetMetaData instances that were created by calling the getMetaData method remain accessible. Note: A ResultSet object is automatically closed by the Statement object that generated it when that Statement object is closed, re-executed, or is used to retrieve the next result from a sequence of multiple results. Calling the method close on a ResultSet object that is already closed is a no-op. Unit deleteRow() Deletes the current row from this ResultSet object and from the underlying database. This method cannot be called when the cursor is on the insert row. Int findColumn(columnLabel: String!) Maps the given ResultSet column label to its ResultSet column index. Boolean first() Moves the cursor to the first row in this ResultSet object. Array! getArray(columnIndex: Int) Retrieves the value of the designated column in the current row of this ResultSet object as an Array object in the Java programming language. Array! getArray(columnLabel: String!) Retrieves the value of the designated column in the current row of this ResultSet object as an Array object in the Java programming language. InputStream! getAsciiStream(columnIndex: Int) Retrieves the value of the designated column in the current row of this ResultSet object as a stream of ASCII characters. The value can then be read in chunks from the stream. This method is particularly suitable for retrieving large LONGVARCHAR values. The JDBC driver will do any necessary conversion from the database format into ASCII. Note: All the data in the returned stream must be read prior to getting the value of any other column. The next call to a getter method implicitly closes the stream. Also, a stream may return 0 when the method InputStream.available is called whether there is data available or not. InputStream! getAsciiStream(columnLabel: String!) Retrieves the value of the designated column in the current row of this ResultSet object as a stream of ASCII characters. The value can then be read in chunks from the stream. This method is particularly suitable for retrieving large LONGVARCHAR values. The JDBC driver will do any necessary conversion from the database format into ASCII. Note: All the data in the returned stream must be read prior to getting the value of any other column. The next call to a getter method implicitly closes the stream. Also, a stream may return 0 when the method available is called whether there is data available or not. BigDecimal! getBigDecimal(columnIndex: Int) Retrieves the value of the designated column in the current row of this ResultSet object as a java.math.BigDecimal with full precision. BigDecimal! getBigDecimal(columnIndex: Int, scale: Int) Retrieves the value of the designated column in the current row of this ResultSet object as a java.sql.BigDecimal in the Java programming language. BigDecimal! getBigDecimal(columnLabel: String!) Retrieves the value of the designated column in the current row of this ResultSet object as a java.math.BigDecimal with full precision. BigDecimal! getBigDecimal(columnLabel: String!, scale: Int) Retrieves the value of the designated column in the current row of this ResultSet object as a java.math.BigDecimal in the Java programming language. InputStream! getBinaryStream(columnIndex: Int) Retrieves the value of the designated column in the current row of this ResultSet object as a stream of uninterpreted bytes. The value can then be read in chunks from the stream. This method is particularly suitable for retrieving large LONGVARBINARY values. Note: All the data in the returned stream must be read prior to getting the value of any other column. The next call to a getter method implicitly closes the stream. Also, a stream may return 0 when the method InputStream.available is called whether there is data available or not. InputStream! getBinaryStream(columnLabel: String!) Retrieves the value of the designated column in the current row of this ResultSet object as a stream of uninterpreted bytes. The value can then be read in chunks from the stream. This method is particularly suitable for retrieving large LONGVARBINARY values. Note: All the data in the returned stream must be read prior to getting the value of any other column. The next call to a getter method implicitly closes the stream. Also, a stream may return 0 when the method available is called whether there is data available or not. Blob! getBlob(columnIndex: Int) Retrieves the value of the designated column in the current row of this ResultSet object as a Blob object in the Java programming language. Blob! getBlob(columnLabel: String!) Retrieves the value of the designated column in the current row of this ResultSet object as a Blob object in the Java programming language. Boolean getBoolean(columnIndex: Int) Retrieves the value of the designated column in the current row of this ResultSet object as a boolean in the Java programming language. If the designated column has a datatype of CHAR or VARCHAR and contains a "0" or has a datatype of BIT, TINYINT, SMALLINT, INTEGER or BIGINT and contains a 0, a value of false is returned. If the designated column has a datatype of CHAR or VARCHAR and contains a "1" or has a datatype of BIT, TINYINT, SMALLINT, INTEGER or BIGINT and contains a 1, a value of true is returned. Boolean getBoolean(columnLabel: String!) Retrieves the value of the designated column in the current row of this ResultSet object as a boolean in the Java programming language. If the designated column has a datatype of CHAR or VARCHAR and contains a "0" or has a datatype of BIT, TINYINT, SMALLINT, INTEGER or BIGINT and contains a 0, a value of false is returned. If the designated column has a datatype of CHAR or VARCHAR and contains a "1" or has a datatype of BIT, TINYINT, SMALLINT, INTEGER or BIGINT and contains a 1, a value of true is returned. Byte getByte(columnIndex: Int) Retrieves the value of the designated column in the current row of this ResultSet object as a byte in the Java programming language. Byte getByte(columnLabel: String!) Retrieves the value of the designated column in the current row of this ResultSet object as a byte in the Java programming language. ByteArray! getBytes(columnIndex: Int) Retrieves the value of the designated column in the current row of this ResultSet object as a byte array in the Java programming language. The bytes represent the raw values returned by the driver. ByteArray! getBytes(columnLabel: String!) Retrieves the value of the designated column in the current row of this ResultSet object as a byte array in the Java programming language. The bytes represent the raw values returned by the driver. Reader! getCharacterStream(columnIndex: Int) Retrieves the value of the designated column in the current row of this ResultSet object as a java.io.Reader object. Reader! getCharacterStream(columnLabel: String!) Retrieves the value of the designated column in the current row of this ResultSet object as a java.io.Reader object. Clob! getClob(columnIndex: Int) Retrieves the value of the designated column in the current row of this ResultSet object as a Clob object in the Java programming language. Clob! getClob(columnLabel: String!) Retrieves the value of the designated column in the current row of this ResultSet object as a Clob object in the Java programming language. Int getConcurrency() Retrieves the concurrency mode of this ResultSet object. The concurrency used is determined by the Statement object that created the result set. String! getCursorName() Retrieves the name of the SQL cursor used by this ResultSet object. In SQL, a result table is retrieved through a cursor that is named. The current row of a result set can be updated or deleted using a positioned update/delete statement that references the cursor name. To insure that the cursor has the proper isolation level to support update, the cursor's SELECT statement should be of the form SELECT FOR UPDATE. If FOR UPDATE is omitted, the positioned updates may fail. The JDBC API supports this SQL feature by providing the name of the SQL cursor used by a ResultSet object. The current row of a ResultSet object is also the current row of this SQL cursor. Date! getDate(columnIndex: Int) Retrieves the value of the designated column in the current row of this ResultSet object as a java.sql.Date object in the Java programming language. Date! getDate(columnIndex: Int, cal: Calendar!) Retrieves the value of the designated column in the current row of this ResultSet object as a java.sql.Date object in the Java programming language. This method uses the given calendar to construct an appropriate millisecond value for the date if the underlying database does not store timezone information. Date! getDate(columnLabel: String!) Retrieves the value of the designated column in the current row of this ResultSet object as a java.sql.Date object in the Java programming language. Date! getDate(columnLabel: String!, cal: Calendar!) Retrieves the value of the designated column in the current row of this ResultSet object as a java.sql.Date object in the Java programming language. This method uses the given calendar to construct an appropriate millisecond value for the date if the underlying database does not store timezone information. Double getDouble(columnIndex: Int) Retrieves the value of the designated column in the current row of this ResultSet object as a double in the Java programming language. Double getDouble(columnLabel: String!) Retrieves the value of the designated column in the current row of this ResultSet object as a double in the Java programming language. Int getFetchDirection() Retrieves the fetch direction for this ResultSet object. Int getFetchSize() Retrieves the fetch size for this ResultSet object. Float getFloat(columnIndex: Int) Retrieves the value of the designated column in the current row of this ResultSet object as a float in the Java programming language. Float getFloat(columnLabel: String!) Retrieves the value of the designated column in the current row of this ResultSet object as a float in the Java programming language. Int getHoldability() Retrieves the holdability of this ResultSet object Int getInt(columnIndex: Int) Retrieves the value of the designated column in the current row of this ResultSet object as an int in the Java programming language. Int getInt(columnLabel: String!) Retrieves the value of the designated column in the current row of this ResultSet object as an int in the Java programming language. Long getLong(columnIndex: Int) Retrieves the value of the designated column in the current row of this ResultSet object as a long in the Java programming language. Long getLong(columnLabel: String!) Retrieves the value of the designated column in the current row of this ResultSet object as a long in the Java programming language. ResultSetMetaData! getMetaData() Retrieves the number, types and properties of this ResultSet object's columns. Reader! getNCharacterStream(columnIndex: Int) 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. Reader! getNCharacterStream(columnLabel: String!) 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. NClob! getNClob(columnIndex: Int) Retrieves the value of the designated column in the current row of this ResultSet object as a NClob object in the Java programming language. NClob! getNClob(columnLabel: String!) Retrieves the value of the designated column in the current row of this ResultSet object as a NClob object in the Java programming language. String! getNString(columnIndex: Int) 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. String! getNString(columnLabel: String!) 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. Any! getObject(columnIndex: Int) Gets the value of the designated column in the current row of this ResultSet object as an Object in the Java programming language. This method will return the value of the given column as a Java object. The type of the Java object will be the default Java object type corresponding to the column's SQL type, following the mapping for built-in types specified in the JDBC specification. If the value is an SQL NULL, the driver returns a Java null. This method may also be used to read database-specific abstract data types. In the JDBC 2.0 API, the behavior of method getObject is extended to materialize data of SQL user-defined types. If Connection.getTypeMap does not throw a SQLFeatureNotSupportedException, then when a column contains a structured or distinct value, the behavior of this method is as if it were a call to: getObject(columnIndex, this.getStatement().getConnection().getTypeMap()). If Connection.getTypeMap does throw a SQLFeatureNotSupportedException, then structured values are not supported, and distinct values are mapped to the default Java class as determined by the underlying SQL type of the DISTINCT type. Any! getObject(columnIndex: Int, map: MutableMap<String!, Class<*>!>!) Retrieves the value of the designated column in the current row of this ResultSet object as an Object in the Java programming language. If the value is an SQL NULL, the driver returns a Java null. This method uses the given Map object for the custom mapping of the SQL structured or distinct type that is being retrieved. Any! getObject(columnLabel: String!) Gets the value of the designated column in the current row of this ResultSet object as an Object in the Java programming language. This method will return the value of the given column as a Java object. The type of the Java object will be the default Java object type corresponding to the column's SQL type, following the mapping for built-in types specified in the JDBC specification. If the value is an SQL NULL, the driver returns a Java null. This method may also be used to read database-specific abstract data types. In the JDBC 2.0 API, the behavior of the method getObject is extended to materialize data of SQL user-defined types. When a column contains a structured or distinct value, the behavior of this method is as if it were a call to: getObject(columnIndex, this.getStatement().getConnection().getTypeMap()). Any! getObject(columnLabel: String!, map: MutableMap<String!, Class<*>!>!) Retrieves the value of the designated column in the current row of this ResultSet object as an Object in the Java programming language. If the value is an SQL NULL, the driver returns a Java null. This method uses the specified Map object for custom mapping if appropriate. Ref! getRef(columnIndex: Int) Retrieves the value of the designated column in the current row of this ResultSet object as a Ref object in the Java programming language. Ref! getRef(columnLabel: String!) Retrieves the value of the designated column in the current row of this ResultSet object as a Ref object in the Java programming language. Int getRow() Retrieves the current row number. The first row is number 1, the second number 2, and so on. Note:Support for the getRow method is optional for ResultSets with a result set type of TYPE_FORWARD_ONLY RowId! getRowId(columnIndex: Int) 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. RowId! getRowId(columnLabel: String!) 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. SQLXML! getSQLXML(columnIndex: Int) 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. SQLXML! getSQLXML(columnLabel: String!) 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. Short getShort(columnIndex: Int) Retrieves the value of the designated column in the current row of this ResultSet object as a short in the Java programming language. Short getShort(columnLabel: String!) Retrieves the value of the designated column in the current row of this ResultSet object as a short in the Java programming language. Statement! getStatement() Retrieves the Statement object that produced this ResultSet object. If the result set was generated some other way, such as by a DatabaseMetaData method, this method may return null. String! getString(columnIndex: Int) Retrieves the value of the designated column in the current row of this ResultSet object as a String in the Java programming language. String! getString(columnLabel: String!) Retrieves the value of the designated column in the current row of this ResultSet object as a String in the Java programming language. Time! getTime(columnIndex: Int) Retrieves the value of the designated column in the current row of this ResultSet object as a java.sql.Time object in the Java programming language. Time! getTime(columnIndex: Int, cal: Calendar!) Retrieves the value of the designated column in the current row of this ResultSet object as a java.sql.Time object in the Java programming language. This method uses the given calendar to construct an appropriate millisecond value for the time if the underlying database does not store timezone information. Time! getTime(columnLabel: String!) Retrieves the value of the designated column in the current row of this ResultSet object as a java.sql.Time object in the Java programming language. Time! getTime(columnLabel: String!, cal: Calendar!) Retrieves the value of the designated column in the current row of this ResultSet object as a java.sql.Time object in the Java programming language. This method uses the given calendar to construct an appropriate millisecond value for the time if the underlying database does not store timezone information. Timestamp! getTimestamp(columnIndex: Int) Retrieves the value of the designated column in the current row of this ResultSet object as a java.sql.Timestamp object in the Java programming language. Timestamp! getTimestamp(columnIndex: Int, cal: Calendar!) Retrieves the value of the designated column in the current row of this ResultSet object as a java.sql.Timestamp object in the Java programming language. This method uses the given calendar to construct an appropriate millisecond value for the timestamp if the underlying database does not store timezone information. Timestamp! getTimestamp(columnLabel: String!) Retrieves the value of the designated column in the current row of this ResultSet object as a java.sql.Timestamp object in the Java programming language. Timestamp! getTimestamp(columnLabel: String!, cal: Calendar!) Retrieves the value of the designated column in the current row of this ResultSet object as a java.sql.Timestamp object in the Java programming language. This method uses the given calendar to construct an appropriate millisecond value for the timestamp if the underlying database does not store timezone information. Int getType() Retrieves the type of this ResultSet object. The type is determined by the Statement object that created the result set. URL! getURL(columnIndex: Int) 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. URL! getURL(columnLabel: String!) 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. InputStream! getUnicodeStream(columnIndex: Int) Retrieves the value of the designated column in the current row of this ResultSet object as as a stream of two-byte 3 characters. The first byte is the high byte; the second byte is the low byte. The value can then be read in chunks from the stream. This method is particularly suitable for retrieving large LONGVARCHARvalues. The JDBC driver will do any necessary conversion from the database format into Unicode. Note: All the data in the returned stream must be read prior to getting the value of any other column. The next call to a getter method implicitly closes the stream. Also, a stream may return 0 when the method InputStream.available is called, whether there is data available or not. InputStream! getUnicodeStream(columnLabel: String!) Retrieves the value of the designated column in the current row of this ResultSet object as a stream of two-byte Unicode characters. The first byte is the high byte; the second byte is the low byte. The value can then be read in chunks from the stream. This method is particularly suitable for retrieving large LONGVARCHAR values. The JDBC technology-enabled driver will do any necessary conversion from the database format into Unicode. Note: All the data in the returned stream must be read prior to getting the value of any other column. The next call to a getter method implicitly closes the stream. Also, a stream may return 0 when the method InputStream.available is called, whether there is data available or not. SQLWarning! getWarnings() Retrieves the first warning reported by calls on this ResultSet object. Subsequent warnings on this ResultSet object will be chained to the SQLWarning object that this method returns. The warning chain is automatically cleared each time a new row is read. This method may not be called on a ResultSet object that has been closed; doing so will cause an SQLException to be thrown. Note: This warning chain only covers warnings caused by ResultSet methods. Any warning caused by Statement methods (such as reading OUT parameters) will be chained on the Statement object. Unit insertRow() Inserts the contents of the insert row into this ResultSet object and into the database. The cursor must be on the insert row when this method is called. Boolean isAfterLast() Retrieves whether the cursor is after the last row in this ResultSet object. Note:Support for the isAfterLast method is optional for ResultSets with a result set type of TYPE_FORWARD_ONLY Boolean isBeforeFirst() Retrieves whether the cursor is before the first row in this ResultSet object. Note:Support for the isBeforeFirst method is optional for ResultSets with a result set type of TYPE_FORWARD_ONLY Boolean isClosed() 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. Boolean isFirst() Retrieves whether the cursor is on the first row of this ResultSet object. Note:Support for the isFirst method is optional for ResultSets with a result set type of TYPE_FORWARD_ONLY Boolean isLast() Retrieves whether the cursor is on the last row of this ResultSet object. Note: Calling the method isLast may be expensive because the JDBC driver might need to fetch ahead one row in order to determine whether the current row is the last row in the result set. Note: Support for the isLast method is optional for ResultSets with a result set type of TYPE_FORWARD_ONLY Boolean last() Moves the cursor to the last row in this ResultSet object. Unit moveToCurrentRow() Moves the cursor to the remembered cursor position, usually the current row. This method has no effect if the cursor is not on the insert row. Unit moveToInsertRow() Moves the cursor 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 updater methods prior to inserting the row into the result set. Only the updater, getter, 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. An updater method must be called before a getter method can be called on a column value. Boolean next() Moves the cursor froward one row from its current position. A ResultSet cursor is initially positioned before the first row; the first call to the method next makes the first row the current row; the second call makes the second row the current row, and so on. When a call to the next method returns false, the cursor is positioned after the last row. Any invocation of a ResultSet method which requires a current row will result in a SQLException being thrown. If the result set type is TYPE_FORWARD_ONLY, it is vendor specified whether their JDBC driver implementation will return false or throw an SQLException on a subsequent call to next. If an input stream is open for the current row, a call to the method next will implicitly close it. A ResultSet object's warning chain is cleared when a new row is read. Boolean previous() Moves the cursor to the previous row in this ResultSet object. When a call to the previous method returns false, the cursor is positioned before the first row. Any invocation of a ResultSet method which requires a current row will result in a SQLException being thrown. If an input stream is open for the current row, a call to the method previous will implicitly close it. A ResultSet object's warning change is cleared when a new row is read. Unit refreshRow() Refreshes the current row with its most recent value in the database. This method cannot be called when the cursor is 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 an updater method, but before calling the method updateRow, then the updates made to the row are lost. Calling the method refreshRow frequently will likely slow performance. Boolean relative(rows: Int) Moves the cursor a relative number of rows, either positive or negative. Attempting to move beyond the first/last row in the result set positions the cursor before/after the the first/last row. Calling relative(0) is valid, but does not change the cursor position. Note: Calling the method relative(1) is identical to calling the method next() and calling the method relative(-1) is identical to calling the method previous(). Boolean rowDeleted() Retrieves whether a row has been deleted. A deleted row may leave a visible "hole" in a result set. This method can be used to detect holes in a result set. The value returned depends on whether or not this ResultSet object can detect deletions. Note: Support for the rowDeleted method is optional with a result set concurrency of CONCUR_READ_ONLY Boolean rowInserted() Retrieves whether the current row has had an insertion. The value returned depends on whether or not this ResultSet object can detect visible inserts. Note: Support for the rowInserted method is optional with a result set concurrency of CONCUR_READ_ONLY Boolean rowUpdated() Retrieves whether the current row has been updated. The value returned depends on whether or not the result set can detect updates. Note: Support for the rowUpdated method is optional with a result set concurrency of CONCUR_READ_ONLY Unit setFetchDirection(direction: Int) Gives a hint as to the direction in which the rows in this ResultSet object will be processed. The initial value is determined by the Statement object that produced this ResultSet object. The fetch direction may be changed at any time. Unit setFetchSize(rows: Int) Gives the JDBC driver a hint as to the number of rows that should be fetched from the database when more rows are needed for this ResultSet object. If the fetch size specified is zero, the JDBC driver ignores the value and is free to make its own best guess as to what the fetch size should be. The default value is set by the Statement object that created the result set. The fetch size may be changed at any time. Unit updateArray(columnIndex: Int, x: Array!) Updates the designated column with a java.sql.Array 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. Unit updateArray(columnLabel: String!, x: Array!) Updates the designated column with a java.sql.Array 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. Unit updateAsciiStream(columnIndex: Int, x: InputStream!) 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. Unit updateAsciiStream(columnIndex: Int, x: InputStream!, length: Int) 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. Unit updateAsciiStream(columnIndex: Int, x: InputStream!, length: Long) 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. Unit updateAsciiStream(columnLabel: String!, x: InputStream!) 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. Unit updateAsciiStream(columnLabel: String!, x: InputStream!, length: Int) 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. Unit updateAsciiStream(columnLabel: String!, x: InputStream!, length: Long) 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. Unit updateBigDecimal(columnIndex: Int, x: BigDecimal!) Updates the designated column with a java.math.BigDecimal 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. Unit updateBigDecimal(columnLabel: String!, x: BigDecimal!) Updates the designated column with a java.sql.BigDecimal 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. Unit updateBinaryStream(columnIndex: Int, x: InputStream!) 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. Unit updateBinaryStream(columnIndex: Int, x: InputStream!, length: Int) 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. Unit updateBinaryStream(columnIndex: Int, x: InputStream!, length: Long) 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. Unit updateBinaryStream(columnLabel: String!, x: InputStream!) 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. Unit updateBinaryStream(columnLabel: String!, x: InputStream!, length: Int) 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. Unit updateBinaryStream(columnLabel: String!, x: InputStream!, length: Long) 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. Unit updateBlob(columnIndex: Int, inputStream: InputStream!) 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. Unit updateBlob(columnIndex: Int, inputStream: InputStream!, length: Long) 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. Unit updateBlob(columnIndex: Int, x: Blob!) Updates the designated column with a java.sql.Blob 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. Unit updateBlob(columnLabel: String!, inputStream: InputStream!) 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. Unit updateBlob(columnLabel: String!, inputStream: InputStream!, length: Long) 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. Unit updateBlob(columnLabel: String!, x: Blob!) Updates the designated column with a java.sql.Blob 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. Unit updateBoolean(columnIndex: Int, x: Boolean) Updates the designated column with a boolean 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. Unit updateBoolean(columnLabel: String!, x: Boolean) Updates the designated column with a boolean 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. Unit updateByte(columnIndex: Int, x: Byte) Updates the designated column with a byte 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. Unit updateByte(columnLabel: String!, x: Byte) Updates the designated column with a byte 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. Unit updateBytes(columnIndex: Int, x: ByteArray!) Updates the designated column with a byte array 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. Unit updateBytes(columnLabel: String!, x: ByteArray!) Updates the designated column with a byte array 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. Unit updateCharacterStream(columnIndex: Int, x: Reader!) 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. Unit updateCharacterStream(columnIndex: Int, x: Reader!, length: Int) 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. Unit updateCharacterStream(columnIndex: Int, x: Reader!, length: Long) 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. Unit updateCharacterStream(columnLabel: String!, reader: Reader!) 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. Unit updateCharacterStream(columnLabel: String!, reader: Reader!, length: Int) 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. Unit updateCharacterStream(columnLabel: String!, reader: Reader!, length: Long) 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. Unit updateClob(columnIndex: Int, reader: Reader!) 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. Unit updateClob(columnIndex: Int, reader: Reader!, length: Long) 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. Unit updateClob(columnIndex: Int, x: Clob!) Updates the designated column with a java.sql.Clob 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. Unit updateClob(columnLabel: String!, reader: Reader!) 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. Unit updateClob(columnLabel: String!, reader: Reader!, length: Long) 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. Unit updateClob(columnLabel: String!, x: Clob!) Updates the designated column with a java.sql.Clob 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. Unit updateDate(columnIndex: Int, x: Date!) Updates the designated column with a java.sql.Date 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. Unit updateDate(columnLabel: String!, x: Date!) Updates the designated column with a java.sql.Date 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. Unit updateDouble(columnIndex: Int, x: Double) Updates the designated column with a double 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. Unit updateDouble(columnLabel: String!, x: Double) Updates the designated column with a double 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. Unit updateFloat(columnIndex: Int, x: Float) Updates the designated column with a float 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. Unit updateFloat(columnLabel: String!, x: Float) Updates the designated column with a float 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. Unit updateInt(columnIndex: Int, x: Int) Updates the designated column with an int 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. Unit updateInt(columnLabel: String!, x: Int) Updates the designated column with an int 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. Unit updateLong(columnIndex: Int, x: Long) Updates the designated column with a long 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. Unit updateLong(columnLabel: String!, x: Long) Updates the designated column with a long 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. Unit updateNCharacterStream(columnIndex: Int, x: Reader!) 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. Unit updateNCharacterStream(columnIndex: Int, x: Reader!, length: Long) 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. Unit updateNCharacterStream(columnLabel: String!, reader: Reader!) 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. Unit updateNCharacterStream(columnLabel: String!, reader: Reader!, length: Long) 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. Unit updateNClob(columnIndex: Int, 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. 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. Unit updateNClob(columnIndex: Int, reader: Reader!, length: Long) 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. Unit updateNClob(columnIndex: Int, nClob: NClob!) 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. Unit updateNClob(columnLabel: String!, reader: Reader!) 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. Unit updateNClob(columnLabel: String!, reader: Reader!, length: Long) 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. Unit updateNClob(columnLabel: String!, nClob: NClob!) 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. Unit updateNString(columnIndex: Int, nString: String!) 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. Unit updateNString(columnLabel: String!, nString: String!) 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. Unit updateNull(columnIndex: Int) Updates the designated column with a null 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. Unit updateNull(columnLabel: String!) Updates the designated column with a null 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. Unit updateObject(columnIndex: Int, x: Any!) Updates the designated column with an Object 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. Unit updateObject(columnIndex: Int, x: Any!, scaleOrLength: Int) Updates the designated column with an Object 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. If the second argument is an InputStream then the stream must contain the number of bytes specified by scaleOrLength. If the second argument is a Reader then the reader must contain the number of characters specified by scaleOrLength. If these conditions are not true the driver will generate a SQLException when the statement is executed. Unit updateObject(columnLabel: String!, x: Any!) Updates the designated column with an Object 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. Unit updateObject(columnLabel: String!, x: Any!, scaleOrLength: Int) Updates the designated column with an Object 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. If the second argument is an InputStream then the stream must contain the number of bytes specified by scaleOrLength. If the second argument is a Reader then the reader must contain the number of characters specified by scaleOrLength. If these conditions are not true the driver will generate a SQLException when the statement is executed. Unit updateRef(columnIndex: Int, x: Ref!) Updates the designated column with a java.sql.Ref 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. Unit updateRef(columnLabel: String!, x: Ref!) Updates the designated column with a java.sql.Ref 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. Unit updateRow() Updates the underlying database with the new contents of the current row of this ResultSet object. This method cannot be called when the cursor is on the insert row. Unit updateRowId(columnIndex: Int, x: RowId!) 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. Unit updateRowId(columnLabel: String!, x: RowId!) 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. Unit updateSQLXML(columnIndex: Int, xmlObject: SQLXML!) 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. Unit updateSQLXML(columnLabel: String!, xmlObject: SQLXML!) 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. Unit updateShort(columnIndex: Int, x: Short) Updates the designated column with a short 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. Unit updateShort(columnLabel: String!, x: Short) Updates the designated column with a short 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. Unit updateString(columnIndex: Int, x: String!) Updates the designated column with a String 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. Unit updateString(columnLabel: String!, x: String!) Updates the designated column with a String 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. Unit updateTime(columnIndex: Int, x: Time!) Updates the designated column with a java.sql.Time 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. Unit updateTime(columnLabel: String!, x: Time!) Updates the designated column with a java.sql.Time 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. Unit updateTimestamp(columnIndex: Int, x: Timestamp!) Updates the designated column with a java.sql.Timestamp 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. Unit updateTimestamp(columnLabel: String!, x: Timestamp!) Updates the designated column with a java.sql.Timestamp 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. Boolean wasNull() Reports whether the last column read had a value of SQL NULL. Note that you must first call one of the getter methods on a column to try to read its value and then call the method wasNull to see if the value read was SQL NULL.
From class Wrapper Boolean isWrapperFor(iface: Class<*>!) Returns true if this either implements the interface argument or is directly or indirectly a wrapper for an object that does. Returns false otherwise. If this implements the interface then return true, else if this is a wrapper then return the result of recursively calling isWrapperFor on the wrapped object. If this does not implement the interface and is not a wrapper, return false. This method should be implemented as a low-cost operation compared to unwrap so that callers can use this method to avoid expensive unwrap calls that may fail. If this method returns true then calling unwrap with the same argument should succeed. T unwrap(iface: Class<T>!) Returns an object that implements the given interface to allow access to non-standard methods, or standard methods not exposed by the proxy. If the receiver implements the interface then the result is the receiver or a proxy for the receiver. If the receiver is a wrapper and the wrapped object implements the interface then the result is the wrapped object or a proxy for the wrapped object. Otherwise return the the result of calling unwrap recursively on the wrapped object or a proxy for that result. If the receiver is not a wrapper and does not implement the interface, then an SQLException is thrown.

Public methods

addRowSetListener

Added in API level 1

abstract fun addRowSetListener(listener: RowSetListener!): Unit

Registers the given listener so that it will be notified of events that occur on this RowSet object.

Parameters
listener	RowSetListener!: a component that has implemented the RowSetListener interface and wants to be notified when events occur on this RowSet object

See Also

• #removeRowSetListener

clearParameters

Added in API level 1

abstract fun clearParameters(): Unit

Clears the parameters set for this RowSet object's command.

In general, parameter values remain in force for repeated use of a RowSet object. Setting a parameter value automatically clears its previous value. However, in some cases it is useful to immediately release the resources used by the current parameter values, which can be done by calling the method clearParameters.

Exceptions
java.sql.SQLException	if a database access error occurs

execute

Added in API level 1

abstract fun execute(): Unit

Fills this RowSet object with data.

The execute method may use the following properties to create a connection for reading data: url, data source name, user name, password, transaction isolation, and type map. The execute method may use the following properties to create a statement to execute a command: command, read only, maximum field size, maximum rows, escape processing, and query timeout.

If the required properties have not been set, an exception is thrown. If this method is successful, the current contents of the rowset are discarded and the rowset's metadata is also (re)set. If there are outstanding updates, they are ignored.

If this RowSet object does not maintain a continuous connection with its source of data, it may use a reader (a RowSetReader object) to fill itself with data. In this case, a reader will have been registered with this RowSet object, and the method execute will call on the reader's readData method as part of its implementation.

Exceptions
java.sql.SQLException	if a database access error occurs or any of the properties necessary for making a connection and creating a statement have not been set

getCommand

Added in API level 1

abstract fun getCommand(): String!

Retrieves this RowSet object's command property. The command property contains a command string, which must be an SQL query, that can be executed to fill the rowset with data. The default value is null.

Return
String!	the command string; may be null

See Also

• #setCommand

getDataSourceName

Added in API level 1

abstract fun getDataSourceName(): String!

Retrieves the logical name that identifies the data source for this RowSet object.

Return
String!	a data source name

See Also

• #setDataSourceName
• #setUrl

getEscapeProcessing

Added in API level 1

abstract fun getEscapeProcessing(): Boolean

Retrieves whether escape processing is enabled for this RowSet object. If escape scanning is enabled, which is the default, the driver will do escape substitution before sending an SQL statement to the database.

Return
Boolean	true if escape processing is enabled; false if it is disabled

Exceptions
java.sql.SQLException	if a database access error occurs

See Also

• #setEscapeProcessing

getMaxFieldSize

Added in API level 1

abstract fun getMaxFieldSize(): Int

Retrieves the maximum number of bytes that may be returned for certain column values. This limit applies only to BINARY, VARBINARY, LONGVARBINARYBINARY, CHAR, VARCHAR, LONGVARCHAR, NCHAR and NVARCHAR columns. If the limit is exceeded, the excess data is silently discarded.

Return
Int	the current maximum column size limit; zero means that there is no limit

Exceptions
java.sql.SQLException	if a database access error occurs

See Also

• #setMaxFieldSize

getMaxRows

Added in API level 1

abstract fun getMaxRows(): Int

Retrieves the maximum number of rows that this RowSet object can contain. If the limit is exceeded, the excess rows are silently dropped.

Return
Int	the current maximum number of rows that this RowSet object can contain; zero means unlimited

Exceptions
java.sql.SQLException	if a database access error occurs

See Also

• #setMaxRows

getPassword

Added in API level 1

abstract fun getPassword(): String!

Retrieves the password used to create a database connection. The password property is set at run time before calling the method execute. It is not usually part of the serialized state of a RowSet object.

Return
String!	the password for making a database connection

See Also

• #setPassword

getQueryTimeout

Added in API level 1

abstract fun getQueryTimeout(): Int

Retrieves the maximum number of seconds the driver will wait for a statement to execute. If this limit is exceeded, an SQLException is thrown.

Return
Int	the current query timeout limit in seconds; zero means unlimited

Exceptions
java.sql.SQLException	if a database access error occurs

See Also

• #setQueryTimeout

getTransactionIsolation

Added in API level 1

abstract fun getTransactionIsolation(): Int

Retrieves the transaction isolation level set for this RowSet object.

Return
Int	the transaction isolation level; one of Connection.TRANSACTION_READ_UNCOMMITTED, Connection.TRANSACTION_READ_COMMITTED, Connection.TRANSACTION_REPEATABLE_READ, or Connection.TRANSACTION_SERIALIZABLE

See Also

• #setTransactionIsolation

getTypeMap

Added in API level 1

abstract fun getTypeMap(): MutableMap<String!, Class<*>!>!

Retrieves the Map object associated with this RowSet object, which specifies the custom mapping of SQL user-defined types, if any. The default is for the type map to be empty.

Return
MutableMap<String!, Class<*>!>!	a java.util.Map object containing the names of SQL user-defined types and the Java classes to which they are to be mapped

Exceptions
java.sql.SQLException	if a database access error occurs

See Also

• #setTypeMap

getUrl

Added in API level 1

abstract fun getUrl(): String!

Retrieves the url property this RowSet object will use to create a connection if it uses the DriverManager instead of a DataSource object to establish the connection. The default value is null.

Return
String!	a string url

Exceptions
java.sql.SQLException	if a database access error occurs

See Also

• #setUrl

getUsername

Added in API level 1

abstract fun getUsername(): String!

Retrieves the username used to create a database connection for this RowSet object. The username property is set at run time before calling the method execute. It is not usually part of the serialized state of a RowSet object.

Return
String!	the username property

See Also

• #setUsername

isReadOnly

Added in API level 1

abstract fun isReadOnly(): Boolean

Retrieves whether this RowSet object is read-only. If updates are possible, the default is for a rowset to be updatable.

Attempts to update a read-only rowset will result in an SQLException being thrown.

Return
Boolean	true if this RowSet object is read-only; false if it is updatable

See Also

• #setReadOnly

removeRowSetListener

Added in API level 1

abstract fun removeRowSetListener(listener: RowSetListener!): Unit

Removes the specified listener from the list of components that will be notified when an event occurs on this RowSet object.

Parameters
listener	RowSetListener!: a component that has been registered as a listener for this RowSet object

See Also

• #addRowSetListener

setArray

Added in API level 1

abstract fun setArray(
    i: Int, 
    x: Array!
): Unit

Sets the designated parameter in this RowSet object's command with the given Array value. The driver will convert this to the ARRAY value that the Array object represents before sending it to the database.

Parameters
i	Int: the first parameter is 1, the second is 2, ...
x	Array!: an object representing an SQL array

Exceptions
java.sql.SQLException	if a database access error occurs

setAsciiStream

Added in API level 9

abstract fun setAsciiStream(
    parameterIndex: Int, 
    x: InputStream!
): Unit

Sets the designated parameter in this RowSet object's command to the given input stream. When a very large ASCII value is input to a LONGVARCHAR parameter, it may be more practical to send it via a java.io.InputStream. Data will be read from the stream as needed until end-of-file is reached. The JDBC driver will do any necessary conversion from ASCII to the database char format.

Note: This stream object can either be a standard Java stream object or your own subclass that implements the standard interface.

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

Parameters
parameterIndex	Int: the first parameter is 1, the second is 2, ...
x	InputStream!: the Java input stream that contains the ASCII parameter value

Exceptions
java.sql.SQLFeatureNotSupportedException	if the JDBC driver does not support this method
java.sql.SQLException	if a database access error occurs or this method is called on a closed PreparedStatement

setAsciiStream

Added in API level 1

abstract fun setAsciiStream(
    parameterIndex: Int, 
    x: InputStream!, 
    length: Int
): Unit

Sets the designated parameter in this RowSet object's command to the given java.io.InputStream value. It may be more practical to send a very large ASCII value via a java.io.InputStream rather than as a LONGVARCHAR parameter. The driver will read the data from the stream as needed until it reaches end-of-file.

Note: This stream object can either be a standard Java stream object or your own subclass that implements the standard interface.

Parameters
parameterIndex	Int: the first parameter is 1, the second is 2, ...
x	InputStream!: the Java input stream that contains the ASCII parameter value
length	Int: the number of bytes in the stream

Exceptions
java.sql.SQLException	if a database access error occurs

setAsciiStream

Added in API level 9

abstract fun setAsciiStream(
    parameterName: String!, 
    x: InputStream!
): Unit

Sets the designated parameter to the given input stream. When a very large ASCII value is input to a LONGVARCHAR parameter, it may be more practical to send it via a java.io.InputStream. Data will be read from the stream as needed until end-of-file is reached. The JDBC driver will do any necessary conversion from ASCII to the database char format.

Note: This stream object can either be a standard Java stream object or your own subclass that implements the standard interface.

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

Parameters
parameterName	String!: the name of the parameter
x	InputStream!: the Java input stream that contains the ASCII parameter value

Exceptions
java.sql.SQLFeatureNotSupportedException	if the JDBC driver does not support this method
java.sql.SQLException	if a database access error occurs or this method is called on a closed CallableStatement

setAsciiStream

Added in API level 9

abstract fun setAsciiStream(
    parameterName: String!, 
    x: InputStream!, 
    length: Int
): Unit

Sets the designated parameter to the given input stream, which will have the specified number of bytes. When a very large ASCII value is input to a LONGVARCHAR parameter, it may be more practical to send it via a java.io.InputStream. Data will be read from the stream as needed until end-of-file is reached. The JDBC driver will do any necessary conversion from ASCII to the database char format.

Note: This stream object can either be a standard Java stream object or your own subclass that implements the standard interface.

Parameters
parameterName	String!: the name of the parameter
x	InputStream!: the Java input stream that contains the ASCII parameter value
length	Int: the number of bytes in the stream

Exceptions
java.sql.SQLException	if a database access error occurs or this method is called on a closed CallableStatement
java.sql.SQLFeatureNotSupportedException	if the JDBC driver does not support this method

setBigDecimal

Added in API level 1

abstract fun setBigDecimal(
    parameterIndex: Int, 
    x: BigDecimal!
): Unit

Sets the designated parameter in this RowSet object's command to the given java.math.BigDeciaml value. The driver converts this to an SQL NUMERIC value before sending it to the database.

Parameters
parameterIndex	Int: the first parameter is 1, the second is 2, ...
x	BigDecimal!: the parameter value

Exceptions
java.sql.SQLException	if a database access error occurs

setBigDecimal

Added in API level 9

abstract fun setBigDecimal(
    parameterName: String!, 
    x: BigDecimal!
): Unit

Sets the designated parameter to the given java.math.BigDecimal value. The driver converts this to an SQL NUMERIC value when it sends it to the database.

Parameters
parameterName	String!: the name of the parameter
x	BigDecimal!: the parameter value

Exceptions
java.sql.SQLException	if a database access error occurs or this method is called on a closed CallableStatement
java.sql.SQLFeatureNotSupportedException	if the JDBC driver does not support this method

See Also

setBinaryStream

Added in API level 9

abstract fun setBinaryStream(
    parameterIndex: Int, 
    x: InputStream!
): Unit

Sets the designated parameter in this RowSet object's command to the given input stream. When a very large binary value is input to a LONGVARBINARY parameter, it may be more practical to send it via a java.io.InputStream object. The data will be read from the stream as needed until end-of-file is reached.

Note: This stream object can either be a standard Java stream object or your own subclass that implements the standard interface.

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

Parameters
parameterIndex	Int: the first parameter is 1, the second is 2, ...
x	InputStream!: the java input stream which contains the binary parameter value

Exceptions
java.sql.SQLFeatureNotSupportedException	if the JDBC driver does not support this method
java.sql.SQLException	if a database access error occurs or this method is called on a closed PreparedStatement

setBinaryStream

Added in API level 1

abstract fun setBinaryStream(
    parameterIndex: Int, 
    x: InputStream!, 
    length: Int
): Unit

Sets the designated parameter in this RowSet object's command to the given java.io.InputStream value. It may be more practical to send a very large binary value via a java.io.InputStream rather than as a LONGVARBINARY parameter. The driver will read the data from the stream as needed until it reaches end-of-file.

Note: This stream object can either be a standard Java stream object or your own subclass that implements the standard interface.

Parameters
parameterIndex	Int: the first parameter is 1, the second is 2, ...
x	InputStream!: the java input stream which contains the binary parameter value
length	Int: the number of bytes in the stream

Exceptions
java.sql.SQLException	if a database access error occurs

setBinaryStream

Added in API level 9

abstract fun setBinaryStream(
    parameterName: String!, 
    x: InputStream!
): Unit

Sets the designated parameter to the given input stream. When a very large binary value is input to a LONGVARBINARY parameter, it may be more practical to send it via a java.io.InputStream object. The data will be read from the stream as needed until end-of-file is reached.

Note: This stream object can either be a standard Java stream object or your own subclass that implements the standard interface.

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

Parameters
parameterName	String!: the name of the parameter
x	InputStream!: the java input stream which contains the binary parameter value

Exceptions
java.sql.SQLFeatureNotSupportedException	if the JDBC driver does not support this method
java.sql.SQLException	if a database access error occurs or this method is called on a closed CallableStatement

setBinaryStream

Added in API level 9

abstract fun setBinaryStream(
    parameterName: String!, 
    x: InputStream!, 
    length: Int
): Unit

Sets the designated parameter to the given input stream, which will have the specified number of bytes. When a very large binary value is input to a LONGVARBINARY parameter, it may be more practical to send it via a java.io.InputStream object. The data will be read from the stream as needed until end-of-file is reached.

Note: This stream object can either be a standard Java stream object or your own subclass that implements the standard interface.

Parameters
parameterName	String!: the name of the parameter
x	InputStream!: the java input stream which contains the binary parameter value
length	Int: the number of bytes in the stream

Exceptions
java.sql.SQLException	if a database access error occurs or this method is called on a closed CallableStatement
java.sql.SQLFeatureNotSupportedException	if the JDBC driver does not support this method

setBlob

Added in API level 9

abstract fun setBlob(
    parameterIndex: Int, 
    inputStream: InputStream!
): Unit

Sets the designated parameter to a InputStream object. This method differs from the setBinaryStream (int, InputStream) method because it informs the driver that the parameter value should be sent to the server as a BLOB. When the setBinaryStream method is used, the driver may have to do extra work to determine whether the parameter data should be sent to the server as a LONGVARBINARY or a BLOB

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

Parameters
parameterIndex	Int: index of the first parameter is 1, the second is 2, ...
inputStream	InputStream!: An object that contains the data to set the parameter value to.

Exceptions
java.sql.SQLException	if a database access error occurs, this method is called on a closed PreparedStatement or if parameterIndex does not correspond to a parameter marker in the SQL statement,
java.sql.SQLFeatureNotSupportedException	if the JDBC driver does not support this method

setBlob

Added in API level 9

abstract fun setBlob(
    parameterIndex: Int, 
    inputStream: InputStream!, 
    length: Long
): Unit

Sets the designated parameter to a InputStream object. The inputstream must contain the number of characters specified by length otherwise a SQLException will be generated when the PreparedStatement is executed. This method differs from the setBinaryStream (int, InputStream, int) method because it informs the driver that the parameter value should be sent to the server as a BLOB. When the setBinaryStream method is used, the driver may have to do extra work to determine whether the parameter data should be sent to the server as a LONGVARBINARY or a BLOB

Parameters
parameterIndex	Int: index of the first parameter is 1, the second is 2, ...
inputStream	InputStream!: An object that contains the data to set the parameter value to.
length	Long: the number of bytes in the parameter data.

Exceptions
java.sql.SQLException	if a database access error occurs, this method is called on a closed PreparedStatement, if parameterIndex does not correspond to a parameter marker in the SQL statement, if the length specified is less than zero or if the number of bytes in the inputstream does not match the specfied length.
java.sql.SQLFeatureNotSupportedException	if the JDBC driver does not support this method

setBlob

Added in API level 1

abstract fun setBlob(
    i: Int, 
    x: Blob!
): Unit

Sets the designated parameter in this RowSet object's command with the given Blob value. The driver will convert this to the BLOB value that the Blob object represents before sending it to the database.

Parameters
i	Int: the first parameter is 1, the second is 2, ...
x	Blob!: an object representing a BLOB

Exceptions
java.sql.SQLException	if a database access error occurs

setBlob

Added in API level 9

abstract fun setBlob(
    parameterName: String!, 
    inputStream: InputStream!
): Unit

Sets the designated parameter to a InputStream object. This method differs from the setBinaryStream (int, InputStream) method because it informs the driver that the parameter value should be sent to the server as a BLOB. When the setBinaryStream method is used, the driver may have to do extra work to determine whether the parameter data should be send to the server as a LONGVARBINARY or a BLOB

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

Parameters
parameterName	String!: the name of the parameter
inputStream	InputStream!: An object that contains the data to set the parameter value to.

Exceptions
java.sql.SQLException	if a database access error occurs or this method is called on a closed CallableStatement
java.sql.SQLFeatureNotSupportedException	if the JDBC driver does not support this method

setBlob

Added in API level 9

abstract fun setBlob(
    parameterName: String!, 
    inputStream: InputStream!, 
    length: Long
): Unit

Sets the designated parameter to a InputStream object. The inputstream must contain the number of characters specified by length, otherwise a SQLException will be generated when the CallableStatement is executed. This method differs from the setBinaryStream (int, InputStream, int) method because it informs the driver that the parameter value should be sent to the server as a BLOB. When the setBinaryStream method is used, the driver may have to do extra work to determine whether the parameter data should be sent to the server as a LONGVARBINARY or a BLOB

Parameters
parameterName	String!: the name of the parameter to be set the second is 2, ...
inputStream	InputStream!: An object that contains the data to set the parameter value to.
length	Long: the number of bytes in the parameter data.

Exceptions
java.sql.SQLException	if parameterIndex does not correspond to a parameter marker in the SQL statement, or if the length specified is less than zero; if the number of bytes in the inputstream does not match the specfied length; if a database access error occurs or this method is called on a closed CallableStatement
java.sql.SQLFeatureNotSupportedException	if the JDBC driver does not support this method

setBlob

Added in API level 9

abstract fun setBlob(
    parameterName: String!, 
    x: Blob!
): Unit

Sets the designated parameter to the given java.sql.Blob object. The driver converts this to an SQL BLOB value when it sends it to the database.

Parameters
parameterName	String!: the name of the parameter
x	Blob!: a Blob object that maps an SQL BLOB value

Exceptions
java.sql.SQLException	if a database access error occurs or this method is called on a closed CallableStatement
java.sql.SQLFeatureNotSupportedException	if the JDBC driver does not support this method

setBoolean

Added in API level 1

abstract fun setBoolean(
    parameterIndex: Int, 
    x: Boolean
): Unit

Sets the designated parameter in this RowSet object's command to the given Java boolean value. The driver converts this to an SQL BIT value before sending it to the database.

Parameters
parameterIndex	Int: the first parameter is 1, the second is 2, ...
x	Boolean: the parameter value

Exceptions
java.sql.SQLException	if a database access error occurs

setBoolean

Added in API level 9

abstract fun setBoolean(
    parameterName: String!, 
    x: Boolean
): Unit

Sets the designated parameter to the given Java boolean value. The driver converts this to an SQL BIT or BOOLEAN value when it sends it to the database.

Parameters
parameterName	String!: the name of the parameter
x	Boolean: the parameter value

Exceptions
java.sql.SQLException	if a database access error occurs or this method is called on a closed CallableStatement
java.sql.SQLFeatureNotSupportedException	if the JDBC driver does not support this method

See Also

setByte

Added in API level 1

abstract fun setByte(
    parameterIndex: Int, 
    x: Byte
): Unit

Sets the designated parameter in this RowSet object's command to the given Java byte value. The driver converts this to an SQL TINYINT value before sending it to the database.

Parameters
parameterIndex	Int: the first parameter is 1, the second is 2, ...
x	Byte: the parameter value

Exceptions
java.sql.SQLException	if a database access error occurs

setByte

Added in API level 9

abstract fun setByte(
    parameterName: String!, 
    x: Byte
): Unit

Sets the designated parameter to the given Java byte value. The driver converts this to an SQL TINYINT value when it sends it to the database.

Parameters
parameterName	String!: the name of the parameter
x	Byte: the parameter value

Exceptions
java.sql.SQLException	if a database access error occurs or this method is called on a closed CallableStatement
java.sql.SQLFeatureNotSupportedException	if the JDBC driver does not support this method

See Also

setBytes

Added in API level 1

abstract fun setBytes(
    parameterIndex: Int, 
    x: ByteArray!
): Unit

Sets the designated parameter in this RowSet object's command to the given Java array of byte values. Before sending it to the database, the driver converts this to an SQL VARBINARY or LONGVARBINARY value, depending on the argument's size relative to the driver's limits on VARBINARY values.

Parameters
parameterIndex	Int: the first parameter is 1, the second is 2, ...
x	ByteArray!: the parameter value

Exceptions
java.sql.SQLException	if a database access error occurs

setBytes

Added in API level 9

abstract fun setBytes(
    parameterName: String!, 
    x: ByteArray!
): Unit

Sets the designated parameter to the given Java array of bytes. The driver converts this to an SQL VARBINARY or LONGVARBINARY (depending on the argument's size relative to the driver's limits on VARBINARY values) when it sends it to the database.

Parameters
parameterName	String!: the name of the parameter
x	ByteArray!: the parameter value

Exceptions
java.sql.SQLException	if a database access error occurs or this method is called on a closed CallableStatement
java.sql.SQLFeatureNotSupportedException	if the JDBC driver does not support this method

See Also

setCharacterStream

Added in API level 9

abstract fun setCharacterStream(
    parameterIndex: Int, 
    reader: Reader!
): Unit

Sets the designated parameter in this RowSet object's command to the given Reader object. 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 data will be read from the stream as needed until end-of-file is reached. The JDBC driver will do any necessary conversion from UNICODE to the database char format.

Note: This stream object can either be a standard Java stream object or your own subclass that implements the standard interface.

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

Parameters
parameterIndex	Int: the first parameter is 1, the second is 2, ...
reader	Reader!: the java.io.Reader object that contains the Unicode data

Exceptions
java.sql.SQLFeatureNotSupportedException	if the JDBC driver does not support this method
java.sql.SQLException	if a database access error occurs or this method is called on a closed PreparedStatement

setCharacterStream

Added in API level 1

abstract fun setCharacterStream(
    parameterIndex: Int, 
    reader: Reader!, 
    length: Int
): Unit

Sets the designated parameter in this RowSet object's command to the given java.io.Reader value. It may be more practical to send a very large UNICODE value via a java.io.Reader rather than as a LONGVARCHAR parameter. The driver will read the data from the stream as needed until it reaches end-of-file.

Note: This stream object can either be a standard Java stream object or your own subclass that implements the standard interface.

Parameters
parameterIndex	Int: the first parameter is 1, the second is 2, ...
reader	Reader!: the Reader object that contains the UNICODE data to be set
length	Int: the number of characters in the stream

Exceptions
java.sql.SQLException	if a database access error occurs

setCharacterStream

Added in API level 9

abstract fun setCharacterStream(
    parameterName: String!, 
    reader: Reader!
): Unit

Sets the designated parameter to the given Reader object. 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 data will be read from the stream as needed until end-of-file is reached. The JDBC driver will do any necessary conversion from UNICODE to the database char format.

Note: This stream object can either be a standard Java stream object or your own subclass that implements the standard interface.

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

Parameters
parameterName	String!: the name of the parameter
reader	Reader!: the java.io.Reader object that contains the Unicode data

Exceptions
java.sql.SQLFeatureNotSupportedException	if the JDBC driver does not support this method
java.sql.SQLException	if a database access error occurs or this method is called on a closed CallableStatement

setCharacterStream

Added in API level 9

abstract fun setCharacterStream(
    parameterName: String!, 
    reader: Reader!, 
    length: Int
): Unit

Sets the designated parameter to 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 data will be read from the stream as needed until end-of-file is reached. The JDBC driver will do any necessary conversion from UNICODE to the database char format.

Note: This stream object can either be a standard Java stream object or your own subclass that implements the standard interface.

Parameters
parameterName	String!: the name of the parameter
reader	Reader!: the java.io.Reader object that contains the UNICODE data used as the designated parameter
length	Int: the number of characters in the stream

Exceptions
java.sql.SQLException	if a database access error occurs or this method is called on a closed CallableStatement
java.sql.SQLFeatureNotSupportedException	if the JDBC driver does not support this method

setClob

Added in API level 9

abstract fun setClob(
    parameterIndex: Int, 
    reader: Reader!
): Unit

Sets the designated parameter to a Reader object. This method differs from the setCharacterStream (int, Reader) method because it informs the driver that the parameter value should be sent to the server as a CLOB. When the setCharacterStream method is used, the driver may have to do extra work to determine whether the parameter data should be sent to the server as a LONGVARCHAR or a CLOB

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

Parameters
parameterIndex	Int: index of the first parameter is 1, the second is 2, ...
reader	Reader!: An object that contains the data to set the parameter value to.

Exceptions
java.sql.SQLException	if a database access error occurs, this method is called on a closed PreparedStatementor if parameterIndex does not correspond to a parameter marker in the SQL statement
java.sql.SQLFeatureNotSupportedException	if the JDBC driver does not support this method

setClob

Added in API level 9

abstract fun setClob(
    parameterIndex: Int, 
    reader: Reader!, 
    length: Long
): Unit

Sets the designated parameter to a Reader object. The reader must contain the number of characters specified by length otherwise a SQLException will be generated when the PreparedStatement is executed. This method differs from the setCharacterStream (int, Reader, int) method because it informs the driver that the parameter value should be sent to the server as a CLOB. When the setCharacterStream method is used, the driver may have to do extra work to determine whether the parameter data should be sent to the server as a LONGVARCHAR or a CLOB

Parameters
parameterIndex	Int: index of the first parameter is 1, the second is 2, ...
reader	Reader!: An object that contains the data to set the parameter value to.
length	Long: the number of characters in the parameter data.

Exceptions
java.sql.SQLException	if a database access error occurs, this method is called on a closed PreparedStatement, if parameterIndex does not correspond to a parameter marker in the SQL statement, or if the length specified is less than zero.
java.sql.SQLFeatureNotSupportedException	if the JDBC driver does not support this method

setClob

Added in API level 1

abstract fun setClob(
    i: Int, 
    x: Clob!
): Unit

Sets the designated parameter in this RowSet object's command with the given Clob value. The driver will convert this to the CLOB value that the Clob object represents before sending it to the database.

Parameters
i	Int: the first parameter is 1, the second is 2, ...
x	Clob!: an object representing a CLOB

Exceptions
java.sql.SQLException	if a database access error occurs

setClob

Added in API level 9

abstract fun setClob(
    parameterName: String!, 
    reader: Reader!
): Unit

Sets the designated parameter to a Reader object. This method differs from the setCharacterStream (int, Reader) method because it informs the driver that the parameter value should be sent to the server as a CLOB. When the setCharacterStream method is used, the driver may have to do extra work to determine whether the parameter data should be send to the server as a LONGVARCHAR or a CLOB

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

Parameters
parameterName	String!: the name of the parameter
reader	Reader!: An object that contains the data to set the parameter value to.

Exceptions
java.sql.SQLException	if a database access error occurs or this method is called on a closed CallableStatement
java.sql.SQLFeatureNotSupportedException	if the JDBC driver does not support this method

setClob

Added in API level 9

abstract fun setClob(
    parameterName: String!, 
    reader: Reader!, 
    length: Long
): Unit

Sets the designated parameter to a Reader object. The reader must contain the number of characters specified by length otherwise a SQLException will be generated when the CallableStatement is executed. This method differs from the setCharacterStream (int, Reader, int) method because it informs the driver that the parameter value should be sent to the server as a CLOB. When the setCharacterStream method is used, the driver may have to do extra work to determine whether the parameter data should be send to the server as a LONGVARCHAR or a CLOB

Parameters
parameterName	String!: the name of the parameter to be set
reader	Reader!: An object that contains the data to set the parameter value to.
length	Long: the number of characters in the parameter data.

Exceptions
java.sql.SQLException	if parameterIndex does not correspond to a parameter marker in the SQL statement; if the length specified is less than zero; a database access error occurs or this method is called on a closed CallableStatement
java.sql.SQLFeatureNotSupportedException	if the JDBC driver does not support this method

setClob

Added in API level 9

abstract fun setClob(
    parameterName: String!, 
    x: Clob!
): Unit

Sets the designated parameter to the given java.sql.Clob object. The driver converts this to an SQL CLOB value when it sends it to the database.

Parameters
parameterName	String!: the name of the parameter
x	Clob!: a Clob object that maps an SQL CLOB value

Exceptions
java.sql.SQLException	if a database access error occurs or this method is called on a closed CallableStatement
java.sql.SQLFeatureNotSupportedException	if the JDBC driver does not support this method

setCommand

Added in API level 1

abstract fun setCommand(cmd: String!): Unit

Sets this RowSet object's command property to the given SQL query. This property is optional when a rowset gets its data from a data source that does not support commands, such as a spreadsheet.

Parameters
cmd	String!: the SQL query that will be used to get the data for this RowSet object; may be null

Exceptions
java.sql.SQLException	if a database access error occurs

See Also

• #getCommand

setConcurrency

Added in API level 1

abstract fun setConcurrency(concurrency: Int): Unit

Sets the concurrency of this RowSet object to the given concurrency level. This method is used to change the concurrency level of a rowset, which is by default ResultSet.CONCUR_READ_ONLY

Parameters
concurrency	Int: one of the ResultSet constants specifying a concurrency level: ResultSet.CONCUR_READ_ONLY or ResultSet.CONCUR_UPDATABLE

Exceptions
java.sql.SQLException	if a database access error occurs

See Also

• java.sql.ResultSet#getConcurrency

setDataSourceName

Added in API level 1

abstract fun setDataSourceName(name: String!): Unit

Sets the data source name property for this RowSet object to the given String.

The value of the data source name property can be used to do a lookup of a DataSource object that has been registered with a naming service. After being retrieved, the DataSource object can be used to create a connection to the data source that it represents.

Parameters
name	String!: the logical name of the data source for this RowSet object; may be null

Exceptions
java.sql.SQLException	if a database access error occurs

See Also

• #getDataSourceName

setDate

Added in API level 1

abstract fun setDate(
    parameterIndex: Int, 
    x: Date!
): Unit

Sets the designated parameter in this RowSet object's command to the given java.sql.Date value. The driver converts this to an SQL DATE value before sending it to the database, using the default java.util.Calendar to calculate the date.

Parameters
parameterIndex	Int: the first parameter is 1, the second is 2, ...
x	Date!: the parameter value

Exceptions
java.sql.SQLException	if a database access error occurs

setDate

Added in API level 1

abstract fun setDate(
    parameterIndex: Int, 
    x: Date!, 
    cal: Calendar!
): Unit

Sets the designated parameter in this RowSet object's command with the given java.sql.Date value. The driver will convert this to an SQL DATE value, using the given java.util.Calendar object to calculate the date.

Parameters
parameterIndex	Int: the first parameter is 1, the second is 2, ...
x	Date!: the parameter value
cal	Calendar!: the java.util.Calendar object to use for calculating the date

Exceptions
java.sql.SQLException	if a database access error occurs

setDate

Added in API level 9

abstract fun setDate(
    parameterName: String!, 
    x: Date!
): Unit

Sets the designated parameter to the given java.sql.Date value using the default time zone of the virtual machine that is running the application. The driver converts this to an SQL DATE value when it sends it to the database.

Parameters
parameterName	String!: the name of the parameter
x	Date!: the parameter value

Exceptions
java.sql.SQLException	if a database access error occurs or this method is called on a closed CallableStatement
java.sql.SQLFeatureNotSupportedException	if the JDBC driver does not support this method

See Also

setDate

Added in API level 9

abstract fun setDate(
    parameterName: String!, 
    x: Date!, 
    cal: Calendar!
): Unit

Sets the designated parameter to the given java.sql.Date value, using the given Calendar object. The driver uses the Calendar object to construct an SQL DATE value, which the driver then sends to the database. With a a Calendar object, the driver can calculate the date taking into account a custom timezone. If no Calendar object is specified, the driver uses the default timezone, which is that of the virtual machine running the application.

Parameters
parameterName	String!: the name of the parameter
x	Date!: the parameter value
cal	Calendar!: the Calendar object the driver will use to construct the date

Exceptions
java.sql.SQLException	if a database access error occurs or this method is called on a closed CallableStatement
java.sql.SQLFeatureNotSupportedException	if the JDBC driver does not support this method

See Also

setDouble

Added in API level 1

abstract fun setDouble(
    parameterIndex: Int, 
    x: Double
): Unit

Sets the designated parameter in this RowSet object's command to the given Java double value. The driver converts this to an SQL DOUBLE value before sending it to the database.

Parameters
parameterIndex	Int: the first parameter is 1, the second is 2, ...
x	Double: the parameter value

Exceptions
java.sql.SQLException	if a database access error occurs

setDouble

Added in API level 9

abstract fun setDouble(
    parameterName: String!, 
    x: Double
): Unit

Sets the designated parameter to the given Java double value. The driver converts this to an SQL DOUBLE value when it sends it to the database.

Parameters
parameterName	String!: the name of the parameter
x	Double: the parameter value

Exceptions
java.sql.SQLException	if a database access error occurs or this method is called on a closed CallableStatement
java.sql.SQLFeatureNotSupportedException	if the JDBC driver does not support this method

See Also

setEscapeProcessing

Added in API level 1

abstract fun setEscapeProcessing(enable: Boolean): Unit

Sets escape processing for this RowSet object on or off. If escape scanning is on (the default), the driver will do escape substitution before sending an SQL statement to the database.

Parameters
enable	Boolean: true to enable escape processing; false to disable it

Exceptions
java.sql.SQLException	if a database access error occurs

See Also

• #getEscapeProcessing

setFloat

Added in API level 1

abstract fun setFloat(
    parameterIndex: Int, 
    x: Float
): Unit

Sets the designated parameter in this RowSet object's command to the given Java float value. The driver converts this to an SQL REAL value before sending it to the database.

Parameters
parameterIndex	Int: the first parameter is 1, the second is 2, ...
x	Float: the parameter value

Exceptions
java.sql.SQLException	if a database access error occurs

setFloat

Added in API level 9

abstract fun setFloat(
    parameterName: String!, 
    x: Float
): Unit

Sets the designated parameter to the given Java float value. The driver converts this to an SQL FLOAT value when it sends it to the database.

Parameters
parameterName	String!: the name of the parameter
x	Float: the parameter value

Exceptions
java.sql.SQLException	if a database access error occurs or this method is called on a closed CallableStatement
java.sql.SQLFeatureNotSupportedException	if the JDBC driver does not support this method

See Also

setInt

Added in API level 1

abstract fun setInt(
    parameterIndex: Int, 
    x: Int
): Unit

Sets the designated parameter in this RowSet object's command to the given Java int value. The driver converts this to an SQL INTEGER value before sending it to the database.

Parameters
parameterIndex	Int: the first parameter is 1, the second is 2, ...
x	Int: the parameter value

Exceptions
java.sql.SQLException	if a database access error occurs

setInt

Added in API level 9

abstract fun setInt(
    parameterName: String!, 
    x: Int
): Unit

Sets the designated parameter to the given Java int value. The driver converts this to an SQL INTEGER value when it sends it to the database.

Parameters
parameterName	String!: the name of the parameter
x	Int: the parameter value

Exceptions
java.sql.SQLException	if a database access error occurs or this method is called on a closed CallableStatement
java.sql.SQLFeatureNotSupportedException	if the JDBC driver does not support this method

See Also

setLong

Added in API level 1

abstract fun setLong(
    parameterIndex: Int, 
    x: Long
): Unit

Sets the designated parameter in this RowSet object's command to the given Java long value. The driver converts this to an SQL BIGINT value before sending it to the database.

Parameters
parameterIndex	Int: the first parameter is 1, the second is 2, ...
x	Long: the parameter value

Exceptions
java.sql.SQLException	if a database access error occurs

setLong

Added in API level 9

abstract fun setLong(
    parameterName: String!, 
    x: Long
): Unit

Sets the designated parameter to the given Java long value. The driver converts this to an SQL BIGINT value when it sends it to the database.

Parameters
parameterName	String!: the name of the parameter
x	Long: the parameter value

Exceptions
java.sql.SQLException	if a database access error occurs or this method is called on a closed CallableStatement
java.sql.SQLFeatureNotSupportedException	if the JDBC driver does not support this method

See Also

setMaxFieldSize

Added in API level 1

abstract fun setMaxFieldSize(max: Int): Unit

Sets the maximum number of bytes that can be returned for a column value to the given number of bytes. This limit applies only to BINARY, VARBINARY, LONGVARBINARYBINARY, CHAR, VARCHAR, LONGVARCHAR, NCHAR and NVARCHAR columns. If the limit is exceeded, the excess data is silently discarded. For maximum portability, use values greater than 256.

Parameters
max	Int: the new max column size limit in bytes; zero means unlimited

Exceptions
java.sql.SQLException	if a database access error occurs

See Also

• #getMaxFieldSize

setMaxRows

Added in API level 1

abstract fun setMaxRows(max: Int): Unit

Sets the maximum number of rows that this RowSet object can contain to the specified number. If the limit is exceeded, the excess rows are silently dropped.

Parameters
max	Int: the new maximum number of rows; zero means unlimited

Exceptions
java.sql.SQLException	if a database access error occurs

See Also

• #getMaxRows

setNCharacterStream

Added in API level 9

abstract fun setNCharacterStream(
    parameterIndex: Int, 
    value: Reader!
): Unit

Sets the designated parameter in this RowSet object's command to a Reader object. The Reader reads the data till end-of-file is reached. The driver does the necessary conversion from Java character format to the national character set in the database.

Note: This stream object can either be a standard Java stream object or your own subclass that implements the standard interface.

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

Parameters
parameterIndex	Int: of the first parameter is 1, the second is 2, ...
value	Reader!: the parameter value

Exceptions
java.sql.SQLException	if the driver does not support national character sets; if the driver can detect that a data conversion error could occur ; if a database access error occurs; or this method is called on a closed PreparedStatement
java.sql.SQLFeatureNotSupportedException	if the JDBC driver does not support this method

setNCharacterStream

Added in API level 9

abstract fun setNCharacterStream(
    parameterIndex: Int, 
    value: Reader!, 
    length: Long
): Unit

Sets the designated parameter to a Reader object. The Reader reads the data till end-of-file is reached. The driver does the necessary conversion from Java character format to the national character set in the database.

Parameters
parameterIndex	Int: of the first parameter is 1, the second is 2, ...
value	Reader!: the parameter value
length	Long: the number of characters in the parameter data.

Exceptions
java.sql.SQLException	if the driver does not support national character sets; if the driver can detect that a data conversion error could occur ; or if a database access error occurs

setNCharacterStream

Added in API level 9

abstract fun setNCharacterStream(
    parameterName: String!, 
    value: Reader!
): Unit

Sets the designated parameter to a Reader object. The Reader reads the data till end-of-file is reached. The driver does the necessary conversion from Java character format to the national character set in the database.

Note: This stream object can either be a standard Java stream object or your own subclass that implements the standard interface.

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

Parameters
parameterName	String!: the name of the parameter
value	Reader!: the parameter value

Exceptions
java.sql.SQLException	if the driver does not support national character sets; if the driver can detect that a data conversion error could occur ; if a database access error occurs; or this method is called on a closed CallableStatement
java.sql.SQLFeatureNotSupportedException	if the JDBC driver does not support this method

setNCharacterStream

Added in API level 9

abstract fun setNCharacterStream(
    parameterName: String!, 
    value: Reader!, 
    length: Long
): Unit

Sets the designated parameter to a Reader object. The Reader reads the data till end-of-file is reached. The driver does the necessary conversion from Java character format to the national character set in the database.

Parameters
parameterName	String!: the name of the column to be set
value	Reader!: the parameter value
length	Long: the number of characters in the parameter data.

Exceptions
java.sql.SQLException	if the driver does not support national character sets; if the driver can detect that a data conversion error could occur; or if a database access error occurs

setNClob

Added in API level 9

abstract fun setNClob(
    parameterIndex: Int, 
    reader: Reader!
): Unit

Sets the designated parameter to a Reader object. This method differs from the setCharacterStream (int, Reader) method because it informs the driver that the parameter value should be sent to the server as a NCLOB. When the setCharacterStream method is used, the driver may have to do extra work to determine whether the parameter data should be sent to the server as a LONGNVARCHAR or a NCLOB

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

Parameters
parameterIndex	Int: index of the first parameter is 1, the second is 2, ...
reader	Reader!: An object that contains the data to set the parameter value to.

Exceptions
java.sql.SQLException	if parameterIndex does not correspond to a parameter marker in the SQL statement; if the driver does not support national character sets; if the driver can detect that a data conversion error could occur; if a database access error occurs or this method is called on a closed PreparedStatement
java.sql.SQLFeatureNotSupportedException	if the JDBC driver does not support this method

setNClob

Added in API level 9

abstract fun setNClob(
    parameterIndex: Int, 
    reader: Reader!, 
    length: Long
): Unit

Sets the designated parameter to a Reader object. The reader must contain the number of characters specified by length otherwise a SQLException will be generated when the PreparedStatement is executed. This method differs from the setCharacterStream (int, Reader, int) method because it informs the driver that the parameter value should be sent to the server as a NCLOB. When the setCharacterStream method is used, the driver may have to do extra work to determine whether the parameter data should be sent to the server as a LONGNVARCHAR or a NCLOB

Parameters
parameterIndex	Int: index of the first parameter is 1, the second is 2, ...
reader	Reader!: An object that contains the data to set the parameter value to.
length	Long: the number of characters in the parameter data.

Exceptions
java.sql.SQLException	if parameterIndex does not correspond to a parameter marker in the SQL statement; if the length specified is less than zero; if the driver does not support national character sets; if the driver can detect that a data conversion error could occur; if a database access error occurs or this method is called on a closed PreparedStatement
java.sql.SQLFeatureNotSupportedException	if the JDBC driver does not support this method

setNClob

Added in API level 9

abstract fun setNClob(
    parameterIndex: Int, 
    value: NClob!
): Unit

Sets the designated parameter to a java.sql.NClob object. The driver converts this to a SQL NCLOB value when it sends it to the database.

Parameters
parameterIndex	Int: of the first parameter is 1, the second is 2, ...
value	NClob!: the parameter value

Exceptions
java.sql.SQLException	if the driver does not support national character sets; if the driver can detect that a data conversion error could occur ; or if a database access error occurs

setNClob

Added in API level 9

abstract fun setNClob(
    parameterName: String!, 
    reader: Reader!
): Unit

Sets the designated parameter to a Reader object. This method differs from the setCharacterStream (int, Reader) method because it informs the driver that the parameter value should be sent to the server as a NCLOB. When the setCharacterStream method is used, the driver may have to do extra work to determine whether the parameter data should be send to the server as a LONGNVARCHAR or a NCLOB

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

Parameters
parameterName	String!: the name of the parameter
reader	Reader!: An object that contains the data to set the parameter value to.

Exceptions
java.sql.SQLException	if the driver does not support national character sets; if the driver can detect that a data conversion error could occur; if a database access error occurs or this method is called on a closed CallableStatement
java.sql.SQLFeatureNotSupportedException	if the JDBC driver does not support this method

setNClob

Added in API level 9

abstract fun setNClob(
    parameterName: String!, 
    reader: Reader!, 
    length: Long
): Unit

Sets the designated parameter to a Reader object. The reader must contain the number of characters specified by length otherwise a SQLException will be generated when the CallableStatement is executed. This method differs from the setCharacterStream (int, Reader, int) method because it informs the driver that the parameter value should be sent to the server as a NCLOB. When the setCharacterStream method is used, the driver may have to do extra work to determine whether the parameter data should be send to the server as a LONGNVARCHAR or a NCLOB

Parameters
parameterName	String!: the name of the parameter to be set
reader	Reader!: An object that contains the data to set the parameter value to.
length	Long: the number of characters in the parameter data.

Exceptions
java.sql.SQLException	if parameterIndex does not correspond to a parameter marker in the SQL statement; if the length specified is less than zero; if the driver does not support national character sets; if the driver can detect that a data conversion error could occur; if a database access error occurs or this method is called on a closed CallableStatement
java.sql.SQLFeatureNotSupportedException	if the JDBC driver does not support this method

setNClob

Added in API level 9

abstract fun setNClob(
    parameterName: String!, 
    value: NClob!
): Unit

Sets the designated parameter to a java.sql.NClob object. The object implements the java.sql.NClob interface. This NClob object maps to a SQL NCLOB.

Parameters
parameterName	String!: the name of the column to be set
value	NClob!: the parameter value

Exceptions
java.sql.SQLException	if the driver does not support national character sets; if the driver can detect that a data conversion error could occur; or if a database access error occurs

setNString

Added in API level 9

abstract fun setNString(
    parameterIndex: Int, 
    value: String!
): Unit

Sets the designated paramter to the given String object. The driver converts this to a SQL NCHAR or NVARCHAR or LONGNVARCHAR value (depending on the argument's size relative to the driver's limits on NVARCHAR values) when it sends it to the database.

Parameters
parameterIndex	Int: of the first parameter is 1, the second is 2, ...
value	String!: the parameter value

Exceptions
java.sql.SQLException	if the driver does not support national character sets; if the driver can detect that a data conversion error could occur ; or if a database access error occurs

setNString

Added in API level 9

abstract fun setNString(
    parameterName: String!, 
    value: String!
): Unit

Sets the designated paramter to the given String object. The driver converts this to a SQL NCHAR or NVARCHAR or LONGNVARCHAR

Parameters
parameterName	String!: the name of the column to be set
value	String!: the parameter value

Exceptions
java.sql.SQLException	if the driver does not support national character sets; if the driver can detect that a data conversion error could occur; or if a database access error occurs

setNull

Added in API level 1

abstract fun setNull(
    parameterIndex: Int, 
    sqlType: Int
): Unit

Sets the designated parameter in this RowSet object's SQL command to SQL NULL.

Note: You must specify the parameter's SQL type.

Parameters
parameterIndex	Int: the first parameter is 1, the second is 2, ...
sqlType	Int: a SQL type code defined by java.sql.Types

Exceptions
java.sql.SQLException	if a database access error occurs

setNull

Added in API level 1

abstract fun setNull(
    paramIndex: Int, 
    sqlType: Int, 
    typeName: String!
): Unit

Sets the designated parameter in this RowSet object's SQL command to SQL NULL. This version of the method setNull should be used for SQL user-defined types (UDTs) and REF type parameters. Examples of UDTs include: STRUCT, DISTINCT, JAVA_OBJECT, and named array types.

Note: To be portable, applications must give the SQL type code and the fully qualified SQL type name when specifying a NULL UDT or REF parameter. In the case of a UDT, the name is the type name of the parameter itself. For a REF parameter, the name is the type name of the referenced type. If a JDBC driver does not need the type code or type name information, it may ignore it. Although it is intended for UDT and REF parameters, this method may be used to set a null parameter of any JDBC type. If the parameter does not have a user-defined or REF type, the typeName parameter is ignored.

Parameters
paramIndex	Int: the first parameter is 1, the second is 2, ...
sqlType	Int: a value from java.sql.Types
typeName	String!: the fully qualified name of an SQL UDT or the type name of the SQL structured type being referenced by a REF type; ignored if the parameter is not a UDT or REF type

Exceptions
java.sql.SQLException	if a database access error occurs

setNull

Added in API level 9

abstract fun setNull(
    parameterName: String!, 
    sqlType: Int
): Unit

Sets the designated parameter to SQL NULL.

Note: You must specify the parameter's SQL type.

Parameters
parameterName	String!: the name of the parameter
sqlType	Int: the SQL type code defined in java.sql.Types

Exceptions
java.sql.SQLException	if a database access error occurs or this method is called on a closed CallableStatement
java.sql.SQLFeatureNotSupportedException	if the JDBC driver does not support this method

setNull

Added in API level 9

abstract fun setNull(
    parameterName: String!, 
    sqlType: Int, 
    typeName: String!
): Unit

Sets the designated parameter to SQL NULL. This version of the method setNull should be used for user-defined types and REF type parameters. Examples of user-defined types include: STRUCT, DISTINCT, JAVA_OBJECT, and named array types.

Note: To be portable, applications must give the SQL type code and the fully-qualified SQL type name when specifying a NULL user-defined or REF parameter. In the case of a user-defined type the name is the type name of the parameter itself. For a REF parameter, the name is the type name of the referenced type. If a JDBC driver does not need the type code or type name information, it may ignore it. Although it is intended for user-defined and Ref parameters, this method may be used to set a null parameter of any JDBC type. If the parameter does not have a user-defined or REF type, the given typeName is ignored.

Parameters
parameterName	String!: the name of the parameter
sqlType	Int: a value from java.sql.Types
typeName	String!: the fully-qualified name of an SQL user-defined type; ignored if the parameter is not a user-defined type or SQL REF value

Exceptions
java.sql.SQLException	if a database access error occurs or this method is called on a closed CallableStatement
java.sql.SQLFeatureNotSupportedException	if the JDBC driver does not support this method

setObject

Added in API level 1

abstract fun setObject(
    parameterIndex: Int, 
    x: Any!
): Unit

Sets the designated parameter in this RowSet object's command with a Java Object. For integral values, the java.lang equivalent objects should be used.

The JDBC specification provides a standard mapping from Java Object types to SQL types. The driver will convert the given Java object to its standard SQL mapping before sending it to the database.

Note that this method may be used to pass datatabase-specific abstract data types by using a driver-specific Java type. If the object is of a class implementing SQLData, the rowset should call the method SQLData.writeSQL to write the object to an SQLOutput data stream. If, on the other hand, the object is of a class implementing Ref, Blob, Clob, NClob, Struct, java.net.URL, or Array, the driver should pass it to the database as a value of the corresponding SQL type.

An exception is thrown if there is an ambiguity, for example, if the object is of a class implementing more than one of these interfaces.

Parameters
parameterIndex	Int: The first parameter is 1, the second is 2, ...
x	Any!: The object containing the input parameter value

Exceptions
java.sql.SQLException	if a database access error occurs

setObject

Added in API level 1

abstract fun setObject(
    parameterIndex: Int, 
    x: Any!, 
    targetSqlType: Int
): Unit

Sets the designated parameter in this RowSet object's command with a Java Object. For integral values, the java.lang equivalent objects should be used. This method is like setObject above, but the scale used is the scale of the second parameter. Scalar values have a scale of zero. Literal values have the scale present in the literal.

Even though it is supported, it is not recommended that this method be called with floating point input values.

Parameters
parameterIndex	Int: the first parameter is 1, the second is 2, ...
x	Any!: the object containing the input parameter value
targetSqlType	Int: the SQL type (as defined in java.sql.Types) to be sent to the database

Exceptions
java.sql.SQLException	if a database access error occurs

setObject

Added in API level 1

abstract fun setObject(
    parameterIndex: Int, 
    x: Any!, 
    targetSqlType: Int, 
    scaleOrLength: Int
): Unit

Sets the designated parameter in this RowSet object's command with the given Java Object. For integral values, the java.lang equivalent objects should be used (for example, an instance of the class Integer for an int). If the second argument is an InputStream then the stream must contain the number of bytes specified by scaleOrLength. If the second argument is a Reader then the reader must contain the number of characters specified * by scaleOrLength. If these conditions are not true the driver will generate a SQLException when the prepared statement is executed.

The given Java object will be converted to the targetSqlType before being sent to the database.

If the object is of a class implementing SQLData, the rowset should call the method SQLData.writeSQL to write the object to an SQLOutput data stream. If, on the other hand, the object is of a class implementing Ref, Blob, Clob, NClob, Struct, java.net.URL, or Array, the driver should pass it to the database as a value of the corresponding SQL type.

Note that this method may be used to pass datatabase-specific abstract data types.

Parameters
parameterIndex	Int: the first parameter is 1, the second is 2, ...
x	Any!: the object containing the input parameter value
targetSqlType	Int: the SQL type (as defined in java.sql.Types) to be sent to the database. The scale argument may further qualify this type.
scaleOrLength	Int: for java.sql.Types.DECIMAL or java.sql.Types.NUMERIC types, this is the number of digits after the decimal point. For Java Object types InputStream and Reader, this is the length of the data in the stream or reader. For all other types, this value will be ignored.

Exceptions
java.sql.SQLException	if a database access error occurs

See Also

• java.sql.Types

setObject

Added in API level 9

abstract fun setObject(
    parameterName: String!, 
    x: Any!
): Unit

Sets the value of the designated parameter with the given object. The second parameter must be of type Object; therefore, the java.lang equivalent objects should be used for built-in types.

The JDBC specification specifies a standard mapping from Java Object types to SQL types. The given argument will be converted to the corresponding SQL type before being sent to the database.

Note that this method may be used to pass datatabase- specific abstract data types, by using a driver-specific Java type. If the object is of a class implementing the interface SQLData, the JDBC driver should call the method SQLData.writeSQL to write it to the SQL data stream. If, on the other hand, the object is of a class implementing Ref, Blob, Clob, NClob, Struct, java.net.URL, or Array, the driver should pass it to the database as a value of the corresponding SQL type.

This method throws an exception if there is an ambiguity, for example, if the object is of a class implementing more than one of the interfaces named above.

Parameters
parameterName	String!: the name of the parameter
x	Any!: the object containing the input parameter value

Exceptions
java.sql.SQLException	if a database access error occurs, this method is called on a closed CallableStatement or if the given Object parameter is ambiguous
java.sql.SQLFeatureNotSupportedException	if the JDBC driver does not support this method

See Also

setObject

Added in API level 9

abstract fun setObject(
    parameterName: String!, 
    x: Any!, 
    targetSqlType: Int
): Unit

Sets the value of the designated parameter with the given object. This method is like the method setObject above, except that it assumes a scale of zero.

Parameters
parameterName	String!: the name of the parameter
x	Any!: the object containing the input parameter value
targetSqlType	Int: the SQL type (as defined in java.sql.Types) to be sent to the database

Exceptions
java.sql.SQLException	if a database access error occurs or this method is called on a closed CallableStatement
java.sql.SQLFeatureNotSupportedException	if targetSqlType is a ARRAY, BLOB, CLOB, DATALINK, JAVA_OBJECT, NCHAR, NCLOB, NVARCHAR, LONGNVARCHAR, REF, ROWID, SQLXML or STRUCT data type and the JDBC driver does not support this data type

See Also

setObject

Added in API level 9

abstract fun setObject(
    parameterName: String!, 
    x: Any!, 
    targetSqlType: Int, 
    scale: Int
): Unit

Sets the value of the designated parameter with the given object. The second argument must be an object type; for integral values, the java.lang equivalent objects should be used.

The given Java object will be converted to the given targetSqlType before being sent to the database. If the object has a custom mapping (is of a class implementing the interface SQLData), the JDBC driver should call the method SQLData.writeSQL to write it to the SQL data stream. If, on the other hand, the object is of a class implementing Ref, Blob, Clob, NClob, Struct, java.net.URL, or Array, the driver should pass it to the database as a value of the corresponding SQL type.

Note that this method may be used to pass datatabase- specific abstract data types.

Parameters
parameterName	String!: the name of the parameter
x	Any!: the object containing the input parameter value
targetSqlType	Int: the SQL type (as defined in java.sql.Types) to be sent to the database. The scale argument may further qualify this type.
scale	Int: for java.sql.Types.DECIMAL or java.sql.Types.NUMERIC types, this is the number of digits after the decimal point. For all other types, this value will be ignored.

Exceptions
java.sql.SQLException	if a database access error occurs or this method is called on a closed CallableStatement
java.sql.SQLFeatureNotSupportedException	if targetSqlType is a ARRAY, BLOB, CLOB, DATALINK, JAVA_OBJECT, NCHAR, NCLOB, NVARCHAR, LONGNVARCHAR, REF, ROWID, SQLXML or STRUCT data type and the JDBC driver does not support this data type

See Also

• java.sql.Types

setPassword

Added in API level 1

abstract fun setPassword(password: String!): Unit

Sets the database password for this RowSet object to the given String.

Parameters
password	String!: the password string

Exceptions
java.sql.SQLException	if a database access error occurs

See Also

• #getPassword

setQueryTimeout

Added in API level 1

abstract fun setQueryTimeout(seconds: Int): Unit

Sets the maximum time the driver will wait for a statement to execute to the given number of seconds. If this limit is exceeded, an SQLException is thrown.

Parameters
seconds	Int: the new query timeout limit in seconds; zero means that there is no limit

Exceptions
java.sql.SQLException	if a database access error occurs

See Also

• #getQueryTimeout

setReadOnly

Added in API level 1

abstract fun setReadOnly(value: Boolean): Unit

Sets whether this RowSet object is read-only to the given boolean.

Parameters
value	Boolean: true if read-only; false if updatable

Exceptions
java.sql.SQLException	if a database access error occurs

See Also

• #isReadOnly

setRef

Added in API level 1

abstract fun setRef(
    i: Int, 
    x: Ref!
): Unit

Sets the designated parameter in this RowSet object's command with the given Ref value. The driver will convert this to the appropriate REF(<structured-type>) value.

Parameters
i	Int: the first parameter is 1, the second is 2, ...
x	Ref!: an object representing data of an SQL REF type

Exceptions
java.sql.SQLException	if a database access error occurs

setRowId

Added in API level 9

abstract fun setRowId(
    parameterIndex: Int, 
    x: RowId!
): Unit

Sets the designated parameter to the given java.sql.RowId object. The driver converts this to a SQL ROWID value when it sends it to the database

Parameters
parameterIndex	Int: the first parameter is 1, the second is 2, ...
x	RowId!: the parameter value

Exceptions
java.sql.SQLException	if a database access error occurs

setRowId

Added in API level 9

abstract fun setRowId(
    parameterName: String!, 
    x: RowId!
): Unit

Sets the designated parameter to the given java.sql.RowId object. The driver converts this to a SQL ROWID when it sends it to the database.

Parameters
parameterName	String!: the name of the parameter
x	RowId!: the parameter value

Exceptions
java.sql.SQLException	if a database access error occurs

setSQLXML

Added in API level 9

abstract fun setSQLXML(
    parameterIndex: Int, 
    xmlObject: SQLXML!
): Unit

Sets the designated parameter to the given java.sql.SQLXML object. The driver converts this to an SQL XML value when it sends it to the database.

Parameters
parameterIndex	Int: index of the first parameter is 1, the second is 2, ...
xmlObject	SQLXML!: a SQLXML object that maps an SQL XML value

Exceptions
java.sql.SQLException	if a database access error occurs, this method is called on a closed result set, the java.xml.transform.Result, Writer or OutputStream has not been closed for the SQLXML object or if there is an error processing the XML value. The getCause method of the exception may provide a more detailed exception, for example, if the stream does not contain valid XML.

setSQLXML

Added in API level 9

abstract fun setSQLXML(
    parameterName: String!, 
    xmlObject: SQLXML!
): Unit

Sets the designated parameter to the given java.sql.SQLXML object. The driver converts this to an SQL XML value when it sends it to the database.

Parameters
parameterName	String!: the name of the parameter
xmlObject	SQLXML!: a SQLXML object that maps an SQL XML value

Exceptions
java.sql.SQLException	if a database access error occurs, this method is called on a closed result set, the java.xml.transform.Result, Writer or OutputStream has not been closed for the SQLXML object or if there is an error processing the XML value. The getCause method of the exception may provide a more detailed exception, for example, if the stream does not contain valid XML.

setShort

Added in API level 1

abstract fun setShort(
    parameterIndex: Int, 
    x: Short
): Unit

Sets the designated parameter in this RowSet object's command to the given Java short value. The driver converts this to an SQL SMALLINT value before sending it to the database.

Parameters
parameterIndex	Int: the first parameter is 1, the second is 2, ...
x	Short: the parameter value

Exceptions
java.sql.SQLException	if a database access error occurs

setShort

Added in API level 9

abstract fun setShort(
    parameterName: String!, 
    x: Short
): Unit

Sets the designated parameter to the given Java short value. The driver converts this to an SQL SMALLINT value when it sends it to the database.

Parameters
parameterName	String!: the name of the parameter
x	Short: the parameter value

Exceptions
java.sql.SQLException	if a database access error occurs or this method is called on a closed CallableStatement
java.sql.SQLFeatureNotSupportedException	if the JDBC driver does not support this method

See Also

setString

Added in API level 1

abstract fun setString(
    parameterIndex: Int, 
    x: String!
): Unit

Sets the designated parameter in this RowSet object's command to the given Java String value. Before sending it to the database, the driver converts this to an SQL VARCHAR or LONGVARCHAR value, depending on the argument's size relative to the driver's limits on VARCHAR values.

Parameters
parameterIndex	Int: the first parameter is 1, the second is 2, ...
x	String!: the parameter value

Exceptions
java.sql.SQLException	if a database access error occurs

setString

Added in API level 9

abstract fun setString(
    parameterName: String!, 
    x: String!
): Unit

Sets the designated parameter to the given Java String value. The driver converts this to an SQL VARCHAR or LONGVARCHAR value (depending on the argument's size relative to the driver's limits on VARCHAR values) when it sends it to the database.

Parameters
parameterName	String!: the name of the parameter
x	String!: the parameter value

Exceptions
java.sql.SQLException	if a database access error occurs or this method is called on a closed CallableStatement
java.sql.SQLFeatureNotSupportedException	if the JDBC driver does not support this method

See Also

setTime

Added in API level 1

abstract fun setTime(
    parameterIndex: Int, 
    x: Time!
): Unit

Sets the designated parameter in this RowSet object's command to the given java.sql.Time value. The driver converts this to an SQL TIME value before sending it to the database, using the default java.util.Calendar to calculate it.

Parameters
parameterIndex	Int: the first parameter is 1, the second is 2, ...
x	Time!: the parameter value

Exceptions
java.sql.SQLException	if a database access error occurs

setTime

Added in API level 1

abstract fun setTime(
    parameterIndex: Int, 
    x: Time!, 
    cal: Calendar!
): Unit

Sets the designated parameter in this RowSet object's command with the given java.sql.Time value. The driver will convert this to an SQL TIME value, using the given java.util.Calendar object to calculate it, before sending it to the database.

Parameters
parameterIndex	Int: the first parameter is 1, the second is 2, ...
x	Time!: the parameter value
cal	Calendar!: the java.util.Calendar object to use for calculating the time

Exceptions
java.sql.SQLException	if a database access error occurs

setTime

Added in API level 9

abstract fun setTime(
    parameterName: String!, 
    x: Time!
): Unit

Sets the designated parameter to the given java.sql.Time value. The driver converts this to an SQL TIME value when it sends it to the database.

Parameters
parameterName	String!: the name of the parameter
x	Time!: the parameter value

Exceptions
java.sql.SQLException	if a database access error occurs or this method is called on a closed CallableStatement
java.sql.SQLFeatureNotSupportedException	if the JDBC driver does not support this method

See Also

setTime

Added in API level 9

abstract fun setTime(
    parameterName: String!, 
    x: Time!, 
    cal: Calendar!
): Unit

Sets the designated parameter to the given java.sql.Time value, using the given Calendar object. The driver uses the Calendar object to construct an SQL TIME value, which the driver then sends to the database. With a a Calendar object, the driver can calculate the time taking into account a custom timezone. If no Calendar object is specified, the driver uses the default timezone, which is that of the virtual machine running the application.

Parameters
parameterName	String!: the name of the parameter
x	Time!: the parameter value
cal	Calendar!: the Calendar object the driver will use to construct the time

Exceptions
java.sql.SQLException	if a database access error occurs or this method is called on a closed CallableStatement
java.sql.SQLFeatureNotSupportedException	if the JDBC driver does not support this method

See Also

setTimestamp

Added in API level 1

abstract fun setTimestamp(
    parameterIndex: Int, 
    x: Timestamp!
): Unit

Sets the designated parameter in this RowSet object's command to the given java.sql.Timestamp value. The driver converts this to an SQL TIMESTAMP value before sending it to the database, using the default java.util.Calendar to calculate it.

Parameters
parameterIndex	Int: the first parameter is 1, the second is 2, ...
x	Timestamp!: the parameter value

Exceptions
java.sql.SQLException	if a database access error occurs

setTimestamp

Added in API level 1

abstract fun setTimestamp(
    parameterIndex: Int, 
    x: Timestamp!, 
    cal: Calendar!
): Unit

Sets the designated parameter in this RowSet object's command with the given java.sql.Timestamp value. The driver will convert this to an SQL TIMESTAMP value, using the given java.util.Calendar object to calculate it, before sending it to the database.

Parameters
parameterIndex	Int: the first parameter is 1, the second is 2, ...
x	Timestamp!: the parameter value
cal	Calendar!: the java.util.Calendar object to use for calculating the timestamp

Exceptions
java.sql.SQLException	if a database access error occurs

setTimestamp

Added in API level 9

abstract fun setTimestamp(
    parameterName: String!, 
    x: Timestamp!
): Unit

Sets the designated parameter to the given java.sql.Timestamp value. The driver converts this to an SQL TIMESTAMP value when it sends it to the database.

Parameters
parameterName	String!: the name of the parameter
x	Timestamp!: the parameter value

Exceptions
java.sql.SQLException	if a database access error occurs or this method is called on a closed CallableStatement
java.sql.SQLFeatureNotSupportedException	if the JDBC driver does not support this method

See Also

setTimestamp

Added in API level 9

abstract fun setTimestamp(
    parameterName: String!, 
    x: Timestamp!, 
    cal: Calendar!
): Unit

Sets the designated parameter to the given java.sql.Timestamp value, using the given Calendar object. The driver uses the Calendar object to construct an SQL TIMESTAMP value, which the driver then sends to the database. With a a Calendar object, the driver can calculate the timestamp taking into account a custom timezone. If no Calendar object is specified, the driver uses the default timezone, which is that of the virtual machine running the application.

Parameters
parameterName	String!: the name of the parameter
x	Timestamp!: the parameter value
cal	Calendar!: the Calendar object the driver will use to construct the timestamp

Exceptions
java.sql.SQLException	if a database access error occurs or this method is called on a closed CallableStatement
java.sql.SQLFeatureNotSupportedException	if the JDBC driver does not support this method

See Also

setTransactionIsolation

Added in API level 1

abstract fun setTransactionIsolation(level: Int): Unit

Sets the transaction isolation level for this RowSet obejct.

Parameters
level	Int: the transaction isolation level; one of Connection.TRANSACTION_READ_UNCOMMITTED, Connection.TRANSACTION_READ_COMMITTED, Connection.TRANSACTION_REPEATABLE_READ, or Connection.TRANSACTION_SERIALIZABLE

Exceptions
java.sql.SQLException	if a database access error occurs

See Also

• #getTransactionIsolation

setType

Added in API level 1

abstract fun setType(type: Int): Unit

Sets the type of this RowSet object to the given type. This method is used to change the type of a rowset, which is by default read-only and non-scrollable.

Parameters
type	Int: one of the ResultSet constants specifying a type: ResultSet.TYPE_FORWARD_ONLY, ResultSet.TYPE_SCROLL_INSENSITIVE, or ResultSet.TYPE_SCROLL_SENSITIVE

Exceptions
java.sql.SQLException	if a database access error occurs

See Also

• java.sql.ResultSet#getType

setTypeMap

Added in API level 1

abstract fun setTypeMap(map: MutableMap<String!, Class<*>!>!): Unit

Installs the given java.util.Map object as the default type map for this RowSet object. This type map will be used unless another type map is supplied as a method parameter.

Parameters
map	MutableMap<String!, Class<*>!>!: a java.util.Map object containing the names of SQL user-defined types and the Java classes to which they are to be mapped

Exceptions
java.sql.SQLException	if a database access error occurs

See Also

• #getTypeMap

setURL

Added in API level 9

abstract fun setURL(
    parameterIndex: Int, 
    x: URL!
): Unit

Sets the designated parameter to the given java.net.URL value. The driver converts this to an SQL DATALINK value when it sends it to the database.

Parameters
parameterIndex	Int: the first parameter is 1, the second is 2, ...
x	URL!: the java.net.URL object to be set

Exceptions
java.sql.SQLFeatureNotSupportedException	if the JDBC driver does not support this method
java.sql.SQLException	if a database access error occurs or this method is called on a closed PreparedStatement

setUrl

Added in API level 1

abstract fun setUrl(url: String!): Unit

Sets the URL this RowSet object will use when it uses the DriverManager to create a connection. Setting this property is optional. If a URL is used, a JDBC driver that accepts the URL must be loaded before the rowset is used to connect to a database. The rowset will use the URL internally to create a database connection when reading or writing data. Either a URL or a data source name is used to create a connection, whichever was set to non null value most recently.

Parameters
url	String!: a string value; may be null

Exceptions
java.sql.SQLException	if a database access error occurs

See Also

• #getUrl

setUsername

Added in API level 1

abstract fun setUsername(name: String!): Unit

Sets the username property for this RowSet object to the given String.

Parameters
name	String!: a user name

Exceptions
java.sql.SQLException	if a database access error occurs

See Also

• #getUsername