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