鴻蒙OS RowSet

RowSet

public interface RowSet
extends ResultSet

添加對 JavaBeans? 組件模型的 JDBC API 支持的接口。 可以在可視化 Bean 開發(fā)環(huán)境中用作 JavaBeans 組件的行集可以在設(shè)計時創(chuàng)建和配置，并在運行時執(zhí)行。

RowSet 接口提供一組 JavaBeans 屬性，允許將 RowSet 實例配置為連接到 JDBC 數(shù)據(jù)源并從數(shù)據(jù)源讀取一些數(shù)據(jù)。 一組 setter 方法（setInt、setBytes、setString 等）提供了一種將輸入?yún)?shù)傳遞給行集的命令屬性的方法。 此命令是行集從關(guān)系數(shù)據(jù)庫獲取數(shù)據(jù)時使用的 SQL 查詢，通常是這種情況。

RowSet 接口支持 JavaBeans 事件，允許在行集上發(fā)生事件時通知應(yīng)用程序中的其他組件，例如其值的更改。

RowSet 接口的獨特之處在于它旨在使用 JDBC API 的其余部分來實現(xiàn)。 換句話說，RowSet 實現(xiàn)是在 JDBC 驅(qū)動程序“頂部”執(zhí)行的軟件層。 任何人都可以提供 RowSet 接口的實現(xiàn)，包括希望將 RowSet 實現(xiàn)作為其 JDBC 產(chǎn)品的一部分提供的 JDBC 驅(qū)動程序供應(yīng)商。

RowSet 對象可以與數(shù)據(jù)源建立連接并在其整個生命周期中維護該連接，在這種情況下，它稱為連接行集。行集還可以與數(shù)據(jù)源建立連接，從中獲取數(shù)據(jù)，然后關(guān)閉連接。這樣的行集稱為斷開連接的行集。斷開連接的行集可以在斷開連接時對其數(shù)據(jù)進行更改，然后將更改發(fā)送回數(shù)據(jù)的原始源，但它必須重新建立連接才能這樣做。

斷開連接的行集可能具有與之關(guān)聯(lián)的讀取器（RowSetReader 對象）和寫入器（RowSetWriter 對象）。讀取器可以以許多不同的方式實現(xiàn)，以使用數(shù)據(jù)填充行集，包括從非關(guān)系數(shù)據(jù)源獲取數(shù)據(jù)。編寫器還可以以多種不同方式實現(xiàn)，以將對行集數(shù)據(jù)所做的更改傳播回底層數(shù)據(jù)源。

行集易于使用。 RowSet 接口擴展了標(biāo)準(zhǔn)的 java.sql.ResultSet 接口。 RowSetMetaData 接口擴展了 java.sql.ResultSetMetaData 接口。因此，熟悉 JDBC API 的開發(fā)人員必須學(xué)習(xí)最少數(shù)量的新 API 才能使用行集。此外，與 JDBC ResultSet 對象一起使用的第三方軟件工具也可以很容易地與行集一起使用。

Since:

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

方法總結(jié)

修飾符和類型	方法	描述
void	addRowSetListener(RowSetListener listener)	注冊給定的偵聽器，以便將在此 RowSet 對象上發(fā)生的事件通知它。
void	clearParameters()	清除為此 RowSet 對象的命令設(shè)置的參數(shù)。
void	execute()	用數(shù)據(jù)填充此 RowSet 對象。
String	getCommand()	檢索此 RowSet 對象的命令屬性。
String	getDataSourceName()	檢索標(biāo)識此 RowSet 對象的數(shù)據(jù)源的邏輯名稱。
boolean	getEscapeProcessing()	檢索是否為此 RowSet 對象啟用了轉(zhuǎn)義處理。
int	getMaxFieldSize()	檢索可以為某些列值返回的最大字節(jié)數(shù)。
int	getMaxRows()	檢索此 RowSet 對象可以包含的最大行數(shù)。
String	getPassword()	檢索用于創(chuàng)建數(shù)據(jù)庫連接的密碼。
int	getQueryTimeout()	檢索驅(qū)動程序等待語句執(zhí)行的最大秒數(shù)。
int	getTransactionIsolation()	檢索為此 RowSet 對象設(shè)置的事務(wù)隔離級別。
MapString,Class<?>	getTypeMap()	檢索與此 RowSet 對象關(guān)聯(lián)的 Map 對象，該對象指定 SQL 用戶定義類型的自定義映射（如果有）。
String	getUrl()	如果此 RowSet 對象使用 DriverManager 而不是 DataSource 對象來建立連接，則檢索此 RowSet 對象將用于創(chuàng)建連接的 url 屬性。
String	getUsername()	檢索用于為此 RowSet 對象創(chuàng)建數(shù)據(jù)庫連接的用戶名。
boolean	isReadOnly()	檢索此 RowSet 對象是否為只讀。
void	removeRowSetListener(RowSetListener listener)	當(dāng)此 RowSet 對象上發(fā)生事件時，從將通知的組件列表中刪除指定的偵聽器。
void	setArray(int i, Array x)	使用給定的 Array 值設(shè)置此 RowSet 對象命令中的指定參數(shù)。
void	setAsciiStream(int parameterIndex, InputStream x)	將此 RowSet 對象的命令中的指定參數(shù)設(shè)置為給定的輸入流。
void	setAsciiStream(int parameterIndex, InputStream x, int length)	將此 RowSet 對象的命令中的指定參數(shù)設(shè)置為給定的 java.io.InputStream 值。
void	setAsciiStream(String parameterName, InputStream x)	將指定參數(shù)設(shè)置為給定的輸入流。
void	setAsciiStream(String parameterName, InputStream x, int length)	將指定參數(shù)設(shè)置為給定的輸入流，該輸入流將具有指定的字節(jié)數(shù)。
void	setBigDecimal(int parameterIndex, BigDecimal x)	將此 RowSet 對象命令中的指定參數(shù)設(shè)置為給定的 java.math.BigDecimal 值。
void	setBigDecimal(String parameterName, BigDecimal x)	將指定參數(shù)設(shè)置為給定的 java.math.BigDecimal 值。
void	setBinaryStream(int parameterIndex, InputStream x)	將此 RowSet 對象的命令中的指定參數(shù)設(shè)置為給定的輸入流。
void	setBinaryStream(int parameterIndex, InputStream x, int length)	將此 RowSet 對象的命令中的指定參數(shù)設(shè)置為給定的 java.io.InputStream 值。
void	setBinaryStream(String parameterName, InputStream x)	將指定參數(shù)設(shè)置為給定的輸入流。
void	setBinaryStream(String parameterName, InputStream x, int length)	將指定參數(shù)設(shè)置為給定的輸入流，該輸入流將具有指定的字節(jié)數(shù)。
void	setBlob(int parameterIndex, InputStream inputStream)	將指定參數(shù)設(shè)置為 InputStream 對象。
void	setBlob(int parameterIndex, InputStream inputStream, long length)	將指定參數(shù)設(shè)置為 InputStream 對象。
void	setBlob(int i, Blob x)	使用給定的 Blob 值設(shè)置此 RowSet 對象命令中的指定參數(shù)。
void	setBlob(String parameterName, InputStream inputStream)	將指定參數(shù)設(shè)置為 InputStream 對象。
void	setBlob(String parameterName, InputStream inputStream, long length)	將指定參數(shù)設(shè)置為 InputStream 對象。
void	setBlob(String parameterName, Blob x)	將指定參數(shù)設(shè)置為給定的 java.sql.Blob 對象。
void	setBoolean(int parameterIndex, boolean x)	將此 RowSet 對象的命令中的指定參數(shù)設(shè)置為給定的 Java 布爾值。
void	setBoolean(String parameterName, boolean x)	將指定參數(shù)設(shè)置為給定的 Java 布爾值。
void	setByte(int parameterIndex, byte x)	將此 RowSet 對象的命令中的指定參數(shù)設(shè)置為給定的 Java 字節(jié)值。
void	setByte(String parameterName, byte x)	將指定參數(shù)設(shè)置為給定的 Java 字節(jié)值。
void	setBytes(int parameterIndex, byte[] x)	將此 RowSet 對象的命令中的指定參數(shù)設(shè)置為給定的 Java 字節(jié)值數(shù)組。
void	setBytes(String parameterName, byte[] x)	將指定參數(shù)設(shè)置為給定的 Java 字節(jié)數(shù)組。
void	setCharacterStream(int parameterIndex, Reader reader)	將此 RowSet 對象的命令中的指定參數(shù)設(shè)置為給定的 Reader 對象。
void	setCharacterStream(int parameterIndex, Reader reader, int length)	將此 RowSet 對象的命令中的指定參數(shù)設(shè)置為給定的 java.io.Reader 值。
void	setCharacterStream(String parameterName, Reader reader)	將指定參數(shù)設(shè)置為給定的 Reader 對象。
void	setCharacterStream(String parameterName, Reader reader, int length)	將指定參數(shù)設(shè)置為給定的 Reader 對象，它是給定的字符數(shù)。
void	setClob(int parameterIndex, Reader reader)	將指定參數(shù)設(shè)置為 Reader 對象。
void	setClob(int parameterIndex, Reader reader, long length)	將指定參數(shù)設(shè)置為 Reader 對象。
void	setClob(int i, Clob x)	使用給定的 Clob 值設(shè)置此 RowSet 對象命令中的指定參數(shù)。
void	setClob(String parameterName, Reader reader)	將指定參數(shù)設(shè)置為 Reader 對象。
void	setClob(String parameterName, Reader reader, long length)	將指定參數(shù)設(shè)置為 Reader 對象。
void	setClob(String parameterName, Clob x)	將指定參數(shù)設(shè)置為給定的 java.sql.Clob 對象。
void	setCommand(String cmd)	將此 RowSet 對象的命令屬性設(shè)置為給定的 SQL 查詢。
void	setConcurrency(int concurrency)	將此 RowSet 對象的并發(fā)設(shè)置為給定的并發(fā)級別。
void	setDataSourceName(String name)	將此 RowSet 對象的數(shù)據(jù)源名稱屬性設(shè)置為給定的字符串。
void	setDate(int parameterIndex, Date x)	將此 RowSet 對象的命令中的指定參數(shù)設(shè)置為給定的 java.sql.Date 值。
void	setDate(int parameterIndex, Date x, Calendar cal)	使用給定的 java.sql.Date 值設(shè)置此 RowSet 對象命令中的指定參數(shù)。
void	setDate(String parameterName, Date x)	使用運行應(yīng)用程序的虛擬機的默認時區(qū)將指定參數(shù)設(shè)置為給定的 java.sql.Date 值。
void	setDate(String parameterName, Date x, Calendar cal)	使用給定的 Calendar 對象將指定參數(shù)設(shè)置為給定的 java.sql.Date 值。
void	setDouble(int parameterIndex, double x)	將此 RowSet 對象的命令中的指定參數(shù)設(shè)置為給定的 Java 雙精度值。
void	setDouble(String parameterName, double x)	將指定參數(shù)設(shè)置為給定的 Java 雙精度值。
void	setEscapeProcessing(boolean enable)	將此 RowSet 對象的轉(zhuǎn)義處理設(shè)置為打開或關(guān)閉。
void	setFloat(int parameterIndex, float x)	將此 RowSet 對象的命令中的指定參數(shù)設(shè)置為給定的 Java 浮點值。
void	setFloat(String parameterName, float x)	將指定參數(shù)設(shè)置為給定的 Java 浮點值。
void	setInt(int parameterIndex, int x)	將此 RowSet 對象的命令中的指定參數(shù)設(shè)置為給定的 Java int 值。
void	setInt(String parameterName, int x)	將指定參數(shù)設(shè)置為給定的 Java int 值。
void	setLong(int parameterIndex, long x)	將此 RowSet 對象的命令中的指定參數(shù)設(shè)置為給定的 Java long 值。
void	setLong(String parameterName, long x)	將指定參數(shù)設(shè)置為給定的 Java long 值。
void	setMaxFieldSize(int max)	將可以為列值返回的最大字節(jié)數(shù)設(shè)置為給定的字節(jié)數(shù)。
void	setMaxRows(int max)	將此 RowSet 對象可以包含的最大行數(shù)設(shè)置為指定的數(shù)目。
void	setNCharacterStream(int parameterIndex, Reader value)	將此 RowSet 對象的命令中的指定參數(shù)設(shè)置為 Reader 對象。
void	setNCharacterStream(int parameterIndex, Reader value, long length)	將指定參數(shù)設(shè)置為 Reader 對象。
void	setNCharacterStream(String parameterName, Reader value)	將指定參數(shù)設(shè)置為 Reader 對象。
void	setNCharacterStream(String parameterName, Reader value, long length)	將指定參數(shù)設(shè)置為 Reader 對象。
void	setNClob(int parameterIndex, Reader reader)	將指定參數(shù)設(shè)置為 Reader 對象。
void	setNClob(int parameterIndex, Reader reader, long length)	將指定參數(shù)設(shè)置為 Reader 對象。
void	setNClob(int parameterIndex, NClob value)	將指定參數(shù)設(shè)置為 java.sql.NClob 對象。
void	setNClob(String parameterName, Reader reader)	將指定參數(shù)設(shè)置為 Reader 對象。
void	setNClob(String parameterName, Reader reader, long length)	將指定參數(shù)設(shè)置為 Reader 對象。
void	setNClob(String parameterName, NClob value)	將指定參數(shù)設(shè)置為 java.sql.NClob 對象。
void	setNString(int parameterIndex, String value)	將指定參數(shù)設(shè)置為給定的 String 對象。
void	setNString(String parameterName, String value)	將指定參數(shù)設(shè)置為給定的 String 對象。
void	setNull(int parameterIndex, int sqlType)	將此 RowSet 對象的 SQL 命令中的指定參數(shù)設(shè)置為 SQL NULL。
void	setNull(int paramIndex, int sqlType, String typeName)	將此 RowSet 對象的 SQL 命令中的指定參數(shù)設(shè)置為 SQL NULL。
void	setNull(String parameterName, int sqlType)	將指定參數(shù)設(shè)置為 SQL NULL。
void	setNull(String parameterName, int sqlType, String typeName)	將指定參數(shù)設(shè)置為 SQL NULL。
void	setObject(int parameterIndex, Object x)	使用 Java 對象設(shè)置此 RowSet 對象命令中的指定參數(shù)。
void	setObject(int parameterIndex, Object x, int targetSqlType)	使用 Java 對象設(shè)置此 RowSet 對象命令中的指定參數(shù)。
void	setObject(int parameterIndex, Object x, int targetSqlType, int scaleOrLength)	使用給定的 Java 對象設(shè)置此 RowSet 對象的命令中的指定參數(shù)。
void	setObject(String parameterName, Object x)	使用給定對象設(shè)置指定參數(shù)的值。
void	setObject(String parameterName, Object x, int targetSqlType)	使用給定對象設(shè)置指定參數(shù)的值。
void	setObject(String parameterName, Object x, int targetSqlType, int scale)	使用給定對象設(shè)置指定參數(shù)的值。
void	setPassword(String password)	將此 RowSet 對象的數(shù)據(jù)庫密碼設(shè)置為給定的字符串。
void	setQueryTimeout(int seconds)	將驅(qū)動程序等待語句執(zhí)行的最長時間設(shè)置為給定的秒數(shù)。
void	setReadOnly(boolean value)	將此 RowSet 對象設(shè)置為給定布爾值是否為只讀。
void	setRef(int i, Ref x)	使用給定的 Ref 值設(shè)置此 RowSet 對象命令中的指定參數(shù)。
void	setRowId(int parameterIndex, RowId x)	將指定參數(shù)設(shè)置為給定的 java.sql.RowId 對象。
void	setRowId(String parameterName, RowId x)	將指定參數(shù)設(shè)置為給定的 java.sql.RowId 對象。
void	setShort(int parameterIndex, short x)	將此 RowSet 對象的命令中的指定參數(shù)設(shè)置為給定的 Java 短值。
void	setShort(String parameterName, short x)	將指定參數(shù)設(shè)置為給定的 Java 短值。
void	setSQLXML(int parameterIndex, SQLXML xmlObject)	將指定參數(shù)設(shè)置為給定的 java.sql.SQLXML 對象。
void	setSQLXML(String parameterName, SQLXML xmlObject)	將指定參數(shù)設(shè)置為給定的 java.sql.SQLXML 對象。
void	setString(int parameterIndex, String x)	將此 RowSet 對象的命令中的指定參數(shù)設(shè)置為給定的 Java 字符串值。
void	setString(String parameterName, String x)	將指定參數(shù)設(shè)置為給定的 Java 字符串值。
void	setTime(int parameterIndex, Time x)	將此 RowSet 對象的命令中的指定參數(shù)設(shè)置為給定的 java.sql.Time 值。
void	setTime(int parameterIndex, Time x, Calendar cal)	使用給定的 java.sql.Time 值設(shè)置此 RowSet 對象命令中的指定參數(shù)。
void	setTime(String parameterName, Time x)	將指定參數(shù)設(shè)置為給定的 java.sql.Time 值。
void	setTime(String parameterName, Time x, Calendar cal)	使用給定的 Calendar 對象將指定參數(shù)設(shè)置為給定的 java.sql.Time 值。
void	setTimestamp(int parameterIndex, Timestamp x)	將此 RowSet 對象的命令中的指定參數(shù)設(shè)置為給定的 java.sql.Timestamp 值。
void	setTimestamp(int parameterIndex, Timestamp x, Calendar cal)	使用給定的 java.sql.Timestamp 值設(shè)置此 RowSet 對象命令中的指定參數(shù)。
void	setTimestamp(String parameterName, Timestamp x)	將指定參數(shù)設(shè)置為給定的 java.sql.Timestamp 值。
void	setTimestamp(String parameterName, Timestamp x, Calendar cal)	使用給定的 Calendar 對象將指定參數(shù)設(shè)置為給定的 java.sql.Timestamp 值。
void	setTransactionIsolation(int level)	設(shè)置此 RowSet 對象的事務(wù)隔離級別。
void	setType(int type)	將此 RowSet 對象的類型設(shè)置為給定類型。
void	setTypeMap(MapString,Class<?> map)	將給定的 java.util.Map 對象安裝為此 RowSet 對象的默認類型映射。
void	setUrl(String url)	設(shè)置此 RowSet 對象在使用 DriverManager 創(chuàng)建連接時將使用的 URL。
void	setURL(int parameterIndex, URL x)	將指定參數(shù)設(shè)置為給定的 java.net.URL 值。
void	setUsername(String name)	將此 RowSet 對象的用戶名屬性設(shè)置為給定的字符串。

