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, 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, 2013, Oracle and/or its affiliates. All rights reserved.