インタフェースRowSet

すべてのスーパー・インタフェース:

AutoCloseable, ResultSet, Wrapper

既知のすべてのサブインタフェース:

CachedRowSet, FilteredRowSet, JdbcRowSet, JoinRowSet, SyncResolver, WebRowSet

public interface RowSet extends ResultSet

JavaBeansコンポーネント・モデルのJDBC APIへのサポートを追加するインタフェース。 行セットはビジュアルなBean開発環境でJavaBeansコンポーネントとして使用できます。また、設計時に作成および構成が行われ、実行時に実行されます。

RowSetインタフェースではJavaBeansプロパティの組を提供します。これらのプロパティによって、RowSetインスタンスがJDBCデータ・ソースに接続し、そのデータ・ソースからデータを読み取るように構成できます。 値を設定するメソッド(setInt、setBytes、setStringなど)では、入力パラメータを行セットのコマンド・プロパティに渡す方法を提供します。 このコマンドは、行セットが通常は関係データベースから自身のデータを取得するときに使用するSQLクエリーです。

RowSetインタフェースではJavaBeansイベントをサポートしており、行セットにイベントが発生したとき(値の変更など)に、アプリケーションのほかのコンポーネントに通知することができます。

JDBC APIのほかの部分を使用して実装するようにしている点で、RowSetインタフェースは独特です。 言い換えると、RowSetの実装とは、JDBCドライバの最上部で実行されるソフトウェアのレイヤーです。 RowSetインタフェースの実装は、JDBC製品の一部としてRowSetの実装を提供しようとするJDBCドライバ・ベンダーを始めとして、誰でも提供できます。

RowSetオブジェクトでは、データ・ソースとの接続を作成し、オブジェクトのライフ・サイクルを通じてその接続を保持します。このような場合、接続された行セットと呼ばれます。 また、行セットはデータ・ソースと接続してデータを取得し、接続を閉じることもできます。 そのような行セットは未接続の行セットと呼ばれます。 未接続の行セットでは、未接続中にデータに変更を加えてから、データの元のソースに変更を送り戻すことができます。しかし、そのためには接続をもう一度確立する必要があります。

切断された行セットには、Reader (RowSetReaderオブジェクト)とライター(RowSetWriterオブジェクト)が関連付けられている場合があります。 Readerは、非リレーショナル・データ・ソースからのデータの取得など、行セットにデータを移入するために様々な方法で実装できます。 ライターもまたさまざまな方法で実装されており、行セットのデータに加えられた変更を基本となるデータ・ソースへ送り戻すことができます。

行セットを使用するのは簡単です。 RowSetインタフェースは標準java.sql.ResultSetインタフェースを拡張したものです。 RowSetMetaDataインタフェースはjava.sql.ResultSetMetaDataインタフェースを拡張したものです。 それにより、JDBC APIに精通している開発者が行セットを使うためには、最小限の新しいAPIを覚えれば済みます。 さらに、JDBC ResultSetオブジェクトとともに動作するサード・パーティ製のソフトウェア・ツールを、行セットを使用して動作するようにすることも簡単にできます。