從接口 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 對象來建立連接，則檢索此 RowSet 對象將用于創(chuàng)建連接的 url 屬性。 默認值為空。

返回:

一個字符串網(wǎng)址

Throws:

Throw名稱	Throw描述
SQLException	如果發(fā)生數(shù)據(jù)庫訪問錯誤

setUrl

void setUrl(String url) throws SQLException

設(shè)置此 RowSet 對象在使用 DriverManager 創(chuàng)建連接時將使用的 URL。 設(shè)置此屬性是可選的。 如果使用 URL，則必須在使用行集連接到數(shù)據(jù)庫之前加載接受 URL 的 JDBC 驅(qū)動程序。 讀取或?qū)懭霐?shù)據(jù)時，行集將在內(nèi)部使用 URL 來創(chuàng)建數(shù)據(jù)庫連接。 URL 或數(shù)據(jù)源名稱用于創(chuàng)建連接，以最近設(shè)置為非空值為準(zhǔn)。

參數(shù)：

參數(shù)名稱	參數(shù)描述
url	一個字符串值； 可能為空

Throws:

Throw名稱	Throw描述
SQLException	如果發(fā)生數(shù)據(jù)庫訪問錯誤

getDataSourceName

String getDataSourceName()

檢索標(biāo)識此 RowSet 對象的數(shù)據(jù)源的邏輯名稱。

返回:

數(shù)據(jù)源名稱

setDataSourceName

void setDataSourceName(String name) throws SQLException

將此 RowSet 對象的數(shù)據(jù)源名稱屬性設(shè)置為給定的字符串。

數(shù)據(jù)源名稱屬性的值可用于查找已向命名服務(wù)注冊的 DataSource 對象。 檢索后，DataSource 對象可用于創(chuàng)建與它所代表的數(shù)據(jù)源的連接。

參數(shù)：

參數(shù)名稱	參數(shù)描述
name	此 RowSet 對象的數(shù)據(jù)源的邏輯名稱； 可能為空

Throws:

Throw名稱	Throw描述
SQLException	如果發(fā)生數(shù)據(jù)庫訪問錯誤

getUsername

String getUsername()

檢索用于為此 RowSet 對象創(chuàng)建數(shù)據(jù)庫連接的用戶名。 username 屬性在調(diào)用方法執(zhí)行之前在運行時設(shè)置。 它通常不是 RowSet 對象的序列化狀態(tài)的一部分。

返回:

用戶名屬性

setUsername

void setUsername(String name) throws SQLException

將此 RowSet 對象的用戶名屬性設(shè)置為給定的字符串。

參數(shù)：

參數(shù)名稱	參數(shù)描述
name	用戶名

Throws:

Throw名稱	Throw描述
SQLException	如果發(fā)生數(shù)據(jù)庫訪問錯誤

getPassword

String getPassword()

檢索用于創(chuàng)建數(shù)據(jù)庫連接的密碼。 在調(diào)用方法執(zhí)行之前，在運行時設(shè)置密碼屬性。 它通常不是 RowSet 對象的序列化狀態(tài)的一部分。

返回:

建立數(shù)據(jù)庫連接的密碼

setPassword

void setPassword(String password) throws SQLException

將此 RowSet 對象的數(shù)據(jù)庫密碼設(shè)置為給定的字符串。

參數(shù)：

參數(shù)名稱	參數(shù)描述
password	密碼字符串

Throws:

Throw名稱	Throw描述
SQLException	如果發(fā)生數(shù)據(jù)庫訪問錯誤

getTransactionIsolation

int getTransactionIsolation()

檢索為此 RowSet 對象設(shè)置的事務(wù)隔離級別。

返回:

事務(wù)隔離級別； Connection.TRANSACTION_READ_UNCOMMITTED、Connection.TRANSACTION_READ_COMMITTED、Connection.TRANSACTION_REPEATABLE_READ 或 Connection.TRANSACTION_SERIALIZABLE 之一

setTransactionIsolation

void setTransactionIsolation(int level) throws SQLException

設(shè)置此 RowSet 對象的事務(wù)隔離級別。

參數(shù)：

參數(shù)名稱	參數(shù)描述
level	事務(wù)隔離級別； Connection.TRANSACTION_READ_UNCOMMITTED、Connection.TRANSACTION_READ_COMMITTED、Connection.TRANSACTION_REPEATABLE_READ 或 Connection.TRANSACTION_SERIALIZABLE 之一

Throws:

Throw名稱	Throw描述
SQLException	如果發(fā)生數(shù)據(jù)庫訪問錯誤

getTypeMap

MapString,Class<?> getTypeMap() throws SQLException

檢索與此 RowSet 對象關(guān)聯(lián)的 Map 對象，該對象指定 SQL 用戶定義類型的自定義映射（如果有）。 默認類型映射為空。

返回:

一個 java.util.Map 對象，其中包含 SQL 用戶定義類型的名稱以及它們要映射到的 Java 類

Throws:

Throw名稱	Throw描述
SQLException	如果發(fā)生數(shù)據(jù)庫訪問錯誤

setTypeMap

void setTypeMap(MapString,Class<?> map) throws SQLException

將給定的 java.util.Map 對象安裝為此 RowSet 對象的默認類型映射。 除非提供另一個類型映射作為方法參數(shù)，否則將使用此類型映射。

參數(shù)：

參數(shù)名稱	參數(shù)描述
map	一個 java.util.Map 對象，其中包含 SQL 用戶定義類型的名稱以及它們要映射到的 Java 類

Throws:

Throw名稱	Throw描述
SQLException	如果發(fā)生數(shù)據(jù)庫訪問錯誤

getCommand

String getCommand()

檢索此 RowSet 對象的命令屬性。 command 屬性包含一個命令字符串，它必須是一個 SQL 查詢，可以執(zhí)行它來用數(shù)據(jù)填充行集。 默認值為空。

返回:

命令字符串； 可能為空

setCommand

void setCommand(String cmd) throws SQLException

將此 RowSet 對象的命令屬性設(shè)置為給定的 SQL 查詢。 當(dāng)行集從不支持命令的數(shù)據(jù)源（例如電子表格）獲取其數(shù)據(jù)時，此屬性是可選的。

參數(shù)：

參數(shù)名稱	參數(shù)描述
cmd	用于獲取此 RowSet 對象數(shù)據(jù)的 SQL 查詢； 可能為空

Throws:

Throw名稱	Throw描述
SQLException	如果發(fā)生數(shù)據(jù)庫訪問錯誤

isReadOnly

boolean isReadOnly()

檢索此 RowSet 對象是否為只讀。 如果可以更新，則默認情況下行集是可更新的。

嘗試更新只讀行集將導(dǎo)致引發(fā) SQLException。

返回:

如果此 RowSet 對象是只讀的，則為 true； 如果它是可更新的，則為 false

setReadOnly

void setReadOnly(boolean value) throws SQLException

將此 RowSet 對象設(shè)置為給定布爾值是否為只讀。

參數(shù)：

參數(shù)名稱	參數(shù)描述
value	如果只讀，則為 true； 如果可更新則為 false

Throws:

Throw名稱	Throw描述
SQLException	如果發(fā)生數(shù)據(jù)庫訪問錯誤

getMaxFieldSize

int getMaxFieldSize() throws SQLException

檢索可以為某些列值返回的最大字節(jié)數(shù)。 此限制僅適用于 BINARY、VARBINARY、LONGVARBINARYBINARY、CHAR、VARCHAR、LONGVARCHAR、NCHAR 和 NVARCHAR 列。 如果超出限制，多余的數(shù)據(jù)將被靜默丟棄。

返回:

當(dāng)前最大列大小限制； 零表示沒有限制

Throws:

Throw名稱	Throw描述
SQLException	如果發(fā)生數(shù)據(jù)庫訪問錯誤

setMaxFieldSize

void setMaxFieldSize(int max) throws SQLException

將可以為列值返回的最大字節(jié)數(shù)設(shè)置為給定的字節(jié)數(shù)。 此限制僅適用于 BINARY、VARBINARY、LONGVARBINARYBINARY、CHAR、VARCHAR、LONGVARCHAR、NCHAR 和 NVARCHAR 列。 如果超出限制，多余的數(shù)據(jù)將被靜默丟棄。 為獲得最大的可移植性，請使用大于 256 的值。

參數(shù)：

參數(shù)名稱	參數(shù)描述
max	新的最大列大小限制（以字節(jié)為單位）； 零意味著無限

Throws:

Throw名稱	Throw描述
SQLException	如果發(fā)生數(shù)據(jù)庫訪問錯誤

getMaxRows

int getMaxRows() throws SQLException

檢索此 RowSet 對象可以包含的最大行數(shù)。 如果超出限制，則會靜默刪除多余的行。

返回:

此 RowSet 對象可以包含的當(dāng)前最大行數(shù)； 零意味著無限

Throws:

Throw名稱	Throw描述
SQLException	如果發(fā)生數(shù)據(jù)庫訪問錯誤

setMaxRows

void setMaxRows(int max) throws SQLException

將此 RowSet 對象可以包含的最大行數(shù)設(shè)置為指定的數(shù)目。 如果超出限制，則會靜默刪除多余的行。

參數(shù)：

參數(shù)名稱	參數(shù)描述
max	新的最大行數(shù)； 零意味著無限

Throws:

Throw名稱	Throw描述
SQLException	如果發(fā)生數(shù)據(jù)庫訪問錯誤

getEscapeProcessing

boolean getEscapeProcessing() throws SQLException

檢索是否為此 RowSet 對象啟用了轉(zhuǎn)義處理。 如果啟用了轉(zhuǎn)義掃描（這是默認設(shè)置），驅(qū)動程序?qū)⒃谙驍?shù)據(jù)庫發(fā)送 SQL 語句之前執(zhí)行轉(zhuǎn)義替換。

返回:

如果啟用了轉(zhuǎn)義處理，則為 true； 如果它被禁用，則為 false

Throws:

Throw名稱	Throw描述
SQLException	如果發(fā)生數(shù)據(jù)庫訪問錯誤

setEscapeProcessing

void setEscapeProcessing(boolean enable) throws SQLException

將此 RowSet 對象的轉(zhuǎn)義處理設(shè)置為打開或關(guān)閉。 如果轉(zhuǎn)義掃描打開（默認），驅(qū)動程序?qū)⒃谙驍?shù)據(jù)庫發(fā)送 SQL 語句之前執(zhí)行轉(zhuǎn)義替換。

參數(shù)：

參數(shù)名稱	參數(shù)描述
enable	true 啟用轉(zhuǎn)義處理； false 禁用它

Throws:

Throw名稱	Throw描述
SQLException	如果發(fā)生數(shù)據(jù)庫訪問錯誤

getQueryTimeout

int getQueryTimeout() throws SQLException

檢索驅(qū)動程序等待語句執(zhí)行的最大秒數(shù)。 如果超出此限制，則會引發(fā) SQLException。

返回:

當(dāng)前查詢超時限制（以秒為單位）； 零意味著無限

Throws:

Throw名稱	Throw描述
SQLException	如果發(fā)生數(shù)據(jù)庫訪問錯誤

setQueryTimeout

void setQueryTimeout(int seconds) throws SQLException

將驅(qū)動程序等待語句執(zhí)行的最長時間設(shè)置為給定的秒數(shù)。 如果超出此限制，則會引發(fā) SQLException。

參數(shù)：

參數(shù)名稱	參數(shù)描述
seconds	以秒為單位的新查詢超時限制； 零表示沒有限制

Throws:

Throw名稱	Throw描述
SQLException	如果發(fā)生數(shù)據(jù)庫訪問錯誤

setType

void setType(int type) throws SQLException

將此 RowSet 對象的類型設(shè)置為給定類型。 此方法用于更改行集的類型，默認為只讀且不可滾動。

參數(shù)：

參數(shù)名稱	參數(shù)描述
type	指定類型的 ResultSet 常量之一：ResultSet.TYPE_FORWARD_ONLY、ResultSet.TYPE_SCROLL_INSENSITIVE 或 ResultSet.TYPE_SCROLL_SENSITIVE

Throws:

Throw名稱	Throw描述
SQLException	如果發(fā)生數(shù)據(jù)庫訪問錯誤

setConcurrency

void setConcurrency(int concurrency) throws SQLException

將此 RowSet 對象的并發(fā)設(shè)置為給定的并發(fā)級別。 此方法用于更改行集的并發(fā)級別，默認為 ResultSet.CONCUR_READ_ONLY

參數(shù)：

參數(shù)名稱	參數(shù)描述
concurrency	指定并發(fā)級別的 ResultSet 常量之一：ResultSet.CONCUR_READ_ONLY 或 ResultSet.CONCUR_UPDATABLE

Throws:

Throw名稱	Throw描述
SQLException	如果發(fā)生數(shù)據(jù)庫訪問錯誤

setNull

void setNull(int parameterIndex, int sqlType) throws SQLException

將此 RowSet 對象的 SQL 命令中的指定參數(shù)設(shè)置為 SQL NULL。

注意：您必須指定參數(shù)的 SQL 類型。

參數(shù)：

參數(shù)名稱	參數(shù)描述
parameterIndex	第一個參數(shù)是1，第二個是2，...
sqlType	由 java.sql.Types 定義的 SQL 類型代碼

Throws:

Throw名稱	Throw描述
SQLException	如果發(fā)生數(shù)據(jù)庫訪問錯誤

setNull

void setNull(String parameterName, int sqlType) throws SQLException

將指定參數(shù)設(shè)置為 SQL NULL。

注意：您必須指定參數(shù)的 SQL 類型。

參數(shù)：

參數(shù)名稱	參數(shù)描述
parameterName	參數(shù)名稱
sqlType	java.sql.Types 中定義的 SQL 類型代碼

Throws:

Throw名稱	Throw描述
SQLException	如果發(fā)生數(shù)據(jù)庫訪問錯誤或在關(guān)閉的 CallableStatement 上調(diào)用此方法
SQLFeatureNotSupportedException	如果 JDBC 驅(qū)動程序不支持此方法

Since:

1.4

setNull

void setNull(int paramIndex, int sqlType, String typeName) throws SQLException

將此 RowSet 對象的 SQL 命令中的指定參數(shù)設(shè)置為 SQL NULL。 此版本的方法 setNull 應(yīng)用于 SQL 用戶定義類型 (UDT) 和 REF 類型參數(shù)。 UDT 的示例包括：STRUCT、DISTINCT、JAVA_OBJECT 和命名數(shù)組類型。

注意：為了便于移植，應(yīng)用程序在指定 NULL UDT 或 REF 參數(shù)時必須提供 SQL 類型代碼和完全限定的 SQL 類型名稱。 對于 UDT，名稱是參數(shù)本身的類型名稱。 對于 REF 參數(shù)，名稱是引用類型的類型名稱。 如果 JDBC 驅(qū)動程序不需要類型代碼或類型名稱信息，它可能會忽略它。 雖然它適用于 UDT 和 REF 參數(shù)，但此方法可用于設(shè)置任何 JDBC 類型的空參數(shù)。 如果參數(shù)沒有用戶定義或 REF 類型，則忽略 typeName 參數(shù)。

參數(shù)：

參數(shù)名稱	參數(shù)描述
paramIndex	第一個參數(shù)是1，第二個是2，...
sqlType	來自 java.sql.Types 的值
typeName	SQL UDT 的完全限定名稱或 REF 類型引用的 SQL 結(jié)構(gòu)化類型的類型名稱； 如果參數(shù)不是 UDT 或 REF 類型，則忽略

Throws:

Throw名稱	Throw描述
SQLException	如果發(fā)生數(shù)據(jù)庫訪問錯誤

setNull

void setNull(String parameterName, int sqlType, String typeName) throws SQLException

將指定參數(shù)設(shè)置為 SQL NULL。 此版本的方法 setNull 應(yīng)用于用戶定義類型和 REF 類型參數(shù)。 用戶定義類型的示例包括：STRUCT、DISTINCT、JAVA_OBJECT 和命名數(shù)組類型。

注意：為了便于移植，應(yīng)用程序必須在指定 NULL 用戶定義或 REF 參數(shù)時提供 SQL 類型代碼和完全限定的 SQL 類型名稱。 在用戶定義類型的情況下，名稱是參數(shù)本身的類型名稱。 對于 REF 參數(shù)，名稱是引用類型的類型名稱。 如果 JDBC 驅(qū)動程序不需要類型代碼或類型名稱信息，它可能會忽略它。 雖然它適用于用戶定義和 Ref 參數(shù)，但此方法可用于設(shè)置任何 JDBC 類型的 null 參數(shù)。 如果參數(shù)沒有用戶定義或 REF 類型，則忽略給定的 typeName。

參數(shù)：

參數(shù)名稱	參數(shù)描述
parameterName	參數(shù)名稱
sqlType	來自 java.sql.Types 的值
typeName	SQL 用戶定義類型的完全限定名稱； 如果參數(shù)不是用戶定義的類型或 SQL REF 值，則忽略

Throws:

Throw名稱	Throw描述
SQLException	如果發(fā)生數(shù)據(jù)庫訪問錯誤或在關(guān)閉的 CallableStatement 上調(diào)用此方法
SQLFeatureNotSupportedException	如果 JDBC 驅(qū)動程序不支持此方法

Since:

1.4

setBoolean

void setBoolean(int parameterIndex, boolean x) throws SQLException

將此 RowSet 對象的命令中的指定參數(shù)設(shè)置為給定的 Java 布爾值。 驅(qū)動程序在將其發(fā)送到數(shù)據(jù)庫之前將其轉(zhuǎn)換為 SQL BIT 值。

參數(shù)：

參數(shù)名稱	參數(shù)描述
parameterIndex	第一個參數(shù)是1，第二個是2，...
x	參數(shù)值

Throws:

Throw名稱	Throw描述
SQLException	如果發(fā)生數(shù)據(jù)庫訪問錯誤

setBoolean

void setBoolean(String parameterName, boolean x) throws SQLException

將指定參數(shù)設(shè)置為給定的 Java 布爾值。 驅(qū)動程序在將其發(fā)送到數(shù)據(jù)庫時將其轉(zhuǎn)換為 SQL BIT 或 BOOLEAN 值。

參數(shù)：

參數(shù)名稱	參數(shù)描述
parameterName	參數(shù)名稱
x	參數(shù)值

Throws:

Throw名稱	Throw描述
SQLException	如果發(fā)生數(shù)據(jù)庫訪問錯誤或在關(guān)閉的 CallableStatement 上調(diào)用此方法
SQLFeatureNotSupportedException	如果 JDBC 驅(qū)動程序不支持此方法

Since:

1.4

setByte

void setByte(int parameterIndex, byte x) throws SQLException

將此 RowSet 對象的命令中的指定參數(shù)設(shè)置為給定的 Java 字節(jié)值。 驅(qū)動程序在將其發(fā)送到數(shù)據(jù)庫之前將其轉(zhuǎn)換為 SQL TINYINT 值。

參數(shù)：

參數(shù)名稱	參數(shù)描述
parameterIndex	第一個參數(shù)是1，第二個是2，...
x	參數(shù)值

Throws:

Throw名稱	Throw描述
SQLException	如果發(fā)生數(shù)據(jù)庫訪問錯誤

setByte

void setByte(String parameterName, byte x) throws SQLException

將指定參數(shù)設(shè)置為給定的 Java 字節(jié)值。 驅(qū)動程序在將其發(fā)送到數(shù)據(jù)庫時將其轉(zhuǎn)換為 SQL TINYINT 值。

參數(shù)：

參數(shù)名稱	參數(shù)描述
parameterName	參數(shù)名稱
x	參數(shù)值

Throws:

Throw名稱	Throw描述
SQLException	如果發(fā)生數(shù)據(jù)庫訪問錯誤或在關(guān)閉的 CallableStatement 上調(diào)用此方法
SQLFeatureNotSupportedException	如果 JDBC 驅(qū)動程序不支持此方法

Since:

1.4

setShort

void setShort(int parameterIndex, short x) throws SQLException

將此 RowSet 對象的命令中的指定參數(shù)設(shè)置為給定的 Java 短值。 驅(qū)動程序在將其發(fā)送到數(shù)據(jù)庫之前將其轉(zhuǎn)換為 SQL SMALLINT 值。

參數(shù)：

參數(shù)名稱	參數(shù)描述
parameterIndex	第一個參數(shù)是1，第二個是2，...
x	參數(shù)值

Throws:

Throw名稱	Throw描述
SQLException	如果發(fā)生數(shù)據(jù)庫訪問錯誤

setShort

void setShort(String parameterName, short x) throws SQLException

將指定參數(shù)設(shè)置為給定的 Java 短值。 驅(qū)動程序在將其發(fā)送到數(shù)據(jù)庫時將其轉(zhuǎn)換為 SQL SMALLINT 值。

參數(shù)：

參數(shù)名稱	參數(shù)描述
parameterName	參數(shù)名稱
x	參數(shù)值

Throws:

Throw名稱	Throw描述
SQLException	如果發(fā)生數(shù)據(jù)庫訪問錯誤或在關(guān)閉的 CallableStatement 上調(diào)用此方法
SQLFeatureNotSupportedException	如果 JDBC 驅(qū)動程序不支持此方法

Since:

1.4

setInt

void setInt(int parameterIndex, int x) throws SQLException

將此 RowSet 對象的命令中的指定參數(shù)設(shè)置為給定的 Java int 值。 驅(qū)動程序在將其發(fā)送到數(shù)據(jù)庫之前將其轉(zhuǎn)換為 SQL INTEGER 值。

參數(shù)：

參數(shù)名稱	參數(shù)描述
parameterIndex	第一個參數(shù)是1，第二個是2，...
x	參數(shù)值

Throws:

Throw名稱	Throw描述
SQLException	如果發(fā)生數(shù)據(jù)庫訪問錯誤

setInt

void setInt(String parameterName, int x) throws SQLException

將指定參數(shù)設(shè)置為給定的 Java int 值。 驅(qū)動程序在將其發(fā)送到數(shù)據(jù)庫時將其轉(zhuǎn)換為 SQL INTEGER 值。

參數(shù)：

參數(shù)名稱	參數(shù)描述
parameterName	參數(shù)名稱
x	參數(shù)值

Throws:

Throw名稱	Throw描述
SQLException	如果發(fā)生數(shù)據(jù)庫訪問錯誤或在關(guān)閉的 CallableStatement 上調(diào)用此方法
SQLFeatureNotSupportedException	如果 JDBC 驅(qū)動程序不支持此方法

Since:

1.4

setLong

void setLong(int parameterIndex, long x) throws SQLException

將此 RowSet 對象的命令中的指定參數(shù)設(shè)置為給定的 Java long 值。 驅(qū)動程序在將其發(fā)送到數(shù)據(jù)庫之前將其轉(zhuǎn)換為 SQL BIGINT 值。

參數(shù)：

參數(shù)名稱	參數(shù)描述
parameterIndex	第一個參數(shù)是1，第二個是2，...
x	參數(shù)值

Throws:

Throw名稱	Throw描述
SQLException	如果發(fā)生數(shù)據(jù)庫訪問錯誤

setLong

void setLong(String parameterName, long x) throws SQLException

將指定參數(shù)設(shè)置為給定的 Java long 值。 驅(qū)動程序在將其發(fā)送到數(shù)據(jù)庫時將其轉(zhuǎn)換為 SQL BIGINT 值。

參數(shù)：

參數(shù)名稱	參數(shù)描述
parameterName	參數(shù)名稱
x	參數(shù)值

Throws:

Throw名稱	Throw描述
SQLException	如果發(fā)生數(shù)據(jù)庫訪問錯誤或在關(guān)閉的 CallableStatement 上調(diào)用此方法
SQLFeatureNotSupportedException	如果 JDBC 驅(qū)動程序不支持此方法

Since:

1.4

setFloat

void setFloat(int parameterIndex, float x) throws SQLException

將此 RowSet 對象的命令中的指定參數(shù)設(shè)置為給定的 Java 浮點值。 驅(qū)動程序在將其發(fā)送到數(shù)據(jù)庫之前將其轉(zhuǎn)換為 SQL REAL 值。

參數(shù)：

參數(shù)名稱	參數(shù)描述
parameterIndex	第一個參數(shù)是1，第二個是2，...
x	參數(shù)值

Throws:

Throw名稱	Throw描述
SQLException	如果發(fā)生數(shù)據(jù)庫訪問錯誤

setFloat

void setFloat(String parameterName, float x) throws SQLException

將指定參數(shù)設(shè)置為給定的 Java 浮點值。 驅(qū)動程序在將其發(fā)送到數(shù)據(jù)庫時將其轉(zhuǎn)換為 SQL FLOAT 值。

參數(shù)：

參數(shù)名稱	參數(shù)描述
parameterName	參數(shù)名稱
x	參數(shù)值

Throws:

Throw名稱	Throw描述
SQLException	如果發(fā)生數(shù)據(jù)庫訪問錯誤或在關(guān)閉的 CallableStatement 上調(diào)用此方法
SQLFeatureNotSupportedException	如果 JDBC 驅(qū)動程序不支持此方法

Since:

1.4

setDouble

void setDouble(int parameterIndex, double x) throws SQLException

將此 RowSet 對象的命令中的指定參數(shù)設(shè)置為給定的 Java 雙精度值。 驅(qū)動程序在將其發(fā)送到數(shù)據(jù)庫之前將其轉(zhuǎn)換為 SQL DOUBLE 值。

參數(shù)：

參數(shù)名稱	參數(shù)描述
parameterIndex	第一個參數(shù)是1，第二個是2，...
x	參數(shù)值

Throws:

Throw名稱	Throw描述
SQLException	如果發(fā)生數(shù)據(jù)庫訪問錯誤

setDouble

void setDouble(String parameterName, double x) throws SQLException

將指定參數(shù)設(shè)置為給定的 Java 雙精度值。 驅(qū)動程序在將其發(fā)送到數(shù)據(jù)庫時將其轉(zhuǎn)換為 SQL DOUBLE 值。

參數(shù)：

參數(shù)名稱	參數(shù)描述
parameterName	參數(shù)名稱
x	參數(shù)值

Throws:

Throw名稱	Throw描述
SQLException	如果發(fā)生數(shù)據(jù)庫訪問錯誤或在關(guān)閉的 CallableStatement 上調(diào)用此方法
SQLFeatureNotSupportedException	如果 JDBC 驅(qū)動程序不支持此方法

