概觀  軟體套件   類別  使用  階層樹  已過時  索引  說明 
JavaTM 2 Platform
Standard Ed. 6
 上一個類別   下一個類別 框架    無框架    
摘要： 巢狀 | 欄位 | 建構子 | 方法 詳細資訊： 欄位 | 建構子 | 方法

javax.sql
介面 RowSet

所有父級介面：
ResultSet, Wrapper
所有已知子介面：
CachedRowSet, FilteredRowSet, JdbcRowSet, JoinRowSet, SyncResolver, WebRowSet
public interface RowSet
extends ResultSet

該介面添加了對 JavaBeansTM 元件模型的 JDBC API 支持。rowset 可用作可視化 Bean 開發環境中的 JavaBeans 元件，它可以在設計時創建和配置並在運行時執行。

RowSet 介面提供一組 JavaBeans 屬性，這些屬性允許配置一個 RowSet 實例來連接 JDBC 資料源並從中讀取某些資料。一組設置方法（setInt、setBytes、setString 等等）提供將輸入參數傳遞到 rowset 命令屬性的方式。在一般情況下，此命令是 rowset 從關聯型資料庫獲取其資料時所使用的 SQL 查詢。

RowSet 介面支持 JavaBeans 事件，允許應用程序中的其他元件在 rowset 發生事件時（如值的更改）得到通知。

RowSet 介面是唯一的，因為需要使用其他 JDBC API 來實作它。換句話說，RowSet 實作是在 JDBC 驅動程序“頂部”執行的軟體層。任何人都可以提供 RowSet 介面的實作，包括希望將 RowSet 實作作為其 JDBC 產品的一部分提供的 JDBC 驅動程序供應商。

RowSet 物件可以建立一個與資料源的連接並在其整個生命週期中維持該連接，在此情況下，該物件被稱為連接的 rowset。rowset 還可以建立一個與資料源的連接，從其獲取資料，然後關閉它。這種 rowset 被稱為非連接 rowset。非連接 rowset 可以在斷開時更改其資料，然後將這些更改發送回原始資料源，不過它必須重新建立連接才能完成此操作。

非連接 rowset 可以具有與之關聯的 reader（RowSetReader 物件）和 writer（RowSetWriter 物件）。可以多種方式實作 reader 來使用資料填充 rowset，包括從非關係型資料源獲取資料。也可以多種方式實作 writer 來將對 rowset 的資料所做的更改傳回底層資料源。

Rowset 易於使用。RowSet 介面擴展了標準 java.sql.ResultSet 介面。RowSetMetaData 介面擴展了 java.sql.ResultSetMetaData 介面。因此，熟悉 JDBC API 的開發人員必須學習少數幾個新 API 才能使用 rowset。此外，與 JDBC ResultSet 物件配套使用的第三方軟體工具也可以方便地用於 rowset。

從以下版本開始：
1.4

欄位摘要
 
從介面 java.sql.ResultSet 繼承的欄位
CLOSE_CURSORS_AT_COMMIT, CONCUR_READ_ONLY, CONCUR_UPDATABLE, FETCH_FORWARD, FETCH_REVERSE, FETCH_UNKNOWN, HOLD_CURSORS_OVER_COMMIT, TYPE_FORWARD_ONLY, TYPE_SCROLL_INSENSITIVE, TYPE_SCROLL_SENSITIVE
 
方法摘要
 void addRowSetListener(RowSetListener listener)
          註冊給定偵聽器，以便此 RowSet 物件上發生事件時將得到通知。
 void clearParameters()
          清除為此 RowSet 物件命令設置的參數。
 void execute()
          使用資料填充此 RowSet 物件。
 String getCommand()
          獲取此 RowSet 物件的命令屬性。
 String getDataSourceName()
          獲取標識此 RowSet 物件的資料源的邏輯名稱。
 boolean getEscapeProcessing()
          獲取是否為此 RowSet 物件啟用轉義處理。
 int getMaxFieldSize()
          獲取可以對某些列值返回的最大位元組數。
 int getMaxRows()
          獲取此 RowSet 物件可以包含的最大行數。
 String getPassword()
          獲取用於創建資料庫連接的密碼。
 int getQueryTimeout()
          獲取驅動程序等待語句執行的最大秒數。
 int getTransactionIsolation()
          獲取為此 RowSet 物件設置的事務隔離級別。
 Map<String,Class<?>> getTypeMap()
          獲取與此 RowSet 物件關聯的 Map 物件，該物件指定 SQL 使用者定義型別的自定義映射關係（如果有）。
 String getUrl()
          如果此 RowSet 物件使用 DriverManager 而非 DataSource 物件建立連接，則獲取創建連接時將使用的 url 屬性。
 String getUsername()
          獲取用於創建此 RowSet 物件的資料庫連接的使用者名。
 boolean isReadOnly()
          獲取此 RowSet 物件是否是只讀的。
 void removeRowSetListener(RowSetListener listener)
          從在此 RowSet 物件上發生事件時得到通知的元件所組成的列表中移除指定的偵聽器。
 void setArray(int i, Array x)
          使用給定 Array 值設置此 RowSet 物件命令中的指定參數。
 void setAsciiStream(int parameterIndex, InputStream x)
          將此 RowSet 物件命令中的指定參數設置為給定輸入串流。
 void setAsciiStream(int parameterIndex, InputStream x, int length)
          將此 RowSet 物件命令中的指定參數設置為給定的 java.io.InputStream 值。
 void setAsciiStream(String parameterName, InputStream x)
          將指定參數設置為給定輸入串流。
 void setAsciiStream(String parameterName, InputStream x, int length)
          將指定參數設置為給定輸入串流，該輸入串流將擁有指定位元組數。
 void setBigDecimal(int parameterIndex, BigDecimal x)
          將此 RowSet 物件命令中的指定參數設置為給定的 java.math.BigDeciaml 值。
 void setBigDecimal(String parameterName, BigDecimal x)
          將指定參數設置為給定的 java.math.BigDecimal 值。
 void setBinaryStream(int parameterIndex, InputStream x)
          將此 RowSet 物件命令中的指定參數設置為給定輸入串流。
 void setBinaryStream(int parameterIndex, InputStream x, int length)
          將此 RowSet 物件命令中的指定參數設置為給定的 java.io.InputStream 值。
 void setBinaryStream(String parameterName, InputStream x)
          將指定參數設置為給定輸入串流。
 void setBinaryStream(String parameterName, InputStream x, int length)
          將指定參數設置為給定輸入串流，該輸入串流將擁有給定位元組數。
 void setBlob(int i, Blob x)
          使用給定 Blob 值設置此 RowSet 物件命令中的指定參數。
 void setBlob(int parameterIndex, InputStream inputStream)
          將指定參數設置為 InputStream 物件。
 void setBlob(int parameterIndex, InputStream inputStream, long length)
          將指定參數設置為 InputStream 物件。
 void setBlob(String parameterName, Blob x)
          將指定參數設置為給定的 java.sql.Blob 物件。
 void setBlob(String parameterName, InputStream inputStream)
          將指定參數設置為 InputStream 物件。
 void setBlob(String parameterName, InputStream inputStream, long length)
          將指定參數設置為 InputStream 物件。
 void setBoolean(int parameterIndex, boolean x)
          將此 RowSet 物件命令中的指定參數設置為給定的 Java boolean 值。
 void setBoolean(String parameterName, boolean x)
          將指定參數設置為給定的 Java boolean 值。
 void setByte(int parameterIndex, byte x)
          將此 RowSet 物件命令中的指定參數設置為給定的 Java byte 值。
 void setByte(String parameterName, byte x)
          將指定參數設置為給定的 Java byte 值。
 void setBytes(int parameterIndex, byte[] x)
          將此 RowSet 物件命令中的指定參數設置為給定的 Java byte 值陣列。
 void setBytes(String parameterName, byte[] x)
          將指定參數設置為給定的 Java byte 陣列。
 void setCharacterStream(int parameterIndex, Reader reader)
          將此 RowSet 物件命令中的指定參數設置為給定 Reader 物件。
 void setCharacterStream(int parameterIndex, Reader reader, int length)
          將此 RowSet 物件命令中的指定參數設置為給定的 java.io.Reader 值。
 void setCharacterStream(String parameterName, Reader reader)
          將指定參數設置為給定 Reader 物件。
 void setCharacterStream(String parameterName, Reader reader, int length)
          將指定參數設置為給定 Reader 物件，該物件是給定的字元長度數目。
 void setClob(int i, Clob x)
          使用給定 Clob 值設置此 RowSet 物件命令中的指定參數。
 void setClob(int parameterIndex, Reader reader)
          將指定參數設置為 Reader 物件。
 void setClob(int parameterIndex, Reader reader, long length)
          將指定參數設置為 Reader 物件。
 void setClob(String parameterName, Clob x)
          將指定參數設置為給定的 java.sql.Clob 物件。
 void setClob(String parameterName, Reader reader)
          將指定參數設置為 Reader 物件。
 void setClob(String parameterName, Reader reader, long length)
          將指定參數設置為 Reader 物件。
 void setCommand(String cmd)
          將此 RowSet 物件的命令屬性設置為給定的 SQL 查詢。
 void setConcurrency(int concurrency)
          將此 RowSet 物件的共時性設置為給定的共時級別。
 void setDataSourceName(String name)
          將此 RowSet 物件的資料源名稱屬性設置為給定的 String。
 void setDate(int parameterIndex, Date x)
          將此 RowSet 物件命令中的指定參數設置為給定的 java.sql.Date 值。
 void setDate(int parameterIndex, Date x, Calendar cal)
          使用給定 java.sql.Date 值設置此 RowSet 物件命令中的指定參數。
 void setDate(String parameterName, Date x)
          使用運行應用程序的虛擬機器所在的預設時區將指定參數設置為給定的 java.sql.Date 值。
 void setDate(String parameterName, Date x, Calendar cal)
          使用給定 Calendar 物件將指定參數設置為給定的 java.sql.Date 值。
 void setDouble(int parameterIndex, double x)
          將此 RowSet 物件命令中的指定參數設置為給定的 Java double 值。
 void setDouble(String parameterName, double x)
          將指定參數設置為給定的 Java double 值。
 void setEscapeProcessing(boolean enable)
          將此 RowSet 物件的轉義處理設置為開或關。
 void setFloat(int parameterIndex, float x)
          將此 RowSet 物件命令中的指定參數設置為給定的 Java float 值。
 void setFloat(String parameterName, float x)
          將指定參數設置為給定的 Java float 值。
 void setInt(int parameterIndex, int x)
          將此 RowSet 物件命令中的指定參數設置為給定的 Java int 值。
 void setInt(String parameterName, int x)
          將指定參數設置為給定的 Java int 值。
 void setLong(int parameterIndex, long x)
          將此 RowSet 物件命令中的指定參數設置為給定的 Java long 值。
 void setLong(String parameterName, long x)
          將指定參數設置為給定的 Java long 值。
 void setMaxFieldSize(int max)
          將可以對列值返回的最大位元組數設置為給定的位元組數。
 void setMaxRows(int max)
          將此 RowSet 物件可以包含的最大行數設置為指定數。
 void setNCharacterStream(int parameterIndex, Reader value)
          將此 RowSet 物件命令中的指定參數設置為 Reader 物件。
 void setNCharacterStream(int parameterIndex, Reader value, long length)
          將指定參數設置為 Reader 物件。
 void setNCharacterStream(String parameterName, Reader value)
          將指定參數設置為 Reader 物件。
 void setNCharacterStream(String parameterName, Reader value, long length)
          將指定參數設置為 Reader 物件。
 void setNClob(int parameterIndex, NClob value)
          將指定參數設置為 java.sql.NClob 物件。
 void setNClob(int parameterIndex, Reader reader)
          將指定參數設置為 Reader 物件。
 void setNClob(int parameterIndex, Reader reader, long length)
          將指定參數設置為 Reader 物件。
 void setNClob(String parameterName, NClob value)
          將指定參數設置為 java.sql.NClob 物件。
 void setNClob(String parameterName, Reader reader)
          將指定參數設置為 Reader 物件。
 void setNClob(String parameterName, Reader reader, long length)
          將指定參數設置為 Reader 物件。
 void setNString(int parameterIndex, String value)
          將指定參數設置為給定的 String 物件。
 void setNString(String parameterName, String value)
          將指定參數設置為給定的 String 物件。
 void setNull(int parameterIndex, int sqlType)
          將此 RowSet 物件的 SQL 命令中的指定參數設置為 SQL NULL。
 void setNull(int paramIndex, int sqlType, String typeName)
          將此 RowSet 物件的 SQL 命令中的指定參數設置為 SQL NULL。
 void setNull(String parameterName, int sqlType)
          將指定參數設置為 SQL NULL。
 void setNull(String parameterName, int sqlType, String typeName)
          將指定參數設置為 SQL NULL。
 void setObject(int parameterIndex, Object x)
          使用 Java Object 設置此 RowSet 物件命令中的指定參數。
 void setObject(int parameterIndex, Object x, int targetSqlType)
          使用 Java Object 設置此 RowSet 物件命令中的指定參數。
 void setObject(int parameterIndex, Object x, int targetSqlType, int scaleOrLength)
          使用給定 Java Object 設置此 RowSet 物件命令中的指定參數。
 void setObject(String parameterName, Object x)
          使用給定物件設置指定參數的值。
 void setObject(String parameterName, Object x, int targetSqlType)
          使用給定物件設置指定參數的值。
 void setObject(String parameterName, Object x, int targetSqlType, int scale)
          使用給定物件設置指定參數的值。
 void setPassword(String password)
          將此 RowSet 物件的資料庫密碼設置為給定的 String。
 void setQueryTimeout(int seconds)
          將驅動程序等待語句執行的最大秒數設置為給定的秒數。
 void setReadOnly(boolean value)
          將此 RowSet 物件的只讀性設置為給定的 boolean 值。
 void setRef(int i, Ref x)
          使用給定 Ref 值設置此 RowSet 物件命令中的指定參數。
 void setRowId(int parameterIndex, RowId x)
          將指定參數設置為給定的 java.sql.RowId 物件。
 void setRowId(String parameterName, RowId x)
          將指定參數設置為給定的 java.sql.RowId 物件。
 void setShort(int parameterIndex, short x)
          將此 RowSet 物件命令中的指定參數設置為給定的 Java short 值。
 void setShort(String parameterName, short x)
          將指定參數設置為給定的 Java short 值。
 void setSQLXML(int parameterIndex, SQLXML xmlObject)
          將指定參數設置為給定 java.sql.SQLXML 物件。
 void setSQLXML(String parameterName, SQLXML xmlObject)
          將指定參數設置為給定的 java.sql.SQLXML 物件。
 void setString(int parameterIndex, String x)
          將此 RowSet 物件命令中的指定參數設置為給定的 Java String 值。
 void setString(String parameterName, String x)
          將指定參數設置為給定的 Java String 值。
 void setTime(int parameterIndex, Time x)
          將此 RowSet 物件命令中的指定參數設置為給定的 java.sql.Time 值。
 void setTime(int parameterIndex, Time x, Calendar cal)
          使用給定 java.sql.Time 值設置此 RowSet 物件命令中的指定參數。
 void setTime(String parameterName, Time x)
          將指定參數設置為給定的 java.sql.Time 值。
 void setTime(String parameterName, Time x, Calendar cal)
          使用給定 Calendar 物件將指定參數設置為給定的 java.sql.Time 值。
 void setTimestamp(int parameterIndex, Timestamp x)
          將此 RowSet 物件命令中的指定參數設置為給定的 java.sql.Timestamp 值。
 void setTimestamp(int parameterIndex, Timestamp x, Calendar cal)
          使用給定 java.sql.Timestamp 值設置此 RowSet 物件命令中的指定參數。
 void setTimestamp(String parameterName, Timestamp x)
          將指定參數設置為給定的 java.sql.Timestamp 值。
 void setTimestamp(String parameterName, Timestamp x, Calendar cal)
          使用給定 Calendar 物件將指定參數設置為給定的 java.sql.Timestamp 值。
 void setTransactionIsolation(int level)
          設置此 RowSet 物件的事務隔離級別。
 void setType(int type)
          將此 RowSet 物件的型別設置為給定的型別。
 void setTypeMap(Map<String,Class<?>> map)
          將給定 java.util.Map 物件安裝為此 RowSet 物件的預設型別映射表。
 void setURL(int parameterIndex, URL x)
          將指定參數設置為給定的 java.net.URL 值。
 void setUrl(String url)
          設置此 RowSet 物件在使用 DriverManager 創建連接時將使用的 URL。
 void setUsername(String name)
          將此 RowSet 物件的使用者名屬性設置為給定的 String。
 