導入されたバージョン:

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オブジェクトのcommandプロパティを取得します。
String	getDataSourceName()	このRowSetオブジェクトのデータ・ソースを特定する論理名を取得します。
boolean	getEscapeProcessing()	このRowSetオブジェクトのエスケープの処理が有効かどうかを取得します。
int	getMaxFieldSize()	ある列値で返される最大バイト数を取得します。
int	getMaxRows()	このRowSetオブジェクトに含めることのできる最大行数を取得します。
String	getPassword()	データベース接続の作成に使用するパスワードを取得します。
int	getQueryTimeout()	ドライバが文の実行を待つ最大秒数を取得します。
int	getTransactionIsolation()	このRowSetオブジェクトのトランザクション遮断レベルの設定を取得します。
Map<String,Class<?>>	getTypeMap()	このRowSetオブジェクトに関連付けられたSQLユーザー定義型のカスタム・マッピングがある場合には、それを指定するMapオブジェクトを取得します。
String	getUrl()	このRowSetオブジェクトが接続を確立するのにDataSourceオブジェクトではなくDriverManagerを使用する場合に、接続を作成するために使用するurlプロパティを取得します。
String	getUsername()	このRowSetオブジェクトのデータベース接続を作成するために使用されるusernameを取得します。
boolean	isReadOnly()	このRowSetオブジェクトが読取り専用かどうかを確認します。
void	removeRowSetListener(RowSetListener listener)	指定したリスナーを、このRowSetオブジェクトでイベントが発生したときに通知されるコンポーネントのリストから削除します。
void	setArray(int i, Array x)	このRowSetオブジェクトのコマンドで指定したパラメータを、指定したArray値に設定します。
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.BigDecimal値に設定します。
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 parameterIndex, InputStream inputStream)	指定されたパラメータをInputStreamオブジェクトに設定します。
void	setBlob(int parameterIndex, InputStream inputStream, long length)	指定されたパラメータをInputStreamオブジェクトに設定します。
void	setBlob(int i, Blob x)	このRowSetオブジェクトのコマンドで指定したパラメータを、指定したBlob値に設定します。
void	setBlob(String parameterName, InputStream inputStream)	指定されたパラメータをInputStreamオブジェクトに設定します。
void	setBlob(String parameterName, InputStream inputStream, long length)	指定されたパラメータをInputStreamオブジェクトに設定します。
void	setBlob(String parameterName, Blob x)	指定されたパラメータを指定されたjava.sql.Blobオブジェクトに設定します。
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オブジェクトのコマンド内の指定したパラメータを、byte値の指定したJava配列値に設定します。
void	setBytes(String parameterName, byte[] x)	指定されたパラメータを指定されたJavaのバイト配列に設定します。
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 parameterIndex, Reader reader)	指定されたパラメータをReaderオブジェクトに設定します。
void	setClob(int parameterIndex, Reader reader, long length)	指定されたパラメータをReaderオブジェクトに設定します。
void	setClob(int i, Clob x)	このRowSetオブジェクトのコマンドで指定したパラメータを、指定したClob値に設定します。
void	setClob(String parameterName, Reader reader)	指定されたパラメータをReaderオブジェクトに設定します。
void	setClob(String parameterName, Reader reader, long length)	指定されたパラメータをReaderオブジェクトに設定します。
void	setClob(String parameterName, Clob x)	指定されたパラメータを指定されたjava.sql.Clobオブジェクトに設定します。
void	setCommand(String cmd)	このRowSetオブジェクトのcommandプロパティに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)	このRowSetオブジェクトのコマンドで指定したパラメータを、指定したjava.sql.Date値に設定します。
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, Reader reader)	指定されたパラメータをReaderオブジェクトに設定します。
void	setNClob(int parameterIndex, Reader reader, long length)	指定されたパラメータをReaderオブジェクトに設定します。
void	setNClob(int parameterIndex, NClob value)	指定されたパラメータをjava.sql.NClobオブジェクトに設定します。
void	setNClob(String parameterName, Reader reader)	指定されたパラメータをReaderオブジェクトに設定します。
void	setNClob(String parameterName, Reader reader, long length)	指定されたパラメータをReaderオブジェクトに設定します。
void	setNClob(String parameterName, NClob value)	指定されたパラメータをjava.sql.NClobオブジェクトに設定します。
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)	このRowSetオブジェクトのコマンド内の指定したパラメータを、Java Objectに設定します。
void	setObject(int parameterIndex, Object x, int targetSqlType)	このRowSetオブジェクトのコマンド内の指定したパラメータを、Java Objectに設定します。
void	setObject(int parameterIndex, Object x, int targetSqlType, int scaleOrLength)	このRowSetオブジェクトのコマンド内の指定したパラメータを、指定したJava Objectに設定します。
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)	このRowSetオブジェクトのコマンドで指定したパラメータを、指定したRef値に設定します。
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)	このRowSetオブジェクトのコマンドで指定したパラメータを、指定したjava.sql.Time値に設定します。
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)	このRowSetオブジェクトのコマンドで指定したパラメータを、指定したjava.sql.Timestamp値に設定します。
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)	このRowSetオブジェクトのデフォルトの型マップとして指定されたjava.util.Mapオブジェクトをインストールします。
void	setUrl(String url)	このRowSetオブジェクトがDriverManagerを使って接続を作成するときに使用するURLを設定します。
void	setURL(int parameterIndex, URL x)	指定されたパラメータを、指定されたjava.net.URL値に設定します。
void	setUsername(String name)	このRowSetオブジェクトのusernameプロパティを、指定した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, 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, 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オブジェクトが接続を確立するのにDataSourceオブジェクトではなくDriverManagerを使用する場合に、接続を作成するために使用するurlプロパティを取得します。 デフォルト値はnullです。

戻り値:

URLを表す文字列

例外:

SQLException - データベース・アクセス・エラーが発生した場合

関連項目:

• setUrl(java.lang.String)

setUrl

void setUrl(String url) throws SQLException

このRowSetオブジェクトがDriverManagerを使って接続を作成するときに使用するURLを設定します。 このプロパティの設定はオプションです。 URLを使用する場合は、データベースへの接続に行セットが使用される前に、そのURLを受け入れるJDBCドライバをロードします。 行セットでは、データを読み書きするときに、この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オブジェクトのデータベース接続を作成するために使用されるusernameを取得します。 usernameプロパティは、実行時にexecuteメソッドを呼び出す前に設定されます。 通常、これはRowSetオブジェクトの直列化状態の一部ではありません。

戻り値:

usernameプロパティ

関連項目:

• setUsername(java.lang.String)

setUsername

void setUsername(String name) throws SQLException

このRowSetオブジェクトのusernameプロパティを、指定したStringに設定します。

パラメータ:

name - ユーザー名

例外:

SQLException - データベース・アクセス・エラーが発生した場合

関連項目:

• getUsername()

getPassword

String getPassword()

データベース接続の作成に使用するパスワードを取得します。 passwordプロパティは、実行時に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のうちの1つ

関連項目:

• 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のうちの1つ

例外:

SQLException - データベース・アクセス・エラーが発生した場合

関連項目:

• getTransactionIsolation()

getTypeMap

Map<String,Class<?>> getTypeMap() throws SQLException

このRowSetオブジェクトに関連付けられたSQLユーザー定義型のカスタム・マッピングがある場合には、それを指定するMapオブジェクトを取得します。 型マップのデフォルトは空です。

戻り値:

SQLユーザー定義型とそれらがマッピングされるJavaクラスが格納されているjava.util.Mapオブジェクト

例外:

SQLException - データベース・アクセス・エラーが発生した場合

関連項目:

• setTypeMap(java.util.Map<java.lang.String, java.lang.Class<?>>)

setTypeMap

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

このRowSetオブジェクトのデフォルトの型マップとして指定されたjava.util.Mapオブジェクトをインストールします。 別の型マップがメソッドのパラメータとして指定されるまで、この型マップが使用されます。

パラメータ:

map - SQLユーザー定義型とそれらがマッピングされるJavaクラスが格納されているjava.util.Mapオブジェクト

例外:

SQLException - データベース・アクセス・エラーが発生した場合

関連項目:

• getTypeMap()

getCommand

String getCommand()

このRowSetオブジェクトのcommandプロパティを取得します。 commandプロパティには、SQLクエリーであるコマンド文字列が格納されます。これは、行セットにデータを格納するために実行されます。 デフォルト値はnullです。

戻り値:

コマンド文字列。nullも可

関連項目:

• setCommand(java.lang.String)

setCommand

void setCommand(String cmd) throws SQLException

このRowSetオブジェクトのcommandプロパティにSQLクエリーを設定します。 行セットがコマンドをサポートしないデータ・ソースからデータを得る場合(スプレッドシートなど)、このプロパティはオプションです。

パラメータ:

cmd - このRowSetオブジェクトのデータを取得するために使用されるSQLクエリー。nullも可

例外:

SQLException - データベース・アクセス・エラーが発生した場合

関連項目:

• getCommand()

isReadOnly

boolean isReadOnly()

この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の各列だけに適用されます。 制限値を超えたデータは通知なしに破棄されます。

戻り値:

現在の最大列サイズ制限値。0は制限がないことを表す

例外:

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オブジェクトの型を、指定した型に設定します。 このメソッドは、デフォルトで読取り専用でスクロール不可の行セットの型を変更するために用いられます。

パラメータ:

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オブジェクトの並行性を、指定した並行性レベルに設定します。 このメソッドは、デフォルトで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番目のパラメータは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に設定します。 SQLユーザー定義型(UDT)およびREF型のパラメータでは、このバージョンのsetNullメソッドを使用する必要があります。 UDTの例には、STRUCT、DISTINCT、JAVA_OBJECT、および名前付き配列があります。

ノート: 移植性を実現するためには、アプリケーションはNULLのユーザー定義パラメータまたはREFパラメータを指定するときにSQL型コードおよび完全指定のSQL型名を指定しなければいけません。 ユーザー定義型の場合、名前はパラメータ自体の型名です。 REFパラメータの場合、名前は参照される型の型名です。 JDBCドライバが型コードまたは型名の情報を必要としない場合、それは無視されます。 UDTおよびREFパラメータを対象としていますが、このメソッドは任意のJDBC型のnullパラメータを設定するために使用できます。 パラメータがユーザー定義の型またはREF型を持たない場合、typeNameパラメータは無視されます。

パラメータ:

paramIndex - 最初のパラメータは1、2番目のパラメータは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に設定します。 ユーザー定義型およびREF型のパラメータでは、このバージョンのsetNullメソッドを使用するべきです。 ユーザー定義型の例には、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番目のパラメータは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番目のパラメータは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番目のパラメータは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番目のパラメータは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番目のパラメータは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番目のパラメータは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番目のパラメータは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.BigDecimal値に設定します。 このパラメータは、データベースに送信される前に、ドライバによってSQL NUMERIC値に変換されます。

パラメータ:

parameterIndex - 最初のパラメータは1、2番目のパラメータは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番目のパラメータは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オブジェクトのコマンド内の指定したパラメータを、byte値の指定したJava配列値に設定します。 これは、データベースへの送信前に、ドライバによってSQL VARBINARYまたはLONGVARBINARY値に変換されます(ドライバのVARBINARY値の制限に関する引数のサイズに依存)。

パラメータ:

parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となる

x - パラメータ値

例外:

SQLException - データベース・アクセス・エラーが発生した場合

setBytes

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

指定されたパラメータを指定されたJavaのバイト配列に設定します。 データベースに送るときに、ドライバはこれを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値に設定します。 このパラメータは、データベースへの送信前に、デフォルトのjava.util.Calendarを使用して日付が計算され、ドライバによってSQL DATE値に変換されます。

パラメータ:

parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となる

x - パラメータ値

例外:

SQLException - データベース・アクセス・エラーが発生した場合

setTime

void setTime(int parameterIndex, Time x) throws SQLException

このRowSetオブジェクトのコマンド内の指定されたパラメータを、指定されたjava.sql.Time値に設定します。 このパラメータは、データベースへの送信前に、デフォルトのjava.util.Calendarを使用して計算され、ドライバによってSQL TIME値に変換されます。

パラメータ:

parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となる

x - パラメータ値

例外:

SQLException - データベース・アクセス・エラーが発生した場合

setTimestamp

void setTimestamp(int parameterIndex, Timestamp x) throws SQLException

このRowSetオブジェクトのコマンド内の指定されたパラメータを、指定されたjava.sql.Timestamp値に設定します。 このパラメータは、データベースへの送信前に、デフォルトのjava.util.Calendarを使用して計算され、ドライバによってSQL TIMESTAMP値に変換されます。

パラメータ:

parameterIndex - 最初のパラメータは1、2番目のパラメータは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を介して非常に大きなASCII値を送信するほうが、LONGVARCHARパラメータを使用するより現実的です。 ファイルの終わりに達するまで必要に応じて、ドライバによってデータがストリームから読み取られます。

ノート: このストリーム・オブジェクトは、標準のJavaストリーム・オブジェクト、または標準インタフェースを実装する独自のサブクラスのどちらでもかまいません。

パラメータ:

parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となる

x - ASCIIパラメータ値を含むJava入力ストリーム

length - ストリームのバイト数

例外:

SQLException - データベース・アクセス・エラーが発生した場合

setAsciiStream

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

指定されたパラメータを、指定されたバイト数を持つ指定された入力ストリームに設定します。 LONGVARCHARパラメータに非常に大きなASCII値が入力されるときには、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番目のパラメータは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を介して非常に大きなUNICODE値を送信するほうが、LONGVARCHARパラメータを使用するより現実的です。 ファイルの終わりに達するまで必要に応じて、ドライバによってデータがストリームから読み取られます。

