public interface RowSet extends ResultSet
RowSetインタフェースではJavaBeansプロパティの組を提供します。これらのプロパティによって、RowSetインスタンスがJDBCデータ・ソースに接続し、そのデータ・ソースからデータを読み取るように構成できます。 値を設定するメソッド(setInt、setBytes、setStringなど)では、入力パラメータを行セットのコマンド・プロパティに渡す方法を提供します。 このコマンドは、行セットが通常は関係データベースから自身のデータを取得するときに使用するSQLクエリーです。
RowSetインタフェースではJavaBeansイベントをサポートしており、行セットにイベントが発生したとき(値の変更など)に、アプリケーションのほかのコンポーネントに通知することができます。
JDBC APIのほかの部分を使用して実装するようにしている点で、RowSetインタフェースは独特です。 言い換えると、RowSetの実装とは、JDBCドライバの最上部で実行されるソフトウェアのレイヤーです。 RowSetインタフェースの実装は、JDBC製品の一部としてRowSetの実装を提供しようとするJDBCドライバ・ベンダーを始めとして、誰でも提供できます。
RowSetオブジェクトでは、データ・ソースとの接続を作成し、オブジェクトのライフ・サイクルを通じてその接続を保持します。このような場合、接続された行セットと呼ばれます。 また、行セットはデータ・ソースと接続してデータを取得し、接続を閉じることもできます。 そのような行セットは未接続の行セットと呼ばれます。 未接続の行セットでは、未接続中にデータに変更を加えてから、データの元のソースに変更を送り戻すことができます。しかし、そのためには接続をもう一度確立する必要があります。
切断された行セットには、関連付けられたリーダー(RowSetReaderオブジェクト)とライター(RowSetWriterオブジェクト)があります。 リーダーは、データ付きで行セットを生成するためにさまざまな方法で実装されており、非関係データ・ソースからデータを取得することもできます。 ライターもまたさまざまな方法で実装されており、行セットのデータに加えられた変更を基本となるデータ・ソースへ送り戻すことができます。
行セットを使用するのは簡単です。 RowSetインタフェースは標準java.sql.ResultSetインタフェースを拡張したものです。 RowSetMetaDataインタフェースはjava.sql.ResultSetMetaDataインタフェースを拡張したものです。 それにより、JDBC APIに精通している開発者が行セットを使うためには、最小限の新しいAPIを覚えれば済みます。 さらに、JDBC 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.BigDeciaml値に設定します。 |
void |
setBigDecimal(String parameterName, BigDecimal x) |
指定されたパラメータを、指定された
java.math.BigDecimal値に設定します。 |
void |
setBinaryStream(int parameterIndex, InputStream x) |
この
RowSetオブジェクトのコマンド内の指定されたパラメータを、指定された入力ストリームに設定します。 |
void |
setBinaryStream(int parameterIndex, InputStream x, int length) |
この
RowSetオブジェクトのコマンド内の指定されたパラメータを、指定されたjava.io.InputStream値に設定します。 |
void |
setBinaryStream(String parameterName, InputStream x) |
指定されたパラメータを指定された入力ストリームに設定します。
|
void |
setBinaryStream(String parameterName, InputStream x, int length) |
指定されたパラメータを、指定されたバイト数を持つ指定された入力ストリームに設定します。
|
void |
setBlob(int i, Blob x) |
この
RowSetオブジェクトのコマンドで指定したパラメータを、指定したBlob値に設定します。 |
void |
setBlob(int parameterIndex, InputStream inputStream) |
指定されたパラメータを
InputStreamオブジェクトに設定します。 |
void |
setBlob(int parameterIndex, InputStream inputStream, long length) |
指定されたパラメータを
InputStreamオブジェクトに設定します。 |
void |
setBlob(String parameterName, Blob x) |
指定されたパラメータを指定された
java.sql.Blobオブジェクトに設定します。 |
void |
setBlob(String parameterName, InputStream inputStream) |
指定されたパラメータを
InputStreamオブジェクトに設定します。 |
void |
setBlob(String parameterName, InputStream inputStream, long length) |
指定されたパラメータを
InputStreamオブジェクトに設定します。 |
void |
setBoolean(int parameterIndex, boolean x) |
この
RowSetオブジェクトのコマンド内の指定されたパラメータを、指定されたJava boolean値に設定します。 |
void |
setBoolean(String parameterName, boolean x) |
指定されたパラメータを指定されたJavaの
boolean値に設定します。 |
void |
setByte(int parameterIndex, byte x) |
この
RowSetオブジェクトのコマンド内の指定されたパラメータを、指定されたJava byte値に設定します。 |
void |
setByte(String parameterName, byte x) |
指定されたパラメータを指定されたJavaの
byte値に設定します。 |
void |
setBytes(int parameterIndex, byte[] x) |
この
RowSetオブジェクトのコマンド内の指定したパラメータを、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 i, Clob x) |
この
RowSetオブジェクトのコマンドで指定したパラメータを、指定したClob値に設定します。 |
void |
setClob(int parameterIndex, Reader reader) |
指定されたパラメータを
Readerオブジェクトに設定します。 |
void |
setClob(int parameterIndex, Reader reader, long length) |
指定されたパラメータを
Readerオブジェクトに設定します。 |
void |
setClob(String parameterName, Clob x) |
指定されたパラメータを指定された
java.sql.Clobオブジェクトに設定します。 |
void |
setClob(String parameterName, Reader reader) |
指定されたパラメータを
Readerオブジェクトに設定します。 |
void |
setClob(String parameterName, Reader reader, long length) |
指定されたパラメータを
Readerオブジェクトに設定します。 |
void |
setCommand(String cmd) |
この
RowSetオブジェクトの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, NClob value) |
指定されたパラメータを
java.sql.NClobオブジェクトに設定します。 |
void |
setNClob(int parameterIndex, Reader reader) |
指定されたパラメータを
Readerオブジェクトに設定します。 |
void |
setNClob(int parameterIndex, Reader reader, long length) |
指定されたパラメータを
Readerオブジェクトに設定します。 |
void |
setNClob(String parameterName, NClob value) |
指定されたパラメータを
java.sql.NClobオブジェクトに設定します。 |
void |
setNClob(String parameterName, Reader reader) |
指定されたパラメータを
Readerオブジェクトに設定します。 |
void |
setNClob(String parameterName, Reader reader, long length) |
指定されたパラメータを
Readerオブジェクトに設定します。 |
void |
setNString(int parameterIndex, String value) |
指定されたパラメータを指定された
Stringオブジェクトに設定します。 |
void |
setNString(String parameterName, String value) |
指定されたパラメータを指定された
Stringオブジェクトに設定します。 |
void |
setNull(int parameterIndex, int sqlType) |
この
RowSetオブジェクトのSQLコマンド内の指定されたパラメータを、SQL NULLに設定します。 |
void |
setNull(int paramIndex, int sqlType, String typeName) |
この
RowSetオブジェクトのSQLコマンド内の指定されたパラメータを、SQL NULLに設定します。 |
void |
setNull(String parameterName, int sqlType) |
指定されたパラメータをSQL
NULLに設定します。 |
void |
setNull(String parameterName, int sqlType, String typeName) |
指定されたパラメータをSQL
NULLに設定します。 |
void |
setObject(int parameterIndex, Object x) |
この
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(int parameterIndex, URL x) |
指定されたパラメータを、指定された
java.net.URL値に設定します。 |
void |
setUrl(String url) |
この
RowSetオブジェクトがDriverManagerを使って接続を作成するときに使用するURLを設定します。 |
void |
setUsername(String name) |
この
RowSetオブジェクトのusernameプロパティを、指定したStringに設定します。 |
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, wasNullisWrapperFor, unwrapString getUrl() throws SQLException
RowSetオブジェクトが接続を確立するのにDataSourceオブジェクトではなくDriverManagerを使用する場合に、接続を作成するために使用するurlプロパティを取得します。 デフォルト値はnullです。 SQLException - データベース・アクセス・エラーが発生した場合setUrl(java.lang.String)void setUrl(String url) throws SQLException
RowSetオブジェクトがDriverManagerを使って接続を作成するときに使用するURLを設定します。 このプロパティの設定はオプションです。 URLを使用する場合は、データベースへの接続に行セットが使用される前に、そのURLを受け入れるJDBCドライバをロードします。 行セットでは、データを読み書きするときに、このURLを内部的に使用して、データベース接続を作成します。 URLとデータ・ソース名のうち、新しくnull以外の値が設定された方が接続の作成に使用されます。 url - 文字列値。nullも可SQLException - データベース・アクセス・エラーが発生した場合getUrl()String getDataSourceName()
RowSetオブジェクトのデータ・ソースを特定する論理名を取得します。setDataSourceName(java.lang.String), setUrl(java.lang.String)void setDataSourceName(String name) throws SQLException
RowSetオブジェクトのデータ・ソース名プロパティを、指定したStringに設定します。
データ・ソース名プロパティの値は、ネーム・サービスで登録されたDataSourceオブジェクトをルックアップするために使用されます。 取得されたDataSourceオブジェクトを使って、このオブジェクトが表すデータ・ソースへの接続を作成できます。
name - このRowSetオブジェクトのデータ・ソースの論理名。nullも可SQLException - データベース・アクセス・エラーが発生した場合getDataSourceName()String getUsername()
RowSetオブジェクトのデータベース接続を作成するために使用されるusernameを取得します。 usernameプロパティは、実行時にexecuteメソッドを呼び出す前に設定されます。 通常、これはRowSetオブジェクトの直列化状態の一部ではありません。 setUsername(java.lang.String)void setUsername(String name) throws SQLException
RowSetオブジェクトのusernameプロパティを、指定したStringに設定します。name - ユーザー名SQLException - データベース・アクセス・エラーが発生した場合getUsername()String getPassword()
executeメソッドを呼び出す前に設定されます。 通常、これはRowSetオブジェクトの直列化状態の一部ではありません。 setPassword(java.lang.String)void setPassword(String password) throws SQLException
RowSetオブジェクトのデータベース・パスワードを、指定したStringに設定します。password - パスワードを表す文字列SQLException - データベース・アクセス・エラーが発生した場合getPassword()int getTransactionIsolation()
RowSetオブジェクトのトランザクション遮断レベルの設定を取得します。Connection.TRANSACTION_READ_UNCOMMITTED、Connection.TRANSACTION_READ_COMMITTED、Connection.TRANSACTION_REPEATABLE_READ、またはConnection.TRANSACTION_SERIALIZABLEのうちの1つsetTransactionIsolation(int)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()Map<String,Class<?>> getTypeMap() throws SQLException
RowSetオブジェクトに関連付けられたSQLユーザー定義型のカスタム・マッピングがある場合には、それを指定するMapオブジェクトを取得します。 型マップのデフォルトは空です。 java.util.MapオブジェクトSQLException - データベース・アクセス・エラーが発生した場合setTypeMap(java.util.Map<java.lang.String, java.lang.Class<?>>)void setTypeMap(Map<String,Class<?>> map) throws SQLException
RowSetオブジェクトのデフォルトの型マップとして指定されたjava.util.Mapオブジェクトをインストールします。 別の型マップがメソッドのパラメータとして指定されるまで、この型マップが使用されます。 map - SQLユーザー定義型とそれらがマッピングされるJavaクラスが格納されているjava.util.MapオブジェクトSQLException - データベース・アクセス・エラーが発生した場合getTypeMap()String getCommand()
RowSetオブジェクトのcommandプロパティを取得します。 commandプロパティには、SQLクエリーであるコマンド文字列が格納されます。これは、行セットにデータを格納するために実行されます。 デフォルト値はnullです。 nullも可setCommand(java.lang.String)void setCommand(String cmd) throws SQLException
RowSetオブジェクトのcommandプロパティにSQLクエリーを設定します。 行セットがコマンドをサポートしないデータ・ソースからデータを得る場合(スプレッドシートなど)、このプロパティはオプションです。 cmd - このRowSetオブジェクトのデータを取得するために使用されるSQLクエリー。nullも可SQLException - データベース・アクセス・エラーが発生した場合getCommand()boolean isReadOnly()
RowSetオブジェクトが読取り専用かどうかを確認します。 更新が可能な場合、行セットのデフォルトは更新可能になります。
読取り専用の行セットを更新しようとすると、SQLExceptionがスローされます。
RowSetオブジェクトが読取り専用の場合はtrue、更新可能な場合はfalsesetReadOnly(boolean)void setReadOnly(boolean value)
throws SQLException
RowSetオブジェクトが読取り専用かどうかを、指定したbooleanに設定します。value - 読取り専用の場合はtrue、更新可能な場合はfalseSQLException - データベース・アクセス・エラーが発生した場合isReadOnly()int getMaxFieldSize()
throws SQLException
BINARY、VARBINARY、LONGVARBINARYBINARY、CHAR、VARCHAR、LONGVARCHAR、NCHAR、およびNVARCHARの各列だけに適用されます。 制限値を超えたデータは通知なしに破棄されます。 SQLException - データベース・アクセス・エラーが発生した場合setMaxFieldSize(int)void setMaxFieldSize(int max)
throws SQLException
BINARY、VARBINARY、LONGVARBINARYBINARY、CHAR、VARCHAR、LONGVARCHAR、NCHAR、およびNVARCHARの各列だけに適用されます。 制限値を超えたデータは通知なしに破棄されます。 移植性を最大限にするには、256より大きい値を使用します。 max - 新しい最大列サイズの制限値(バイト)。ゼロは無制限を意味するSQLException - データベース・アクセス・エラーが発生した場合getMaxFieldSize()int getMaxRows()
throws SQLException
RowSetオブジェクトに含めることのできる最大行数を取得します。 制限値を超えた行は通知なしに除外されます。 RowSetオブジェクトに含めることのできる現在の最大行数。ゼロは無制限を意味するSQLException - データベース・アクセス・エラーが発生した場合setMaxRows(int)void setMaxRows(int max)
throws SQLException
RowSetオブジェクトに含めることのできる最大の行数を、指定した値に設定します。 制限値を超えた行は通知なしに除外されます。 max - 新しい最大行数。ゼロは無制限を意味するSQLException - データベース・アクセス・エラーが発生した場合getMaxRows()boolean getEscapeProcessing()
throws SQLException
RowSetオブジェクトのエスケープの処理が有効かどうかを取得します。 エスケープ・スキャニングが有効の場合(デフォルト)、ドライバはSQL文をデータベースに送る前にエスケープ置換えを実行します。 true、無効な場合はfalseSQLException - データベース・アクセス・エラーが発生した場合setEscapeProcessing(boolean)void setEscapeProcessing(boolean enable)
throws SQLException
RowSetオブジェクトのエスケープの処理をオンまたはオフに設定します。 エスケープ・スキャニングがオンの場合(デフォルト)、ドライバはSQL文をデータベースに送る前にエスケープ置換えを実行します。 enable - エスケープ処理を有効にする場合はtrue、無効にする場合はfalseSQLException - データベース・アクセス・エラーが発生した場合getEscapeProcessing()int getQueryTimeout()
throws SQLException
SQLExceptionがスローされます。 SQLException - データベース・アクセス・エラーが発生した場合setQueryTimeout(int)void setQueryTimeout(int seconds)
throws SQLException
SQLExceptionがスローされます。 seconds - 新しいクエリー・タイムアウトの制限値の秒数。ゼロは無制限を意味するSQLException - データベース・アクセス・エラーが発生した場合getQueryTimeout()void setType(int type)
throws SQLException
RowSetオブジェクトの型を、指定した型に設定します。 このメソッドは、デフォルトで読取り専用でスクロール不可の行セットの型を変更するために用いられます。 type - タイプを指定するResultSet定数。ResultSet.TYPE_FORWARD_ONLY、ResultSet.TYPE_SCROLL_INSENSITIVE、またはResultSet.TYPE_SCROLL_SENSITIVESQLException - データベース・アクセス・エラーが発生した場合ResultSet.getType()void setConcurrency(int concurrency)
throws SQLException
RowSetオブジェクトの並行性を、指定した並行性レベルに設定します。 このメソッドは、デフォルトでResultSet.CONCUR_READ_ONLYである行セットの並行性レベルを変更するために用いられます。 concurrency - 並行処理のレベルを指定するResultSet定数。ResultSet.CONCUR_READ_ONLYまたはResultSet.CONCUR_UPDATABLESQLException - データベース・アクセス・エラーが発生した場合ResultSet.getConcurrency()void setNull(int parameterIndex,
int sqlType)
throws SQLException
RowSetオブジェクトのSQLコマンド内の指定されたパラメータを、SQL NULLに設定します。
ノート: パラメータのSQLの型を指定する必要があります。
parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となるsqlType - java.sql.Typesによって定義されるSQL型のコードSQLException - データベース・アクセス・エラーが発生した場合void setNull(String parameterName, int sqlType) throws SQLException
NULLに設定します。
ノート: パラメータのSQLの型を指定する必要があります。
parameterName - パラメータの名前sqlType - java.sql.Typesで定義されるSQL型コードSQLException - データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementについて呼び出された場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合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 - データベース・アクセス・エラーが発生した場合void setNull(String parameterName, int sqlType, String typeName) throws SQLException
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ドライバがこのメソッドをサポートしない場合void setBoolean(int parameterIndex,
boolean x)
throws SQLException
RowSetオブジェクトのコマンド内の指定されたパラメータを、指定されたJava boolean値に設定します。 このパラメータは、データベースに送信される前に、ドライバによってSQL BIT値に変換されます。 parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となるx - パラメータ値SQLException - データベース・アクセス・エラーが発生した場合void setBoolean(String parameterName, boolean x) throws SQLException
boolean値に設定します。 データベースに送るときに、ドライバはこれをSQL BITまたはBOOLEAN値に変換します。 parameterName - パラメータの名前x - パラメータ値SQLException - データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementについて呼び出された場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合ResultSet.getBoolean(int)void setByte(int parameterIndex,
byte x)
throws SQLException
RowSetオブジェクトのコマンド内の指定されたパラメータを、指定されたJava byte値に設定します。 このパラメータは、データベースに送信される前に、ドライバによってSQL TINYINT値に変換されます。 parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となるx - パラメータ値SQLException - データベース・アクセス・エラーが発生した場合void setByte(String parameterName, byte x) throws SQLException
byte値に設定します。 データベースに送るときに、ドライバはこれをSQL TINYINT値に変換します。 parameterName - パラメータの名前x - パラメータ値SQLException - データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementについて呼び出された場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合ResultSet.getByte(int)void setShort(int parameterIndex,
short x)
throws SQLException
RowSetオブジェクトのコマンド内の指定されたパラメータを、指定されたJava short値に設定します。 このパラメータは、データベースに送信される前に、ドライバによってSQL SMALLINT値に変換されます。 parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となるx - パラメータ値SQLException - データベース・アクセス・エラーが発生した場合void setShort(String parameterName, short x) throws SQLException
short値に設定します。 データベースに送るときに、ドライバはこれをSQL SMALLINT値に変換します。 parameterName - パラメータの名前x - パラメータ値SQLException - データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementについて呼び出された場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合ResultSet.getShort(int)void setInt(int parameterIndex,
int x)
throws SQLException
RowSetオブジェクトのコマンド内の指定されたパラメータを、指定されたJava int値に設定します。 このパラメータは、データベースに送信される前に、ドライバによってSQL INTEGER値に変換されます。 parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となるx - パラメータ値SQLException - データベース・アクセス・エラーが発生した場合void setInt(String parameterName, int x) throws SQLException
int値に設定します。 データベースに送るときに、ドライバはこれをSQL INTEGER値に変換します。 parameterName - パラメータの名前x - パラメータ値SQLException - データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementについて呼び出された場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合ResultSet.getInt(int)void setLong(int parameterIndex,
long x)
throws SQLException
RowSetオブジェクトのコマンド内の指定されたパラメータを、指定されたJava long値に設定します。 このパラメータは、データベースに送信される前に、ドライバによってSQL BIGINT値に変換されます。 parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となるx - パラメータ値SQLException - データベース・アクセス・エラーが発生した場合void setLong(String parameterName, long x) throws SQLException
long値に設定します。 データベースに送るときに、ドライバはこれをSQL BIGINT値に変換します。 parameterName - パラメータの名前x - パラメータ値SQLException - データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementについて呼び出された場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合ResultSet.getLong(int)void setFloat(int parameterIndex,
float x)
throws SQLException
RowSetオブジェクトのコマンド内の指定されたパラメータを、指定されたJava float値に設定します。 このパラメータは、データベースに送信される前に、ドライバによってSQL REAL値に変換されます。 parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となるx - パラメータ値SQLException - データベース・アクセス・エラーが発生した場合void setFloat(String parameterName, float x) throws SQLException
float値に設定します。 データベースに送るときに、ドライバはこれをSQL FLOAT値に変換します。 parameterName - パラメータの名前x - パラメータ値SQLException - データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementについて呼び出された場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合ResultSet.getFloat(int)void setDouble(int parameterIndex,
double x)
throws SQLException
RowSetオブジェクトのコマンド内の指定されたパラメータを、指定されたJava double値に設定します。 このパラメータは、データベースに送信される前に、ドライバによってSQL DOUBLE値に変換されます。 parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となるx - パラメータ値SQLException - データベース・アクセス・エラーが発生した場合void setDouble(String parameterName, double x) throws SQLException
double値に設定します。 データベースに送るときに、ドライバはこれをSQL DOUBLE値に変換します。 parameterName - パラメータの名前x - パラメータ値SQLException - データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementについて呼び出された場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合ResultSet.getDouble(int)void setBigDecimal(int parameterIndex,
BigDecimal x)
throws SQLException
RowSetオブジェクトのコマンド内の指定されたパラメータを、指定されたjava.math.BigDeciaml値に設定します。 このパラメータは、データベースに送信される前に、ドライバによってSQL NUMERIC値に変換されます。 parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となるx - パラメータ値SQLException - データベース・アクセス・エラーが発生した場合void setBigDecimal(String parameterName, BigDecimal x) throws SQLException
java.math.BigDecimal値に設定します。 データベースに送るときに、ドライバはこれをSQL NUMERIC値に変換します。 parameterName - パラメータの名前x - パラメータ値SQLException - データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementについて呼び出された場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合ResultSet.getBigDecimal(int, int)void setString(int parameterIndex,
String x)
throws SQLException
RowSetオブジェクトのコマンド内の指定されたパラメータを、指定されたJava String値に設定します。 これは、データベースへの送信前に、ドライバによってSQL VARCHARまたはLONGVARCHAR値に変換されます(ドライバのVARCHAR値の制限に関する引数のサイズに依存)。 parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となるx - パラメータ値SQLException - データベース・アクセス・エラーが発生した場合void setString(String parameterName, String x) throws SQLException
String値に設定します。 データベースに送るときに、ドライバはこれをSQL VARCHARまたはLONGVARCHAR値(ドライバのVARCHAR値の制限に対する引数のサイズに依存)に変換します。 parameterName - パラメータの名前x - パラメータ値SQLException - データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementについて呼び出された場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合ResultSet.getString(int)void setBytes(int parameterIndex,
byte[] x)
throws SQLException
RowSetオブジェクトのコマンド内の指定したパラメータを、byte値の指定したJava配列値に設定します。 これは、データベースへの送信前に、ドライバによってSQL VARBINARYまたはLONGVARBINARY値に変換されます(ドライバのVARBINARY値の制限に関する引数のサイズに依存)。 parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となるx - パラメータ値SQLException - データベース・アクセス・エラーが発生した場合void setBytes(String parameterName, byte[] x) throws SQLException
VARBINARYまたはLONGVARBINARY (ドライバのVARBINARY値の制限に対する引数のサイズに依存)に変換します。 parameterName - パラメータの名前x - パラメータ値SQLException - データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementについて呼び出された場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合ResultSet.getBytes(int)void setDate(int parameterIndex,
Date x)
throws SQLException
RowSetオブジェクトのコマンド内の指定されたパラメータを、指定されたjava.sql.Date値に設定します。 このパラメータは、データベースへの送信前に、デフォルトのjava.util.Calendarを使用して日付が計算され、ドライバによってSQL DATE値に変換されます。 parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となるx - パラメータ値SQLException - データベース・アクセス・エラーが発生した場合void setTime(int parameterIndex,
Time x)
throws SQLException
RowSetオブジェクトのコマンド内の指定されたパラメータを、指定されたjava.sql.Time値に設定します。 このパラメータは、データベースへの送信前に、デフォルトのjava.util.Calendarを使用して計算され、ドライバによってSQL TIME値に変換されます。 parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となるx - パラメータ値SQLException - データベース・アクセス・エラーが発生した場合void setTimestamp(int parameterIndex,
Timestamp x)
throws SQLException
RowSetオブジェクトのコマンド内の指定されたパラメータを、指定されたjava.sql.Timestamp値に設定します。 このパラメータは、データベースへの送信前に、デフォルトのjava.util.Calendarを使用して計算され、ドライバによってSQL TIMESTAMP値に変換されます。 parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となるx - パラメータ値SQLException - データベース・アクセス・エラーが発生した場合void setTimestamp(String parameterName, Timestamp x) throws SQLException
java.sql.Timestamp値に設定します。 データベースに送るときに、ドライバはこれをSQL TIMESTAMP値に変換します。 parameterName - パラメータの名前x - パラメータ値SQLException - データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementについて呼び出された場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合ResultSet.getTimestamp(int)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 - データベース・アクセス・エラーが発生した場合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ドライバがこのメソッドをサポートしない場合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 - データベース・アクセス・エラーが発生した場合void setBinaryStream(String parameterName, InputStream x, int length) throws SQLException
LONGVARBINARYパラメータに非常に大きなバイナリ値が入力されるときには、java.io.InputStreamオブジェクトを介して送るのが現実的です。 ファイルの終わりに達するまで必要に応じてストリームからデータが読み込まれます。
ノート: このストリーム・オブジェクトは、標準のJavaストリーム・オブジェクト、または標準インタフェースを実装する独自のサブクラスのどちらでもかまいません。
parameterName - パラメータの名前x - バイナリ・パラメータ値を含むJava入力ストリームlength - ストリームのバイト数SQLException - データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementについて呼び出された場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合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 - データベース・アクセス・エラーが発生した場合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ドライバがこのメソッドをサポートしない場合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ドライバがこのメソッドをサポートしない場合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ドライバがこのメソッドをサポートしない場合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ドライバがこのメソッドをサポートしない場合void setBinaryStream(String parameterName, InputStream x) throws SQLException
LONGVARBINARYパラメータに非常に大きなバイナリ値が入力されるときには、java.io.InputStreamオブジェクトを介して送るのが現実的です。 ファイルの終わりに達するまで必要に応じてストリームからデータが読み込まれます。
ノート: このストリーム・オブジェクトは、標準のJavaストリーム・オブジェクト、または標準インタフェースを実装する独自のサブクラスのどちらでもかまいません。
ノート: lengthパラメータを使用するバージョンのsetBinaryStreamを使用する方が効率的かどうかを判断するには、JDBCドライバのドキュメントを参照してください。
parameterName - パラメータの名前x - バイナリ・パラメータ値を含むJava入力ストリームSQLException - データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementについて呼び出された場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合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ドライバがこのメソッドをサポートしない場合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ドライバがこのメソッドをサポートしない場合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ドライバがこのメソッドをサポートしない場合void setObject(int parameterIndex,
Object x,
int targetSqlType,
int scaleOrLength)
throws SQLException
RowSetオブジェクトのコマンド内の指定したパラメータを、指定したJava Objectに設定します。 整数値の場合は等価なjava.langオブジェクトを使用する必要があります(たとえばintに対してIntegerクラスのインスタンス)。 2番目の引数がInputStreamである場合、ストリームにはscaleOrLengthで指定されるバイト数が含まれる必要があります。 2番目の引数が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の場合は、ストリームまたはリーダーのデータ長。 ほかのすべての型では、この値は無視される。 SQLException - データベース・アクセス・エラーが発生した場合Typesvoid setObject(String parameterName, Object x, int targetSqlType, int scale) throws SQLException
java.langオブジェクトを使用すべきです。
指定されたJavaオブジェクトは、データベースに送られる前に、指定されたtargetSqlTypeに変換されます。 オブジェクトがカスタム・マッピングを持つ場合(オブジェクトがインタフェースSQLDataを実装するクラスのインスタンスである場合)、JDBCドライバはSQLData.writeSQLメソッドを呼び出して、そのオブジェクトをSQLデータ・ストリームへ書き込む必要があります。 また、オブジェクトがRef、Blob、Clob、NClob、Struct、java.net.URL、またはArrayを実装するクラスのオブジェクトである場合、ドライバはこのオブジェクトを対応するSQL型の値としてデータベースに渡す必要があります。
このメソッドは、データベース固有の抽象データ型を渡すために使用できることに注意してください。
parameterName - パラメータの名前x - 入力パラメータ値を含むオブジェクトtargetSqlType - データベースに送られる(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ドライバがこのデータ型をサポートしていない場合Types、ResultSet.getObject(int)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 - データベース・アクセス・エラーが発生した場合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ドライバがこのデータ型をサポートしていない場合ResultSet.getObject(int)void setObject(String parameterName, Object x) throws SQLException
Object型である必要があります。したがって、組込み型の場合、等価なjava.langオブジェクトを使用すべきです。
JDBCの仕様では、JavaのObject型からSQL型への標準マッピングを規定しています。 指定された引数は、データベースに送られる前に、対応するSQL型に変換されます。
このメソッドは、ドライバ固有のJava型を使用して、データベース固有の抽象データ型を渡すために使用することに注意してください。 オブジェクトがインタフェースSQLDataを実装するクラスのインスタンスである場合、JDBCドライバはSQLData.writeSQLメソッドを呼び出して、そのオブジェクトをSQLデータ・ストリームへ書き込む必要があります。 また、オブジェクトがRef、Blob、Clob、NClob、Struct、java.net.URL、またはArrayを実装するクラスのオブジェクトである場合、ドライバはこのオブジェクトを対応するSQL型の値としてデータベースに渡す必要があります。
たとえば、オブジェクトが上記のインタフェースを複数実装するクラスであるなど、あいまいさがある場合、このメソッドは例外をスローします。
parameterName - パラメータの名前x - 入力パラメータ値を含むオブジェクトSQLException - データベース・アクセス・エラーが発生した場合、このメソッドがクローズされたCallableStatementで呼び出された場合、または指定されたObjectパラメータがあいまいな場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合ResultSet.getObject(int)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 - データベース・アクセス・エラーが発生した場合void setRef(int i,
Ref x)
throws SQLException
RowSetオブジェクトのコマンドで指定したパラメータを、指定したRef値に設定します。 このパラメータはドライバによって適切なREF(<structured-type>) (構造化型)値に変換されます。 i - 最初のパラメータは1、2番目のパラメータは2、... となるx - SQL REF型のデータを表すオブジェクトSQLException - データベース・アクセス・エラーが発生した場合void setBlob(int i,
Blob x)
throws SQLException
RowSetオブジェクトのコマンドで指定したパラメータを、指定したBlob値に設定します。 このパラメータは、データベースへの送信前に、ドライバによってBlobオブジェクトが表すBLOB値に変換されます。 i - 最初のパラメータは1、2番目のパラメータは2、... となるx - BLOBを表すオブジェクトSQLException - データベース・アクセス・エラーが発生した場合void setBlob(int parameterIndex,
InputStream inputStream,
long length)
throws SQLException
InputStreamオブジェクトに設定します。 inputstreamには、lengthで指定された文字数が含まれている必要があります。そうでない場合、PreparedStatementの実行時にSQLExceptionが生成されます。 このメソッドは、setBinaryStream (int, InputStream, int)メソッドと異なり、パラメータ値をBLOBとしてサーバーに送信するべきであることをドライバに通知します。 setBinaryStreamメソッドを使用すると、ドライバは、パラメータ・データをLONGVARBINARYとBLOBのどちらとしてサーバーに送信するべきかを判断するために余計な作業を行う必要がある可能性があります。 parameterIndex - 最初のパラメータのインデックスは1、2番目のパラメータのインデックスは2、... となるinputStream - パラメータ値に設定されるデータを含むオブジェクト。length - パラメータ・データ内のバイト数。SQLException - データベース・アクセス・エラーが発生した場合、このメソッドがクローズされたPreparedStatement上で呼び出された場合、parameterIndexがSQL文のパラメータ・マーカーと対応していない場合、長さとしてゼロ未満の値が指定された場合、入力ストリーム内のバイト数が指定された長さと一致していない場合。SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合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ドライバがこのメソッドをサポートしない場合void setBlob(String parameterName, InputStream inputStream, long length) throws SQLException
InputStreamオブジェクトに設定します。 inputstreamには、lengthで指定された文字数が含まれている必要があります。そうでない場合、CallableStatementの実行時にSQLExceptionが生成されます。 このメソッドは、setBinaryStream (int, InputStream, int)メソッドと異なり、パラメータ値をBLOBとしてサーバーに送信するべきであることをドライバに通知します。 setBinaryStreamメソッドを使用すると、ドライバは、パラメータ・データをLONGVARBINARYとBLOBのどちらとしてサーバーに送信するべきかを判断するために余計な作業を行う必要がある可能性があります。 parameterName - 2番目は2に設定されるパラメータの名前inputStream - パラメータ値に設定されるデータを含むオブジェクト。length - パラメータ・データ内のバイト数。SQLException - parameterIndexがSQL文のパラメータ・マーカーと対応していない場合、長さとしてゼロ未満の値が指定された場合、入力ストリーム内のバイト数が指定された長さと一致していない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatement上で呼び出された場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合void setBlob(String parameterName, Blob x) throws SQLException
java.sql.Blobオブジェクトに設定します。 データベースに送るときに、ドライバはこれをSQL BLOB値に変換します。 parameterName - パラメータの名前x - SQL BLOB値をマッピングするBlobオブジェクトSQLException - データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementについて呼び出された場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合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ドライバがこのメソッドをサポートしない場合void setClob(int i,
Clob x)
throws SQLException
RowSetオブジェクトのコマンドで指定したパラメータを、指定したClob値に設定します。 このパラメータは、データベースへの送信前に、ドライバによってClobオブジェクトが表すCLOB値に変換されます。 i - 最初のパラメータは1、2番目のパラメータは2、... となるx - CLOBを表すオブジェクトSQLException - データベース・アクセス・エラーが発生した場合void setClob(int parameterIndex,
Reader reader,
long length)
throws SQLException
Readerオブジェクトに設定します。 readerには、lengthで指定された文字数が含まれている必要があります。そうでない場合、PreparedStatementの実行時にSQLExceptionが生成されます。 このメソッドは、setCharacterStream (int, Reader, int)メソッドと異なり、パラメータ値をCLOBとしてサーバーに送信するべきであることをドライバに通知します。 setCharacterStreamメソッドを使用すると、ドライバは、パラメータ・データをLONGVARCHARとCLOBのどちらとしてサーバーに送信するべきかを判断するために余計な作業を行う必要がある可能性があります。 parameterIndex - 最初のパラメータのインデックスは1、2番目のパラメータのインデックスは2、... となるreader - パラメータ値に設定されるデータを含むオブジェクト。length - パラメータ・データ内の文字数。SQLException - データベース・アクセス・エラーが発生した場合、このメソッドがクローズされたPreparedStatementで呼び出された場合、parameterIndexがSQL文のパラメータ・マーカーと対応していない場合、または長さとしてゼロ未満の値が指定された場合。SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合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ドライバがこのメソッドをサポートしない場合void setClob(String parameterName, Reader reader, long length) throws SQLException
Readerオブジェクトに設定します。 readerには、lengthで指定された文字数が含まれている必要があります。そうでない場合、CallableStatementの実行時にSQLExceptionが生成されます。 このメソッドは、setCharacterStream (int, Reader, int)メソッドと異なり、パラメータ値をCLOBとしてサーバーに送信するべきであることをドライバに通知します。 setCharacterStreamメソッドを使用すると、ドライバは、パラメータ・データをLONGVARCHARとCLOBのどちらとしてサーバーに送信するかを判断するために余計な作業を行う必要がある可能性があります。 parameterName - 設定されるパラメータの名前。reader - パラメータ値に設定されるデータを含むオブジェクト。length - パラメータ・データ内の文字数。SQLException - parameterIndexがSQL文のパラメータ・マーカーと対応していない場合、長さとしてゼロ未満の値が指定された場合、データベース・アクセス・エラーが発生した場合、このメソッドがクローズされたCallableStatementで呼び出された場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合void setClob(String parameterName, Clob x) throws SQLException
java.sql.Clobオブジェクトに設定します。 データベースに送るときに、ドライバはこれをSQL CLOB値に変換します。 parameterName - パラメータの名前x - SQL CLOB値をマッピングするClobオブジェクトSQLException - データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementについて呼び出された場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合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ドライバがこのメソッドをサポートしない場合void setArray(int i,
Array x)
throws SQLException
RowSetオブジェクトのコマンドで指定したパラメータを、指定したArray値に設定します。 このパラメータは、データベースへの送信前に、ドライバによってArrayオブジェクトが表すARRAY値に変換されます。 i - 最初のパラメータは1、2番目のパラメータは2、... となるx - SQL ARRAYを表すオブジェクトSQLException - データベース・アクセス・エラーが発生した場合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 - データベース・アクセス・エラーが発生した場合void setDate(String parameterName, Date x) throws SQLException
java.sql.Date値に設定します。 データベースに送るときに、ドライバはこれをSQL DATE値に変換します。 parameterName - パラメータの名前x - パラメータ値SQLException - データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementについて呼び出された場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合ResultSet.getDate(int)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ドライバがこのメソッドをサポートしない場合ResultSet.getDate(int)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 - データベース・アクセス・エラーが発生した場合void setTime(String parameterName, Time x) throws SQLException
java.sql.Time値に設定します。 データベースに送るときに、ドライバはこれをSQL TIME値に変換します。 parameterName - パラメータの名前x - パラメータ値SQLException - データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementについて呼び出された場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合ResultSet.getTime(int)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ドライバがこのメソッドをサポートしない場合ResultSet.getTime(int)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 - データベース・アクセス・エラーが発生した場合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ドライバがこのメソッドをサポートしない場合ResultSet.getTimestamp(int)void clearParameters()
throws SQLException
RowSetオブジェクトのコマンド用のパラメータ・セットをクリアします。
通常、RowSetオブジェクトを繰返し使用するために、パラメータ値は強制的に残されます。 パラメータ値を設定すると、前の値は自動的にクリアされます。 しかし、現在のパラメータ値によって使用されたリソースをただちに解放した方が役に立つ場合があります。これは、clearParametersメソッドを呼び出して実行できます。
SQLException - データベース・アクセス・エラーが発生した場合void execute()
throws SQLException
RowSetオブジェクトにデータを格納します。
executeメソッドは、url、データ・ソース名、ユーザー名、パスワード、トランザクション遮断、型マップなどのプロパティを使用して、データを読み取るために接続を作成します。 executeメソッドは、コマンド、読取り専用、最大フィールド・サイズ、最大行数、エスケープ処理、クエリー・タイムアウトなどのプロパティを使用して、コマンド実行文を作成します。
要求したプロパティが設定されていない場合は例外がスローされます。 このメソッドの実行が成功すると、行セットの現在の内容は破棄され、行セットのメタデータも(再)設定されます。 未処理の更新がある場合、これらは無視されます。
このRowSetオブジェクトがデータのソースとの連続した接続を保持できない場合は、リーダー(RowSetReaderオブジェクト)がデータを入れるために使用されます。 この場合、リーダーはこのRowSetオブジェクトで登録されており、executeメソッドでは、実装の一部としてリーダーのreadDataメソッドを呼び出します。
SQLException - データベース・アクセス・エラーが発生した場合、または、接続を作成し、文を作成するために必要なプロパティのどれかが設定されていない場合void addRowSetListener(RowSetListener listener)
RowSetオブジェクトで発生するイベントが通知されるようにします。listener - RowSetListenerインタフェースを実装し、かつ、このRowSetオブジェクトでイベントが発生したときに通知を受けるコンポーネントremoveRowSetListener(javax.sql.RowSetListener)void removeRowSetListener(RowSetListener listener)
RowSetオブジェクトでイベントが発生したときに通知されるコンポーネントのリストから削除します。listener - このRowSetオブジェクトのリスナーとして登録されているコンポーネントaddRowSetListener(javax.sql.RowSetListener)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が含まれていない場合)。 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が含まれていない場合)。 void setRowId(int parameterIndex,
RowId x)
throws SQLException
java.sql.RowIdオブジェクトに設定します。 データベースに送るときに、ドライバはこれをSQL ROWID値に変換します。 parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となるx - パラメータ値SQLException - データベース・アクセス・エラーが発生した場合void setRowId(String parameterName, RowId x) throws SQLException
java.sql.RowIdオブジェクトに設定します。 データベースに送るときに、ドライバはこれをSQL ROWIDに変換します。 parameterName - パラメータの名前x - パラメータ値SQLException - データベース・アクセス・エラーが発生した場合void setNString(int parameterIndex,
String value)
throws SQLException
Stringオブジェクトに設定します。 データベースに送るときに、ドライバはこれをSQL NCHAR、NVARCHAR、またはLONGNVARCHAR値(ドライバのNVARCHAR値に関する制限に関する引数のサイズに依存)に変換します。 parameterIndex - 最初のパラメータのインデックスは1、2番目のパラメータのインデックスは2、... となるvalue - パラメータ値SQLException - ドライバが各国文字セットをサポートしない場合、ドライバがデータ変換エラーが発生した可能性を検出できる場合、またはデータベース・アクセス・エラーが発生した場合void setNString(String parameterName, String value) throws SQLException
Stringオブジェクトに設定します。 ドライバはこれをSQL NCHAR、NVARCHAR、またはLONGNVARCHARに変換します。 parameterName - 設定される列の名前value - パラメータ値SQLException - ドライバが各国文字セットをサポートしない場合、ドライバがデータ変換エラーが発生した可能性を検出できる場合、またはデータベース・アクセス・エラーが発生した場合void setNCharacterStream(int parameterIndex,
Reader value,
long length)
throws SQLException
Readerオブジェクトに設定します。 Readerは、ファイルの終わりに達するまでデータを読み込みます。 ドライバは、必要に応じて、Javaの文字表現をデータベース内の各国文字セットに変換します。 parameterIndex - 最初のパラメータのインデックスは1、2番目のパラメータのインデックスは2、... となるvalue - パラメータ値length - パラメータ・データ内の文字数。SQLException - ドライバが各国文字セットをサポートしない場合、ドライバがデータ変換エラーが発生した可能性を検出できる場合、またはデータベース・アクセス・エラーが発生した場合void setNCharacterStream(String parameterName, Reader value, long length) throws SQLException
Readerオブジェクトに設定します。 Readerは、ファイルの終わりに達するまでデータを読み込みます。 ドライバは、必要に応じて、Javaの文字表現をデータベース内の各国文字セットに変換します。 parameterName - 設定される列の名前value - パラメータ値length - パラメータ・データ内の文字数。SQLException - ドライバが各国文字セットをサポートしない場合、ドライバがデータ変換エラーが発生した可能性を検出できる場合、またはデータベース・アクセス・エラーが発生した場合void setNCharacterStream(String parameterName, Reader value) throws SQLException
Readerオブジェクトに設定します。 Readerは、ファイルの終わりに達するまでデータを読み込みます。 ドライバは、必要に応じて、Javaの文字表現をデータベース内の各国文字セットに変換します。
ノート: このストリーム・オブジェクトは、標準のJavaストリーム・オブジェクト、または標準インタフェースを実装する独自のサブクラスのどちらでもかまいません。
ノート: lengthパラメータを使用するバージョンのsetNCharacterStreamを使用する方が効率的かどうかを判断するには、JDBCドライバのドキュメントを参照してください。
parameterName - パラメータの名前value - パラメータ値SQLException - ドライバが各国文字セットをサポートしない場合、ドライバがデータ変換エラーが発生した可能性を検出できる場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatement上で呼び出された場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合void setNClob(String parameterName, NClob value) throws SQLException
java.sql.NClobオブジェクトに設定します。 このオブジェクトは、java.sql.NClobインタフェースを実装します。 このNClobオブジェクトは、SQL NCLOBにマッピングされます。 parameterName - 設定される列の名前value - パラメータ値SQLException - ドライバが各国文字セットをサポートしない場合、ドライバがデータ変換エラーが発生した可能性を検出できる場合、またはデータベース・アクセス・エラーが発生した場合void setNClob(String parameterName, Reader reader, long length) throws SQLException
Readerオブジェクトに設定します。 readerには、lengthで指定された文字数が含まれている必要があります。そうでない場合、CallableStatementの実行時にSQLExceptionが生成されます。 このメソッドは、setCharacterStream (int, Reader, int)メソッドと異なり、パラメータ値をNCLOBとしてサーバーに送信するべきであることをドライバに通知します。 setCharacterStreamメソッドを使用すると、ドライバは、パラメータ・データをLONGNVARCHARとNCLOBのどちらとしてサーバーに送信するかを判断するために余計な作業を行う必要がある可能性があります。 parameterName - 設定されるパラメータの名前。reader - パラメータ値に設定されるデータを含むオブジェクト。length - パラメータ・データ内の文字数。SQLException - parameterIndexがSQL文のパラメータ・マーカーと対応していない場合、長さとしてゼロ未満の値が指定された場合、ドライバが各国文字セットをサポートしない場合、ドライバがデータ変換エラーが発生した可能性を検出できる場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatement上で呼び出された場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合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ドライバがこのメソッドをサポートしない場合void setNClob(int parameterIndex,
Reader reader,
long length)
throws SQLException
Readerオブジェクトに設定します。 readerには、lengthで指定された文字数が含まれている必要があります。そうでない場合、PreparedStatementの実行時にSQLExceptionが生成されます。 このメソッドは、setCharacterStream (int, Reader, int)メソッドと異なり、パラメータ値をNCLOBとしてサーバーに送信するべきであることをドライバに通知します。 setCharacterStreamメソッドを使用すると、ドライバは、パラメータ・データをLONGNVARCHARとNCLOBのどちらとしてサーバーに送信するべきかを判断するために余計な作業を行う必要がある可能性があります。 parameterIndex - 最初のパラメータのインデックスは1、2番目のパラメータのインデックスは2、... となるreader - パラメータ値に設定されるデータを含むオブジェクト。length - パラメータ・データ内の文字数。SQLException - parameterIndexがSQL文のパラメータ・マーカーと対応していない場合、長さとしてゼロ未満の値が指定された場合、ドライバが各国文字セットをサポートしない場合、ドライバがデータ変換エラーが発生した可能性を検出できる場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたPreparedStatement上で呼び出された場合SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合void setNClob(int parameterIndex,
NClob value)
throws SQLException
java.sql.NClobオブジェクトに設定します。 データベースに送るときに、ドライバはこれをSQL NCLOB値に変換します。 parameterIndex - 最初のパラメータのインデックスは1、2番目のパラメータのインデックスは2、... となるvalue - パラメータ値SQLException - ドライバが各国文字セットをサポートしない場合、ドライバがデータ変換エラーが発生した可能性を検出できる場合、またはデータベース・アクセス・エラーが発生した場合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ドライバがこのメソッドをサポートしない場合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ドライバがこのメソッドをサポートしない場合 バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。 そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2025, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Documentation Redistribution Policyも参照してください。