從介面 java.sql.ResultSet 繼承的方法
absolute, afterLast, beforeFirst, cancelRowUpdates, clearWarnings, close, deleteRow, findColumn, first, getArray, getArray, getAsciiStream, getAsciiStream, getBigDecimal, getBigDecimal, getBigDecimal, getBigDecimal, getBinaryStream, getBinaryStream, getBlob, getBlob, getBoolean, getBoolean, getByte, getByte, getBytes, getBytes, getCharacterStream, getCharacterStream, getClob, getClob, getConcurrency, getCursorName, getDate, getDate, getDate, getDate, getDouble, getDouble, getFetchDirection, getFetchSize, getFloat, getFloat, getHoldability, getInt, getInt, getLong, getLong, getMetaData, getNCharacterStream, getNCharacterStream, getNClob, getNClob, getNString, getNString, getObject, getObject, getObject, getObject, getRef, getRef, getRow, getRowId, getRowId, getShort, getShort, getSQLXML, getSQLXML, getStatement, getString, getString, getTime, getTime, getTime, getTime, getTimestamp, getTimestamp, getTimestamp, getTimestamp, getType, getUnicodeStream, getUnicodeStream, getURL, getURL, getWarnings, insertRow, isAfterLast, isBeforeFirst, isClosed, isFirst, isLast, last, moveToCurrentRow, moveToInsertRow, next, previous, refreshRow, relative, rowDeleted, rowInserted, rowUpdated, setFetchDirection, setFetchSize, updateArray, updateArray, updateAsciiStream, updateAsciiStream, updateAsciiStream, updateAsciiStream, updateAsciiStream, updateAsciiStream, updateBigDecimal, updateBigDecimal, updateBinaryStream, updateBinaryStream, updateBinaryStream, updateBinaryStream, updateBinaryStream, updateBinaryStream, updateBlob, updateBlob, updateBlob, updateBlob, updateBlob, updateBlob, updateBoolean, updateBoolean, updateByte, updateByte, updateBytes, updateBytes, updateCharacterStream, updateCharacterStream, updateCharacterStream, updateCharacterStream, updateCharacterStream, updateCharacterStream, updateClob, updateClob, updateClob, updateClob, updateClob, updateClob, updateDate, updateDate, updateDouble, updateDouble, updateFloat, updateFloat, updateInt, updateInt, updateLong, updateLong, updateNCharacterStream, updateNCharacterStream, updateNCharacterStream, updateNCharacterStream, updateNClob, updateNClob, updateNClob, updateNClob, updateNClob, updateNClob, updateNString, updateNString, updateNull, updateNull, updateObject, updateObject, updateObject, updateObject, updateRef, updateRef, updateRow, updateRowId, updateRowId, updateShort, updateShort, updateSQLXML, updateSQLXML, updateString, updateString, updateTime, updateTime, updateTimestamp, updateTimestamp, wasNull
 
從介面 java.sql.Wrapper 繼承的方法
isWrapperFor, unwrap
 

方法詳細資訊

getUrl

String getUrl()
              throws SQLException
如果此 RowSet 物件使用 DriverManager 而非 DataSource 物件建立連接，則獲取創建連接時將使用的 url 屬性。預設值為 null。

返回：
字元串 url
拋出：
SQLException - 如果發生資料庫存取錯誤
另請參見：
setUrl(java.lang.String)

setUrl

void setUrl(String url)
            throws SQLException
設置此 RowSet 物件在使用 DriverManager 創建連接時將使用的 URL。 設置此屬性是可選的。如果使用 URL，則在使用 rowset 連接到資料庫之前，必須載入接受 URL 的 JDBC 驅動程序。在讀取或寫入資料時，rowset 將在內部使用 URL 創建資料庫連接。創建連接時可能使用 URL，也可能使用資料源名稱，具體取決於最近一次設置為非 null 值的是哪一個。

參數：
url - 字元串值；可以為 null
拋出：
SQLException - 如果發生資料庫存取錯誤
另請參見：
getUrl()

getDataSourceName

String getDataSourceName()
獲取標識此 RowSet 物件的資料源的邏輯名稱。

返回：
資料源名稱
另請參見：
setDataSourceName(java.lang.String), setUrl(java.lang.String)

setDataSourceName

void setDataSourceName(String name)
                       throws SQLException
將此 RowSet 物件的資料源名稱屬性設置為給定的 String。

可以使用資料源名稱屬性的值來尋找已經在命名服務中註冊的 DataSource 物件。完成檢索後，可以使用 DataSource 物件創建到它所表示的資料源的連接。

參數：
name - 此 RowSet 物件資料源的邏輯名稱；可以為 null
拋出：
SQLException - 如果發生資料庫存取錯誤
另請參見：
getDataSourceName()

getUsername

String getUsername()
獲取用於創建此 RowSet 物件的資料庫連接的使用者名。使用者名屬性是在調用 execute 方法前在運行時設置的。它通常不是 RowSet 物件的序列化狀態的一部分。

返回：
使用者名屬性
另請參見：
setUsername(java.lang.String)

setUsername

void setUsername(String name)
                 throws SQLException
將此 RowSet 物件的使用者名屬性設置為給定的 String。

參數：
name - 使用者名
拋出：
SQLException - 如果發生資料庫存取錯誤
另請參見：
getUsername()

getPassword

String getPassword()
獲取用於創建資料庫連接的密碼。密碼屬性是在調用 execute 方法前在運行時設置的。它通常不是 RowSet 物件的序列化狀態的一部分。

返回：
用於創建資料庫連接的密碼
另請參見：
setPassword(java.lang.String)

setPassword

void setPassword(String password)
                 throws SQLException
將此 RowSet 物件的資料庫密碼設置為給定的 String。

參數：
password - 密碼字元串
拋出：
SQLException - 如果發生資料庫存取錯誤
另請參見：
getPassword()

getTransactionIsolation

int getTransactionIsolation()
獲取為此 RowSet 物件設置的事務隔離級別。

返回：
事務隔離級別；Connection.TRANSACTION_READ_UNCOMMITTED、Connection.TRANSACTION_READ_COMMITTED、Connection.TRANSACTION_REPEATABLE_READ 或 Connection.TRANSACTION_SERIALIZABLE 之一
另請參見：
setTransactionIsolation(int)

setTransactionIsolation

void setTransactionIsolation(int level)
                             throws SQLException
設置此 RowSet 物件的事務隔離級別。

參數：
level - 事務隔離級別；Connection.TRANSACTION_READ_UNCOMMITTED、Connection.TRANSACTION_READ_COMMITTED、Connection.TRANSACTION_REPEATABLE_READ 或 Connection.TRANSACTION_SERIALIZABLE 之一
拋出：
SQLException - 如果發生資料庫存取錯誤
另請參見：
getTransactionIsolation()

getTypeMap

Map<String,Class<?>> getTypeMap()
                                throws SQLException
獲取與此 RowSet 物件關聯的 Map 物件，該物件指定 SQL 使用者定義型別的自定義映射關係（如果有）。預設型別映射為空。