ノート: このストリーム・オブジェクトは、標準のJavaストリーム・オブジェクト、または標準インタフェースを実装する独自のサブクラスのどちらでもかまいません。

パラメータ:

parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となる

reader - 設定するUNICODEデータを含むReaderオブジェクト

length - ストリーム内の文字数

例外:

SQLException - データベース・アクセス・エラーが発生した場合

setCharacterStream

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

指定されたパラメータを、指定された文字数である指定されたReaderオブジェクトに設定します。 LONGVARCHARパラメータに非常に大きなUNICODE値が入力されるときには、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オブジェクトのコマンド内の指定されたパラメータを、指定された入力ストリームに設定します。 LONGVARCHARパラメータに非常に大きなASCII値が入力されるときには、java.io.InputStreamを介して送るのが現実的です。 ファイルの終わりに達するまで必要に応じてストリームからデータが読み込まれます。 JDBCドライバは、データをASCIIからデータベースのchar形式に変換します。

ノート: このストリーム・オブジェクトは、標準のJavaストリーム・オブジェクト、または標準インタフェースを実装する独自のサブクラスのどちらでもかまいません。

ノート: lengthパラメータを使用するバージョンのsetAsciiStreamを使用する方が効率的かどうかを判断するには、JDBCドライバのドキュメントを参照してください。

パラメータ:

parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となる

x - ASCIIパラメータ値を含むJava入力ストリーム

例外:

SQLException - データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたPreparedStatementについて呼び出された場合

SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合

導入されたバージョン:

1.6

setAsciiStream

void setAsciiStream(String parameterName, InputStream x) throws SQLException

指定されたパラメータを指定された入力ストリームに設定します。 LONGVARCHARパラメータに非常に大きなASCII値が入力されるときには、java.io.InputStreamを介して送るのが現実的です。 ファイルの終わりに達するまで必要に応じてストリームからデータが読み込まれます。 JDBCドライバは、データをASCIIからデータベースのchar形式に変換します。

ノート: このストリーム・オブジェクトは、標準のJavaストリーム・オブジェクト、または標準インタフェースを実装する独自のサブクラスのどちらでもかまいません。

ノート: lengthパラメータを使用するバージョンのsetAsciiStreamを使用する方が効率的かどうかを判断するには、JDBCドライバのドキュメントを参照してください。

パラメータ:

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ストリーム・オブジェクト、または標準インタフェースを実装する独自のサブクラスのどちらでもかまいません。

ノート: lengthパラメータを使用するバージョンのsetBinaryStreamを使用する方が効率的かどうかを判断するには、JDBCドライバのドキュメントを参照してください。

パラメータ:

parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となる

x - バイナリ・パラメータ値を含むJava入力ストリーム

例外:

SQLException - データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたPreparedStatementについて呼び出された場合

SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合

導入されたバージョン:

1.6

setBinaryStream

void setBinaryStream(String parameterName, InputStream x) throws SQLException

指定されたパラメータを指定された入力ストリームに設定します。 LONGVARBINARYパラメータに非常に大きなバイナリ値が入力されるときには、java.io.InputStreamオブジェクトを介して送るのが現実的です。 ファイルの終わりに達するまで必要に応じてストリームからデータが読み込まれます。

ノート: このストリーム・オブジェクトは、標準のJavaストリーム・オブジェクト、または標準インタフェースを実装する独自のサブクラスのどちらでもかまいません。

ノート: lengthパラメータを使用するバージョンのsetBinaryStreamを使用する方が効率的かどうかを判断するには、JDBCドライバのドキュメントを参照してください。

パラメータ:

parameterName - パラメータの名前

x - バイナリ・パラメータ値を含むJava入力ストリーム

例外:

SQLException - データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementについて呼び出された場合

SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合

導入されたバージョン:

1.6

setCharacterStream

void setCharacterStream(int parameterIndex, Reader reader) throws SQLException

このRowSetオブジェクトのコマンド内の指定されたパラメータを、指定されたReaderオブジェクトに設定します。 LONGVARCHARパラメータに非常に大きなUNICODE値が入力されるときには、java.io.Readerオブジェクトを介して送るのが現実的です。 ファイルの終わりに達するまで必要に応じてストリームからデータが読み込まれます。 JDBCドライバは、データをUNICODEからデータベースのchar形式に変換します。

ノート: このストリーム・オブジェクトは、標準のJavaストリーム・オブジェクト、または標準インタフェースを実装する独自のサブクラスのどちらでもかまいません。

ノート: lengthパラメータを使用するバージョンのsetCharacterStreamを使用する方が効率的かどうかを判断するには、JDBCドライバのドキュメントを参照してください。

パラメータ:

parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となる

reader - Unicodeデータを格納するjava.io.Readerオブジェクト

例外:

SQLException - データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたPreparedStatementについて呼び出された場合

SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合

導入されたバージョン:

1.6

setCharacterStream

void setCharacterStream(String parameterName, Reader reader) throws SQLException

指定されたパラメータを指定されたReaderオブジェクトに設定します。 LONGVARCHARパラメータに非常に大きなUNICODE値が入力されるときには、java.io.Readerオブジェクトを介して送るのが現実的です。 ファイルの終わりに達するまで必要に応じてストリームからデータが読み込まれます。 JDBCドライバは、データをUNICODEからデータベースのchar形式に変換します。

ノート: このストリーム・オブジェクトは、標準のJavaストリーム・オブジェクト、または標準インタフェースを実装する独自のサブクラスのどちらでもかまいません。