Since:

1.4

setBigDecimal

void setBigDecimal(int parameterIndex, BigDecimal x) throws SQLException

將此 RowSet 對象命令中的指定參數(shù)設(shè)置為給定的 java.math.BigDecimal 值。 驅(qū)動程序在將其發(fā)送到數(shù)據(jù)庫之前將其轉(zhuǎn)換為 SQL NUMERIC 值。

參數(shù)：

參數(shù)名稱	參數(shù)描述
parameterIndex	第一個參數(shù)是1，第二個是2，...
x	參數(shù)值

Throws:

Throw名稱	Throw描述
SQLException	如果發(fā)生數(shù)據(jù)庫訪問錯誤

setBigDecimal

void setBigDecimal(String parameterName, BigDecimal x) throws SQLException

將指定參數(shù)設(shè)置為給定的 java.math.BigDecimal 值。 驅(qū)動程序在將其發(fā)送到數(shù)據(jù)庫時將其轉(zhuǎn)換為 SQL NUMERIC 值。

參數(shù)：

參數(shù)名稱	參數(shù)描述
parameterName	參數(shù)名稱
x	參數(shù)值

Throws:

Throw名稱	Throw描述
SQLException	如果發(fā)生數(shù)據(jù)庫訪問錯誤或在關(guān)閉的 CallableStatement 上調(diào)用此方法
SQLFeatureNotSupportedException	如果 JDBC 驅(qū)動程序不支持此方法

Since:

1.4

setString

void setString(int parameterIndex, String x) throws SQLException

將此 RowSet 對象的命令中的指定參數(shù)設(shè)置為給定的 Java 字符串值。 在將其發(fā)送到數(shù)據(jù)庫之前，驅(qū)動程序?qū)⑵滢D(zhuǎn)換為 SQL VARCHAR 或 LONGVARCHAR 值，具體取決于參數(shù)的大小相對于驅(qū)動程序?qū)?VARCHAR 值的限制。

參數(shù)：

參數(shù)名稱	參數(shù)描述
parameterIndex	第一個參數(shù)是1，第二個是2，...
x	參數(shù)值

Throws:

Throw名稱	Throw描述
SQLException	如果發(fā)生數(shù)據(jù)庫訪問錯誤

setString

void setString(String parameterName, String x) throws SQLException

將指定參數(shù)設(shè)置為給定的 Java 字符串值。 驅(qū)動程序在將其發(fā)送到數(shù)據(jù)庫時將其轉(zhuǎn)換為 SQL VARCHAR 或 LONGVARCHAR 值（取決于參數(shù)的大小相對于驅(qū)動程序?qū)?VARCHAR 值的限制）。

參數(shù)：

參數(shù)名稱	參數(shù)描述
parameterName	參數(shù)名稱
x	參數(shù)值

Throws:

Throw名稱	Throw描述
SQLException	如果發(fā)生數(shù)據(jù)庫訪問錯誤或在關(guān)閉的 CallableStatement 上調(diào)用此方法
SQLFeatureNotSupportedException	如果 JDBC 驅(qū)動程序不支持此方法

Since:

1.4

setBytes

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

將此 RowSet 對象的命令中的指定參數(shù)設(shè)置為給定的 Java 字節(jié)值數(shù)組。 在將其發(fā)送到數(shù)據(jù)庫之前，驅(qū)動程序?qū)⑵滢D(zhuǎn)換為 SQL VARBINARY 或 LONGVARBINARY 值，具體取決于參數(shù)相對于驅(qū)動程序?qū)?VARBINARY 值的限制的大小。

參數(shù)：

參數(shù)名稱	參數(shù)描述
parameterIndex	第一個參數(shù)是1，第二個是2，...
x	參數(shù)值

Throws:

Throw名稱	Throw描述
SQLException	如果發(fā)生數(shù)據(jù)庫訪問錯誤

setBytes

void setBytes(String parameterName, byte[] x) throws SQLException

將指定參數(shù)設(shè)置為給定的 Java 字節(jié)數(shù)組。 驅(qū)動程序在將其發(fā)送到數(shù)據(jù)庫時將其轉(zhuǎn)換為 SQL VARBINARY 或 LONGVARBINARY（取決于參數(shù)的大小相對于驅(qū)動程序?qū)?VARBINARY 值的限制）。

參數(shù)：

參數(shù)名稱	參數(shù)描述
parameterName	參數(shù)名稱
x	參數(shù)值

Throws:

Throw名稱	Throw描述
SQLException	如果發(fā)生數(shù)據(jù)庫訪問錯誤或在關(guān)閉的 CallableStatement 上調(diào)用此方法
SQLFeatureNotSupportedException	如果 JDBC 驅(qū)動程序不支持此方法

Since:

1.4

setDate

void setDate(int parameterIndex, Date x) throws SQLException

將此 RowSet 對象的命令中的指定參數(shù)設(shè)置為給定的 java.sql.Date 值。 驅(qū)動程序在將其發(fā)送到數(shù)據(jù)庫之前將其轉(zhuǎn)換為 SQL DATE 值，使用默認的 java.util.Calendar 來計算日期。

參數(shù)：

參數(shù)名稱	參數(shù)描述
parameterIndex	第一個參數(shù)是1，第二個是2，...
x	參數(shù)值

Throws:

Throw名稱	Throw描述
SQLException	如果發(fā)生數(shù)據(jù)庫訪問錯誤

setTime

void setTime(int parameterIndex, Time x) throws SQLException

將此 RowSet 對象的命令中的指定參數(shù)設(shè)置為給定的 java.sql.Time 值。 驅(qū)動程序在將其發(fā)送到數(shù)據(jù)庫之前將其轉(zhuǎn)換為 SQL TIME 值，使用默認的 java.util.Calendar 來計算它。

參數(shù)：

參數(shù)名稱	參數(shù)描述
parameterIndex	第一個參數(shù)是1，第二個是2，...
x	參數(shù)值

Throws:

Throw名稱	Throw描述
SQLException	如果發(fā)生數(shù)據(jù)庫訪問錯誤

setTimestamp

void setTimestamp(int parameterIndex, Timestamp x) throws SQLException

將此 RowSet 對象的命令中的指定參數(shù)設(shè)置為給定的 java.sql.Timestamp 值。 驅(qū)動程序在將其發(fā)送到數(shù)據(jù)庫之前將其轉(zhuǎn)換為 SQL TIMESTAMP 值，使用默認的 java.util.Calendar 來計算它。

參數(shù)：

參數(shù)名稱	參數(shù)描述
parameterIndex	第一個參數(shù)是1，第二個是2，...
x	參數(shù)值

Throws:

Throw名稱	Throw描述
SQLException	如果發(fā)生數(shù)據(jù)庫訪問錯誤

setTimestamp

void setTimestamp(String parameterName, Timestamp x) throws SQLException

將指定參數(shù)設(shè)置為給定的 java.sql.Timestamp 值。 驅(qū)動程序在將其發(fā)送到數(shù)據(jù)庫時將其轉(zhuǎn)換為 SQL TIMESTAMP 值。

參數(shù)：

參數(shù)名稱	參數(shù)描述
parameterName	參數(shù)名稱
x	參數(shù)值

Throws:

Throw名稱	Throw描述
SQLException	如果發(fā)生數(shù)據(jù)庫訪問錯誤或在關(guān)閉的 CallableStatement 上調(diào)用此方法
SQLFeatureNotSupportedException	如果 JDBC 驅(qū)動程序不支持此方法

Since:

1.4

setAsciiStream

void setAsciiStream(int parameterIndex, InputStream x, int length) throws SQLException

將此 RowSet 對象的命令中的指定參數(shù)設(shè)置為給定的 java.io.InputStream 值。 通過 java.io.InputStream 而不是作為 LONGVARCHAR 參數(shù)發(fā)送非常大的 ASCII 值可能更實用。 驅(qū)動程序?qū)⒏鶕?jù)需要從流中讀取數(shù)據(jù)，直到到達文件末尾。

注意：這個流對象可以是標(biāo)準(zhǔn)的 Java 流對象，也可以是您自己的實現(xiàn)標(biāo)準(zhǔn)接口的子類。

參數(shù)：

參數(shù)名稱	參數(shù)描述
parameterIndex	第一個參數(shù)是1，第二個是2，...
x	包含 ASCII 參數(shù)值的 Java 輸入流
length	流中的字節(jié)數(shù)

Throws:

Throw名稱	Throw描述
SQLException	如果發(fā)生數(shù)據(jù)庫訪問錯誤

setAsciiStream

void setAsciiStream(String parameterName, InputStream x, int length) throws SQLException

將指定參數(shù)設(shè)置為給定的輸入流，該輸入流將具有指定的字節(jié)數(shù)。 當(dāng)向 LONGVARCHAR 參數(shù)輸入非常大的 ASCII 值時，通過 java.io.InputStream 發(fā)送它可能更實際。 將根據(jù)需要從流中讀取數(shù)據(jù)，直到到達文件結(jié)尾。 JDBC 驅(qū)動程序?qū)?zhí)行從 ASCII 到數(shù)據(jù)庫字符格式的任何必要轉(zhuǎn)換。

注意：這個流對象可以是標(biāo)準(zhǔn)的 Java 流對象，也可以是您自己的實現(xiàn)標(biāo)準(zhǔn)接口的子類。

參數(shù)：

參數(shù)名稱	參數(shù)描述
parameterName	參數(shù)名稱
x	包含 ASCII 參數(shù)值的 Java 輸入流
length	流中的字節(jié)數(shù)

Throws:

Throw名稱	Throw描述
SQLException	如果發(fā)生數(shù)據(jù)庫訪問錯誤或在關(guān)閉的 CallableStatement 上調(diào)用此方法
SQLFeatureNotSupportedException	如果 JDBC 驅(qū)動程序不支持此方法

Since:

1.4

setBinaryStream

void setBinaryStream(int parameterIndex, InputStream x, int length) throws SQLException

將此 RowSet 對象的命令中的指定參數(shù)設(shè)置為給定的 java.io.InputStream 值。 通過 java.io.InputStream 而不是作為 LONGVARBINARY 參數(shù)發(fā)送非常大的二進制值可能更實用。 驅(qū)動程序?qū)⒏鶕?jù)需要從流中讀取數(shù)據(jù)，直到到達文件末尾。

注意：這個流對象可以是標(biāo)準(zhǔn)的 Java 流對象，也可以是您自己的實現(xiàn)標(biāo)準(zhǔn)接口的子類。

參數(shù)：

參數(shù)名稱	參數(shù)描述
parameterIndex	第一個參數(shù)是1，第二個是2，...
x	包含二進制參數(shù)值的 java 輸入流
length	流中的字節(jié)數(shù)

Throws:

Throw名稱	Throw描述
SQLException	如果發(fā)生數(shù)據(jù)庫訪問錯誤

setBinaryStream

void setBinaryStream(String parameterName, InputStream x, int length) throws SQLException

將指定參數(shù)設(shè)置為給定的輸入流，該輸入流將具有指定的字節(jié)數(shù)。 當(dāng)一個非常大的二進制值輸入到 LONGVARBINARY 參數(shù)時，通過 java.io.InputStream 對象發(fā)送它可能更實際。 將根據(jù)需要從流中讀取數(shù)據(jù)，直到到達文件結(jié)尾。

注意：這個流對象可以是標(biāo)準(zhǔn)的 Java 流對象，也可以是您自己的實現(xiàn)標(biāo)準(zhǔn)接口的子類。

參數(shù)：

參數(shù)名稱	參數(shù)描述
parameterName	參數(shù)名稱
x	包含二進制參數(shù)值的 java 輸入流
length	流中的字節(jié)數(shù)

Throws:

Throw名稱	Throw描述
SQLException	如果發(fā)生數(shù)據(jù)庫訪問錯誤或在關(guān)閉的 CallableStatement 上調(diào)用此方法
SQLFeatureNotSupportedException	如果 JDBC 驅(qū)動程序不支持此方法

Since:

1.4

setCharacterStream

void setCharacterStream(int parameterIndex, Reader reader, int length) throws SQLException

將此 RowSet 對象的命令中的指定參數(shù)設(shè)置為給定的 java.io.Reader 值。 通過 java.io.Reader 而不是作為 LONGVARCHAR 參數(shù)發(fā)送非常大的 UNICODE 值可能更實用。 驅(qū)動程序?qū)⒏鶕?jù)需要從流中讀取數(shù)據(jù)，直到到達文件末尾。

注意：這個流對象可以是標(biāo)準(zhǔn)的 Java 流對象，也可以是您自己的實現(xiàn)標(biāo)準(zhǔn)接口的子類。

參數(shù)：

參數(shù)名稱	參數(shù)描述
parameterIndex	第一個參數(shù)是1，第二個是2，...
reader	包含要設(shè)置的 UNICODE 數(shù)據(jù)的 Reader 對象
length	流中的字符數(shù)

Throws:

Throw名稱	Throw描述
SQLException	如果發(fā)生數(shù)據(jù)庫訪問錯誤

setCharacterStream

void setCharacterStream(String parameterName, Reader reader, int length) throws SQLException

將指定參數(shù)設(shè)置為給定的 Reader 對象，它是給定的字符數(shù)。 當(dāng)向 LONGVARCHAR 參數(shù)輸入非常大的 UNICODE 值時，通過 java.io.Reader 對象發(fā)送它可能更實際。 將根據(jù)需要從流中讀取數(shù)據(jù)，直到到達文件結(jié)尾。 JDBC 驅(qū)動程序?qū)?zhí)行從 UNICODE 到數(shù)據(jù)庫字符格式的任何必要轉(zhuǎn)換。

注意：這個流對象可以是標(biāo)準(zhǔn)的 Java 流對象，也可以是您自己的實現(xiàn)標(biāo)準(zhǔn)接口的子類。

參數(shù)：

參數(shù)名稱	參數(shù)描述
parameterName	參數(shù)名稱
reader	包含用作指定參數(shù)的 UNICODE 數(shù)據(jù)的 java.io.Reader 對象
length	流中的字符數(shù)

Throws:

Throw名稱	Throw描述
SQLException	如果發(fā)生數(shù)據(jù)庫訪問錯誤或在關(guān)閉的 CallableStatement 上調(diào)用此方法
SQLFeatureNotSupportedException	如果 JDBC 驅(qū)動程序不支持此方法

Since:

1.4

setAsciiStream

void setAsciiStream(int parameterIndex, InputStream x) throws SQLException

將此 RowSet 對象的命令中的指定參數(shù)設(shè)置為給定的輸入流。 當(dāng)向 LONGVARCHAR 參數(shù)輸入非常大的 ASCII 值時，通過 java.io.InputStream 發(fā)送它可能更實際。 將根據(jù)需要從流中讀取數(shù)據(jù)，直到到達文件結(jié)尾。 JDBC 驅(qū)動程序?qū)?zhí)行從 ASCII 到數(shù)據(jù)庫字符格式的任何必要轉(zhuǎn)換。

注意：這個流對象可以是標(biāo)準(zhǔn)的 Java 流對象，也可以是您自己的實現(xiàn)標(biāo)準(zhǔn)接口的子類。