返回：
一個 java.util.Map 物件，該物件包含 SQL 使用者定義型別的名稱及其映射到的 Java 類別
拋出：
SQLException - 如果發生資料庫存取錯誤
另請參見：
setTypeMap(java.util.Map>)

setTypeMap

void setTypeMap(Map<String,Class<?>> map)
                throws SQLException
將給定 java.util.Map 物件安裝為此 RowSet 物件的預設型別映射表。在通過方法參數提供另一個型別映射表之前，將一直使用此型別映射表。

參數：
map - 一個 java.util.Map 物件，該物件包含 SQL 使用者定義型別的名稱及其映射到的 Java 類別
拋出：
SQLException - 如果發生資料庫存取錯誤
另請參見：
getTypeMap()

getCommand

String getCommand()
獲取此 RowSet 物件的命令屬性。 命令屬性包含命令字元串，該字元串必須為 SQL 查詢，執行該查詢可以使用資料填充 rowset。預設值為 null。

返回：
命令字元串；可以為 null
另請參見：
setCommand(java.lang.String)

setCommand

void setCommand(String cmd)
                throws SQLException
將此 RowSet 物件的命令屬性設置為給定的 SQL 查詢。 當 rowset 從不支持命令的資料源（如電子錶格）獲取資料時，此屬性是可選的。

參數：
cmd - 將用於為此 RowSet 物件獲取資料的 SQL 查詢；可以為 null
拋出：
SQLException - 如果發生資料庫存取錯誤
另請參見：
getCommand()

isReadOnly

boolean isReadOnly()
獲取此 RowSet 物件是否是只讀的。如果能夠進行更新，則預設 rowset 為可更新。

試圖更新只讀 rowset 將導致拋出 SQLException。

返回：
如果此 RowSet 物件是只讀的，則返回 true；如果它是可更新的，則返回 false
另請參見：
setReadOnly(boolean)

setReadOnly

void setReadOnly(boolean value)
                 throws SQLException
將此 RowSet 物件的只讀性設置為給定的 boolean 值。

參數：
value - 如果只讀，則該值為 true；如果可更新，則為 false
拋出：
SQLException - 如果發生資料庫存取錯誤
另請參見：
isReadOnly()

getMaxFieldSize

int getMaxFieldSize()
                    throws SQLException
獲取可以對某些列值返回的最大位元組數。此限制僅應用於 BINARY、VARBINARY、LONGVARBINARYBINARY、CHAR、VARCHAR、LONGVARCHAR、NCHAR 和 NVARCHAR 列。如果超過了該限制，則預設丟棄多出的資料。

返回：
當前最大列大小限制；零表示不存在任何限制
拋出：
SQLException - 如果發生資料庫存取錯誤
另請參見：
setMaxFieldSize(int)

setMaxFieldSize

void setMaxFieldSize(int max)
                     throws SQLException
將可以對列值返回的最大位元組數設置為給定的位元組數。此限制僅應用於 BINARY、VARBINARY、LONGVARBINARYBINARY、CHAR、VARCHAR、LONGVARCHAR、NCHAR 和 NVARCHAR 列。如果超過了該限制，則預設丟棄多出的資料。為了獲得最大的可移植性，應該使用大於 256 的值。

參數：
max - 以位元組為單位的新最大列大小限制；零表示沒有任何限制
拋出：
SQLException - 如果發生資料庫存取錯誤
另請參見：
getMaxFieldSize()

getMaxRows

int getMaxRows()
               throws SQLException
獲取此 RowSet 物件可以包含的最大行數。如果超過了該限制，則正常撤消多出的行。

返回：
此 RowSet 物件可以包含的當前最大行數；零表示不存在任何限制
拋出：
SQLException - 如果發生資料庫存取錯誤
另請參見：
setMaxRows(int)

setMaxRows

void setMaxRows(int max)
                throws SQLException
將此 RowSet 物件可以包含的最大行數設置為指定數。如果超過了該限制，則正常撤消多出的行。

參數：
max - 新最大行數；零表示沒有任何限制
拋出：
SQLException - 如果發生資料庫存取錯誤
另請參見：
getMaxRows()

getEscapeProcessing

boolean getEscapeProcessing()
                            throws SQLException
獲取是否為此 RowSet 物件啟用轉義處理。如果啟用轉義掃瞄（預設值），則驅動程序在將 SQL 語句發送到資料庫之前將執行轉義替換。

返回：
如果啟用轉義處理，則返回 true；如果禁用，則返回 false
拋出：
SQLException - 如果發生資料庫存取錯誤
另請參見：
setEscapeProcessing(boolean)

setEscapeProcessing

void setEscapeProcessing(boolean enable)
                         throws SQLException
將此 RowSet 物件的轉義處理設置為開或關。如果轉義掃瞄為開啟（預設值），則驅動程序在將 SQL 語句發送到資料庫之前將執行轉義替換。

參數：
enable - 為 true 表示啟用轉義處理；為 false 表示禁用轉義處理
拋出：
SQLException - 如果發生資料庫存取錯誤
另請參見：
getEscapeProcessing()

getQueryTimeout

int getQueryTimeout()
                    throws SQLException
獲取驅動程序等待語句執行的最大秒數。如果超過此限制，則拋出 SQLException。

返回：
以秒為單位的當前查詢逾時限制；零表示不存在任何限制
拋出：
SQLException - 如果發生資料庫存取錯誤
另請參見：
setQueryTimeout(int)

setQueryTimeout

void setQueryTimeout(int seconds)
                     throws SQLException
將驅動程序等待語句執行的最大秒數設置為給定的秒數。如果超過此限制，則拋出 SQLException。

參數：
seconds - 以秒為單位的新查詢逾時限制；零表示不存在任何限制
拋出：
SQLException - 如果發生資料庫存取錯誤
另請參見：
getQueryTimeout()

setType

void setType(int type)
             throws SQLException
將此 RowSet 物件的型別設置為給定的型別。此方法用於更改 rowset 的型別，預設情況下該型別為只讀且不可滾動。

參數：
type - 以下指定型別的 ResultSet 常數之一：ResultSet.TYPE_FORWARD_ONLY、ResultSet.TYPE_SCROLL_INSENSITIVE 或 ResultSet.TYPE_SCROLL_SENSITIVE
拋出：
SQLException - 如果發生資料庫存取錯誤
另請參見：
ResultSet.getType()

setConcurrency

void setConcurrency(int concurrency)
                    throws SQLException
將此 RowSet 物件的共時性設置為給定的共時級別。此方法用於更改 rowset 的共時級別，預設情況下為 ResultSet.CONCUR_READ_ONLY。

參數：
concurrency - 以下指定共時級別的 ResultSet 常數之一：ResultSet.CONCUR_READ_ONLY 或 ResultSet.CONCUR_UPDATABLE
拋出：
SQLException - 如果發生資料庫存取錯誤
另請參見：
ResultSet.getConcurrency()

setNull

void setNull(int parameterIndex,
             int sqlType)
             throws SQLException
將此 RowSet 物件的 SQL 命令中的指定參數設置為 SQL NULL。

註： 必須指定參數的 SQL 型別。

參數：
parameterIndex - 第一個參數的索引是 1，第二個參數的索引是 2 ……
sqlType - 由 java.sql.Types 定義的 SQL 型別程式碼
拋出：
SQLException - 如果發生資料庫存取錯誤

setNull

void setNull(String parameterName,
             int sqlType)
             throws SQLException
將指定參數設置為 SQL NULL。

註： 必須指定該參數的 SQL 型別。

參數：
parameterName - 參數的名稱
sqlType - java.sql.Types 中定義的 SQL 型別程式碼
拋出：
SQLException - 如果發生資料庫存取錯誤或者在關閉的 CallableStatement 上調用此方法
SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法
從以下版本開始：
1.4

setNull

void setNull(int paramIndex,
             int sqlType,
             String typeName)
             throws SQLException
將此 RowSet 物件的 SQL 命令中的指定參數設置為 SQL NULL。這種 setNull 方法應該用於 SQL 使用者定義的型別 (UDT) 和 REF 型別參數。UDT 的例子包括：STRUCT、DISTINCT、JAVA_OBJECT 和指定陣列型別。

註： 為了便於移植，在指定 NULL UDT 或 REF 參數時，應用程序必須提供 SQL 型別程式碼和全限定 SQL 型別名稱。對於 UDT 參數，名稱是參數本身的型別名稱。對於 REF 參數，名稱是所參考型別的型別名稱。如果 JDBC 驅動程序不需要型別程式碼或型別名稱資訊，那麼它可以忽略此資訊。 儘管此方法適合 UDT 和 REF 參數使用，但可以使用此方法來設置任意 JDBC 型別的 null 參數。如果該參數沒有使用者定義的型別或 REF 型別，則忽略 typeName 參數。

參數：
paramIndex - 第一個參數是 1，第二個參數是 2 ……
sqlType - 取自 java.sql.Types 的值
typeName - SQL UDT 的完全限定名或 REF 型別參考的 SQL 結構化型別的名稱；如果不是 UDT 或 REF 型別，則忽略該參數
拋出：
SQLException - 如果發生資料庫存取錯誤

setNull

void setNull(String parameterName,
             int sqlType,
             String typeName)
             throws SQLException
將指定參數設置為 SQL NULL。這種 setNull 方法應該用於使用者定義型別和 REF 型別參數。使用者定義型別的範例有：STRUCT、DISTINCT、JAVA_OBJECT 和指定陣列型別。

註： 為了便於移植，在指定 NULL 使用者定義參數或 REF 參數時，應用程序必須提供 SQL 型別程式碼和完全限定的 SQL 型別名稱。 在使用者定義型別的情況下，名稱是參數本身的型別名稱。對於 REF 參數，名稱是所參考型別的型別名稱。如果 JDBC 驅動程序不需要型別程式碼或型別名稱資訊，那麼它可以忽略這些資訊。 儘管此方法供使用者定義參數和 Ref 參數使用，但也可以使用它設置任何 JDBC 型別的 null 參數。如果該參數不具有使用者定義型別或 REF 型別，則忽略給定 typeName。

參數：
parameterName - 參數的名稱
sqlType - 取自 java.sql.Types 的值
typeName - SQL 使用者定義型別的完全限定名稱；如果該參數不是使用者定義型別或 SQL REF 值，則忽略它
拋出：
SQLException - 如果發生資料庫存取錯誤或者在關閉的 CallableStatement 上調用此方法
SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法
從以下版本開始：
1.4

setBoolean

void setBoolean(int parameterIndex,
                boolean x)
                throws SQLException
將此 RowSet 物件命令中的指定參數設置為給定的 Java boolean 值。在將此值發送到資料庫之前，驅動程序將其轉換為 SQL BIT 值。

參數：
parameterIndex - 第一個參數的索引是 1，第二個參數的索引是 2 ……
x - 參數值
拋出：
SQLException - 如果發生資料庫存取錯誤

setBoolean

void setBoolean(String parameterName,
                boolean x)
                throws SQLException
將指定參數設置為給定的 Java boolean 值。在將此值發送到資料庫時，驅動程序將其轉換為 SQL BIT 或 BOOLEAN 值。

參數：
parameterName - 參數的名稱
x - 參數值
拋出：
SQLException - 如果發生資料庫存取錯誤或者在關閉的 CallableStatement 上調用此方法
SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法
從以下版本開始：
1.4
另請參見：
ResultSet.getBoolean(int)

setByte

void setByte(int parameterIndex,
             byte x)
             throws SQLException
將此 RowSet 物件命令中的指定參數設置為給定的 Java byte 值。在將此值發送到資料庫之前，驅動程序將其轉換為 SQL TINYINT 值。

參數：
parameterIndex - 第一個參數的索引是 1，第二個參數的索引是 2 ……
x - 參數值
拋出：
SQLException - 如果發生資料庫存取錯誤