ノート: lengthパラメータを使用するバージョンのsetCharacterStreamを使用する方が効率的かどうかを判断するには、JDBCドライバのドキュメントを参照してください。

パラメータ:

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の文字表現をデータベース内の各国文字セットに変換します。

ノート: このストリーム・オブジェクトは、標準のJavaストリーム・オブジェクト、または標準インタフェースを実装する独自のサブクラスのどちらでもかまいません。

ノート: lengthパラメータを使用するバージョンのsetNCharacterStreamを使用する方が効率的かどうかを判断するには、JDBCドライバのドキュメントを参照してください。

パラメータ:

parameterIndex - 最初のパラメータのインデックスは1、2番目のパラメータのインデックスは2、... となる

value - パラメータ値

例外:

SQLException - ドライバが各国文字セットをサポートしない場合、ドライバがデータ変換エラーが発生した可能性を検出できる場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたPreparedStatement上で呼び出された場合

SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合

導入されたバージョン:

1.6

setObject

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

このRowSetオブジェクトのコマンド内の指定したパラメータを、指定したJava Objectに設定します。 整数値の場合は等価なjava.langオブジェクトを使用する必要があります(たとえばintに対してIntegerクラスのインスタンス)。 2番目の引数がInputStreamである場合、ストリームにはscaleOrLengthで指定されるバイト数が含まれる必要があります。 2番目の引数がReaderの場合、Readerには、scaleOrLengthで指定された文字数が含まれている必要があります。 これらの条件がtrueではない場合、準備された文の実行時にドライバはSQLExceptionを生成します。

指定されたJavaオブジェクトは、データベースに送られる前にtargetSqlTypeに変換されます。

オブジェクトのクラスがSQLDataを実装する場合は、行セットでSQLData.writeSQLメソッドを呼び出して、オブジェクトをSQLOutputデータ・ストリームに書き込む必要があります。 また、オブジェクトがRef、Blob、Clob、NClob、Struct、java.net.URL、またはArrayを実装するクラスのオブジェクトである場合、ドライバはこのオブジェクトを対応するSQL型の値としてデータベースに渡す必要があります。

このメソッドは、データベース固有の抽象データ型を渡すために使用することに注意してください。

パラメータ:

parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となる

x - 入力パラメータ値を含むオブジェクト

targetSqlType - データベースに送られる(java.sql.Typesで定義される) SQL型。 scale引数で、さらにこの型を限定できる。

scaleOrLength - java.sql.Types.DECIMALまたはjava.sql.Types.NUMERIC typesの場合、これは小数点のあとの桁数になる。 Javaオブジェクト型InputStreamおよびReaderの場合、ストリームまたはReader内のデータの長さです。 ほかのすべての型では、この値は無視される。

例外:

SQLException - データベース・アクセス・エラーが発生した場合

関連項目:

• Types

setObject

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

指定されたパラメータの値を、指定されたオブジェクトで設定します。 2番目の引数はオブジェクト型である必要があります。整数値の場合は等価なjava.langオブジェクトを使用すべきです。

指定されたJavaオブジェクトは、データベースに送られる前に、指定されたtargetSqlTypeに変換されます。 オブジェクトがカスタム・マッピングを持つ場合(オブジェクトがインタフェースSQLDataを実装するクラスのインスタンスである場合)、JDBCドライバはSQLData.writeSQLメソッドを呼び出して、そのオブジェクトをSQLデータ・ストリームへ書き込む必要があります。 また、オブジェクトがRef、Blob、Clob、NClob、Struct、java.net.URL、またはArrayを実装するクラスのオブジェクトである場合、ドライバはこのオブジェクトを対応するSQL型の値としてデータベースに渡す必要があります。

このメソッドは、データベース固有の抽象データ型を渡すために使用することに注意してください。

パラメータ:

parameterName - パラメータの名前

x - 入力パラメータ値を含むオブジェクト

targetSqlType - データベースに送られる(java.sql.Typesで定義される) SQL型。 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

このRowSetオブジェクトのコマンド内の指定したパラメータを、Java Objectに設定します。 整数値の場合は等価なjava.langオブジェクトを使用する必要があります。 このメソッドは前述のsetObjectに似ていますが、使われるスケールは2番目のパラメータのスケールになります。 スカラー値のスケールは0です。 リテラル値が保持するスケールは、リテラル内に存在します。

浮動小数点の入力値でこのメソッドを呼び出すことは、サポートされていますが推奨はされていません。

パラメータ:

parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となる

x - 入力パラメータ値を含むオブジェクト

targetSqlType - データベースに送られる(java.sql.Typesで定義される) SQL型

例外:

SQLException - データベース・アクセス・エラーが発生した場合

setObject

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

指定されたパラメータの値を、指定されたオブジェクトで設定します。 このメソッドは、上記のsetObjectメソッドに似ていますが、scaleに0を仮定している点が異なります。

パラメータ:

parameterName - パラメータの名前

x - 入力パラメータ値を含むオブジェクト

targetSqlType - データベースに送られる(java.sql.Typesで定義される) SQL型

例外:

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

指定されたパラメータの値を、指定されたオブジェクトで設定します。 2番目のパラメータは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

このRowSetオブジェクトのコマンド内の指定したパラメータを、Java Objectに設定します。 整数値の場合は等価なjava.langオブジェクトを使用する必要があります。

JDBCは、JavaのObject型からSQL型への標準マッピングを提供します。 指定されたJavaオブジェクトは、データベースに送られる前にドライバによって標準のSQLマッピングに変換されます。