注意：請查閱您的 JDBC 驅(qū)動程序文檔以確定使用帶有長度參數(shù)的 setAsciiStream 版本是否更有效。

參數(shù)：

參數(shù)名稱	參數(shù)描述
parameterIndex	第一個參數(shù)是1，第二個是2，...
x	包含 ASCII 參數(shù)值的 Java 輸入流

Throws:

Throw名稱	Throw描述
SQLException	如果發(fā)生數(shù)據(jù)庫訪問錯誤或在關(guān)閉的 PreparedStatement 上調(diào)用此方法
SQLFeatureNotSupportedException	如果 JDBC 驅(qū)動程序不支持此方法

Since:

1.6

setAsciiStream

void setAsciiStream(String parameterName, InputStream x) throws SQLException

將指定參數(shù)設(shè)置為給定的輸入流。 當(dāng)向 LONGVARCHAR 參數(shù)輸入非常大的 ASCII 值時，通過 java.io.InputStream 發(fā)送它可能更實際。 將根據(jù)需要從流中讀取數(shù)據(jù)，直到到達文件結(jié)尾。 JDBC 驅(qū)動程序?qū)?zhí)行從 ASCII 到數(shù)據(jù)庫字符格式的任何必要轉(zhuǎn)換。

注意：這個流對象可以是標(biāo)準(zhǔn)的 Java 流對象，也可以是您自己的實現(xiàn)標(biāo)準(zhǔn)接口的子類。

注意：請查閱您的 JDBC 驅(qū)動程序文檔以確定使用帶有長度參數(shù)的 setAsciiStream 版本是否更有效。

參數(shù)：

參數(shù)名稱	參數(shù)描述
parameterName	參數(shù)名稱
x	包含 ASCII 參數(shù)值的 Java 輸入流

Throws:

Throw名稱	Throw描述
SQLException	如果發(fā)生數(shù)據(jù)庫訪問錯誤或在關(guān)閉的 CallableStatement 上調(diào)用此方法
SQLFeatureNotSupportedException	如果 JDBC 驅(qū)動程序不支持此方法

Since:

1.6

setBinaryStream

void setBinaryStream(int parameterIndex, InputStream x) throws SQLException

將此 RowSet 對象的命令中的指定參數(shù)設(shè)置為給定的輸入流。 當(dāng)一個非常大的二進制值輸入到 LONGVARBINARY 參數(shù)時，通過 java.io.InputStream 對象發(fā)送它可能更實際。 將根據(jù)需要從流中讀取數(shù)據(jù)，直到到達文件結(jié)尾。

注意：這個流對象可以是標(biāo)準(zhǔn)的 Java 流對象，也可以是您自己的實現(xiàn)標(biāo)準(zhǔn)接口的子類。

注意：請查閱您的 JDBC 驅(qū)動程序文檔以確定使用帶有長度參數(shù)的 setBinaryStream 版本是否更有效。

參數(shù)：

參數(shù)名稱	參數(shù)描述
parameterIndex	第一個參數(shù)是1，第二個是2，...
x	包含二進制參數(shù)值的 java 輸入流

Throws:

Throw名稱	Throw描述
SQLException	如果發(fā)生數(shù)據(jù)庫訪問錯誤或在關(guān)閉的 PreparedStatement 上調(diào)用此方法
SQLFeatureNotSupportedException	如果 JDBC 驅(qū)動程序不支持此方法

Since:

1.6

setBinaryStream

void setBinaryStream(String parameterName, InputStream x) throws SQLException

將指定參數(shù)設(shè)置為給定的輸入流。 當(dāng)一個非常大的二進制值輸入到 LONGVARBINARY 參數(shù)時，通過 java.io.InputStream 對象發(fā)送它可能更實際。 將根據(jù)需要從流中讀取數(shù)據(jù)，直到到達文件結(jié)尾。

注意：這個流對象可以是標(biāo)準(zhǔn)的 Java 流對象，也可以是您自己的實現(xiàn)標(biāo)準(zhǔn)接口的子類。

注意：請查閱您的 JDBC 驅(qū)動程序文檔以確定使用帶有長度參數(shù)的 setBinaryStream 版本是否更有效。

參數(shù)：

參數(shù)名稱	參數(shù)描述
parameterName	參數(shù)名稱
x	包含二進制參數(shù)值的 java 輸入流

Throws:

Throw名稱	Throw描述
SQLException	如果發(fā)生數(shù)據(jù)庫訪問錯誤或在關(guān)閉的 CallableStatement 上調(diào)用此方法
SQLFeatureNotSupportedException	如果 JDBC 驅(qū)動程序不支持此方法

Since:

1.6

setCharacterStream

void setCharacterStream(int parameterIndex, Reader reader) throws SQLException

將此 RowSet 對象的命令中的指定參數(shù)設(shè)置為給定的 Reader 對象。 當(dāng)向 LONGVARCHAR 參數(shù)輸入非常大的 UNICODE 值時，通過 java.io.Reader 對象發(fā)送它可能更實際。 將根據(jù)需要從流中讀取數(shù)據(jù)，直到到達文件結(jié)尾。 JDBC 驅(qū)動程序?qū)?zhí)行從 UNICODE 到數(shù)據(jù)庫字符格式的任何必要轉(zhuǎn)換。

注意：這個流對象可以是標(biāo)準(zhǔn)的 Java 流對象，也可以是您自己的實現(xiàn)標(biāo)準(zhǔn)接口的子類。

注意：請查閱您的 JDBC 驅(qū)動程序文檔以確定使用帶有長度參數(shù)的 setCharacterStream 版本是否更有效。

參數(shù)：

參數(shù)名稱	參數(shù)描述
parameterIndex	第一個參數(shù)是1，第二個是2，...
reader	包含 Unicode 數(shù)據(jù)的 java.io.Reader 對象

Throws:

Throw名稱	Throw描述
SQLException	如果發(fā)生數(shù)據(jù)庫訪問錯誤或在關(guān)閉的 PreparedStatement 上調(diào)用此方法
SQLFeatureNotSupportedException	如果 JDBC 驅(qū)動程序不支持此方法

Since:

1.6

setCharacterStream

void setCharacterStream(String parameterName, Reader reader) throws SQLException

將指定參數(shù)設(shè)置為給定的 Reader 對象。 當(dāng)向 LONGVARCHAR 參數(shù)輸入非常大的 UNICODE 值時，通過 java.io.Reader 對象發(fā)送它可能更實際。 將根據(jù)需要從流中讀取數(shù)據(jù)，直到到達文件結(jié)尾。 JDBC 驅(qū)動程序?qū)?zhí)行從 UNICODE 到數(shù)據(jù)庫字符格式的任何必要轉(zhuǎn)換。

注意：這個流對象可以是標(biāo)準(zhǔn)的 Java 流對象，也可以是您自己的實現(xiàn)標(biāo)準(zhǔn)接口的子類。

注意：請查閱您的 JDBC 驅(qū)動程序文檔以確定使用帶有長度參數(shù)的 setCharacterStream 版本是否更有效。

參數(shù)：

參數(shù)名稱	參數(shù)描述
parameterName	參數(shù)名稱
reader	包含 Unicode 數(shù)據(jù)的 java.io.Reader 對象

Throws:

Throw名稱	Throw描述
SQLException	如果發(fā)生數(shù)據(jù)庫訪問錯誤或在關(guān)閉的 CallableStatement 上調(diào)用此方法
SQLFeatureNotSupportedException	如果 JDBC 驅(qū)動程序不支持此方法

Since:

1.6

setNCharacterStream

void setNCharacterStream(int parameterIndex, Reader value) throws SQLException

將此 RowSet 對象的命令中的指定參數(shù)設(shè)置為 Reader 對象。 Reader 讀取數(shù)據(jù)直到到達文件末尾。 驅(qū)動程序執(zhí)行從 Java 字符格式到數(shù)據(jù)庫中國家字符集的必要轉(zhuǎn)換。

注意：這個流對象可以是標(biāo)準(zhǔn)的 Java 流對象，也可以是您自己的實現(xiàn)標(biāo)準(zhǔn)接口的子類。

注意：請參閱您的 JDBC 驅(qū)動程序文檔以確定使用帶有長度參數(shù)的 setNCharacterStream 版本是否更有效。

參數(shù)：

參數(shù)名稱	參數(shù)描述
parameterIndex	第一個參數(shù)是1，第二個是2，...
value	參數(shù)值

Throws:

Throw名稱	Throw描述
SQLException	如果驅(qū)動程序不支持國家字符集； 如果驅(qū)動程序可以檢測到可能發(fā)生數(shù)據(jù)轉(zhuǎn)換錯誤； 如果發(fā)生數(shù)據(jù)庫訪問錯誤； 或者在關(guān)閉的 PreparedStatement 上調(diào)用此方法
SQLFeatureNotSupportedException	如果 JDBC 驅(qū)動程序不支持此方法

Since:

1.6

setObject

void setObject(int parameterIndex, Object x, int targetSqlType, int scaleOrLength) throws SQLException

使用給定的 Java 對象設(shè)置此 RowSet 對象的命令中的指定參數(shù)。對于整數(shù)值，應(yīng)使用 java.lang 等效對象（例如，int 類 Integer 的實例）。如果第二個參數(shù)是 InputStream，則流必須包含 scaleOrLength 指定的字節(jié)數(shù)。如果第二個參數(shù)是 Reader，則 reader 必須包含 scaleOrLength 指定的字符數(shù)。如果這些條件不成立，則驅(qū)動程序?qū)⒃趫?zhí)行準(zhǔn)備好的語句時生成 SQLException。

給定的 Java 對象將在發(fā)送到數(shù)據(jù)庫之前轉(zhuǎn)換為 targetSqlType。

如果對象屬于實現(xiàn) SQLData 的類，則行集應(yīng)調(diào)用方法 SQLData.writeSQL 將對象寫入 SQLOutput 數(shù)據(jù)流。另一方面，如果對象屬于實現(xiàn) Ref、Blob、Clob、NClob、Struct、java.net.URL 或 Array 的類，則驅(qū)動程序應(yīng)將其作為相應(yīng) SQL 類型的值傳遞給數(shù)據(jù)庫。

請注意，此方法可用于傳遞特定于數(shù)據(jù)庫的抽象數(shù)據(jù)類型。

參數(shù)：

參數(shù)名稱	參數(shù)描述
parameterIndex	第一個參數(shù)是1，第二個是2，...
x	包含輸入?yún)?shù)值的對象
targetSqlType	要發(fā)送到數(shù)據(jù)庫的 SQL 類型（在 java.sql.Types 中定義）。 scale 參數(shù)可以進一步限定這種類型。
scaleOrLength	對于 java.sql.Types.DECIMAL 或 java.sql.Types.NUMERIC 類型，這是小數(shù)點后的位數(shù)。 對于 Java 對象類型 InputStream 和 Reader，這是流或讀取器中數(shù)據(jù)的長度。 對于所有其他類型，此值將被忽略。

Throws:

Throw名稱	Throw描述
SQLException	如果發(fā)生數(shù)據(jù)庫訪問錯誤

setObject

void setObject(String parameterName, Object x, int targetSqlType, int scale) throws SQLException

使用給定對象設(shè)置指定參數(shù)的值。 第二個參數(shù)必須是對象類型； 對于整數(shù)值，應(yīng)使用 java.lang 等效對象。

給定的 Java 對象將在發(fā)送到數(shù)據(jù)庫之前轉(zhuǎn)換為給定的 targetSqlType。 如果對象具有自定義映射（屬于實現(xiàn)接口 SQLData 的類），則 JDBC 驅(qū)動程序應(yīng)調(diào)用方法 SQLData.writeSQL 將其寫入 SQL 數(shù)據(jù)流。 另一方面，如果對象屬于實現(xiàn) Ref、Blob、Clob、NClob、Struct、java.net.URL 或 Array 的類，則驅(qū)動程序應(yīng)將其作為相應(yīng) SQL 類型的值傳遞給數(shù)據(jù)庫。

請注意，此方法可用于傳遞特定于數(shù)據(jù)庫的抽象數(shù)據(jù)類型。

參數(shù)：

參數(shù)名稱	參數(shù)描述
parameterName	參數(shù)名稱
x	包含輸入?yún)?shù)值的對象
targetSqlType	要發(fā)送到數(shù)據(jù)庫的 SQL 類型（在 java.sql.Types 中定義）。 scale 參數(shù)可以進一步限定這種類型。
scale	對于 java.sql.Types.DECIMAL 或 java.sql.Types.NUMERIC 類型，這是小數(shù)點后的位數(shù)。 對于所有其他類型，此值將被忽略。

Throws:

Throw名稱	Throw描述
SQLException	如果發(fā)生數(shù)據(jù)庫訪問錯誤或在關(guān)閉的 CallableStatement 上調(diào)用此方法
SQLFeatureNotSupportedException	如果 targetSqlType 是 ARRAY、BLOB、CLOB、DATALINK、JAVA_OBJECT、NCHAR、NCLOB、NVARCHAR、LONGNVARCHAR、REF、ROWID、SQLXML 或 STRUCT 數(shù)據(jù)類型并且 JDBC 驅(qū)動程序不支持此數(shù)據(jù)類型

Since:

1.4

setObject

void setObject(int parameterIndex, Object x, int targetSqlType) throws SQLException

使用 Java 對象設(shè)置此 RowSet 對象命令中的指定參數(shù)。 對于整數(shù)值，應(yīng)使用 java.lang 等效對象。 這個方法和上面的setObject類似，但是使用的比例是第二個參數(shù)的比例。 標(biāo)量值的比例為零。 文字值具有文字中存在的比例。

即使支持，也不建議使用浮點輸入值調(diào)用此方法。

參數(shù)：

參數(shù)名稱	參數(shù)描述
parameterIndex	第一個參數(shù)是1，第二個是2，...
x	包含輸入?yún)?shù)值的對象
targetSqlType	要發(fā)送到數(shù)據(jù)庫的 SQL 類型（在 java.sql.Types 中定義）

Throws:

Throw名稱	Throw描述
SQLException	如果發(fā)生數(shù)據(jù)庫訪問錯誤

setObject

void setObject(String parameterName, Object x, int targetSqlType) throws SQLException

使用給定對象設(shè)置指定參數(shù)的值。 此方法與上面的方法 setObject 類似，不同之處在于它假定比例為零。

參數(shù)：

參數(shù)名稱	參數(shù)描述
parameterName	參數(shù)名稱
x	包含輸入?yún)?shù)值的對象
targetSqlType	要發(fā)送到數(shù)據(jù)庫的 SQL 類型（在 java.sql.Types 中定義）

Throws:

Throw名稱	Throw描述
SQLException	如果發(fā)生數(shù)據(jù)庫訪問錯誤或在關(guān)閉的 CallableStatement 上調(diào)用此方法
SQLFeatureNotSupportedException	如果 targetSqlType 是 ARRAY、BLOB、CLOB、DATALINK、JAVA_OBJECT、NCHAR、NCLOB、NVARCHAR、LONGNVARCHAR、REF、ROWID、SQLXML 或 STRUCT 數(shù)據(jù)類型并且 JDBC 驅(qū)動程序不支持此數(shù)據(jù)類型