setByte

void setByte(String parameterName,
             byte x)
             throws SQLException
將指定參數設置為給定的 Java byte 值。在將此值發送到資料庫時，驅動程序將其轉換為 SQL TINYINT 值。

參數：
parameterName - 參數的名稱
x - 參數值
拋出：
SQLException - 如果發生資料庫存取錯誤或者在關閉的 CallableStatement 上調用此方法
SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法
從以下版本開始：
1.4
另請參見：
ResultSet.getByte(int)

setShort

void setShort(int parameterIndex,
              short x)
              throws SQLException
將此 RowSet 物件命令中的指定參數設置為給定的 Java short 值。在將此值發送到資料庫之前，驅動程序將其轉換為 SQL SMALLINT 值。

參數：
parameterIndex - 第一個參數的索引是 1，第二個參數的索引是 2 ……
x - 參數值
拋出：
SQLException - 如果發生資料庫存取錯誤

setShort

void setShort(String parameterName,
              short x)
              throws SQLException
將指定參數設置為給定的 Java short 值。在將此值發送到資料庫時，驅動程序將其轉換為 SQL SMALLINT 值。

參數：
parameterName - 參數的名稱
x - 參數值
拋出：
SQLException - 如果發生資料庫存取錯誤或者在關閉的 CallableStatement 上調用此方法
SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法
從以下版本開始：
1.4
另請參見：
ResultSet.getShort(int)

setInt

void setInt(int parameterIndex,
            int x)
            throws SQLException
將此 RowSet 物件命令中的指定參數設置為給定的 Java int 值。在將此值發送到資料庫之前，驅動程序將其轉換為 SQL INTEGER 值。

參數：
parameterIndex - 第一個參數的索引是 1，第二個參數的索引是 2 ……
x - 參數值
拋出：
SQLException - 如果發生資料庫存取錯誤

setInt

void setInt(String parameterName,
            int x)
            throws SQLException
將指定參數設置為給定的 Java int 值。在將此值發送到資料庫時，驅動程序將其轉換為 SQL INTEGER 值。

參數：
parameterName - 參數的名稱
x - 參數值
拋出：
SQLException - 如果發生資料庫存取錯誤或者在關閉的 CallableStatement 上調用此方法
SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法
從以下版本開始：
1.4
另請參見：
ResultSet.getInt(int)

setLong

void setLong(int parameterIndex,
             long x)
             throws SQLException
將此 RowSet 物件命令中的指定參數設置為給定的 Java long 值。在將此值發送到資料庫之前，驅動程序將其轉換為 SQL BIGINT 值。

參數：
parameterIndex - 第一個參數的索引是 1，第二個參數的索引是 2 ……
x - 參數值
拋出：
SQLException - 如果發生資料庫存取錯誤

setLong

void setLong(String parameterName,
             long x)
             throws SQLException
將指定參數設置為給定的 Java long 值。在將此值發送到資料庫時，驅動程序將其轉換為 SQL BIGINT 值。

參數：
parameterName - 參數的名稱
x - 參數值
拋出：
SQLException - 如果發生資料庫存取錯誤或者在關閉的 CallableStatement 上調用此方法
SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法
從以下版本開始：
1.4
另請參見：
ResultSet.getLong(int)

setFloat

void setFloat(int parameterIndex,
              float x)
              throws SQLException
將此 RowSet 物件命令中的指定參數設置為給定的 Java float 值。在將此值發送到資料庫之前，驅動程序將其轉換為 SQL REAL 值。

參數：
parameterIndex - 第一個參數的索引是 1，第二個參數的索引是 2 ……
x - 參數值
拋出：
SQLException - 如果發生資料庫存取錯誤

setFloat

void setFloat(String parameterName,
              float x)
              throws SQLException
將指定參數設置為給定的 Java float 值。在將此值發送到資料庫時，驅動程序將其轉換為 SQL FLOAT 值。

參數：
parameterName - 參數的名稱
x - 參數值
拋出：
SQLException - 如果發生資料庫存取錯誤或者在關閉的 CallableStatement 上調用此方法
SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法
從以下版本開始：
1.4
另請參見：
ResultSet.getFloat(int)

setDouble

void setDouble(int parameterIndex,
               double x)
               throws SQLException
將此 RowSet 物件命令中的指定參數設置為給定的 Java double 值。在將此值發送到資料庫之前，驅動程序將其轉換為 SQL DOUBLE 值。

參數：
parameterIndex - 第一個參數的索引是 1，第二個參數的索引是 2 ……
x - 參數值
拋出：
SQLException - 如果發生資料庫存取錯誤

setDouble

void setDouble(String parameterName,
               double x)
               throws SQLException
將指定參數設置為給定的 Java double 值。在將此值發送到資料庫時，驅動程序將其轉換為 SQL DOUBLE 值。

參數：
parameterName - 參數的名稱
x - 參數值
拋出：
SQLException - 如果發生資料庫存取錯誤或者在關閉的 CallableStatement 上調用此方法
SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法
從以下版本開始：
1.4
另請參見：
ResultSet.getDouble(int)

setBigDecimal

void setBigDecimal(int parameterIndex,
                   BigDecimal x)
                   throws SQLException
將此 RowSet 物件命令中的指定參數設置為給定的 java.math.BigDeciaml 值。在將此值發送到資料庫之前，驅動程序將其轉換為 SQL NUMERIC 值。

參數：
parameterIndex - 第一個參數的索引是 1，第二個參數的索引是 2 ……
x - 參數值
拋出：
SQLException - 如果發生資料庫存取錯誤

setBigDecimal

void setBigDecimal(String parameterName,
                   BigDecimal x)
                   throws SQLException
將指定參數設置為給定的 java.math.BigDecimal 值。在將此值發送到資料庫時，驅動程序將其轉換為 SQL NUMERIC 值。

參數：
parameterName - 參數的名稱
x - 參數值
拋出：
SQLException - 如果發生資料庫存取錯誤或者在關閉的 CallableStatement 上調用此方法
SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法
從以下版本開始：
1.4
另請參見：
ResultSet.getBigDecimal(int, int)

setString

void setString(int parameterIndex,
               String x)
               throws SQLException
將此 RowSet 物件命令中的指定參數設置為給定的 Java String 值。在將此值發送給資料庫之前，驅動程序將其轉換為 SQL VARCHAR 或 LONGVARCHAR 值，具體取決於該參數相對於驅動程序在 VARCHAR 值上的限制的大小。

參數：
parameterIndex - 第一個參數的索引是 1，第二個參數的索引是 2 ……
x - 參數值
拋出：
SQLException - 如果發生資料庫存取錯誤

setString

void setString(String parameterName,
               String x)
               throws SQLException
將指定參數設置為給定的 Java String 值。在將此值發送到資料庫時，驅動程序將其轉換為 SQL VARCHAR 或 LONGVARCHAR 值（具體取決於該參數相對於驅動程序在 VARCHAR 值上的限制的大小）。

參數：
parameterName - 參數的名稱
x - 參數值
拋出：
SQLException - 如果發生資料庫存取錯誤或者在關閉的 CallableStatement 上調用此方法
SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法
從以下版本開始：
1.4
另請參見：
ResultSet.getString(int)

setBytes

void setBytes(int parameterIndex,
              byte[] x)
              throws SQLException
將此 RowSet 物件命令中的指定參數設置為給定的 Java byte 值陣列。在將此值發送給資料庫之前，驅動程序將其轉換為 SQL VARBINARY 或 LONGVARBINARY 值，具體取決於該參數相對於驅動程序在 VARBINARY 值上的限制的大小。

參數：
parameterIndex - 第一個參數的索引是 1，第二個參數的索引是 2 ……
x - 參數值
拋出：
SQLException - 如果發生資料庫存取錯誤

setBytes

void setBytes(String parameterName,
              byte[] x)
              throws SQLException
將指定參數設置為給定的 Java byte 陣列。在將此值發送到資料庫時，驅動程序將其轉換為 SQL VARBINARY 或 LONGVARBINARY 值（具體取決於該參數相對於驅動程序在 VARBINARY 值上的限制的大小）。

參數：
parameterName - 參數的名稱
x - 參數值
拋出：
SQLException - 如果發生資料庫存取錯誤或者在關閉的 CallableStatement 上調用此方法
SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法
從以下版本開始：
1.4
另請參見：
ResultSet.getBytes(int)

setDate

void setDate(int parameterIndex,
             Date x)
             throws SQLException
將此 RowSet 物件命令中的指定參數設置為給定的 java.sql.Date 值。在將此值發送到資料庫之前，驅動程序將其轉換為 SQL DATE 值，使用預設的 java.util.Calendar 來計算日期。

參數：
parameterIndex - 第一個參數的索引是 1，第二個參數的索引是 2 ……
x - 參數值
拋出：
SQLException - 如果發生資料庫存取錯誤

setTime

void setTime(int parameterIndex,
             Time x)
             throws SQLException
將此 RowSet 物件命令中的指定參數設置為給定的 java.sql.Time 值。在將此值發送到資料庫之前，驅動程序將其轉換為 SQL TIME 值，使用預設的 java.util.Calendar 來計算該值。

參數：
parameterIndex - 第一個參數的索引是 1，第二個參數的索引是 2 ……
x - 參數值
拋出：
SQLException - 如果發生資料庫存取錯誤

setTimestamp

void setTimestamp(int parameterIndex,
                  Timestamp x)
                  throws SQLException
將此 RowSet 物件命令中的指定參數設置為給定的 java.sql.Timestamp 值。在將此值發送到資料庫之前，驅動程序將其轉換為 SQL TIMESTAMP 值，使用預設的 java.util.Calendar 來計算該值。

參數：
parameterIndex - 第一個參數的索引是 1，第二個參數的索引是 2 ……
x - 參數值
拋出：
SQLException - 如果發生資料庫存取錯誤

setTimestamp

void setTimestamp(String parameterName,
                  Timestamp x)
                  throws SQLException
將指定參數設置為給定的 java.sql.Timestamp 值。在將此值發送到資料庫時，驅動程序將其轉換為 SQL TIMESTAMP 值。

參數：
parameterName - 參數的名稱
x - 參數值
拋出：
SQLException - 如果發生資料庫存取錯誤或者在關閉的 CallableStatement 上調用此方法
SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法
從以下版本開始：
1.4
另請參見：
ResultSet.getTimestamp(int)

setAsciiStream

void setAsciiStream(int parameterIndex,
                    InputStream x,
                    int length)
                    throws SQLException
將此 RowSet 物件命令中的指定參數設置為給定的 java.io.InputStream 值。更實際的做法是，通過 java.io.InputStream 而不是 LONGVARCHAR 參數來發送很大的 ASCII 值。在到達檔案末尾之前，驅動程序將根據需要從該串流讀取資料。

註：此串流物件既可以是一個標準 Java 串流物件，也可以是使用者定義的實作標準介面的子類別。

參數：
parameterIndex - 第一個參數的索引是 1，第二個參數的索引是 2 ……
x - 套件含 ASCII 參數值的 Java 輸入串流
length - 串流中的位元組數
拋出：
SQLException - 如果發生資料庫存取錯誤

setAsciiStream

void setAsciiStream(String parameterName,
                    InputStream x,
                    int length)
                    throws SQLException
將指定參數設置為給定輸入串流，該輸入串流將擁有指定位元組數。在將一個非常大的 ASCII 值輸入到 LONGVARCHAR 參數時，通過 java.io.InputStream 發送可能更為實際。將根據需要從串流中讀取資料，一直讀取到檔案末尾。 JDBC 驅動程序將執行從 ASCII 到資料庫 char 格式的任何必要轉換。

註： 此串流物件既可以是一個標準 Java 串流物件，也可以是實作標準介面的使用者自己的子類別。