このメソッドは、ドライバ固有のJava型を使用してデータベース固有の抽象データ型を渡すために使用できます。 オブジェクトのクラスがSQLDataを実装する場合は、行セットでSQLData.writeSQLメソッドを呼び出して、オブジェクトをSQLOutputデータ・ストリームに書き込む必要があります。 また、オブジェクトがRef、Blob、Clob、NClob、Struct、java.net.URL、またはArrayを実装するクラスのオブジェクトである場合、ドライバはこのオブジェクトを対応するSQL型の値としてデータベースに渡す必要があります。

たとえば、オブジェクトがこれらのインタフェースを複数実装するクラスであるなど、あいまいさがある場合、例外がスローされます。

パラメータ:

parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となる

x - 入力パラメータ値を含むオブジェクト

例外:

SQLException - データベース・アクセス・エラーが発生した場合

setRef

void setRef(int i, Ref x) throws SQLException

このRowSetオブジェクトのコマンドで指定したパラメータを、指定したRef値に設定します。 このパラメータはドライバによって適切なREF(<structured-type>) (構造化型)値に変換されます。

パラメータ:

i - 最初のパラメータは1、2番目のパラメータは2、... となる

x - SQL REF型のデータを表すオブジェクト

例外:

SQLException - データベース・アクセス・エラーが発生した場合

setBlob

void setBlob(int i, Blob x) throws SQLException

このRowSetオブジェクトのコマンドで指定したパラメータを、指定したBlob値に設定します。 このパラメータは、データベースへの送信前に、ドライバによってBlobオブジェクトが表すBLOB値に変換されます。

パラメータ:

i - 最初のパラメータは1、2番目のパラメータは2、... となる

x - BLOBを表すオブジェクト

例外:

SQLException - データベース・アクセス・エラーが発生した場合

setBlob

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

指定されたパラメータをInputStreamオブジェクトに設定します。 InputStreamには、長さで指定された文字数が含まれている必要があります。そうでない場合、PreparedStatementの実行時にSQLExceptionが生成されます。 このメソッドは、setBinaryStream (int, InputStream, int)メソッドと異なり、パラメータ値をBLOBとしてサーバーに送信するべきであることをドライバに通知します。 setBinaryStreamメソッドを使用すると、ドライバは、パラメータ・データをLONGVARBINARYとBLOBのどちらとしてサーバーに送信するべきかを判断するために余計な作業を行う必要がある可能性があります。

パラメータ:

parameterIndex - 最初のパラメータのインデックスは1、2番目のパラメータのインデックスは2、... となる

inputStream - パラメータ値に設定されるデータを含むオブジェクト。

length - パラメータ・データ内のバイト数。

例外:

SQLException - データベース・アクセス・エラーが発生した場合、parameterIndexがSQL文のパラメータ・マーカーに対応していない場合、指定された長さが0より小さい場合、またはInputStreamのバイト数が指定された長さと一致しない場合、このメソッドはクローズされたPreparedStatementでコールされます。

SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合

導入されたバージョン:

1.6

setBlob

void setBlob(int parameterIndex, InputStream inputStream) throws SQLException

指定されたパラメータをInputStreamオブジェクトに設定します。 このメソッドは、setBinaryStream (int, InputStream)メソッドと異なり、パラメータ値をBLOBとしてサーバーに送信しなければならないことをドライバに通知します。 setBinaryStreamメソッドを使用すると、ドライバは、パラメータ・データをLONGVARBINARYとBLOBのどちらとしてサーバーに送信するべきかを判断するために余計な作業を行う必要がある可能性があります。

ノート: lengthパラメータを使用するバージョンのsetBlobを使用する方が効率的かどうかを判断するには、JDBCドライバのドキュメントを参照してください。

パラメータ:

parameterIndex - 最初のパラメータのインデックスは1、2番目のパラメータのインデックスは2、... となる

inputStream - パラメータ値に設定されるデータを含むオブジェクト。

例外:

SQLException - データベース・アクセス・エラーが発生した場合、このメソッドがクローズされたPreparedStatementで呼び出された場合、またはparameterIndexがSQL文のパラメータ・マーカーと対応していない場合、

SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合

導入されたバージョン:

1.6

setBlob

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

指定されたパラメータをInputStreamオブジェクトに設定します。 InputStreamには、長さで指定された文字数が含まれている必要があります。そうでない場合は、CallableStatementの実行時にSQLExceptionが生成されます。 このメソッドは、setBinaryStream (int, InputStream, int)メソッドと異なり、パラメータ値をBLOBとしてサーバーに送信するべきであることをドライバに通知します。 setBinaryStreamメソッドを使用すると、ドライバは、パラメータ・データをLONGVARBINARYとBLOBのどちらとしてサーバーに送信するべきかを判断するために余計な作業を行う必要がある可能性があります。

パラメータ:

parameterName - 2番目は2に設定されるパラメータの名前

inputStream - パラメータ値に設定されるデータを含むオブジェクト。

length - パラメータ・データ内のバイト数。

例外:

SQLException - parameterIndexがSQL文のパラメータ・マーカーに対応しない場合、または指定された長さがゼロ未満の場合、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のどちらとしてサーバーに送信するかを判断するために余計な作業を行う必要がある可能性があります。

ノート: lengthパラメータを使用するバージョンのsetBlobを使用する方が効率的かどうかを判断するには、JDBCドライバのドキュメントを参照してください。

パラメータ:

parameterName - パラメータの名前

inputStream - パラメータ値に設定されるデータを含むオブジェクト。

例外:

SQLException - データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementについて呼び出された場合

SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合

導入されたバージョン:

1.6

setClob

void setClob(int i, Clob x) throws SQLException

このRowSetオブジェクトのコマンドで指定したパラメータを、指定したClob値に設定します。 このパラメータは、データベースへの送信前に、ドライバによってClobオブジェクトが表すCLOB値に変換されます。

パラメータ:

i - 最初のパラメータは1、2番目のパラメータは2、... となる

x - CLOBを表すオブジェクト

例外:

SQLException - データベース・アクセス・エラーが発生した場合

setClob

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

指定されたパラメータをReaderオブジェクトに設定します。 Readerには、長さで指定された文字数が含まれている必要があります。そうでない場合、PreparedStatementの実行時にSQLExceptionが生成されます。 このメソッドは、setCharacterStream (int, Reader, int)メソッドと異なり、パラメータ値をCLOBとしてサーバーに送信するべきであることをドライバに通知します。 setCharacterStreamメソッドを使用すると、ドライバは、パラメータ・データをLONGVARCHARとCLOBのどちらとしてサーバーに送信するべきかを判断するために余計な作業を行う必要がある可能性があります。

パラメータ:

parameterIndex - 最初のパラメータのインデックスは1、2番目のパラメータのインデックスは2、... となる

reader - パラメータ値に設定されるデータを含むオブジェクト。

length - パラメータ・データ内の文字数。

例外:

SQLException - データベース・アクセス・エラーが発生した場合、このメソッドがクローズされたPreparedStatementで呼び出された場合、parameterIndexがSQL文のパラメータ・マーカーと対応していない場合、または長さとしてゼロ未満の値が指定された場合。

SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合

導入されたバージョン:

1.6

setClob

void setClob(int parameterIndex, Reader reader) throws SQLException

指定されたパラメータをReaderオブジェクトに設定します。 このメソッドは、setCharacterStream (int, Reader)メソッドと異なり、パラメータ値をCLOBとしてサーバーに送信するべきであることをドライバに通知します。 setCharacterStreamメソッドを使用すると、ドライバは、パラメータ・データをLONGVARCHARとCLOBのどちらとしてサーバーに送信するべきかを判断するために余計な作業を行う必要がある可能性があります。

ノート: lengthパラメータを使用するバージョンのsetClobを使用する方が効率的かどうかを判断するには、JDBCドライバのドキュメントを参照してください。

パラメータ:

parameterIndex - 最初のパラメータのインデックスは1、2番目のパラメータのインデックスは2、... となる

reader - パラメータ値に設定されるデータを含むオブジェクト。

例外:

SQLException - データベース・アクセス・エラーが発生した場合、このメソッドがクローズされたPreparedStatementで呼び出された場合、またはparameterIndexがSQL文のパラメータ・マーカーと対応していない場合

SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合

導入されたバージョン:

1.6

setClob

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

指定されたパラメータをReaderオブジェクトに設定します。 Readerには、長さで指定された文字数が含まれている必要があります。そうでない場合、CallableStatementの実行時にSQLExceptionが生成されます。 このメソッドは、setCharacterStream (int, Reader, int)メソッドと異なり、パラメータ値をCLOBとしてサーバーに送信するべきであることをドライバに通知します。 setCharacterStreamメソッドを使用すると、ドライバは、パラメータ・データをLONGVARCHARとCLOBのどちらとしてサーバーに送信するかを判断するために余計な作業を行う必要がある可能性があります。

パラメータ:

parameterName - 設定されるパラメータの名前。

reader - パラメータ値に設定されるデータを含むオブジェクト。

length - パラメータ・データ内の文字数。

例外:

SQLException - parameterIndexがSQL文のパラメータ・マーカーと対応していない場合、長さとしてゼロ未満の値が指定された場合、データベース・アクセス・エラーが発生した場合、このメソッドがクローズされた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のどちらとしてサーバーに送信するかを判断するために余計な作業を行う必要がある可能性があります。

ノート: lengthパラメータを使用するバージョンのsetClobを使用する方が効率的かどうかを判断するには、JDBCドライバのドキュメントを参照してください。

パラメータ:

parameterName - パラメータの名前

reader - パラメータ値に設定されるデータを含むオブジェクト。

例外:

SQLException - データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementについて呼び出された場合

SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合

導入されたバージョン:

1.6

setArray

void setArray(int i, Array x) throws SQLException

このRowSetオブジェクトのコマンドで指定したパラメータを、指定したArray値に設定します。 このパラメータは、データベースへの送信前に、ドライバによってArrayオブジェクトが表すARRAY値に変換されます。

パラメータ:

i - 最初のパラメータは1、2番目のパラメータは2、... となる

x - SQL ARRAYを表すオブジェクト

例外:

SQLException - データベース・アクセス・エラーが発生した場合

setDate

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

このRowSetオブジェクトのコマンドで指定したパラメータを、指定したjava.sql.Date値に設定します。 このパラメータは、指定したjava.util.Calendarオブジェクトを使用して日付が計算され、ドライバによってSQL DATE値に変換されます。

パラメータ:

parameterIndex - 最初のパラメータは1、2番目のパラメータは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

このRowSetオブジェクトのコマンドで指定したパラメータを、指定したjava.sql.Time値に設定します。 このパラメータは、データベースへの送信前に、指定したjava.util.Calendarオブジェクトを使用して日付が計算され、ドライバによってSQL TIME値に変換されます。

パラメータ:

parameterIndex - 最初のパラメータは1、2番目のパラメータは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

このRowSetオブジェクトのコマンドで指定したパラメータを、指定したjava.sql.Timestamp値に設定します。 このパラメータは、データベースへの送信前に、指定したjava.util.Calendarオブジェクトを使用して日付が計算され、ドライバによってSQL TIMESTAMP値に変換されます。

