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, wasNull
isWrapperFor, unwrap
String 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
、更新可能な場合はfalse
setReadOnly(boolean)
void setReadOnly(boolean value) throws SQLException
RowSet
オブジェクトが読取り専用かどうかを、指定したboolean
に設定します。value
- 読取り専用の場合はtrue
、更新可能な場合はfalse
SQLException
- データベース・アクセス・エラーが発生した場合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
、無効な場合はfalse
SQLException
- データベース・アクセス・エラーが発生した場合setEscapeProcessing(boolean)
void setEscapeProcessing(boolean enable) throws SQLException
RowSet
オブジェクトのエスケープの処理をオンまたはオフに設定します。エスケープ・スキャニングがオンの場合(デフォルト)、ドライバはSQL文をデータベースに送る前にエスケープ置換えを実行します。enable
- エスケープ処理を有効にする場合はtrue
、無効にする場合はfalse
SQLException
- データベース・アクセス・エラーが発生した場合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_SENSITIVE
SQLException
- データベース・アクセス・エラーが発生した場合ResultSet.getType()
void setConcurrency(int concurrency) throws SQLException
RowSet
オブジェクトの並行性を、指定した並行性レベルに設定します。このメソッドは、デフォルトでResultSet.CONCUR_READ_ONLY
である行セットの並行性レベルを変更するために用いられます。concurrency
- 並行処理のレベルを指定するResultSet
定数。ResultSet.CONCUR_READ_ONLY
またはResultSet.CONCUR_UPDATABLE
SQLException
- データベース・アクセス・エラーが発生した場合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
- データベース・アクセス・エラーが発生した場合Types
void setObject(String parameterName, Object x, int targetSqlType, int scale) throws SQLException
java.lang
オブジェクトを使用すべきです。
指定されたJavaオブジェクトは、データベースに送られる前に、指定されたtargetSqlTypeに変換されます。オブジェクトがカスタム・マッピングを持つ場合(オブジェクトがインタフェースSQLData
を実装するクラスのインスタンスである場合)、JDBCドライバはSQLData.writeSQL
メソッドを呼び出して、そのオブジェクトをSQLデータ・ストリームへ書き込む必要があります。また、オブジェクトがRef
、Blob
、Clob
、NClob
、Struct
、java.net.URL
、またはArray
を実装するクラスのオブジェクトである場合、ドライバはこのオブジェクトを対応するSQL型の値としてデータベースに渡す必要があります。
このメソッドは、データベース固有の抽象データ型を渡すために使用できることに注意してください。
parameterName
- パラメータの名前x
- 入力パラメータ値を含むオブジェクトtargetSqlType
- データベースに送られる(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, 2014, Oracle and/or its affiliates. All rights reserved.