參數：
parameterName - 參數的名稱
x - 套件含 ASCII 參數值的 Java 輸入串流
length - 串流中的位元組數
拋出：
SQLException - 如果發生資料庫存取錯誤或者在關閉的 CallableStatement 上調用此方法
SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法
從以下版本開始：
1.4

setBinaryStream

void setBinaryStream(int parameterIndex,
                     InputStream x,
                     int length)
                     throws SQLException
將此 RowSet 物件命令中的指定參數設置為給定的 java.io.InputStream 值。更實際的做法是，通過 java.io.InputStream 而不是 LONGVARBINARY 參數來發送很大的二進制值。在到達檔案末尾之前，驅動程序將根據需要從該串流讀取資料。

註： 此串流物件既可以是一個標準 Java 串流物件，也可以是實作標準介面的使用者自己的子類別。

參數：
parameterIndex - 第一個參數的索引是 1，第二個參數的索引是 2 ……
x - 套件含二進制參數值的 Java 輸入串流
length - 串流中的位元組數
拋出：
SQLException - 如果發生資料庫存取錯誤

setBinaryStream

void setBinaryStream(String parameterName,
                     InputStream x,
                     int length)
                     throws SQLException
將指定參數設置為給定輸入串流，該輸入串流將擁有給定位元組數。在將一個非常大的二進制值輸入到 LONGVARBINARY 參數時，通過 java.io.InputStream 物件發送它可能更為實際。將根據需要從串流中讀取資料，一直讀取到檔案末尾。

註： 此串流物件既可以是一個標準 Java 串流物件，也可以是實作標準介面的使用者自己的子類別。

參數：
parameterName - 參數的名稱
x - 套件含二進制參數值的 java 輸入串流
length - 串流中的位元組數
拋出：
SQLException - 如果發生資料庫存取錯誤或者在關閉的 CallableStatement 上調用此方法
SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法
從以下版本開始：
1.4

setCharacterStream

void setCharacterStream(int parameterIndex,
                        Reader reader,
                        int length)
                        throws SQLException
將此 RowSet 物件命令中的指定參數設置為給定的 java.io.Reader 值。更實際的做法是，通過 java.io.Reader 而不是 LONGVARCHAR 參數來發送很大的 UNICODE 值。在到達檔案末尾之前，驅動程序將根據需要從該串流讀取資料。

註： 此串流物件既可以是一個標準 Java 串流物件，也可以是實作標準介面的使用者自己的子類別。

參數：
parameterIndex - 第一個參數的索引是 1，第二個參數的索引是 2 ……
reader - 套件含要設置的 UNICODE 資料的 Reader 物件
length - 串流中的字元數
拋出：
SQLException - 如果發生資料庫存取錯誤

setCharacterStream

void setCharacterStream(String parameterName,
                        Reader reader,
                        int length)
                        throws SQLException
將指定參數設置為給定 Reader 物件，該物件是給定的字元長度數目。在將一個非常大的 UNICODE 值輸入到 LONGVARCHAR 參數時，通過 java.io.Reader 發送它可能更為實際。將根據需要從串流中讀取資料，一直讀取到檔案末尾。 JDBC 驅動程序將執行從 UNICODE 到資料庫 char 格式的任何必要轉換。

註： 此串流物件既可以是一個標準 Java 串流物件，也可以是實作標準介面的使用者自己的子類別。

參數：
parameterName - 參數的名稱
reader - 套件含用作指定參數的 UNICODE 資料的 java.io.Reader 物件
length - 串流中的字元數
拋出：
SQLException - 如果發生資料庫存取錯誤或者在關閉的 CallableStatement 上調用此方法
SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法
從以下版本開始：
1.4

setAsciiStream

void setAsciiStream(int parameterIndex,
                    InputStream x)
                    throws SQLException
將此 RowSet 物件命令中的指定參數設置為給定輸入串流。在將一個非常大的 ASCII 值輸入到 LONGVARCHAR 參數時，通過 java.io.InputStream 發送它可能更為實際。將根據需要從串流中讀取資料，一直讀取到檔案末尾。 JDBC 驅動程序將執行從 ASCII 到資料庫 char 格式的任何必要轉換。

註： 此串流物件既可以是一個標準 Java 串流物件，也可以是實作標準介面的使用者自己的子類別。

註： 請參考 JDBC 驅動程序文檔確定使用帶長度參數的 setAsciiStream 是否更有效。

參數：
parameterIndex - 第一個參數的索引是 1，第二個參數的索引是 2 ……
x - 套件含 ASCII 參數值的 Java 輸入串流
拋出：
SQLException - 如果發生資料庫存取錯誤或者在關閉的 PreparedStatement 上調用此方法
SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法
從以下版本開始：
1.6

setAsciiStream

void setAsciiStream(String parameterName,
                    InputStream x)
                    throws SQLException
將指定參數設置為給定輸入串流。在將一個非常大的 ASCII 值輸入到 LONGVARCHAR 參數時，通過 java.io.InputStream 發送它可能更為實際。將根據需要從串流中讀取資料，一直讀取到檔案末尾。JDBC 驅動程序將執行從 ASCII 到資料庫 char 格式的任何必要轉換。

註： 此串流物件既可以是一個標準 Java 串流物件，也可以是實作標準介面的使用者自己的子類別。

註： 請參考 JDBC 驅動程序文檔確定使用帶有長度參數的 setAsciiStream 是否更有效。

參數：
parameterName - 參數的名稱
x - 套件含 ASCII 參數值的 Java 輸入串流
拋出：
SQLException - 如果發生資料庫存取錯誤或者在關閉的 CallableStatement 上調用此方法
SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法
從以下版本開始：
1.6

setBinaryStream

void setBinaryStream(int parameterIndex,
                     InputStream x)
                     throws SQLException
將此 RowSet 物件命令中的指定參數設置為給定輸入串流。在將一個非常大的二進制值輸入到 LONGVARBINARY 參數時，通過 java.io.InputStream 物件發送它可能更為實際。將根據需要從串流中讀取資料，一直讀取到檔案末尾。

註： 此串流物件既可以是一個標準 Java 串流物件，也可以是實作標準介面的使用者自己的子類別。

註： 請參考 JDBC 驅動程序文檔確定使用帶有長度參數的 setBinaryStream 是否更有效。

參數：
parameterIndex - 第一個參數的索引是 1，第二個參數的索引是 2 ……
x - 套件含二進制參數值的 Java 輸入串流
拋出：
SQLException - 如果發生資料庫存取錯誤或者在關閉的 PreparedStatement 上調用此方法
SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法
從以下版本開始：
1.6

setBinaryStream

void setBinaryStream(String parameterName,
                     InputStream x)
                     throws SQLException
將指定參數設置為給定輸入串流。在將一個非常大的二進制值輸入到 LONGVARBINARY 參數時，通過 java.io.InputStream 物件發送它可能更為實際。將根據需要從串流中讀取資料，一直讀取到檔案末尾。

註： 此串流物件既可以是一個標準 Java 串流物件，也可以是實作標準介面的使用者自己的子類別。

註： 請參考 JDBC 驅動程序文檔確定使用帶有長度參數的 setBinaryStream 是否更有效。

參數：
parameterName - 參數的名稱
x - 套件含二進制參數值的 Java 輸入串流
拋出：
SQLException - 如果發生資料庫存取錯誤或者在關閉的 CallableStatement 上調用此方法
SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法
從以下版本開始：
1.6

setCharacterStream

void setCharacterStream(int parameterIndex,
                        Reader reader)
                        throws SQLException
將此 RowSet 物件命令中的指定參數設置為給定 Reader 物件。在將一個非常大的 UNICODE 值輸入到 LONGVARCHAR 參數時，通過 java.io.Reader 物件發送它可能更為實際。將根據需要從串流中讀取資料，一直讀取到檔案末尾。 JDBC 驅動程序將執行從 UNICODE 到資料庫 char 格式的任何必要轉換。

註： 此串流物件既可以是一個標準 Java 串流物件，也可以是實作標準介面的使用者自己的子類別。

註： 請參考 JDBC 驅動程序文檔確定使用帶有長度參數的 setCharacterStream 是否更有效。

參數：
parameterIndex - 第一個參數的索引是 1，第二個參數的索引是 2 ……
reader - 套件含 Unicode 資料的 java.io.Reader 物件
拋出：
SQLException - 如果發生資料庫存取錯誤或者在關閉的 PreparedStatement 上調用此方法
SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法
從以下版本開始：
1.6

setCharacterStream

void setCharacterStream(String parameterName,
                        Reader reader)
                        throws SQLException
將指定參數設置為給定 Reader 物件。在將一個非常大的 UNICODE 值輸入到 LONGVARCHAR 參數時，通過 java.io.Reader 物件發送它可能更為實際。將根據需要從串流中讀取資料，一直讀取到檔案末尾。JDBC 驅動程序將執行從 UNICODE 到資料庫 char 格式的任何必要轉換。

註： 此串流物件既可以是一個標準 Java 串流物件，也可以是實作標準介面的使用者自己的子類別。

註： 請參考 JDBC 驅動程序文檔確定使用帶有長度參數的 setCharacterStream 是否更有效。

參數：
parameterName - 參數的名稱
reader - 套件含 Unicode 資料的 java.io.Reader 物件
拋出：
SQLException - 如果發生資料庫存取錯誤或者在關閉的 CallableStatement 上調用此方法
SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法
從以下版本開始：
1.6

setNCharacterStream

void setNCharacterStream(int parameterIndex,
                         Reader value)
                         throws SQLException
將此 RowSet 物件命令中的指定參數設置為 Reader 物件。Reader 讀取資料，一直讀取到檔案末尾。驅動程序將執行從 Java 字元格式到資料庫中國家字元集 (national character set) 的必要轉換。

註： 此串流物件既可以是一個標準 Java 串流物件，也可以是實作標準介面的使用者自己的子類別。

註： 請參考 JDBC 驅動程序文檔確定使用帶有長度參數的 setNCharacterStream 是否更有效。

參數：
parameterIndex - 第一個參數的索引是 1，第二個參數的索引是 2 ……
value - 參數值
拋出：
SQLException - 如果驅動程序不支持國家字元集；如果驅動程序檢測到可能發生資料轉換錯誤；如果發生資料庫存取錯誤；如果在關閉的 PreparedStatement 上調用此方法
SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法
從以下版本開始：
1.6

setObject

void setObject(int parameterIndex,
               Object x,
               int targetSqlType,
               int scaleOrLength)
               throws SQLException
使用給定 Java Object 設置此 RowSet 物件命令中的指定參數。對於整數值，應該使用 java.lang 等效物件（例如，對於 int，應使用 Integer 類別的實例）。 如果第二個參數是 InputStream，則該串流必須包含 scaleOrLength 所指定的位元組數。如果第二個參數是 Reader，則該 reader 必須包含 scaleOrLength 所指定的字元數。如果這些條件都不為 true，則驅動程序在執行準備好的語句時將會產生 SQLException。

在發送到資料庫之前，給定 Java 物件將被轉換為 targetSqlType。

如果物件是實作 SQLData 的類別，則 rowset 應該調用 SQLData.writeSQL 方法將物件寫入 SQLOutput 資料串流中。另一方面，如果物件是實作 Ref、Blob、Clob、NClob、Struct、java.net.URL 或 Array 的類別，則驅動程序應該將其作為相應 SQL 型別的值傳遞給資料庫。

注意，此方法可用於傳遞特定於資料庫的抽象資料型別。

參數：
parameterIndex - 第一個參數的索引是 1，第二個參數的索引是 2 ……
x - 套件含輸入參數值的物件
targetSqlType - 將發送給資料庫的 SQL 型別（定義於 java.sql.Types 中）。scale 參數可以進一步限定此型別。
scaleOrLength - 對於 java.sql.Types.DECIMAL 或 java.sql.Types.NUMERIC 型別，該值是小數點後的位數。對於 Java Object 型別 InputStream 和 Reader，該值是串流或 reader 中資料的長度。對於所有其他型別，將忽略此值。
拋出：
SQLException - 如果發生資料庫存取錯誤
另請參見：
Types