Since:

1.4

setObject

void setObject(String parameterName, Object x) throws SQLException

使用給定對象設(shè)置指定參數(shù)的值。第二個參數(shù)必須是 Object 類型；因此，java.lang 等效對象應(yīng)該用于內(nèi)置類型。

JDBC 規(guī)范指定了從 Java 對象類型到 SQL 類型的標(biāo)準(zhǔn)映射。給定的參數(shù)將在發(fā)送到數(shù)據(jù)庫之前轉(zhuǎn)換為相應(yīng)的 SQL 類型。

請注意，此方法可用于通過使用特定于驅(qū)動程序的 Java 類型來傳遞特定于數(shù)據(jù)庫的抽象數(shù)據(jù)類型。如果對象是實現(xiàn)接口 SQLData 的類，則 JDBC 驅(qū)動程序應(yīng)調(diào)用方法 SQLData.writeSQL 將其寫入 SQL 數(shù)據(jù)流。另一方面，如果對象屬于實現(xiàn) Ref、Blob、Clob、NClob、Struct、java.net.URL 或 Array 的類，則驅(qū)動程序應(yīng)將其作為相應(yīng) SQL 類型的值傳遞給數(shù)據(jù)庫。

如果存在歧義，例如，如果對象屬于實現(xiàn)多個上述接口的類，則此方法將引發(fā)異常。

參數(shù)：

參數(shù)名稱	參數(shù)描述
parameterName	參數(shù)名稱
x	包含輸入?yún)?shù)值的對象

Throws:

Throw名稱	Throw描述
SQLException	如果發(fā)生數(shù)據(jù)庫訪問錯誤，則在關(guān)閉的 CallableStatement 上調(diào)用此方法，或者如果給定的 Object 參數(shù)不明確
SQLFeatureNotSupportedException	如果 JDBC 驅(qū)動程序不支持此方法

Since:

1.4

setObject

void setObject(int parameterIndex, Object x) throws SQLException

使用 Java 對象設(shè)置此 RowSet 對象命令中的指定參數(shù)。 對于整數(shù)值，應(yīng)使用 java.lang 等效對象。

JDBC 規(guī)范提供了從 Java 對象類型到 SQL 類型的標(biāo)準(zhǔn)映射。 在將給定的 Java 對象發(fā)送到數(shù)據(jù)庫之前，驅(qū)動程序會將其轉(zhuǎn)換為其標(biāo)準(zhǔn) SQL 映射。

請注意，此方法可用于通過使用特定于驅(qū)動程序的 Java 類型來傳遞特定于數(shù)據(jù)庫的抽象數(shù)據(jù)類型。 如果對象屬于實現(xiàn) SQLData 的類，則行集應(yīng)調(diào)用方法 SQLData.writeSQL 將對象寫入 SQLOutput 數(shù)據(jù)流。 另一方面，如果對象屬于實現(xiàn) Ref、Blob、Clob、NClob、Struct、java.net.URL 或 Array 的類，則驅(qū)動程序應(yīng)將其作為相應(yīng) SQL 類型的值傳遞給數(shù)據(jù)庫。

如果存在歧義，則拋出異常，例如，如果對象屬于實現(xiàn)多個這些接口的類。

參數(shù)：

參數(shù)名稱	參數(shù)描述
parameterIndex	第一個參數(shù)是1，第二個是2，...
x	包含輸入?yún)?shù)值的對象

Throws:

Throw名稱	Throw描述
SQLException	如果發(fā)生數(shù)據(jù)庫訪問錯誤

setRef

void setRef(int i, Ref x) throws SQLException

使用給定的 Ref 值設(shè)置此 RowSet 對象命令中的指定參數(shù)。 驅(qū)動程序會將其轉(zhuǎn)換為適當(dāng)?shù)?REF(<structured-type>) 值。

參數(shù)：

參數(shù)名稱	參數(shù)描述
i	第一個參數(shù)是1，第二個是2，...
x	表示 SQL REF 類型數(shù)據(jù)的對象

Throws:

Throw名稱	Throw描述
SQLException	如果發(fā)生數(shù)據(jù)庫訪問錯誤

setBlob

void setBlob(int i, Blob x) throws SQLException

使用給定的 Blob 值設(shè)置此 RowSet 對象命令中的指定參數(shù)。 驅(qū)動程序?qū)⑵滢D(zhuǎn)換為 Blob 對象表示的 BLOB 值，然后再將其發(fā)送到數(shù)據(jù)庫。

參數(shù)：

參數(shù)名稱	參數(shù)描述
i	第一個參數(shù)是1，第二個是2，...
x	表示 BLOB 的對象

Throws:

Throw名稱	Throw描述
SQLException	如果發(fā)生數(shù)據(jù)庫訪問錯誤

setBlob

void setBlob(int parameterIndex, InputStream inputStream, long length) throws SQLException

將指定參數(shù)設(shè)置為 InputStream 對象。 輸入流必須包含長度指定的字符數(shù)，否則在執(zhí)行 PreparedStatement 時將生成 SQLException。 此方法與 setBinaryStream (int, InputStream, int) 方法不同，因為它通知驅(qū)動程序應(yīng)將參數(shù)值作為 BLOB 發(fā)送到服務(wù)器。 當(dāng)使用 setBinaryStream 方法時，驅(qū)動程序可能需要做額外的工作來確定參數(shù)數(shù)據(jù)應(yīng)該作為 LONGVARBINARY 還是 BLOB 發(fā)送到服務(wù)器

參數(shù)：

參數(shù)名稱	參數(shù)描述
parameterIndex	第一個參數(shù)的索引是 1，第二個是 2，...
inputStream	一個對象，其中包含要設(shè)置參數(shù)值的數(shù)據(jù)。
length	參數(shù)數(shù)據(jù)中的字節(jié)數(shù)。

Throws:

Throw名稱	Throw描述
SQLException	如果發(fā)生數(shù)據(jù)庫訪問錯誤，則在關(guān)閉的 PreparedStatement 上調(diào)用此方法，如果 parameterIndex 與 SQL 語句中的參數(shù)標(biāo)記不對應(yīng)，如果指定的長度小于零或輸入流中的字節(jié)數(shù)不匹配 指定的長度。
SQLFeatureNotSupportedException	如果 JDBC 驅(qū)動程序不支持此方法

Since:

1.6

setBlob

void setBlob(int parameterIndex, InputStream inputStream) throws SQLException

將指定參數(shù)設(shè)置為 InputStream 對象。 此方法與 setBinaryStream (int, InputStream) 方法不同，因為它通知驅(qū)動程序應(yīng)將參數(shù)值作為 BLOB 發(fā)送到服務(wù)器。 當(dāng)使用 setBinaryStream 方法時，驅(qū)動程序可能需要做額外的工作來確定參數(shù)數(shù)據(jù)應(yīng)該作為 LONGVARBINARY 還是 BLOB 發(fā)送到服務(wù)器

注意：請查閱您的 JDBC 驅(qū)動程序文檔以確定使用帶有長度參數(shù)的 setBlob 版本是否更有效。

參數(shù)：

參數(shù)名稱	參數(shù)描述
parameterIndex	第一個參數(shù)的索引是 1，第二個是 2，...
inputStream	一個對象，其中包含要設(shè)置參數(shù)值的數(shù)據(jù)。

Throws:

Throw名稱	Throw描述
SQLException	如果發(fā)生數(shù)據(jù)庫訪問錯誤，則在關(guān)閉的 PreparedStatement 上調(diào)用此方法，或者如果 parameterIndex 與 SQL 語句中的參數(shù)標(biāo)記不對應(yīng)，
SQLFeatureNotSupportedException	如果 JDBC 驅(qū)動程序不支持此方法

Since:

1.6

setBlob

void setBlob(String parameterName, InputStream inputStream, long length) throws SQLException

將指定參數(shù)設(shè)置為 InputStream 對象。 輸入流必須包含長度指定的字符數(shù)，否則執(zhí)行 CallableStatement 時會產(chǎn)生 SQLException。 此方法與 setBinaryStream (int, InputStream, int) 方法不同，因為它通知驅(qū)動程序應(yīng)將參數(shù)值作為 BLOB 發(fā)送到服務(wù)器。 當(dāng)使用 setBinaryStream 方法時，驅(qū)動程序可能需要做額外的工作來確定參數(shù)數(shù)據(jù)應(yīng)該作為 LONGVARBINARY 還是 BLOB 發(fā)送到服務(wù)器

參數(shù)：

參數(shù)名稱	參數(shù)描述
parameterName	第二個要設(shè)置的參數(shù)的名稱是2，...
inputStream	一個對象，其中包含要設(shè)置參數(shù)值的數(shù)據(jù)。
length	參數(shù)數(shù)據(jù)中的字節(jié)數(shù)。

Throws:

Throw名稱	Throw描述
SQLException	如果 parameterIndex 不對應(yīng) SQL 語句中的參數(shù)標(biāo)記，或者指定的長度小于零； 如果輸入流中的字節(jié)數(shù)與指定的長度不匹配； 如果發(fā)生數(shù)據(jù)庫訪問錯誤或在關(guān)閉的 CallableStatement 上調(diào)用此方法
SQLFeatureNotSupportedException	如果 JDBC 驅(qū)動程序不支持此方法

Since:

1.6

setBlob

void setBlob(String parameterName, Blob x) throws SQLException

將指定參數(shù)設(shè)置為給定的 java.sql.Blob 對象。 驅(qū)動程序在將其發(fā)送到數(shù)據(jù)庫時將其轉(zhuǎn)換為 SQL BLOB 值。

參數(shù)：

參數(shù)名稱	參數(shù)描述
parameterName	參數(shù)名稱
x	映射 SQL BLOB 值的 Blob 對象

Throws:

Throw名稱	Throw描述
SQLException	如果發(fā)生數(shù)據(jù)庫訪問錯誤或在關(guān)閉的 CallableStatement 上調(diào)用此方法
SQLFeatureNotSupportedException	如果 JDBC 驅(qū)動程序不支持此方法

Since:

1.6

setBlob

void setBlob(String parameterName, InputStream inputStream) throws SQLException

將指定參數(shù)設(shè)置為 InputStream 對象。 此方法與 setBinaryStream (int, InputStream) 方法不同，因為它通知驅(qū)動程序應(yīng)將參數(shù)值作為 BLOB 發(fā)送到服務(wù)器。 當(dāng)使用 setBinaryStream 方法時，驅(qū)動程序可能需要做額外的工作來確定參數(shù)數(shù)據(jù)應(yīng)該作為 LONGVARBINARY 還是 BLOB 發(fā)送到服務(wù)器

注意：請查閱您的 JDBC 驅(qū)動程序文檔以確定使用帶有長度參數(shù)的 setBlob 版本是否更有效。

參數(shù)：

參數(shù)名稱	參數(shù)描述
parameterName	參數(shù)名稱
inputStream	一個對象，其中包含要設(shè)置參數(shù)值的數(shù)據(jù)。

Throws:

Throw名稱	Throw描述
SQLException	如果發(fā)生數(shù)據(jù)庫訪問錯誤或在關(guān)閉的 CallableStatement 上調(diào)用此方法
SQLFeatureNotSupportedException	如果 JDBC 驅(qū)動程序不支持此方法

Since:

1.6

setClob

void setClob(int i, Clob x) throws SQLException

使用給定的 Clob 值設(shè)置此 RowSet 對象命令中的指定參數(shù)。 驅(qū)動程序會將其轉(zhuǎn)換為 Clob 對象表示的 CLOB 值，然后再將其發(fā)送到數(shù)據(jù)庫。

參數(shù)：

參數(shù)名稱	參數(shù)描述
i	第一個參數(shù)是1，第二個是2，...
x	表示 CLOB 的對象

Throws:

Throw名稱	Throw描述
SQLException	如果發(fā)生數(shù)據(jù)庫訪問錯誤

setClob

void setClob(int parameterIndex, Reader reader, long length) throws SQLException

將指定參數(shù)設(shè)置為 Reader 對象。 reader 必須包含 length 指定的字符數(shù)，否則執(zhí)行 PreparedStatement 時將生成 SQLException。 此方法與 setCharacterStream (int, Reader, int) 方法不同，因為它通知驅(qū)動程序應(yīng)將參數(shù)值作為 CLOB 發(fā)送到服務(wù)器。 當(dāng)使用 setCharacterStream 方法時，驅(qū)動程序可能需要做額外的工作來確定參數(shù)數(shù)據(jù)應(yīng)該作為 LONGVARCHAR 還是 CLOB 發(fā)送到服務(wù)器

參數(shù)：

參數(shù)名稱	參數(shù)描述
parameterIndex	第一個參數(shù)的索引是 1，第二個是 2，...
reader	一個對象，其中包含要設(shè)置參數(shù)值的數(shù)據(jù)。
length	參數(shù)數(shù)據(jù)中的字符數(shù)。

Throws:

Throw名稱	Throw描述
SQLException	如果發(fā)生數(shù)據(jù)庫訪問錯誤，則在關(guān)閉的 PreparedStatement 上調(diào)用此方法，如果 parameterIndex 與 SQL 語句中的參數(shù)標(biāo)記不對應(yīng)，或者指定的長度小于零。
SQLFeatureNotSupportedException	如果 JDBC 驅(qū)動程序不支持此方法

Since:

1.6

setClob

void setClob(int parameterIndex, Reader reader) throws SQLException

將指定參數(shù)設(shè)置為 Reader 對象。 此方法與 setCharacterStream (int, Reader) 方法不同，因為它通知驅(qū)動程序應(yīng)將參數(shù)值作為 CLOB 發(fā)送到服務(wù)器。 當(dāng)使用 setCharacterStream 方法時，驅(qū)動程序可能需要做額外的工作來確定參數(shù)數(shù)據(jù)應(yīng)該作為 LONGVARCHAR 還是 CLOB 發(fā)送到服務(wù)器

注意：請查閱您的 JDBC 驅(qū)動程序文檔以確定使用帶有長度參數(shù)的 setClob 版本是否更有效。

參數(shù)：

參數(shù)名稱	參數(shù)描述
parameterIndex	第一個參數(shù)的索引是 1，第二個是 2，...
reader	一個對象，其中包含要設(shè)置參數(shù)值的數(shù)據(jù)。

Throws:

Throw名稱	Throw描述
SQLException	如果發(fā)生數(shù)據(jù)庫訪問錯誤，如果 parameterIndex 與 SQL 語句中的參數(shù)標(biāo)記不對應(yīng)，則在關(guān)閉的 PreparedStatementor 上調(diào)用此方法
SQLFeatureNotSupportedException	如果 JDBC 驅(qū)動程序不支持此方法

Since:

1.6

setClob

void setClob(String parameterName, Reader reader, long length) throws SQLException