パラメータ:

parameterIndex - 最初のパラメータは1、2番目のパラメータは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オブジェクトがデータ・ソースとの連続接続を維持していない場合は、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番目のパラメータのインデックスは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番目のパラメータは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番目のパラメータのインデックスは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番目のパラメータのインデックスは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ストリーム・オブジェクト、または標準インタフェースを実装する独自のサブクラスのどちらでもかまいません。

ノート: lengthパラメータを使用するバージョンのsetNCharacterStreamを使用する方が効率的かどうかを判断するには、JDBCドライバのドキュメントを参照してください。

パラメータ:

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には、長さで指定された文字数が含まれている必要があります。そうでない場合、CallableStatementの実行時にSQLExceptionが生成されます。 このメソッドは、setCharacterStream (int, Reader, int)メソッドと異なり、パラメータ値をNCLOBとしてサーバーに送信するべきであることをドライバに通知します。 setCharacterStreamメソッドを使用すると、ドライバは、パラメータ・データをLONGNVARCHARとNCLOBのどちらとしてサーバーに送信するかを判断するために余計な作業を行う必要がある可能性があります。

パラメータ:

parameterName - 設定されるパラメータの名前。

reader - パラメータ値に設定されるデータを含むオブジェクト。

length - パラメータ・データ内の文字数。

例外:

SQLException - parameterIndexがSQL文のパラメータ・マーカーと対応していない場合、長さとしてゼロ未満の値が指定された場合、ドライバが各国文字セットをサポートしない場合、ドライバがデータ変換エラーが発生した可能性を検出できる場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatement上で呼び出された場合

SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合

導入されたバージョン:

1.6

setNClob

void setNClob(String parameterName, Reader reader) throws SQLException

指定されたパラメータをReaderオブジェクトに設定します。 このメソッドは、setCharacterStream (int, Reader)メソッドと異なり、パラメータ値をNCLOBとしてサーバーに送信しなければならないことをドライバに通知します。 setCharacterStreamメソッドを使用すると、ドライバは、パラメータ・データをLONGNVARCHARとNCLOBのどちらとしてサーバーに送信するかを判断するために余計な作業を行う必要がある可能性があります。

ノート: lengthパラメータを使用するバージョンのsetNClobを使用する方が効率的かどうかを判断するには、JDBCドライバのドキュメントを参照してください。

パラメータ:

parameterName - パラメータの名前

reader - パラメータ値に設定されるデータを含むオブジェクト。

例外:

SQLException - ドライバが各国文字セットをサポートしない場合、ドライバがデータ変換エラーが発生した可能性を検出できる場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatement上で呼び出された場合

SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合

導入されたバージョン:

1.6

setNClob

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

指定されたパラメータをReaderオブジェクトに設定します。 Readerには、長さで指定された文字数が含まれている必要があります。そうでない場合、PreparedStatementの実行時にSQLExceptionが生成されます。 このメソッドは、setCharacterStream (int, Reader, int)メソッドと異なり、パラメータ値をNCLOBとしてサーバーに送信するべきであることをドライバに通知します。 setCharacterStreamメソッドを使用すると、ドライバは、パラメータ・データをLONGNVARCHARとNCLOBのどちらとしてサーバーに送信するべきかを判断するために余計な作業を行う必要がある可能性があります。

パラメータ:

parameterIndex - 最初のパラメータのインデックスは1、2番目のパラメータのインデックスは2、... となる

reader - パラメータ値に設定されるデータを含むオブジェクト。

length - パラメータ・データ内の文字数。

例外:

SQLException - parameterIndexがSQL文のパラメータ・マーカーと対応していない場合、長さとしてゼロ未満の値が指定された場合、ドライバが各国文字セットをサポートしない場合、ドライバがデータ変換エラーが発生した可能性を検出できる場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたPreparedStatement上で呼び出された場合

SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合

導入されたバージョン:

1.6

setNClob

void setNClob(int parameterIndex, NClob value) throws SQLException

指定されたパラメータをjava.sql.NClobオブジェクトに設定します。 データベースに送るときに、ドライバはこれをSQL NCLOB値に変換します。

パラメータ:

parameterIndex - 最初のパラメータのインデックスは1、2番目のパラメータのインデックスは2、... となる

value - パラメータ値

例外:

SQLException - ドライバが各国文字セットをサポートしない場合、ドライバがデータ変換エラーが発生した可能性を検出できる場合、またはデータベース・アクセス・エラーが発生した場合

導入されたバージョン:

1.6

setNClob

void setNClob(int parameterIndex, Reader reader) throws SQLException

指定されたパラメータをReaderオブジェクトに設定します。 このメソッドは、setCharacterStream (int, Reader)メソッドと異なり、パラメータ値をNCLOBとしてサーバーに送信しなければならないことをドライバに通知します。 setCharacterStreamメソッドを使用すると、ドライバは、パラメータ・データをLONGNVARCHARとNCLOBのどちらとしてサーバーに送信するべきかを判断するために余計な作業を行う必要がある可能性があります。

ノート: lengthパラメータを使用するバージョンのsetNClobを使用する方が効率的かどうかを判断するには、JDBCドライバのドキュメントを参照してください。

パラメータ:

parameterIndex - 最初のパラメータのインデックスは1、2番目のパラメータのインデックスは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番目のパラメータは2、... となる

x - 設定されるjava.net.URLオブジェクト

例外:

SQLException - データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたPreparedStatementについて呼び出された場合

SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合

導入されたバージョン:

1.4