setObject

void setObject(String parameterName,
               Object x,
               int targetSqlType,
               int scale)
               throws SQLException
使用給定物件設置指定參數的值。第二個參數必須是一個物件型別；對於整數值，應該使用 java.lang 的等效物件。

在發送到資料庫之前，給定 Java 物件將被轉換為給定的 targetSqlType。 如果物件具有自定義映射關係（屬於實作 SQLData 介面的類別），則 JDBC 驅動程序應該調用 SQLData.writeSQL 方法將它寫入 SQL 資料串流中。另一方面，如果物件是實作 Ref、Blob、Clob、NClob、Struct、java.net.URL 或 Array 的類別，則驅動程序應該將其作為相應 SQL 型別的值傳遞給資料庫。

注意，此方法可用於傳遞特定於資料庫的抽象資料型別。

參數：
parameterName - 參數的名稱
x - 套件含輸入參數值的物件
targetSqlType - 將發送給資料庫的 SQL 型別（在 java.sql.Types 中定義）。scale 參數可以進一步限定此型別。
scale - 對於 java.sql.Types.DECIMAL 或 java.sql.Types.NUMERIC 型別，該值是小數點後的位數。對於所有其他型別，將忽略此值。
拋出：
SQLException - 如果發生資料庫存取錯誤或者在關閉的 CallableStatement 上調用此方法
SQLFeatureNotSupportedException - 如果 targetSqlType 是 ARRAY、BLOB、CLOB、DATALINK、JAVA_OBJECT、NCHAR、NCLOB、NVARCHAR、LONGNVARCHAR、REF、ROWID、SQLXML 或 STRUCT 資料型別並且 JDBC 驅動程序不支持此資料型別
從以下版本開始：
1.4
另請參見：
Types, ResultSet.getObject(int)

setObject

void setObject(int parameterIndex,
               Object x,
               int targetSqlType)
               throws SQLException
使用 Java Object 設置此 RowSet 物件命令中的指定參數。對於整數值，應該使用 java.lang 等效物件。此方法與上述 setObject 類似，但使用的 scale 是第二個參數的 scale。標量值的 scale 為零。文字值的 scale 存在於字面中。

儘管支持浮點型輸入值，但不建立使用該型別值調用此方法。

參數：
parameterIndex - 第一個參數的索引是 1，第二個參數的索引是 2 ……
x - 套件含輸入參數值的物件
targetSqlType - 將發送給資料庫的 SQL 型別（定義於 java.sql.Types 中）
拋出：
SQLException - 如果發生資料庫存取錯誤

setObject

void setObject(String parameterName,
               Object x,
               int targetSqlType)
               throws SQLException
使用給定物件設置指定參數的值。此方法類似於上面的 setObject 方法，不同之處在於它假定 scale 為 0。

參數：
parameterName - 參數的名稱
x - 套件含輸入參數值的物件
targetSqlType - 將發送給資料庫的 SQL 型別（在 java.sql.Types 中定義）
拋出：
SQLException - 如果發生資料庫存取錯誤或者在關閉的 CallableStatement 上調用此方法
SQLFeatureNotSupportedException - 如果 targetSqlType 是 ARRAY、BLOB、CLOB、DATALINK、JAVA_OBJECT、NCHAR、NCLOB、NVARCHAR、LONGNVARCHAR、REF、ROWID、SQLXML 或 STRUCT 資料型別並且 JDBC 驅動程序不支持此資料型別
從以下版本開始：
1.4
另請參見：
ResultSet.getObject(int)

setObject

void setObject(String parameterName,
               Object x)
               throws SQLException
使用給定物件設置指定參數的值。第二個參數必須是 Object 型別；所以，應該對內置型別使用 java.lang 的等效物件。

JDBC 規範指定一個從 Java Object 型別到 SQL 型別的標準映射關係。在發送到資料庫之前，給定參數將被轉換為相應的 SQL 型別。

注意，通過使用特定於驅動程序的 Java 型別，此方法可用於傳遞特定於資料庫的抽象資料型別。 如果物件是實作 SQLData 介面的類別，則 JDBC 驅動程序應該調用 SQLData.writeSQL 方法將它寫入 SQL 資料串流中。另一方面，如果物件是實作 Ref、Blob、Clob、NClob、Struct、java.net.URL 或 Array 的類別，則驅動程序應該將其作為相應 SQL 型別的值傳遞給資料庫。

如果出現混淆，例如該物件是實作多個上述指定介面的類別，則此方法拋出異常。

參數：
parameterName - 參數的名稱
x - 套件含輸入參數值的物件
拋出：
SQLException - 如果發生資料庫存取錯誤，在關閉的 CallableStatement 上調用此方法或者給定 Object 參數不明確
SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法
從以下版本開始：
1.4
另請參見：
ResultSet.getObject(int)

setObject

void setObject(int parameterIndex,
               Object x)
               throws SQLException
使用 Java Object 設置此 RowSet 物件命令中的指定參數。對於整數值，應該使用 java.lang 等效物件。

JDBC 規範提供了一個從 Java Object 型別到 SQL 型別的標準映射關係。在將給定 Java 物件發送到資料庫之前，驅動程序將其轉換為其標準的 SQL 映射關係。

注意，通過使用特定於驅動程序的 Java 型別，此方法可用於傳遞特定於資料庫的抽象資料型別。 如果物件是實作 SQLData 的類別，則 rowset 應該調用 SQLData.writeSQL 方法將物件寫入 SQLOutput 資料串流中。另一方面，如果物件是實作 Ref、Blob、Clob、NClob、Struct、java.net.URL 或 Array 的類別，則驅動程序應該將其作為相應 SQL 型別的值傳遞給資料庫。

如果出現混淆，例如如果該物件是實作多個這些介面的類別，則拋出異常。

參數：
parameterIndex - 第一個參數的索引是 1，第二個參數的索引是 2 ……
x - 套件含輸入參數值的物件
拋出：
SQLException - 如果發生資料庫存取錯誤

setRef

void setRef(int i,
            Ref x)
            throws SQLException
使用給定 Ref 值設置此 RowSet 物件命令中的指定參數。驅動程序將此值轉換為適當的 REF(<結構化型別>) 值。

參數：
i - 第一個參數是 1，第二個參數是 2 ……
x - 一個物件，它表示 SQL REF 型別的資料
拋出：
SQLException - 如果發生資料庫存取錯誤

setBlob

void setBlob(int i,
             Blob x)
             throws SQLException
使用給定 Blob 值設置此 RowSet 物件命令中的指定參數。在將此值發送到資料庫之前，驅動程序會將其轉換為 Blob 物件表示的 BLOB 值。

參數：
i - 第一個參數是 1，第二個參數是 2 ……
x - 表示 BLOB 的物件
拋出：
SQLException - 如果發生資料庫存取錯誤

setBlob

void setBlob(int parameterIndex,
             InputStream inputStream,
             long length)
             throws SQLException
將指定參數設置為 InputStream 物件。 inputstream 必須包含 length 所指定的字元數，否則，在執行 PreparedStatement 時將會產生 SQLException。此方法不同於 setBinaryStream (int, InputStream, int) 方法，因為它通知驅動程序參數值應該以 BLOB 的形式發送到伺服器。使用 setBinaryStream 方法時，驅動程序必須做額外的工作來確定參數資料是以 LONGVARBINARY 還是 BLOB 的形式發送到伺服器

參數：
parameterIndex - 第一個參數的索引是 1，第二個參數的索引是 2 ……
inputStream - 套件含用來設置參數值的資料的物件。
length - 參數資料中的位元組數。
拋出：
SQLException - 如果發生資料庫存取錯誤；如果在關閉的 PreparedStatement 上調用此方法；如果 parameterIndex 不對應 SQL 語句中的參數標記；如果指定長度小於 0 或者 inputstream 中的位元組數不比對指定長度。
SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法
從以下版本開始：
1.6

setBlob

void setBlob(int parameterIndex,
             InputStream inputStream)
             throws SQLException
將指定參數設置為 InputStream 物件。此方法不同於 setBinaryStream (int, InputStream) 方法，因為它通知驅動程序參數值應該以 BLOB 的形式發送到伺服器。使用 setBinaryStream 方法時，驅動程序必須做額外的工作來確定參數資料是以 LONGVARBINARY 還是 BLOB 的形式發送到伺服器

註： 請參考 JDBC 驅動程序文檔確定使用帶有長度參數的 setBlob 是否更有效。

參數：
parameterIndex - 第一個參數的索引是 1，第二個參數的索引是 2 ……
inputStream - 套件含用來設置參數值的資料的物件。
拋出：
SQLException - 如果發生資料庫存取錯誤，在關閉的 PreparedStatement 上調用此方法或者 parameterIndex 不對應 SQL 語句中的參數標記
SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法
從以下版本開始：
1.6

setBlob

void setBlob(String parameterName,
             InputStream inputStream,
             long length)
             throws SQLException
將指定參數設置為 InputStream 物件。inputstream 必須包含 length 所指定的字元數，否則，在執行 CallableStatement 時將會產生 SQLException。此方法不同於 setBinaryStream (int, InputStream, int) 方法，因為它通知驅動程序參數值應該以 BLOB 的形式發送到伺服器。使用 setBinaryStream 方法時，驅動程序必須做額外的工作來確定參數資料是以 LONGVARBINARY 還是 BLOB 的形式發送到伺服器。

參數：
parameterName - 要設置的參數名稱
inputStream - 套件含用來設置參數值的資料的物件。
length - 參數資料中的位元組數。
拋出：
SQLException - 如果 parameterIndex 不對應 SQL 語句中的參數標記，或者指定長度小於 0；如果 inputstream 中的位元組數不比對指定長度；如果發生資料庫存取錯誤或者在關閉的 CallableStatement 上調用此方法
SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法
從以下版本開始：
1.6

setBlob

void setBlob(String parameterName,
             Blob x)
             throws SQLException
將指定參數設置為給定的 java.sql.Blob 物件。在將此值發送到資料庫時，驅動程序將其轉換為 SQL BLOB 值。

參數：
parameterName - 參數的名稱
x - 映射 SQL BLOB 值的 Blob 物件
拋出：
SQLException - 如果發生資料庫存取錯誤或者在關閉的 CallableStatement 上調用此方法
SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法
從以下版本開始：
1.6

setBlob

void setBlob(String parameterName,
             InputStream inputStream)
             throws SQLException
將指定參數設置為 InputStream 物件。此方法不同於 setBinaryStream (int, InputStream) 方法，因為它通知驅動程序參數值應該以 BLOB 的形式發送到伺服器。使用 setBinaryStream 方法時，驅動程序必須做額外的工作來確定參數資料是以 LONGVARBINARY 還是 BLOB 的形式發送到伺服器。

註： 請參考 JDBC 驅動程序文檔確定使用帶有長度參數的 setBlob 是否更有效。

參數：
parameterName - 參數的名稱
inputStream - 套件含用來設置參數值的資料的物件。
拋出：
SQLException - 如果發生資料庫存取錯誤或者在關閉的 CallableStatement 上調用此方法
SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法
從以下版本開始：
1.6

setClob

void setClob(int i,
             Clob x)
             throws SQLException
使用給定 Clob 值設置此 RowSet 物件命令中的指定參數。在將此值發送到資料庫之前，驅動程序會將其轉換為 Clob 物件表示的 CLOB 值。

參數：
i - 第一個參數是 1，第二個參數是 2 ……
x - 表示 CLOB 的物件
拋出：
SQLException - 如果發生資料庫存取錯誤

setClob

void setClob(int parameterIndex,
             Reader reader,
             long length)
             throws SQLException