將指定參數(shù)設(shè)置為 Reader 對象。 reader 必須包含 length 指定的字符數(shù)，否則執(zhí)行 CallableStatement 時將生成 SQLException。 此方法與 setCharacterStream (int, Reader, int) 方法不同，因為它通知驅(qū)動程序應(yīng)將參數(shù)值作為 CLOB 發(fā)送到服務(wù)器。 當(dāng)使用 setCharacterStream 方法時，驅(qū)動程序可能需要做額外的工作來確定參數(shù)數(shù)據(jù)應(yīng)該作為 LONGVARCHAR 還是 CLOB 發(fā)送到服務(wù)器

參數(shù)：

參數(shù)名稱	參數(shù)描述
parameterName	要設(shè)置的參數(shù)的名稱
reader	一個對象，其中包含要設(shè)置參數(shù)值的數(shù)據(jù)。
length	參數(shù)數(shù)據(jù)中的字符數(shù)。

Throws:

Throw名稱	Throw描述
SQLException	如果 parameterIndex 不對應(yīng) SQL 語句中的參數(shù)標(biāo)記； 如果指定的長度小于零； 發(fā)生數(shù)據(jù)庫訪問錯誤或在關(guān)閉的 CallableStatement 上調(diào)用此方法
SQLFeatureNotSupportedException	如果 JDBC 驅(qū)動程序不支持此方法

Since:

1.6

setClob

void setClob(String parameterName, Clob x) throws SQLException

將指定參數(shù)設(shè)置為給定的 java.sql.Clob 對象。 驅(qū)動程序在將其發(fā)送到數(shù)據(jù)庫時將其轉(zhuǎn)換為 SQL CLOB 值。

參數(shù)：

參數(shù)名稱	參數(shù)描述
parameterName	參數(shù)名稱
x	映射 SQL CLOB 值的 Clob 對象

Throws:

Throw名稱	Throw描述
SQLException	如果發(fā)生數(shù)據(jù)庫訪問錯誤或在關(guān)閉的 CallableStatement 上調(diào)用此方法
SQLFeatureNotSupportedException	如果 JDBC 驅(qū)動程序不支持此方法

Since:

1.6

setClob

void setClob(String parameterName, Reader reader) throws SQLException

將指定參數(shù)設(shè)置為 Reader 對象。 此方法與 setCharacterStream (int, Reader) 方法不同，因為它通知驅(qū)動程序應(yīng)將參數(shù)值作為 CLOB 發(fā)送到服務(wù)器。 當(dāng)使用 setCharacterStream 方法時，驅(qū)動程序可能需要做額外的工作來確定參數(shù)數(shù)據(jù)應(yīng)該作為 LONGVARCHAR 還是 CLOB 發(fā)送到服務(wù)器

注意：請查閱您的 JDBC 驅(qū)動程序文檔以確定使用帶有長度參數(shù)的 setClob 版本是否更有效。

參數(shù)：

參數(shù)名稱	參數(shù)描述
parameterName	參數(shù)名稱
reader	一個對象，其中包含要設(shè)置參數(shù)值的數(shù)據(jù)。

Throws:

Throw名稱	Throw描述
SQLException	如果發(fā)生數(shù)據(jù)庫訪問錯誤或在關(guān)閉的 CallableStatement 上調(diào)用此方法
SQLFeatureNotSupportedException	如果 JDBC 驅(qū)動程序不支持此方法

Since:

1.6

setArray

void setArray(int i, Array x) throws SQLException

使用給定的 Array 值設(shè)置此 RowSet 對象命令中的指定參數(shù)。 驅(qū)動程序會將其轉(zhuǎn)換為 Array 對象表示的 ARRAY 值，然后再將其發(fā)送到數(shù)據(jù)庫。

參數(shù)：

參數(shù)名稱	參數(shù)描述
i	第一個參數(shù)是1，第二個是2，...
x	表示 SQL 數(shù)組的對象

Throws:

Throw名稱	Throw描述
SQLException	如果發(fā)生數(shù)據(jù)庫訪問錯誤

setDate

void setDate(int parameterIndex, Date x, Calendar cal) throws SQLException

使用給定的 java.sql.Date 值設(shè)置此 RowSet 對象命令中的指定參數(shù)。 驅(qū)動程序會將其轉(zhuǎn)換為 SQL DATE 值，使用給定的 java.util.Calendar 對象來計算日期。

參數(shù)：

參數(shù)名稱	參數(shù)描述
parameterIndex	第一個參數(shù)是1，第二個是2，...
x	參數(shù)值
cal	用于計算日期的 java.util.Calendar 對象

Throws:

Throw名稱	Throw描述
SQLException	如果發(fā)生數(shù)據(jù)庫訪問錯誤

setDate

void setDate(String parameterName, Date x) throws SQLException

使用運行應(yīng)用程序的虛擬機的默認時區(qū)將指定參數(shù)設(shè)置為給定的 java.sql.Date 值。 驅(qū)動程序在將其發(fā)送到數(shù)據(jù)庫時將其轉(zhuǎn)換為 SQL DATE 值。

參數(shù)：

參數(shù)名稱	參數(shù)描述
parameterName	參數(shù)名稱
x	參數(shù)值

Throws:

Throw名稱	Throw描述
SQLException	如果發(fā)生數(shù)據(jù)庫訪問錯誤或在關(guān)閉的 CallableStatement 上調(diào)用此方法
SQLFeatureNotSupportedException	如果 JDBC 驅(qū)動程序不支持此方法

Since:

1.4

setDate

void setDate(String parameterName, Date x, Calendar cal) throws SQLException

使用給定的 Calendar 對象將指定參數(shù)設(shè)置為給定的 java.sql.Date 值。 驅(qū)動程序使用 Calendar 對象構(gòu)造 SQL DATE 值，然后驅(qū)動程序?qū)⑵浒l(fā)送到數(shù)據(jù)庫。 使用 Calendar 對象，驅(qū)動程序可以在考慮自定義時區(qū)的情況下計算日期。 如果未指定日歷對象，則驅(qū)動程序使用默認時區(qū)，即運行應(yīng)用程序的虛擬機的時區(qū)。

參數(shù)：

參數(shù)名稱	參數(shù)描述
parameterName	參數(shù)名稱
x	參數(shù)值
cal	驅(qū)動程序?qū)⒂糜跇?gòu)造日期的 Calendar 對象

Throws:

Throw名稱	Throw描述
SQLException	如果發(fā)生數(shù)據(jù)庫訪問錯誤或在關(guān)閉的 CallableStatement 上調(diào)用此方法
SQLFeatureNotSupportedException	如果 JDBC 驅(qū)動程序不支持此方法

Since:

1.4

setTime

void setTime(int parameterIndex, Time x, Calendar cal) throws SQLException

使用給定的 java.sql.Time 值設(shè)置此 RowSet 對象命令中的指定參數(shù)。 驅(qū)動程序會將其轉(zhuǎn)換為 SQL TIME 值，使用給定的 java.util.Calendar 對象進行計算，然后將其發(fā)送到數(shù)據(jù)庫。

參數(shù)：

參數(shù)名稱	參數(shù)描述
parameterIndex	第一個參數(shù)是1，第二個是2，...
x	參數(shù)值
cal	用于計算時間的 java.util.Calendar 對象

Throws:

Throw名稱	Throw描述
SQLException	如果發(fā)生數(shù)據(jù)庫訪問錯誤

setTime

void setTime(String parameterName, Time x) throws SQLException

將指定參數(shù)設(shè)置為給定的 java.sql.Time 值。 驅(qū)動程序在將其發(fā)送到數(shù)據(jù)庫時將其轉(zhuǎn)換為 SQL TIME 值。

參數(shù)：

參數(shù)名稱	參數(shù)描述
parameterName	參數(shù)名稱
x	參數(shù)值

Throws:

Throw名稱	Throw描述
SQLException	如果發(fā)生數(shù)據(jù)庫訪問錯誤或在關(guān)閉的 CallableStatement 上調(diào)用此方法
SQLFeatureNotSupportedException	如果 JDBC 驅(qū)動程序不支持此方法

Since:

1.4

setTime

void setTime(String parameterName, Time x, Calendar cal) throws SQLException

使用給定的 Calendar 對象將指定參數(shù)設(shè)置為給定的 java.sql.Time 值。 驅(qū)動程序使用 Calendar 對象構(gòu)造 SQL TIME 值，然后驅(qū)動程序?qū)⑵浒l(fā)送到數(shù)據(jù)庫。 使用 Calendar 對象，驅(qū)動程序可以在考慮自定義時區(qū)的情況下計算時間。 如果未指定日歷對象，則驅(qū)動程序使用默認時區(qū)，即運行應(yīng)用程序的虛擬機的時區(qū)。

參數(shù)：

參數(shù)名稱	參數(shù)描述
parameterName	參數(shù)名稱
x	參數(shù)值
cal	驅(qū)動程序?qū)⒂糜跇?gòu)造時間的 Calendar 對象

Throws:

Throw名稱	Throw描述
SQLException	如果發(fā)生數(shù)據(jù)庫訪問錯誤或在關(guān)閉的 CallableStatement 上調(diào)用此方法
SQLFeatureNotSupportedException	如果 JDBC 驅(qū)動程序不支持此方法

Since:

1.4

setTimestamp

void setTimestamp(int parameterIndex, Timestamp x, Calendar cal) throws SQLException

使用給定的 java.sql.Timestamp 值設(shè)置此 RowSet 對象命令中的指定參數(shù)。 驅(qū)動程序會將其轉(zhuǎn)換為 SQL TIMESTAMP 值，使用給定的 java.util.Calendar 對象進行計算，然后將其發(fā)送到數(shù)據(jù)庫。

參數(shù)：

參數(shù)名稱	參數(shù)描述
parameterIndex	第一個參數(shù)是1，第二個是2，...
x	參數(shù)值
cal	用于計算時間戳的 java.util.Calendar 對象

Throws:

Throw名稱	Throw描述
SQLException	如果發(fā)生數(shù)據(jù)庫訪問錯誤

setTimestamp

void setTimestamp(String parameterName, Timestamp x, Calendar cal) throws SQLException

使用給定的 Calendar 對象將指定參數(shù)設(shè)置為給定的 java.sql.Timestamp 值。 驅(qū)動程序使用日歷對象構(gòu)造一個 SQL TIMESTAMP 值，然后驅(qū)動程序?qū)⑵浒l(fā)送到數(shù)據(jù)庫。 使用 Calendar 對象，驅(qū)動程序可以在考慮自定義時區(qū)的情況下計算時間戳。 如果未指定日歷對象，則驅(qū)動程序使用默認時區(qū)，即運行應(yīng)用程序的虛擬機的時區(qū)。

參數(shù)：

參數(shù)名稱	參數(shù)描述
parameterName	參數(shù)名稱
x	參數(shù)值
cal	驅(qū)動程序?qū)⒂糜跇?gòu)造時間戳的 Calendar 對象

Throws:

Throw名稱	Throw描述
SQLException	如果發(fā)生數(shù)據(jù)庫訪問錯誤或在關(guān)閉的 CallableStatement 上調(diào)用此方法
SQLFeatureNotSupportedException	如果 JDBC 驅(qū)動程序不支持此方法

Since:

1.4

clearParameters

void clearParameters() throws SQLException

清除為此 RowSet 對象的命令設(shè)置的參數(shù)。

通常，對于 RowSet 對象的重復(fù)使用，參數(shù)值仍然有效。 設(shè)置參數(shù)值會自動清除其先前的值。 但是，在某些情況下，立即釋放當(dāng)前參數(shù)值使用的資源是有用的，這可以通過調(diào)用方法 clearParameters 來完成。

Throws:

Throw名稱	Throw描述
SQLException	如果發(fā)生數(shù)據(jù)庫訪問錯誤

execute

void execute() throws SQLException

用數(shù)據(jù)填充此 RowSet 對象。

execute 方法可以使用以下屬性來創(chuàng)建讀取數(shù)據(jù)的連接：url、數(shù)據(jù)源名稱、用戶名、密碼、事務(wù)隔離和類型映射。 execute 方法可以使用以下屬性來創(chuàng)建執(zhí)行命令的語句：命令、只讀、最大字段大小、最大行數(shù)、轉(zhuǎn)義處理和查詢超時。

如果尚未設(shè)置所需的屬性，則會引發(fā)異常。 如果此方法成功，行集的當(dāng)前內(nèi)容將被丟棄，并且行集的元數(shù)據(jù)也被（重新）設(shè)置。 如果有未完成的更新，它們將被忽略。

如果此 RowSet 對象不保持與其數(shù)據(jù)源的連續(xù)連接，則它可以使用讀取器（RowSetReader 對象）向自身填充數(shù)據(jù)。 在這種情況下，讀取器將已注冊到此 RowSet 對象，并且方法 execute 將調(diào)用讀取器的 readData 方法作為其實現(xiàn)的一部分。

Throws:

Throw名稱	Throw描述
SQLException	如果發(fā)生數(shù)據(jù)庫訪問錯誤或未設(shè)置建立連接和創(chuàng)建語句所需的任何屬性

addRowSetListener

void addRowSetListener(RowSetListener listener)

注冊給定的偵聽器，以便將在此 RowSet 對象上發(fā)生的事件通知它。

參數(shù)：

參數(shù)名稱	參數(shù)描述
listener	已實現(xiàn) RowSetListener 接口并希望在此 RowSet 對象上發(fā)生事件時收到通知的組件

removeRowSetListener

void removeRowSetListener(RowSetListener listener)

當(dāng)此 RowSet 對象上發(fā)生事件時，從將通知的組件列表中刪除指定的偵聽器。

參數(shù)：

參數(shù)名稱	參數(shù)描述
listener	已注冊為此 RowSet 對象的偵聽器的組件

setSQLXML

void setSQLXML(int parameterIndex, SQLXML xmlObject) throws SQLException

將指定參數(shù)設(shè)置為給定的 java.sql.SQLXML 對象。 驅(qū)動程序在將其發(fā)送到數(shù)據(jù)庫時將其轉(zhuǎn)換為 SQL XML 值。

參數(shù)：

參數(shù)名稱	參數(shù)描述
parameterIndex	第一個參數(shù)的索引是 1，第二個是 2，...
xmlObject	映射 SQL XML 值的 SQLXML 對象

Throws:

Throw名稱	Throw描述
SQLException	如果發(fā)生數(shù)據(jù)庫訪問錯誤，則在關(guān)閉的結(jié)果集上調(diào)用此方法，Java.xml.transform.Result、Writer 或 OutputStream 尚未為 SQLXML 對象關(guān)閉，或者在處理 XML 值時出現(xiàn)錯誤。 異常的 getCause 方法可能會提供更詳細的異常，例如，如果流不包含有效的 XML。

Since:

1.6

setSQLXML

void setSQLXML(String parameterName, SQLXML xmlObject) throws SQLException

將指定參數(shù)設(shè)置為給定的 java.sql.SQLXML 對象。 驅(qū)動程序在將其發(fā)送到數(shù)據(jù)庫時將其轉(zhuǎn)換為 SQL XML 值。

參數(shù)：

參數(shù)名稱	參數(shù)描述
parameterName	參數(shù)名稱
xmlObject	映射 SQL XML 值的 SQLXML 對象