將指定參數設置為 Reader 物件。reader 必須包含 length 所指定的字元數，否則，在執行 PreparedStatement 時將會產生 SQLException。此方法不同於 setCharacterStream (int, Reader, int) 方法，因為它通知驅動程序參數值應該以 CLOB 的形式發送到伺服器。使用 setCharacterStream 方法時，驅動程序必須做額外的工作來確定參數資料是以 LONGVARCHAR 還是 CLOB 的形式發送到伺服器。

參數：
parameterIndex - 第一個參數的索引是 1，第二個參數的索引是 2 ……
reader - 套件含用來設置參數值的資料的物件。
length - 參數資料中的字元數。
拋出：
SQLException - 如果發生資料庫存取錯誤，或者在關閉的 PreparedStatement 上調用此方法；如果 parameterIndex 不對應 SQL 語句中的參數標記，或者指定長度小於 0。
SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法
從以下版本開始：
1.6

setClob

void setClob(int parameterIndex,
             Reader reader)
             throws SQLException
將指定參數設置為 Reader 物件。此方法不同於 setCharacterStream (int, Reader) 方法，因為它通知驅動程序該參數值應該以 CLOB 的形式發送到伺服器。使用 setCharacterStream 方法時，驅動程序必須做額外的工作來確定參數資料是以 LONGVARCHAR 還是 CLOB 的形式發送到伺服器。

註： 請參考 JDBC 驅動程序文檔確定使用帶有長度參數的 setClob 是否更有效。

參數：
parameterIndex - 第一個參數的索引是 1，第二個參數的索引是 2 ……
reader - 套件含用來設置參數值的資料的物件。
拋出：
SQLException - 如果發生資料庫存取錯誤，在關閉的 PreparedStatement 上調用此方法或者 parameterIndex 不對應 SQL 語句中的參數標記
SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法
從以下版本開始：
1.6

setClob

void setClob(String parameterName,
             Reader reader,
             long length)
             throws SQLException
將指定參數設置為 Reader 物件。reader 必須包含 length 所指定的字元數，否則，在執行 CallableStatement 時將會產生 SQLException。此方法不同於 setCharacterStream (int, Reader, int) 方法，因為它通知驅動程序該參數值應該以 CLOB 的形式發送到伺服器。使用 setCharacterStream 方法時，驅動程序必須做額外的工作來確定參數資料是以 LONGVARCHAR 還是 CLOB 的形式發送到伺服器。

參數：
parameterName - 要設置的參數的名稱
reader - 套件含用來設置參數值的資料的物件。
length - 參數資料中的字元數。
拋出：
SQLException - 如果 parameterIndex 不對應 SQL 語句中的參數標記；如果指定長度小於 0；如果發生資料庫存取錯誤或者在關閉的 CallableStatement 上調用此方法
SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法
從以下版本開始：
1.6

setClob

void setClob(String parameterName,
             Clob x)
             throws SQLException
將指定參數設置為給定的 java.sql.Clob 物件。將此值發送到資料庫時，驅動程序將其轉換為 SQL CLOB 值。

參數：
parameterName - 參數的名稱
x - 映射 SQL CLOB 值的 Clob 物件
拋出：
SQLException - 如果發生資料庫存取錯誤或者在關閉的 CallableStatement 上調用此方法
SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法
從以下版本開始：
1.6

setClob

void setClob(String parameterName,
             Reader reader)
             throws SQLException
將指定參數設置為 Reader 物件。此方法不同於 setCharacterStream (int, Reader) 方法，因為它通知驅動程序該參數值應該以 CLOB 的形式發送到伺服器。使用 setCharacterStream 方法時，驅動程序必須做額外的工作來確定參數資料是以 LONGVARCHAR 還是 CLOB 的形式發送到伺服器。

註： 請參考 JDBC 驅動程序文檔確定使用帶有長度參數的 setClob 是否更有效。

參數：
parameterName - 參數的名稱
reader - 套件含用來設置參數值的資料的物件。
拋出：
SQLException - 如果發生資料庫存取錯誤或者在關閉的 CallableStatement 上調用此方法
SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法
從以下版本開始：
1.6

setArray

void setArray(int i,
              Array x)
              throws SQLException
使用給定 Array 值設置此 RowSet 物件命令中的指定參數。在將此值發送到資料庫之前，驅動程序會將其轉換為 Array 物件表示的 ARRAY 值。

參數：
i - 第一個參數是 1，第二個參數是 2 ……
x - 表示 SQL 陣列的物件
拋出：
SQLException - 如果發生資料庫存取錯誤

setDate

void setDate(int parameterIndex,
             Date x,
             Calendar cal)
             throws SQLException
使用給定 java.sql.Date 值設置此 RowSet 物件命令中的指定參數。驅動程序將此值轉換為 SQL DATE 值，使用給定 java.util.Calendar 物件來計算日期。

參數：
parameterIndex - 第一個參數的索引是 1，第二個參數的索引是 2 ……
x - 參數值
cal - 用於計算日期的 java.util.Calendar 物件
拋出：
SQLException - 如果發生資料庫存取錯誤

setDate

void setDate(String parameterName,
             Date x)
             throws SQLException
使用運行應用程序的虛擬機器所在的預設時區將指定參數設置為給定的 java.sql.Date 值。在將此值發送到資料庫時，驅動程序將其轉換為 SQL DATE 值。

參數：
parameterName - 參數的名稱
x - 參數值
拋出：
SQLException - 如果發生資料庫存取錯誤或者在關閉的 CallableStatement 上調用此方法
SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法
從以下版本開始：
1.4
另請參見：
ResultSet.getDate(int)

setDate

void setDate(String parameterName,
             Date x,
             Calendar cal)
             throws SQLException
使用給定 Calendar 物件將指定參數設置為給定的 java.sql.Date 值。驅動程序使用 Calendar 物件建構一個 SQL DATE 值，該值隨後被驅動程序發送到資料庫。利用 Calendar 物件，驅動程序可以在考慮自定義時區的情況下計算日期。如果沒有指定任何 Calendar 物件，則驅動程序使用預設時區，該時區是運行應用程序的虛擬機器所在的時區。

參數：
parameterName - 參數的名稱
x - 參數值
cal - 驅動程序將用來建構日期的 Calendar 物件
拋出：
SQLException - 如果發生資料庫存取錯誤或者在關閉的 CallableStatement 上調用此方法
SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法
從以下版本開始：
1.4
另請參見：
ResultSet.getDate(int)

setTime

void setTime(int parameterIndex,
             Time x,
             Calendar cal)
             throws SQLException
使用給定 java.sql.Time 值設置此 RowSet 物件命令中的指定參數。在將此值發送到資料庫之前，驅動程序將其轉換為 SQL TIME 值，使用給定 java.util.Calendar 物件來計算該值。

參數：
parameterIndex - 第一個參數的索引是 1，第二個參數的索引是 2 ……
x - 參數值
cal - 用於計算時間的 java.util.Calendar 物件
拋出：
SQLException - 如果發生資料庫存取錯誤

setTime

void setTime(String parameterName,
             Time x)
             throws SQLException
將指定參數設置為給定的 java.sql.Time 值。在將此值發送到資料庫時，驅動程序將其轉換為 SQL TIME 值。

參數：
parameterName - 參數的名稱
x - 參數值
拋出：
SQLException - 如果發生資料庫存取錯誤或者在關閉的 CallableStatement 上調用此方法
SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法
從以下版本開始：
1.4
另請參見：
ResultSet.getTime(int)

setTime

void setTime(String parameterName,
             Time x,
             Calendar cal)
             throws SQLException
使用給定 Calendar 物件將指定參數設置為給定的 java.sql.Time 值。驅動程序使用 Calendar 物件建構一個 SQL TIME 值，該值隨後被驅動程序發送到資料庫。利用 Calendar 物件，驅動程序可以在考慮自定義時區的情況下計算時間。如果沒有指定任何 Calendar 物件，則驅動程序使用預設時區，該時區是運行應用程序的虛擬機器所在的時區。

參數：
parameterName - 參數的名稱
x - 參數值
cal - 驅動程序將用來建構時間的 Calendar 物件
拋出：
SQLException - 如果發生資料庫存取錯誤或者在關閉的 CallableStatement 上調用此方法
SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法
從以下版本開始：
1.4
另請參見：
ResultSet.getTime(int)

setTimestamp

void setTimestamp(int parameterIndex,
                  Timestamp x,
                  Calendar cal)
                  throws SQLException
使用給定 java.sql.Timestamp 值設置此 RowSet 物件命令中的指定參數。在將此值發送到資料庫之前，驅動程序將其轉換為 SQL TIMESTAMP 值，使用給定 java.util.Calendar 物件來計算該值。

參數：
parameterIndex - 第一個參數的索引是 1，第二個參數的索引是 2 ……
x - 參數值
cal - 用於計算時間戳的 java.util.Calendar 物件
拋出：
SQLException - 如果發生資料庫存取錯誤

setTimestamp

void setTimestamp(String parameterName,
                  Timestamp x,
                  Calendar cal)
                  throws SQLException
使用給定 Calendar 物件將指定參數設置為給定的 java.sql.Timestamp 值。驅動程序使用 Calendar 物件建構一個 SQL TIMESTAMP 值，該值隨後被驅動程序發送到資料庫。利用 Calendar 物件，驅動程序可以在考慮自定義時區的情況下計算時間戳。如果沒有指定任何 Calendar 物件，則驅動程序使用預設時區，該時區是運行應用程序的虛擬機器所在的時區。

參數：
parameterName - 參數的名稱
x - 參數值
cal - 驅動程序將用來建構時間戳的 Calendar 物件
拋出：
SQLException - 如果發生資料庫存取錯誤或者在關閉的 CallableStatement 上調用此方法
SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法
從以下版本開始：
1.4
另請參見：
ResultSet.getTimestamp(int)

clearParameters

void clearParameters()
                     throws SQLException
清除為此 RowSet 物件命令設置的參數。

通常參數值對 RowSet 物件的重複使用仍然有效。設置一個參數值會自動清除其以前的值。不過，在某些情況下，直接釋放當前參數值使用的資源也是很有用的；這可以通過調用 clearParameters 方法來實作。

拋出：
SQLException - 如果發生資料庫存取錯誤

execute

void execute()
             throws SQLException
使用資料填充此 RowSet 物件。

execute 方法可以使用以下屬性來創建用於讀取資料的連接：url、資料源名稱、使用者名、密碼、事務隔離和型別映射表。 execute 方法可以使用以下屬性來創建執行命令的語句：命令、只讀、最大欄位大小、最大行數、轉義處理和查詢逾時值。

如果沒有設置必需的參數，則拋出異常。如果此方法執行成功，則丟棄 rowset 的當前內容，同時設置（或重置）rowset 的元資料。如果存在未執行的更新，則忽略它們。

如果此 RowSet 物件不維持與其資料源的連續連接，則它可以使用 reader（RowSetReader 物件）來填充資料。在此情況下，reader 應該已經在此 RowSet 物件中註冊，並且 execute 方法將作為其實作的一部分調用 reader 的 readData 方法。

拋出：
SQLException - 如果發生資料庫存取錯誤，或者沒有設置建立連接和創建語句所需的任何屬性

addRowSetListener

void addRowSetListener(RowSetListener listener)
註冊給定偵聽器，以便此 RowSet 物件上發生事件時將得到通知。

參數：
listener - 一個元件，它實作了 RowSetListener 介面並希望在此 RowSet 物件上發生事件時得到通知
另請參見：
removeRowSetListener(javax.sql.RowSetListener)

removeRowSetListener

void removeRowSetListener(RowSetListener listener)
從在此 RowSet 物件上發生事件時得到通知的元件所組成的列表中移除指定的偵聽器。

參數：
listener - 一個元件，它已註冊為此 RowSet 物件的偵聽器
另請參見：
addRowSetListener(javax.sql.RowSetListener)

setSQLXML

void setSQLXML(int parameterIndex,
               SQLXML xmlObject)
               throws SQLException
將指定參數設置為給定 java.sql.SQLXML 物件。在將此值發送到資料庫時，驅動程序將其轉換為 SQL XML 值。

參數：
parameterIndex - 第一個參數的索引是 1，第二個參數的索引是 2 ……
xmlObject - 映射 SQL XML 值的 SQLXML 物件
拋出：
SQLException - 如果發生資料庫存取錯誤，在關閉的結果集上調用此方法，沒有為 SQLXML 物件關閉 java.xml.transform.Result、Writer 或 OutputStream，或者在處理 XML 值時發生錯誤。異常的 getCause 方法可以提供更詳細的異常，例如，如果該串流不包含有效的 XML。
從以下版本開始：
1.6

setSQLXML

void setSQLXML(String parameterName,
               SQLXML xmlObject)
               throws SQLException
將指定參數設置為給定的 java.sql.SQLXML 物件。在將此值發送到資料庫時，驅動程序將其轉換為 SQL XML 值。

參數：
parameterName - 參數的名稱
xmlObject - 映射 SQL XML 值的 SQLXML 物件
拋出：
SQLException - 如果發生資料庫存取錯誤，在關閉的結果集上調用此方法，沒有為 SQLXML 物件關閉 java.xml.transform.Result、Writer 或 OutputStream，或者在處理 XML 值時發生錯誤。異常的 getCause 方法可以提供更詳細的異常，例如，如果該串流不包含有效的 XML。
從以下版本開始：
1.6

setRowId

void setRowId(int parameterIndex,
              RowId x)
              throws SQLException
將指定參數設置為給定的 java.sql.RowId 物件。在將此值發送到資料庫時，驅動程序將其轉換為 SQL ROWID 值。

參數：
parameterIndex - 第一個參數的索引是 1，第二個參數的索引是 2 ……
x - 參數值
拋出：
SQLException - 如果發生資料庫存取錯誤
從以下版本開始：
1.6

setRowId

void setRowId(String parameterName,
              RowId x)
              throws SQLException
將指定參數設置為給定的 java.sql.RowId 物件。在將此值發送到資料庫時，驅動程序將其轉換為 SQL ROWID。

參數：
parameterName - 參數的名稱
x - 參數值
拋出：
SQLException - 如果發生資料庫存取錯誤
從以下版本開始：
1.6

setNString

void setNString(int parameterIndex,
                String value)
                throws SQLException
將指定參數設置為給定的 String 物件。在將此值發送到資料庫時，驅動程序將其轉換為 SQL NCHAR、NVARCHAR 或 LONGNVARCHAR 值（具體取決於該參數相對於驅動程序在 NVARCHAR 值上的限制的大小）。

參數：
parameterIndex - 第一個參數的索引是 1，第二個參數的索引是 2 ……
value - 參數值
拋出：
SQLException - 如果驅動程序不支持國家字元集；如果驅動程序檢測到可能發生資料轉換錯誤；或者發生資料庫存取錯誤
從以下版本開始：
1.6

setNString

void setNString(String parameterName,
                String value)
                throws SQLException
將指定參數設置為給定的 String 物件。驅動程序將此值轉換為 SQL NCHAR、NVARCHAR 或 LONGNVARCHAR

參數：
parameterName - 要設置的列的名稱
value - 參數值
拋出：
SQLException - 如果驅動程序不支持國家字元集；如果驅動程序檢測到可能發生資料轉換錯誤；或者發生資料庫存取錯誤
從以下版本開始：
1.6

setNCharacterStream

void setNCharacterStream(int parameterIndex,
                         Reader value,
                         long length)
                         throws SQLException
將指定參數設置為 Reader 物件。Reader 讀取資料，一直讀取到檔案末尾。驅動程序將執行從 Java 字元格式到資料庫中國家字元集的必要轉換。

參數：
parameterIndex - 第一個參數的索引是 1，第二個參數的索引是 2 ……
value - 參數值
length - 參數資料中的字元數。
拋出：
SQLException - 如果驅動程序不支持國家字元集；如果驅動程序檢測到可能發生資料轉換錯誤；或者發生資料庫存取錯誤
從以下版本開始：
1.6

setNCharacterStream

void setNCharacterStream(String parameterName,
                         Reader value,
                         long length)
                         throws SQLException
將指定參數設置為 Reader 物件。Reader 讀取資料，一直讀取到檔案末尾。驅動程序將執行從 Java 字元格式到資料庫中國家字元集的必要轉換。

參數：
parameterName - 要設置的列的名稱
value - 參數值
length - 參數資料中的字元數。
拋出：
SQLException - 如果驅動程序不支持國家字元集；如果驅動程序檢測到可能發生資料轉換錯誤；或者發生資料庫存取錯誤
從以下版本開始：
1.6

setNCharacterStream

void setNCharacterStream(String parameterName,
                         Reader value)
                         throws SQLException
將指定參數設置為 Reader 物件。Reader 讀取資料，一直讀取到檔案末尾。驅動程序將執行從 Java 字元格式到資料庫中國家字元集的必要轉換。

註： 此串流物件既可以是一個標準 Java 串流物件，也可以是實作標準介面的使用者自己的子類別。

註： 請參考 JDBC 驅動程序文檔確定使用帶有長度參數的 setNCharacterStream 是否更有效。

參數：
parameterName - 參數的名稱
value - 參數值
拋出：
SQLException - 如果驅動程序不支持國家字元集；如果驅動程序檢測到可能發生資料轉換錯誤；如果發生資料庫存取錯誤；或者在關閉的 CallableStatement 上調用此方法
SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法
從以下版本開始：
1.6

setNClob

void setNClob(String parameterName,
              NClob value)
              throws SQLException
將指定參數設置為 java.sql.NClob 物件。該物件實作 java.sql.NClob 介面。此 NClob 物件映射到 SQL NCLOB。

參數：
parameterName - 要設置的列的名稱
value - 參數值
拋出：
SQLException - 如果驅動程序不支持國家字元集；如果驅動程序檢測到可能發生資料轉換錯誤；或者發生資料庫存取錯誤
從以下版本開始：
1.6

setNClob

void setNClob(String parameterName,
              Reader reader,
              long length)
              throws SQLException
將指定參數設置為 Reader 物件。reader 必須包含 length 所指定的字元數，否則，在執行 CallableStatement 時將會產生 SQLException。此方法不同於 setCharacterStream (int, Reader, int) 方法，因為它通知驅動程序該參數值應該以 NCLOB 的形式發送到伺服器。使用 setCharacterStream 方法時，驅動程序必須做額外的工作來確定參數資料是以 LONGNVARCHAR 還是 NCLOB 的形式發送到伺服器。

參數：
parameterName - 要設置的參數的名稱
reader - 套件含用來設置參數值的資料的物件。
length - 參數資料中的字元數。
拋出：
SQLException - 如果 parameterIndex 不對應 SQL 語句中的參數標記；如果指定長度小於 0；如果驅動程序不支持國家字元集；如果驅動程序檢測到可能發生資料轉換錯誤；如果發生資料庫存取錯誤或者在關閉的 CallableStatement 上調用此方法
SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法
從以下版本開始：
1.6

setNClob

void setNClob(String parameterName,
              Reader reader)
              throws SQLException
將指定參數設置為 Reader 物件。此方法不同於 setCharacterStream (int, Reader) 方法，因為它通知驅動程序該參數值應該以 NCLOB 的形式發送到伺服器。使用 setCharacterStream 方法時，驅動程序必須做額外的工作來確定參數資料是以 LONGNVARCHAR 還是 NCLOB 的形式發送到伺服器。

註： 請參考 JDBC 驅動程序文檔確定使用帶有長度參數的 setNClob 是否更有效。

參數：
parameterName - 參數的名稱
reader - 套件含用來設置參數值的資料的物件。
拋出：
SQLException - 如果驅動程序不支持國家字元集；如果驅動程序檢測到可能發生資料轉換錯誤；如果發生資料庫存取錯誤或者在關閉的 CallableStatement 上調用此方法
SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法
從以下版本開始：
1.6

setNClob

void setNClob(int parameterIndex,
              Reader reader,
              long length)
              throws SQLException
將指定參數設置為 Reader 物件。reader 必須包含 length 所指定的字元數，否則，在執行 PreparedStatement 時將會產生 SQLException。此方法不同於 setCharacterStream (int, Reader, int) 方法，因為它通知驅動程序該參數值應該以 NCLOB 的形式發送到伺服器。使用 setCharacterStream 方法時，驅動程序必須做額外的工作來確定參數資料是以 LONGNVARCHAR 還是 NCLOB 的形式發送到伺服器。

參數：
parameterIndex - 第一個參數的索引是 1，第二個參數的索引是 2 ……
reader - 套件含用來設置參數值的資料的物件。
length - 參數資料中的字元數。
拋出：
SQLException - 如果 parameterIndex 不對應 SQL 語句中的參數標記；如果指定長度小於 0；如果驅動程序不支持國家字元集；如果驅動程序檢測到可能發生資料轉換錯誤；如果發生資料庫存取錯誤或者在關閉的 PreparedStatement 上調用此方法
SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法
從以下版本開始：
1.6

setNClob

void setNClob(int parameterIndex,
              NClob value)
              throws SQLException
將指定參數設置為 java.sql.NClob 物件。在將此值發送到資料庫時，驅動程序將其轉換為 SQL NCLOB 值。

參數：
parameterIndex - 第一個參數的索引是 1，第二個參數的索引是 2 ……
value - 參數值
拋出：
SQLException - 如果驅動程序不支持國家字元集；如果驅動程序檢測到可能發生資料轉換錯誤；如果發生資料庫存取錯誤
從以下版本開始：
1.6

setNClob

void setNClob(int parameterIndex,
              Reader reader)
              throws SQLException
將指定參數設置為 Reader 物件。此方法不同於 setCharacterStream (int, Reader) 方法，因為它通知驅動程序該參數值應該以 NCLOB 的形式發送到伺服器。使用 setCharacterStream 方法時，驅動程序必須做額外的工作來確定參數資料是以 LONGNVARCHAR 還是 NCLOB 的形式發送到伺服器。

註： 請參考 JDBC 驅動程序文檔確定使用帶有長度參數的 setNClob 是否更有效。

參數：
parameterIndex - 第一個參數的索引是 1，第二個參數的索引是 2 ……
reader - 套件含用來設置參數值的資料的物件。
拋出：
SQLException - 如果 parameterIndex 不對應 SQL 語句中的參數標記；如果驅動程序不支持國家字元集；如果驅動程序檢測到可能發生資料轉換錯誤；如果發生資料庫存取錯誤或者在關閉的 PreparedStatement 上調用此方法
SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法
從以下版本開始：
1.6

setURL

void setURL(int parameterIndex,
            URL x)
            throws SQLException
將指定參數設置為給定的 java.net.URL 值。在將此值發送到資料庫時，驅動程序將其轉換為 SQL DATALINK 值。

參數：
parameterIndex - 第一個參數的索引是 1，第二個參數的索引是 2 ……
x - 要設置的 java.net.URL 物件
拋出：
SQLException - 如果發生資料庫存取錯誤或者在關閉的 PreparedStatement 上調用此方法
SQLFeatureNotSupportedException - 如果 JDBC 驅動程序不支持此方法
從以下版本開始：
1.4
概觀  軟體套件   類別  使用  階層樹  已過時  索引  說明 
JavaTM 2 Platform
Standard Ed. 6
 上一個類別   下一個類別 框架    無框架    
摘要： 巢狀 | 欄位 | 建構子 | 方法 詳細資訊： 欄位 | 建構子 | 方法
提交錯誤或意見

版權所有 2008 Sun Microsystems, Inc. 保留所有權利。請遵守GNU General Public License, version 2 only。