Throws:

Throw名稱	Throw描述
SQLException	如果發(fā)生數(shù)據(jù)庫訪問錯誤，則在關(guān)閉的結(jié)果集上調(diào)用此方法，Java.xml.transform.Result、Writer 或 OutputStream 尚未為 SQLXML 對象關(guān)閉，或者在處理 XML 值時出現(xiàn)錯誤。 異常的 getCause 方法可能會提供更詳細的異常，例如，如果流不包含有效的 XML。

Since:

1.6

setRowId

void setRowId(int parameterIndex, RowId x) throws SQLException

將指定參數(shù)設(shè)置為給定的 java.sql.RowId 對象。 驅(qū)動程序在將其發(fā)送到數(shù)據(jù)庫時將其轉(zhuǎn)換為 SQL ROWID 值

參數(shù)：

參數(shù)名稱	參數(shù)描述
parameterIndex	第一個參數(shù)是1，第二個是2，...
x	參數(shù)值

Throws:

Throw名稱	Throw描述
SQLException	如果發(fā)生數(shù)據(jù)庫訪問錯誤

Since:

1.6

setRowId

void setRowId(String parameterName, RowId x) throws SQLException

將指定參數(shù)設(shè)置為給定的 java.sql.RowId 對象。 驅(qū)動程序在將其發(fā)送到數(shù)據(jù)庫時將其轉(zhuǎn)換為 SQL ROWID。

參數(shù)：

參數(shù)名稱	參數(shù)描述
parameterName	參數(shù)名稱
x	參數(shù)值

Throws:

Throw名稱	Throw描述
SQLException	如果發(fā)生數(shù)據(jù)庫訪問錯誤

Since:

1.6

setNString

void setNString(int parameterIndex, String value) throws SQLException

將指定參數(shù)設(shè)置為給定的 String 對象。 驅(qū)動程序在將其發(fā)送到數(shù)據(jù)庫時將其轉(zhuǎn)換為 SQL NCHAR 或 NVARCHAR 或 LONGNVARCHAR 值（取決于參數(shù)的大小相對于驅(qū)動程序?qū)?NVARCHAR 值的限制）。

參數(shù)：

參數(shù)名稱	參數(shù)描述
parameterIndex	第一個參數(shù)是1，第二個是2，...
value	參數(shù)值

Throws:

Throw名稱	Throw描述
SQLException	如果驅(qū)動程序不支持國家字符集； 如果驅(qū)動程序可以檢測到可能發(fā)生數(shù)據(jù)轉(zhuǎn)換錯誤； 或者如果發(fā)生數(shù)據(jù)庫訪問錯誤

Since:

1.6

setNString

void setNString(String parameterName, String value) throws SQLException

將指定參數(shù)設(shè)置為給定的 String 對象。 驅(qū)動程序?qū)⑵滢D(zhuǎn)換為 SQL NCHAR 或 NVARCHAR 或 LONGNVARCHAR

參數(shù)：

參數(shù)名稱	參數(shù)描述
parameterName	要設(shè)置的列的名稱
value	參數(shù)值

Throws:

Throw名稱	Throw描述
SQLException	如果驅(qū)動程序不支持國家字符集； 如果驅(qū)動程序可以檢測到可能發(fā)生數(shù)據(jù)轉(zhuǎn)換錯誤； 或者如果發(fā)生數(shù)據(jù)庫訪問錯誤

Since:

1.6

setNCharacterStream

void setNCharacterStream(int parameterIndex, Reader value, long length) throws SQLException

將指定參數(shù)設(shè)置為 Reader 對象。 Reader 讀取數(shù)據(jù)直到到達文件末尾。 驅(qū)動程序執(zhí)行從 Java 字符格式到數(shù)據(jù)庫中國家字符集的必要轉(zhuǎn)換。

參數(shù)：

參數(shù)名稱	參數(shù)描述
parameterIndex	第一個參數(shù)是1，第二個是2，...
value	參數(shù)值
length	參數(shù)數(shù)據(jù)中的字符數(shù)。

Throws:

Throw名稱	Throw描述
SQLException	如果驅(qū)動程序不支持國家字符集； 如果驅(qū)動程序可以檢測到可能發(fā)生數(shù)據(jù)轉(zhuǎn)換錯誤； 或者如果發(fā)生數(shù)據(jù)庫訪問錯誤

Since:

1.6

setNCharacterStream

void setNCharacterStream(String parameterName, Reader value, long length) throws SQLException

將指定參數(shù)設(shè)置為 Reader 對象。 Reader 讀取數(shù)據(jù)直到到達文件末尾。 驅(qū)動程序執(zhí)行從 Java 字符格式到數(shù)據(jù)庫中國家字符集的必要轉(zhuǎn)換。

參數(shù)：

參數(shù)名稱	參數(shù)描述
parameterName	要設(shè)置的列的名稱
value	參數(shù)值
length	參數(shù)數(shù)據(jù)中的字符數(shù)。

Throws:

Throw名稱	Throw描述
SQLException	如果驅(qū)動程序不支持國家字符集； 如果驅(qū)動程序可以檢測到可能發(fā)生數(shù)據(jù)轉(zhuǎn)換錯誤； 或者如果發(fā)生數(shù)據(jù)庫訪問錯誤

Since:

1.6

setNCharacterStream

void setNCharacterStream(String parameterName, Reader value) throws SQLException

將指定參數(shù)設(shè)置為 Reader 對象。 Reader 讀取數(shù)據(jù)直到到達文件末尾。 驅(qū)動程序執(zhí)行從 Java 字符格式到數(shù)據(jù)庫中國家字符集的必要轉(zhuǎn)換。

注意：這個流對象可以是標(biāo)準(zhǔn)的 Java 流對象，也可以是您自己的實現(xiàn)標(biāo)準(zhǔn)接口的子類。

注意：請參閱您的 JDBC 驅(qū)動程序文檔以確定使用帶有長度參數(shù)的 setNCharacterStream 版本是否更有效。

參數(shù)：

參數(shù)名稱	參數(shù)描述
parameterName	參數(shù)名稱
value	參數(shù)值

Throws:

Throw名稱	Throw描述
SQLException	如果驅(qū)動程序不支持國家字符集； 如果驅(qū)動程序可以檢測到可能發(fā)生數(shù)據(jù)轉(zhuǎn)換錯誤； 如果發(fā)生數(shù)據(jù)庫訪問錯誤； 或者在關(guān)閉的 CallableStatement 上調(diào)用此方法
SQLFeatureNotSupportedException	如果 JDBC 驅(qū)動程序不支持此方法

Since:

1.6

setNClob

void setNClob(String parameterName, NClob value) throws SQLException

將指定參數(shù)設(shè)置為 java.sql.NClob 對象。 該對象實現(xiàn)了 java.sql.NClob 接口。 此 NClob 對象映射到 SQL NCLOB。

參數(shù)：

參數(shù)名稱	參數(shù)描述
parameterName	要設(shè)置的列的名稱
value	參數(shù)值

Throws:

Throw名稱	Throw描述
SQLException	如果驅(qū)動程序不支持國家字符集； 如果驅(qū)動程序可以檢測到可能發(fā)生數(shù)據(jù)轉(zhuǎn)換錯誤； 或者如果發(fā)生數(shù)據(jù)庫訪問錯誤

Since:

1.6

setNClob

void setNClob(String parameterName, Reader reader, long length) throws SQLException

將指定參數(shù)設(shè)置為 Reader 對象。 reader 必須包含 length 指定的字符數(shù)，否則執(zhí)行 CallableStatement 時將生成 SQLException。 此方法與 setCharacterStream (int, Reader, int) 方法不同，因為它通知驅(qū)動程序應(yīng)將參數(shù)值作為 NCLOB 發(fā)送到服務(wù)器。 當(dāng)使用 setCharacterStream 方法時，驅(qū)動程序可能需要做額外的工作來確定參數(shù)數(shù)據(jù)應(yīng)該作為 LONGNVARCHAR 還是 NCLOB 發(fā)送到服務(wù)器

參數(shù)：

參數(shù)名稱	參數(shù)描述
parameterName	要設(shè)置的參數(shù)的名稱
reader	一個對象，其中包含要設(shè)置參數(shù)值的數(shù)據(jù)。
length	參數(shù)數(shù)據(jù)中的字符數(shù)。

Throws:

Throw名稱	Throw描述
SQLException	如果 parameterIndex 不對應(yīng) SQL 語句中的參數(shù)標(biāo)記； 如果指定的長度小于零； 如果驅(qū)動程序不支持國家字符集； 如果驅(qū)動程序可以檢測到可能發(fā)生數(shù)據(jù)轉(zhuǎn)換錯誤； 如果發(fā)生數(shù)據(jù)庫訪問錯誤或在關(guān)閉的 CallableStatement 上調(diào)用此方法
SQLFeatureNotSupportedException	如果 JDBC 驅(qū)動程序不支持此方法

Since:

1.6

setNClob

void setNClob(String parameterName, Reader reader) throws SQLException

將指定參數(shù)設(shè)置為 Reader 對象。 此方法與 setCharacterStream (int, Reader) 方法不同，因為它通知驅(qū)動程序應(yīng)將參數(shù)值作為 NCLOB 發(fā)送到服務(wù)器。 當(dāng)使用 setCharacterStream 方法時，驅(qū)動程序可能需要做額外的工作來確定參數(shù)數(shù)據(jù)應(yīng)該作為 LONGNVARCHAR 還是 NCLOB 發(fā)送到服務(wù)器

注意：請查閱您的 JDBC 驅(qū)動程序文檔以確定使用帶有長度參數(shù)的 setNClob 版本是否更有效。

參數(shù)：

參數(shù)名稱	參數(shù)描述
parameterName	參數(shù)名稱
reader	一個對象，其中包含要設(shè)置參數(shù)值的數(shù)據(jù)。

Throws:

Throw名稱	Throw描述
SQLException	如果驅(qū)動程序不支持國家字符集； 如果驅(qū)動程序可以檢測到可能發(fā)生數(shù)據(jù)轉(zhuǎn)換錯誤； 如果發(fā)生數(shù)據(jù)庫訪問錯誤或在關(guān)閉的 CallableStatement 上調(diào)用此方法
SQLFeatureNotSupportedException	如果 JDBC 驅(qū)動程序不支持此方法

Since:

1.6

setNClob

void setNClob(int parameterIndex, Reader reader, long length) throws SQLException

將指定參數(shù)設(shè)置為 Reader 對象。 reader 必須包含 length 指定的字符數(shù)，否則執(zhí)行 PreparedStatement 時將生成 SQLException。 此方法與 setCharacterStream (int, Reader, int) 方法不同，因為它通知驅(qū)動程序應(yīng)將參數(shù)值作為 NCLOB 發(fā)送到服務(wù)器。 當(dāng)使用 setCharacterStream 方法時，驅(qū)動程序可能需要做額外的工作來確定參數(shù)數(shù)據(jù)應(yīng)該作為 LONGNVARCHAR 還是 NCLOB 發(fā)送到服務(wù)器

參數(shù)：

參數(shù)名稱	參數(shù)描述
parameterIndex	第一個參數(shù)的索引是 1，第二個是 2，...
reader	一個對象，其中包含要設(shè)置參數(shù)值的數(shù)據(jù)。
length	參數(shù)數(shù)據(jù)中的字符數(shù)。

Throws:

Throw名稱	Throw描述
SQLException	如果 parameterIndex 不對應(yīng) SQL 語句中的參數(shù)標(biāo)記； 如果指定的長度小于零； 如果驅(qū)動程序不支持國家字符集； 如果驅(qū)動程序可以檢測到可能發(fā)生數(shù)據(jù)轉(zhuǎn)換錯誤； 如果發(fā)生數(shù)據(jù)庫訪問錯誤或在關(guān)閉的 PreparedStatement 上調(diào)用此方法
SQLFeatureNotSupportedException	如果 JDBC 驅(qū)動程序不支持此方法

Since:

1.6

setNClob

void setNClob(int parameterIndex, NClob value) throws SQLException

將指定參數(shù)設(shè)置為 java.sql.NClob 對象。 驅(qū)動程序在將其發(fā)送到數(shù)據(jù)庫時將其轉(zhuǎn)換為 SQL NCLOB 值。

參數(shù)：

參數(shù)名稱	參數(shù)描述
parameterIndex	第一個參數(shù)是1，第二個是2，...
value	參數(shù)值

Throws:

Throw名稱	Throw描述
SQLException	如果驅(qū)動程序不支持國家字符集； 如果驅(qū)動程序可以檢測到可能發(fā)生數(shù)據(jù)轉(zhuǎn)換錯誤； 或者如果發(fā)生數(shù)據(jù)庫訪問錯誤

Since:

1.6

setNClob

void setNClob(int parameterIndex, Reader reader) throws SQLException

將指定參數(shù)設(shè)置為 Reader 對象。 此方法與 setCharacterStream (int, Reader) 方法不同，因為它通知驅(qū)動程序應(yīng)將參數(shù)值作為 NCLOB 發(fā)送到服務(wù)器。 當(dāng)使用 setCharacterStream 方法時，驅(qū)動程序可能需要做額外的工作來確定參數(shù)數(shù)據(jù)應(yīng)該作為 LONGNVARCHAR 還是 NCLOB 發(fā)送到服務(wù)器

注意：請查閱您的 JDBC 驅(qū)動程序文檔以確定使用帶有長度參數(shù)的 setNClob 版本是否更有效。

參數(shù)：

參數(shù)名稱	參數(shù)描述
parameterIndex	第一個參數(shù)的索引是 1，第二個是 2，...
reader	一個對象，其中包含要設(shè)置參數(shù)值的數(shù)據(jù)。

Throws:

Throw名稱	Throw描述
SQLException	如果 parameterIndex 不對應(yīng) SQL 語句中的參數(shù)標(biāo)記； 如果驅(qū)動程序不支持國家字符集； 如果驅(qū)動程序可以檢測到可能發(fā)生數(shù)據(jù)轉(zhuǎn)換錯誤； 如果發(fā)生數(shù)據(jù)庫訪問錯誤或在關(guān)閉的 PreparedStatement 上調(diào)用此方法
SQLFeatureNotSupportedException	如果 JDBC 驅(qū)動程序不支持此方法

Since:

1.6

setURL

void setURL(int parameterIndex, URL x) throws SQLException

將指定參數(shù)設(shè)置為給定的 java.net.URL 值。 驅(qū)動程序在將其發(fā)送到數(shù)據(jù)庫時將其轉(zhuǎn)換為 SQL DATALINK 值。

參數(shù)：

參數(shù)名稱	參數(shù)描述
parameterIndex	第一個參數(shù)是1，第二個是2，...
x	要設(shè)置的 java.net.URL 對象

Throws:

Throw名稱	Throw描述
SQLException	如果發(fā)生數(shù)據(jù)庫訪問錯誤或在關(guān)閉的 PreparedStatement 上調(diào)用此方法
SQLFeatureNotSupportedException	如果 JDBC 驅(qū)動程序不支持此方法

Since:

1.4