概要  パッケージ   クラス  使用  階層ツリー  非推奨 API  索引  ヘルプ 
JavaTM Platform
Standard Ed. 6
 前のクラス   次のクラス フレームあり    フレームなし    
概要: 入れ子 | フィールド | コンストラクタ | メソッド 詳細: フィールド | コンストラクタ | メソッド

javax.sql
インタフェース RowSet

すべてのスーパーインタフェース:
ResultSet, Wrapper
既知のサブインタフェースの一覧:
CachedRowSet, FilteredRowSet, JdbcRowSet, JoinRowSet, SyncResolver, WebRowSet
public interface RowSet
extends ResultSet

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

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

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

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

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

切断された行セットには、関連付けられたリーダー (RowSetReader オブジェクト) とライター (RowSetWriter オブジェクト) があります。リーダーは、データ付きで行セットを生成するためにさまざまな方法で実装されており、非関係データソースからデータを取得することもできます。ライターもまたさまざまな方法で実装されており、行セットのデータに加えられた変更を基本となるデータソースへ送り戻すことができます。  

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

導入されたバージョン:
1.4

フィールドの概要
 
インタフェース java.sql.ResultSet から継承されたフィールド
CLOSE_CURSORS_AT_COMMIT, CONCUR_READ_ONLY, CONCUR_UPDATABLE, FETCH_FORWARD, FETCH_REVERSE, FETCH_UNKNOWN, HOLD_CURSORS_OVER_COMMIT, TYPE_FORWARD_ONLY, TYPE_SCROLL_INSENSITIVE, TYPE_SCROLL_SENSITIVE
 
メソッドの概要
 void addRowSetListener(RowSetListener listener)
          指定したイベントリスナーを登録して、この RowSet オブジェクトで発生するイベントが通知されるようにします。
 void clearParameters()
          この RowSet オブジェクトのコマンド用のパラメータセットをクリアします。
 void execute()
          この RowSet オブジェクトにデータを格納します。
 String getCommand()
          この RowSet オブジェクトの command プロパティーを取得します。
 String getDataSourceName()
          この RowSet オブジェクトのデータソースを特定する論理名を取得します。
 boolean getEscapeProcessing()
          この RowSet オブジェクトのエスケープの処理が有効かどうかを取得します。
 int getMaxFieldSize()
          ある列値で返される最大バイト数を取得します。
 int getMaxRows()
          データベースアクセスエラーが発生した場合 この RowSet オブジェクトに含めることのできる最大行数を取得します。
 String getPassword()
          データベース接続の作成に使用するパスワードを取得します。
 int getQueryTimeout()
          ドライバが文の実行を待つ最大秒数を取得します。
 int getTransactionIsolation()
          この RowSet オブジェクトのトランザクション遮断レベルの設定を取得します。
 Map<String,Class<?>> getTypeMap()
          この RowSet オブジェクトに関連付けられた SQL ユーザー定義型のカスタムマッピングがある場合には、それを指定する Map オブジェクトを取得します。
 String getUrl()
          この RowSet オブジェクトが接続を確立するのに DataSource オブジェクトではなく DriverManager を使用する場合に、接続を作成するために使用する url プロパティーを取得します。
 String getUsername()
          この RowSet オブジェクトのデータベース接続を作成するために使用される username を取得します。
 boolean isReadOnly()
          この RowSet オブジェクトが読み取り専用かどうかを確認します。
 void removeRowSetListener(RowSetListener listener)
          指定したリスナーを、この RowSet オブジェクトでイベントが発生したときに通知されるコンポーネントのリストから削除します。
 void setArray(int i, Array x)
          この RowSet オブジェクトのコマンドで指定したパラメータを、指定した Array 値に設定します。
 void setAsciiStream(int parameterIndex, InputStream x)
          この RowSet オブジェクトのコマンド内の指定されたパラメータを、指定された入力ストリームに設定します。
 void setAsciiStream(int parameterIndex, InputStream x, int length)
          この RowSet オブジェクトのコマンド内の指定したパラメータを、指定した java.io.InputStream 値に設定します。
 void setAsciiStream(String parameterName, InputStream x)
          指定されたパラメータを、指定された入力ストリームに設定します。
 void setAsciiStream(String parameterName, InputStream x, int length)
          指定されたパラメータを、指定されたバイト数を持つ指定された入力ストリームに設定します。
 void setBigDecimal(int parameterIndex, BigDecimal x)
          この RowSet オブジェクトのコマンド内の指定したパラメータを、指定した java.math.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)
          指定されたパラメータを、指定された Java の String オブジェクトに設定します。
 void setNString(String parameterName, String value)
          指定されたパラメータを、指定された Java の 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 オブジェクトのコマンドで指定したパラメータを、指定した Java 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)
          指定した java.util.Map オブジェクトを、この RowSet オブジェクトのデフォルト型マップとしてインストールします。
 void setURL(int parameterIndex, URL x)
          指定されたパラメータを指定された java.net.URL 値に設定します。
 void setUrl(String url)
          この RowSet オブジェクトが DriverManager を使って接続を作成するときに使用する URL を設定します。
 void setUsername(String name)
          この RowSet オブジェクトの username プロパティーを、指定した String に設定します。
 
インタフェース java.sql.ResultSet から継承されたメソッド
absolute, afterLast, beforeFirst, cancelRowUpdates, clearWarnings, close, deleteRow, findColumn, first, getArray, getArray, getAsciiStream, getAsciiStream, getBigDecimal, getBigDecimal, getBigDecimal, getBigDecimal, getBinaryStream, getBinaryStream, getBlob, getBlob, getBoolean, getBoolean, getByte, getByte, getBytes, getBytes, getCharacterStream, getCharacterStream, getClob, getClob, getConcurrency, getCursorName, getDate, getDate, getDate, getDate, getDouble, getDouble, getFetchDirection, getFetchSize, getFloat, getFloat, getHoldability, getInt, getInt, getLong, getLong, getMetaData, getNCharacterStream, getNCharacterStream, getNClob, getNClob, getNString, getNString, getObject, getObject, getObject, getObject, 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
 
インタフェース java.sql.Wrapper から継承されたメソッド
isWrapperFor, unwrap
 

メソッドの詳細

getUrl

String getUrl()
              throws SQLException
この RowSet オブジェクトが接続を確立するのに DataSource オブジェクトではなく DriverManager を使用する場合に、接続を作成するために使用する url プロパティーを取得します。デフォルト値は null です。

戻り値:
URL を表す文字列
例外:
SQLException - データベースアクセスエラーが発生した場合
関連項目:
setUrl(java.lang.String)

setUrl

void setUrl(String url)
            throws SQLException
この RowSet オブジェクトが DriverManager を使って接続を作成するときに使用する URL を設定します。 このプロパティーの設定は省略可能です。URL を使用する場合は、データベースへの接続に行セットが使用される前に、その URL を受け入れる JDBC ドライバをロードします。行セットでは、データを読み書きするときに、この URL を内部的に使用して、データベース接続を作成します。URL とデータソース名のうち、新しく null 以外の値が設定された方が接続の作成に使用されます。

パラメータ:
url - 文字列値。null も可
例外:
SQLException - データベースアクセスエラーが発生した場合
関連項目:
getUrl()

getDataSourceName

String getDataSourceName()
この RowSet オブジェクトのデータソースを特定する論理名を取得します。

戻り値:
データソース名
関連項目:
setDataSourceName(java.lang.String), setUrl(java.lang.String)

setDataSourceName

void setDataSourceName(String name)
                       throws SQLException
この RowSet オブジェクトのデータソース名プロパティーを、指定した String に設定します。  

データソース名プロパティーの値は、ネームサービスで登録された DataSource オブジェクトをルックアップするために使用されます。取得された DataSource オブジェクトを使って、このオブジェクトが表すデータソースへの接続を作成できます。

パラメータ:
name - この RowSet オブジェクトのデータソースの論理名。null も可
例外:
SQLException - データベースアクセスエラーが発生した場合
関連項目:
getDataSourceName()

getUsername

String getUsername()
この RowSet オブジェクトのデータベース接続を作成するために使用される username を取得します。username プロパティーは、実行時に execute メソッドを呼び出す前に設定されます。通常、これは RowSet オブジェクトの直列化状態の一部ではありません。

戻り値:
username プロパティー
関連項目:
setUsername(java.lang.String)

setUsername

void setUsername(String name)
                 throws SQLException
この RowSet オブジェクトの username プロパティーを、指定した String に設定します。

パラメータ:
name - ユーザー名
例外:
SQLException - データベースアクセスエラーが発生した場合
関連項目:
getUsername()

getPassword

String getPassword()
データベース接続の作成に使用するパスワードを取得します。password プロパティーは、実行時に execute メソッドを呼び出す前に設定されます。通常、これは RowSet オブジェクトの直列化状態の一部ではありません。

戻り値:
データベース接続の作成に必要なパスワード
関連項目:
setPassword(java.lang.String)

setPassword

void setPassword(String password)
                 throws SQLException
この RowSet オブジェクトのデータベースパスワードを、指定した String に設定します。

パラメータ:
password - パスワードを表す文字列
例外:
SQLException - データベースアクセスエラーが発生した場合
関連項目:
getPassword()

getTransactionIsolation

int getTransactionIsolation()
この RowSet オブジェクトのトランザクション遮断レベルの設定を取得します。

戻り値:
トランザクション遮断レベル。 Connection.TRANSACTION_READ_UNCOMMITTED、 Connection.TRANSACTION_READ_COMMITTED、 Connection.TRANSACTION_REPEATABLE_READ、 Connection.TRANSACTION_SERIALIZABLE のどれか
関連項目:
setTransactionIsolation(int)

setTransactionIsolation

void setTransactionIsolation(int level)
                             throws SQLException
この RowSet オブジェクトのトランザクション遮断レベルを設定します。

パラメータ:
level - トランザクション遮断レベル。 Connection.TRANSACTION_READ_UNCOMMITTED、 Connection.TRANSACTION_READ_COMMITTED、 Connection.TRANSACTION_REPEATABLE_READ、 Connection.TRANSACTION_SERIALIZABLE のどれか
例外:
SQLException - データベースアクセスエラーが発生した場合
関連項目:
getTransactionIsolation()

getTypeMap

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

戻り値:
SQL ユーザー定義型とそれらがマッピングされる Java クラスが格納されている java.util.Map オブジェクト
例外:
SQLException - データベースアクセスエラーが発生した場合
関連項目:
setTypeMap(java.util.Map>)

setTypeMap

void setTypeMap(Map<String,Class<?>> map)
                throws SQLException
指定した java.util.Map オブジェクトを、この RowSet オブジェクトのデフォルト型マップとしてインストールします。別の型マップがメソッドのパラメータとして指定されるまで、この型マップが使用されます。

パラメータ:
map - SQL ユーザー定義型とそれらがマッピングされる Java クラスが格納されている java.util.Map オブジェクト
例外:
SQLException - データベースアクセスエラーが発生した場合
関連項目:
getTypeMap()

getCommand

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

戻り値:
コマンド文字列。null も可
関連項目:
setCommand(java.lang.String)

setCommand

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

パラメータ:
cmd - この RowSet オブジェクトのデータを取得するために使用される SQL クエリー。null も可
例外:
SQLException - データベースアクセスエラーが発生した場合
関連項目:
getCommand()

isReadOnly

boolean isReadOnly()
この RowSet オブジェクトが読み取り専用かどうかを確認します。更新が可能な場合、行セットのデフォルトは更新可能になります。  

読み取り専用の行セットを更新しようとすると、SQLException がスローされます。

戻り値:
この RowSet オブジェクトが読み取り専用の場合は true、更新可能な場合は false
関連項目:
setReadOnly(boolean)

setReadOnly

void setReadOnly(boolean value)
                 throws SQLException
この RowSet オブジェクトが読み取り専用かどうかを、指定した boolean に設定します。

パラメータ:
value - 読み取り専用の場合は true、更新可能な場合は false
例外:
SQLException - データベースアクセスエラーが発生した場合
関連項目:
isReadOnly()

getMaxFieldSize

int getMaxFieldSize()
                    throws SQLException
ある列値で返される最大バイト数を取得します。この制限値は、BINARY、VARBINARY、LONGVARBINARYBINARY、CHAR、VARCHAR、LONGVARCHAR、NCHAR、および NVARCHAR の各列だけに適用されます。制限値を超えたデータは通知なしに破棄されます。

戻り値:
現在の最大列サイズ制限値。0 は制限がないことを表す
例外:
SQLException - データベースアクセスエラーが発生した場合
関連項目:
setMaxFieldSize(int)

setMaxFieldSize

void setMaxFieldSize(int max)
                     throws SQLException
列値に返される最大バイト数を、指定されたバイト数に設定します。この制限値は、BINARY、VARBINARY、LONGVARBINARYBINARY、CHAR、VARCHAR、LONGVARCHAR、NCHAR、および NVARCHAR の各列だけに適用されます。制限値を超えたデータは通知なしに破棄されます。移植性を最大限にするには、256 より大きい値を使用します。

パラメータ:
max - 新しい最大列サイズの制限値 (バイト)。ゼロは無制限を意味する
例外:
SQLException - データベースアクセスエラーが発生した場合
関連項目:
getMaxFieldSize()

getMaxRows

int getMaxRows()
               throws SQLException
データベースアクセスエラーが発生した場合 この RowSet オブジェクトに含めることのできる最大行数を取得します。制限値を超えた行は通知なしに除外されます。

戻り値:
この RowSet オブジェクトに含めることのできる現在の最大行数。ゼロは無制限を意味する
例外:
SQLException - データベースアクセスエラーが発生した場合
関連項目:
setMaxRows(int)

setMaxRows

void setMaxRows(int max)
                throws SQLException
データベースアクセスエラーが発生した場合 この RowSet オブジェクトに含めることのできる最大の行数を、指定した値に設定します。制限値を超えた行は通知なしに除外されます。

パラメータ:
max - 新しい最大行数。ゼロは無制限を意味する
例外:
SQLException - データベースアクセスエラーが発生した場合
関連項目:
getMaxRows()

getEscapeProcessing

boolean getEscapeProcessing()
                            throws SQLException
この RowSet オブジェクトのエスケープの処理が有効かどうかを取得します。エスケープスキャンニングがオンの場合 (デフォルト)、ドライバは SQL 文をデータベースに送る前にエスケープ置き換えを実行します。

戻り値:
エスケープ処理が有効な場合は true、無効な場合は false
例外:
SQLException - データベースアクセスエラーが発生した場合
関連項目:
setEscapeProcessing(boolean)

setEscapeProcessing

void setEscapeProcessing(boolean enable)
                         throws SQLException
この RowSet オブジェクトのエスケープの処理をオンまたはオフに設定します。エスケープスキャンニングがオンの場合 (デフォルト)、ドライバは SQL 文をデータベースに送る前にエスケープ置き換えを実行します。

パラメータ:
enable - エスケープ処理を有効にする場合は true、無効にする場合は false
例外:
SQLException - データベースアクセスエラーが発生した場合
関連項目:
getEscapeProcessing()

getQueryTimeout

int getQueryTimeout()
                    throws SQLException
ドライバが文の実行を待つ最大秒数を取得します。この制限時間を経過すると、SQLException がスローされます。

戻り値:
現在のクエリータイムアウトの制限値 (秒数)。ゼロは無制限を意味する
例外:
SQLException - データベースアクセスエラーが発生した場合
関連項目:
setQueryTimeout(int)

setQueryTimeout

void setQueryTimeout(int seconds)
                     throws SQLException
データベースアクセスエラーが発生した場合 ドライバが文の実行を待つ最大時間を、指定した秒数に設定します。この制限時間を経過すると、SQLException がスローされます。

パラメータ:
seconds - 新しいクエリータイムアウトの制限値の秒数。ゼロは無制限を意味する
例外:
SQLException - データベースアクセスエラーが発生した場合
関連項目:
getQueryTimeout()

setType

void setType(int type)
             throws SQLException
この RowSet オブジェクトの型を、指定した型に設定します。このメソッドは、デフォルトで読み取り専用でスクロール不可の行セットの型を変更するために用いられます。

パラメータ:
type - 型を指定する ResultSet 定数。ResultSet.TYPE_FORWARD_ONLY、ResultSet.TYPE_SCROLL_INSENSITIVE、または ResultSet.TYPE_SCROLL_SENSITIVE のどれか
例外:
SQLException - データベースアクセスエラーが発生した場合
関連項目:
ResultSet.getType()

setConcurrency

void setConcurrency(int concurrency)
                    throws SQLException
この RowSet オブジェクトの並行性を、指定した並行性レベルに設定します。このメソッドは、デフォルトで ResultSet.CONCUR_READ_ONLY である行セットの並行性レベルを変更するために用いられます。

パラメータ:
concurrency - 並行処理のレベルを指定する ResultSet 定数。ResultSet.CONCUR_READ_ONLY または ResultSet.CONCUR_UPDATABLE のどちらか
例外:
SQLException - データベースアクセスエラーが発生した場合
関連項目:
ResultSet.getConcurrency()

setNull

void setNull(int parameterIndex,
             int sqlType)
             throws SQLException
この RowSet オブジェクトの、指定した SQL コマンドのパラメータを、SQL NULL に設定します。

注: パラメータの SQL の型を指定する必要があります。

パラメータ:
parameterIndex - 最初のパラメータは 1、2 番目のパラメータは 2、... となる
sqlType - java.sql.Types によって定義される SQL の型のコード
例外:
SQLException - データベースアクセスエラーが発生した場合

setNull

void setNull(String parameterName,
             int sqlType)
             throws SQLException
指定されたパラメータを SQL NULL に設定します。

注: パラメータの SQL の型を指定する必要があります。

パラメータ:
parameterName - パラメータの名前
sqlType - java.sql.Types で定義される SQL 型コード
例外:
SQLException - データベースアクセスエラーが発生した場合、またはこのメソッドがクローズされた CallableStatement について呼び出された場合
SQLFeatureNotSupportedException - JDBC ドライバがこのメソッドをサポートしない場合
導入されたバージョン:
1.4

setNull

void setNull(int paramIndex,
             int sqlType,
             String typeName)
             throws SQLException
この RowSet オブジェクトの、指定した SQL コマンドのパラメータを、SQL NULL に設定します。SQL ユーザー定義型 (UDT) および REF 型のパラメータでは、このバージョンの setNull メソッドを使用する必要があります。UDT の例には、STRUCT、DISTINCT、JAVA_OBJECT、および名前付き配列があります。

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

パラメータ:
paramIndex - 最初のパラメータは 1、2 番目のパラメータは 2、... となる
sqlType - java.sql.Types からの値
typeName - SQL UDT の完全指定名、または REF 型で参照される SQL 構造型の型名。パラメータが UDT または REF 型でない場合は無視される
例外:
SQLException - データベースアクセスエラーが発生した場合

setNull

void setNull(String parameterName,
             int sqlType,
             String typeName)
             throws SQLException
指定されたパラメータを SQL NULL に設定します。ユーザー定義型および REF 型のパラメータでは、このバージョンのメソッド setNull を使用しなければなりません。ユーザー定義型の例には、STRUCT、DISTINCT、JAVA_OBJECT、および名前付き配列があります。

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

パラメータ:
parameterName - パラメータの名前
sqlType - java.sql.Types からの値
typeName - SQL ユーザー定義型の完全指定された名前。パラメータがユーザー定義型でも SQL REF 値でもない場合は無視される
例外:
SQLException - データベースアクセスエラーが発生した場合、またはこのメソッドがクローズされた CallableStatement について呼び出された場合
SQLFeatureNotSupportedException - JDBC ドライバがこのメソッドをサポートしない場合
導入されたバージョン:
1.4

setBoolean

void setBoolean(int parameterIndex,
                boolean x)
                throws SQLException
この RowSet オブジェクトのコマンド内の指定したパラメータを、指定した Java boolean 値に設定します。このパラメータは、データベースに送信される前に、ドライバによって SQL BIT 値に変換されます。

パラメータ:
parameterIndex - 最初のパラメータは 1、2 番目のパラメータは 2、... となる
x - パラメータ値
例外:
SQLException - データベースアクセスエラーが発生した場合

setBoolean

void setBoolean(String parameterName,
                boolean x)
                throws SQLException
指定されたパラメータを指定された Java の boolean 値に設定します。データベースに送るときに、ドライバはこれを SQL BIT または BOOLEAN 値に変換します。

パラメータ:
parameterName - パラメータの名前
x - パラメータ値
例外:
SQLException - データベースアクセスエラーが発生した場合、またはこのメソッドがクローズされた CallableStatement について呼び出された場合
SQLFeatureNotSupportedException - JDBC ドライバがこのメソッドをサポートしない場合
導入されたバージョン:
1.4
関連項目:
ResultSet.getBoolean(int)

setByte

void setByte(int parameterIndex,
             byte x)
             throws SQLException
この RowSet オブジェクトのコマンドにおいて指定したパラメータを、指定した Java byte 値に設定します。このパラメータは、データベースに送信される前に、ドライバによって SQL TINYINT 値に変換されます。

パラメータ:
parameterIndex - 最初のパラメータは 1、2 番目のパラメータは 2、... となる
x - パラメータ値
例外:
SQLException - データベースアクセスエラーが発生した場合

setByte

void setByte(String parameterName,
             byte x)
             throws SQLException
指定されたパラメータを指定された Java の byte 値に設定します。データベースに送るときに、ドライバはこれを SQL TINYINT 値に変換します。

パラメータ:
parameterName - パラメータの名前
x - パラメータ値
例外:
SQLException - データベースアクセスエラーが発生した場合、またはこのメソッドがクローズされた CallableStatement について呼び出された場合
SQLFeatureNotSupportedException - JDBC ドライバがこのメソッドをサポートしない場合
導入されたバージョン:
1.4
関連項目:
ResultSet.getByte(int)

setShort

void setShort(int parameterIndex,
              short x)
              throws SQLException
この RowSet オブジェクトのコマンド内の指定したパラメータを、指定した Java short 値に設定します。このパラメータは、データベースに送信される前に、ドライバによって SQL SMALLINT 値に変換されます。

パラメータ:
parameterIndex - 最初のパラメータは 1、2 番目のパラメータは 2、... となる
x - パラメータ値
例外:
SQLException - データベースアクセスエラーが発生した場合

setShort

void setShort(String parameterName,
              short x)
              throws SQLException
指定されたパラメータを指定された Java の short 値に設定します。データベースに送るときに、ドライバはこれを SQL SMALLINT 値に変換します。

パラメータ:
parameterName - パラメータの名前
x - パラメータ値
例外:
SQLException - データベースアクセスエラーが発生した場合、またはこのメソッドがクローズされた CallableStatement について呼び出された場合
SQLFeatureNotSupportedException - JDBC ドライバがこのメソッドをサポートしない場合
導入されたバージョン:
1.4
関連項目:
ResultSet.getShort(int)

setInt

void setInt(int parameterIndex,
            int x)
            throws SQLException
この RowSet オブジェクトのコマンド内の指定したパラメータを、指定した Java int 値に設定します。このパラメータは、データベースに送信される前に、ドライバによって SQL INTEGER 値に変換されます。

パラメータ:
parameterIndex - 最初のパラメータは 1、2 番目のパラメータは 2、... となる
x - パラメータ値
例外:
SQLException - データベースアクセスエラーが発生した場合

setInt

void setInt(String parameterName,
            int x)
            throws SQLException
指定されたパラメータを指定された Java の int 値に設定します。データベースに送るときに、ドライバはこれを SQL INTEGER 値に変換します。

パラメータ:
parameterName - パラメータの名前
x - パラメータ値
例外:
SQLException - データベースアクセスエラーが発生した場合、またはこのメソッドがクローズされた CallableStatement について呼び出された場合
SQLFeatureNotSupportedException - JDBC ドライバがこのメソッドをサポートしない場合
導入されたバージョン:
1.4
関連項目:
ResultSet.getInt(int)

setLong

void setLong(int parameterIndex,
             long x)
             throws SQLException
この RowSet オブジェクトのコマンド内の指定したパラメータを、指定した Java long 値に設定します。このパラメータは、データベースに送信される前に、ドライバによって SQL BIGINT 値に変換されます。

パラメータ:
parameterIndex - 最初のパラメータは 1、2 番目のパラメータは 2、... となる
x - パラメータ値
例外:
SQLException - データベースアクセスエラーが発生した場合

setLong

void setLong(String parameterName,
             long x)
             throws SQLException
指定されたパラメータを指定された Java の long 値に設定します。データベースに送るときに、ドライバはこれを SQL BIGINT 値に変換します。

パラメータ:
parameterName - パラメータの名前
x - パラメータ値
例外:
SQLException - データベースアクセスエラーが発生した場合、またはこのメソッドがクローズされた CallableStatement について呼び出された場合
SQLFeatureNotSupportedException - JDBC ドライバがこのメソッドをサポートしない場合
導入されたバージョン:
1.4
関連項目:
ResultSet.getLong(int)

setFloat

void setFloat(int parameterIndex,
              float x)
              throws SQLException
この RowSet オブジェクトのコマンド内の指定したパラメータを、指定した Java float 値に設定します。このパラメータは、データベースに送信される前に、ドライバによって SQL REAL 値に変換されます。

パラメータ:
parameterIndex - 最初のパラメータは 1、2 番目のパラメータは 2、... となる
x - パラメータ値
例外:
SQLException - データベースアクセスエラーが発生した場合

setFloat

void setFloat(String parameterName,
              float x)
              throws SQLException
指定されたパラメータを指定された Java の float 値に設定します。データベースに送るときに、ドライバはこれを SQL FLOAT 値に変換します。

パラメータ:
parameterName - パラメータの名前
x - パラメータ値
例外:
SQLException - データベースアクセスエラーが発生した場合、またはこのメソッドがクローズされた CallableStatement について呼び出された場合
SQLFeatureNotSupportedException - JDBC ドライバがこのメソッドをサポートしない場合
導入されたバージョン:
1.4
関連項目:
ResultSet.getFloat(int)

setDouble

void setDouble(int parameterIndex,
               double x)
               throws SQLException
この RowSet オブジェクトのコマンド内の指定したパラメータを、指定した Java double 値に設定します。このパラメータは、データベースに送信される前に、ドライバによって SQL DOUBLE 値に変換されます。

パラメータ:
parameterIndex - 最初のパラメータは 1、2 番目のパラメータは 2、... となる
x - パラメータ値
例外:
SQLException - データベースアクセスエラーが発生した場合

setDouble

void setDouble(String parameterName,
               double x)
               throws SQLException
指定されたパラメータを指定された Java の double 値に設定します。データベースに送るときに、ドライバはこれを SQL DOUBLE 値に変換します。

パラメータ:
parameterName - パラメータの名前
x - パラメータ値
例外:
SQLException - データベースアクセスエラーが発生した場合、またはこのメソッドがクローズされた CallableStatement について呼び出された場合
SQLFeatureNotSupportedException - JDBC ドライバがこのメソッドをサポートしない場合
導入されたバージョン:
1.4
関連項目:
ResultSet.getDouble(int)

setBigDecimal

void setBigDecimal(int parameterIndex,
                   BigDecimal x)
                   throws SQLException
この RowSet オブジェクトのコマンド内の指定したパラメータを、指定した java.math.BigDeciaml 値に設定します。このパラメータは、データベースに送信される前に、ドライバによって SQL NUMERIC 値に変換されます。

パラメータ:
parameterIndex - 最初のパラメータは 1、2 番目のパラメータは 2、... となる
x - パラメータ値
例外:
SQLException - データベースアクセスエラーが発生した場合

setBigDecimal

void setBigDecimal(String parameterName,
                   BigDecimal x)
                   throws SQLException
指定されたパラメータを指定された java.math.BigDecimal 値に設定します。データベースに送るときに、ドライバはこれを SQL NUMERIC 値に変換します。

パラメータ:
parameterName - パラメータの名前
x - パラメータ値
例外:
SQLException - データベースアクセスエラーが発生した場合、またはこのメソッドがクローズされた CallableStatement について呼び出された場合
SQLFeatureNotSupportedException - JDBC ドライバがこのメソッドをサポートしない場合
導入されたバージョン:
1.4
関連項目:
ResultSet.getBigDecimal(int, int)

setString

void setString(int parameterIndex,
               String x)
               throws SQLException
この RowSet オブジェクトのコマンド内の指定したパラメータを、指定した Java String 値に設定します。これは、データベースへの送信前に、ドライバによって SQL VARCHAR または LONGVARCHAR 値に変換されます (ドライバの VARCHAR 値の制限に関する引数のサイズに依存)。

パラメータ:
parameterIndex - 最初のパラメータは 1、2 番目のパラメータは 2、... となる
x - パラメータ値
例外:
SQLException - データベースアクセスエラーが発生した場合

setString

void setString(String parameterName,
               String x)
               throws SQLException
指定されたパラメータを指定された Java の String 値に設定します。データベースに送るときに、ドライバはこれを SQL VARCHAR または LONGVARCHAR 値 (ドライバの VARCHAR 値に関する制限に関する引数のサイズに依存) に変換します。

パラメータ:
parameterName - パラメータの名前
x - パラメータ値
例外:
SQLException - データベースアクセスエラーが発生した場合、またはこのメソッドがクローズされた CallableStatement について呼び出された場合
SQLFeatureNotSupportedException - JDBC ドライバがこのメソッドをサポートしない場合
導入されたバージョン:
1.4
関連項目:
ResultSet.getString(int)

setBytes

void setBytes(int parameterIndex,
              byte[] x)
              throws SQLException
この RowSet オブジェクトのコマンド内の指定したパラメータを、byte 値の指定した Java 配列値に設定します。これは、データベースへの送信前に、ドライバによって SQL VARBINARY または LONGVARBINARY 値に変換されます (ドライバの VARBINARY 値に関する制限に関する引数のサイズに依存)。

パラメータ:
parameterIndex - 最初のパラメータは 1、2 番目のパラメータは 2、... となる
x - パラメータ値
例外:
SQLException - データベースアクセスエラーが発生した場合

setBytes

void setBytes(String parameterName,
              byte[] x)
              throws SQLException
指定されたパラメータを指定された Java のバイト配列に設定します。データベースに送るときに、ドライバはこれを SQL VARBINARY または LONGVARBINARY (ドライバの VARBINARY 値に関する制限に関する引数のサイズに依存) に変換します。

パラメータ:
parameterName - パラメータの名前
x - パラメータ値
例外:
SQLException - データベースアクセスエラーが発生した場合、またはこのメソッドがクローズされた CallableStatement について呼び出された場合
SQLFeatureNotSupportedException - JDBC ドライバがこのメソッドをサポートしない場合
導入されたバージョン:
1.4
関連項目:
ResultSet.getBytes(int)

setDate

void setDate(int parameterIndex,
             Date x)
             throws SQLException
この RowSet オブジェクトのコマンド内の指定したパラメータを、指定した java.sql.Date 値に設定します。このパラメータは、データベースへの送信前に、デフォルトの java.util.Calendar を使用して日付が計算され、ドライバによって SQL DATE 値に変換されます。

パラメータ:
parameterIndex - 最初のパラメータは 1、2 番目のパラメータは 2、... となる
x - パラメータ値
例外:
SQLException - データベースアクセスエラーが発生した場合

setTime

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

パラメータ:
parameterIndex - 最初のパラメータは 1、2 番目のパラメータは 2、... となる
x - パラメータ値
例外:
SQLException - データベースアクセスエラーが発生した場合

setTimestamp

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

パラメータ:
parameterIndex - 最初のパラメータは 1、2 番目のパラメータは 2、... となる
x - パラメータ値
例外:
SQLException - データベースアクセスエラーが発生した場合

setTimestamp

void setTimestamp(String parameterName,
                  Timestamp x)
                  throws SQLException
指定されたパラメータを、指定された java.sql.Timestamp 値に設定します。データベースに送るときに、ドライバはこれを SQL TIMESTAMP 値に変換します。

パラメータ:
parameterName - パラメータの名前
x - パラメータ値
例外:
SQLException - データベースアクセスエラーが発生した場合、またはこのメソッドがクローズされた CallableStatement について呼び出された場合
SQLFeatureNotSupportedException - JDBC ドライバがこのメソッドをサポートしない場合
導入されたバージョン:
1.4
関連項目:
ResultSet.getTimestamp(int)

setAsciiStream

void setAsciiStream(int parameterIndex,
                    InputStream x,
                    int length)
                    throws SQLException
この RowSet オブジェクトのコマンド内の指定したパラメータを、指定した java.io.InputStream 値に設定します。java.io.InputStream を介して非常に大きな ASCII 値を送信するほうが、LONGVARCHAR パラメータを使用するより現実的です。ファイルの終わりに達するまで必要に応じて、ドライバによってデータがストリームから読み取られます。

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

パラメータ:
parameterIndex - 最初のパラメータは 1、2 番目のパラメータは 2、... となる
x - ASCII パラメータ値を含む Java 入力ストリーム
length - ストリームのバイト数
例外:
SQLException - データベースアクセスエラーが発生した場合

setAsciiStream

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

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

パラメータ:
parameterName - パラメータの名前
x - ASCII パラメータ値を含む Java 入力ストリーム
length - ストリームのバイト数
例外:
SQLException - データベースアクセスエラーが発生した場合、またはこのメソッドがクローズされた CallableStatement について呼び出された場合
SQLFeatureNotSupportedException - JDBC ドライバがこのメソッドをサポートしない場合
導入されたバージョン:
1.4

setBinaryStream

void setBinaryStream(int parameterIndex,
                     InputStream x,
                     int length)
                     throws SQLException
この RowSet オブジェクトのコマンド内の指定したパラメータを、指定した java.io.InputStream 値に設定します。java.io.InputStream を介して非常に大きなバイナリ値を送信する方が、LONGVARBINARY パラメータを使用するより現実的です。ファイルの終わりに達するまで必要に応じて、ドライバによってデータがストリームから読み取られます。

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

パラメータ:
parameterIndex - 最初のパラメータは 1、2 番目のパラメータは 2、... となる
x - バイナリパラメータ値を含む Java 入力ストリーム
length - ストリームのバイト数
例外:
SQLException - データベースアクセスエラーが発生した場合

setBinaryStream

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

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

パラメータ:
parameterName - パラメータの名前
x - バイナリパラメータ値を含む Java 入力ストリーム
length - ストリームのバイト数
例外:
SQLException - データベースアクセスエラーが発生した場合、またはこのメソッドがクローズされた CallableStatement について呼び出された場合
SQLFeatureNotSupportedException - JDBC ドライバがこのメソッドをサポートしない場合
導入されたバージョン:
1.4

setCharacterStream

void setCharacterStream(int parameterIndex,
                        Reader reader,
                        int length)
                        throws SQLException
この RowSet オブジェクトのコマンド内の指定したパラメータを、指定した java.io.Reader 値に設定します。java.io.Reader を介して非常に大きな UNICODE 値を送信する方が、LONGVARCHAR パラメータを使用するより現実的です。ファイルの終わりに達するまで必要に応じて、ドライバによってデータがストリームから読み取られます。

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

パラメータ:
parameterIndex - 最初のパラメータは 1、2 番目のパラメータは 2、... となる
reader - 設定する UNICODE データを含む Reader オブジェクト
length - ストリーム内の文字数
例外:
SQLException - データベースアクセスエラーが発生した場合

setCharacterStream

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

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

パラメータ:
parameterName - パラメータの名前
reader - 指定されたパラメータとして使用される UNICODE データを含む java.io.Reader オブジェクト
length - ストリーム内の文字数
例外:
SQLException - データベースアクセスエラーが発生した場合、またはこのメソッドがクローズされた CallableStatement について呼び出された場合
SQLFeatureNotSupportedException - JDBC ドライバがこのメソッドをサポートしない場合
導入されたバージョン:
1.4

setAsciiStream

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

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

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

パラメータ:
parameterIndex - 最初のパラメータは 1、2 番目のパラメータは 2、... となる
x - ASCII パラメータ値を含む Java 入力ストリーム
例外:
SQLException - データベースアクセスエラーが発生した場合、またはこのメソッドがクローズされた PreparedStatement について呼び出された場合
SQLFeatureNotSupportedException - JDBC ドライバがこのメソッドをサポートしない場合
導入されたバージョン:
1.6

setAsciiStream

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

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

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

パラメータ:
parameterName - パラメータの名前
x - ASCII パラメータ値を含む Java 入力ストリーム
例外:
SQLException - データベースアクセスエラーが発生した場合、またはこのメソッドがクローズされた CallableStatement について呼び出された場合
SQLFeatureNotSupportedException - JDBC ドライバがこのメソッドをサポートしない場合
導入されたバージョン:
1.6

setBinaryStream

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

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

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

パラメータ:
parameterIndex - 最初のパラメータは 1、2 番目のパラメータは 2、... となる
x - バイナリパラメータ値を含む Java 入力ストリーム
例外:
SQLException - データベースアクセスエラーが発生した場合、またはこのメソッドがクローズされた PreparedStatement について呼び出された場合
SQLFeatureNotSupportedException - JDBC ドライバがこのメソッドをサポートしない場合
導入されたバージョン:
1.6

setBinaryStream

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

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

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

パラメータ:
parameterName - パラメータの名前
x - バイナリパラメータ値を含む Java 入力ストリーム
例外:
SQLException - データベースアクセスエラーが発生した場合、またはこのメソッドがクローズされた CallableStatement について呼び出された場合
SQLFeatureNotSupportedException - JDBC ドライバがこのメソッドをサポートしない場合
導入されたバージョン:
1.6

setCharacterStream

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

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

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

パラメータ:
parameterIndex - 最初のパラメータは 1、2 番目のパラメータは 2、... となる
reader - Unicode データを格納する java.io.Reader オブジェクト
例外:
SQLException - データベースアクセスエラーが発生した場合、またはこのメソッドがクローズされた PreparedStatement について呼び出された場合
SQLFeatureNotSupportedException - JDBC ドライバがこのメソッドをサポートしない場合
導入されたバージョン:
1.6

setCharacterStream

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

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

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

パラメータ:
parameterName - パラメータの名前
reader - Unicode データを格納する java.io.Reader オブジェクト
例外:
SQLException - データベースアクセスエラーが発生した場合、またはこのメソッドがクローズされた CallableStatement について呼び出された場合
SQLFeatureNotSupportedException - JDBC ドライバがこのメソッドをサポートしない場合
導入されたバージョン:
1.6

setNCharacterStream

void setNCharacterStream(int parameterIndex,
                         Reader value)
                         throws SQLException
この RowSet オブジェクトのコマンド内の指定されたパラメータを、Reader オブジェクトに設定します。Reader は、ファイルの終わりに達するまでデータを読み込みます。ドライバは、必要に応じて、Java の文字表現をデータベース内の各国文字セットに変換します。

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

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

パラメータ:
parameterIndex - 最初のパラメータは 1、2 番目のパラメータは 2、... となる
value - パラメータ値
例外:
SQLException - ドライバが各国文字セットをサポートしない場合、ドライバがデータ変換エラーが発生した可能性を検出できる場合、データベースアクセスエラーが発生した場合、またはこのメソッドがクローズされた PreparedStatement 上で呼び出された場合
SQLFeatureNotSupportedException - JDBC ドライバがこのメソッドをサポートしない場合
導入されたバージョン:
1.6

setObject

void setObject(int parameterIndex,
               Object x,
               int targetSqlType,
               int scaleOrLength)
               throws SQLException
この RowSet オブジェクトのコマンド内の指定したパラメータを、指定した Java Object に設定します。整数値の場合は等価な java.lang オブジェクトを使用する必要があります (たとえば int に対して Integer クラスのインスタンス)。 2 番目の引数が InputStream である場合、ストリームには scaleOrLength で指定されるバイト数が含まれる必要があります。2 番目の引数が Reader である場合、リーダーには 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 型。スケール引数で、さらに型を限定できる
scaleOrLength - java.sql.Types.DECIMAL や java.sql.Types.NUMERIC 型では、小数点以下の桁数。Java オブジェクト型 InputStream および Reader の場合は、ストリームまたはリーダーのデータ長。ほかのすべての型では、この値は無視される
例外:
SQLException - データベースアクセスエラーが発生した場合
関連項目:
Types

setObject

void setObject(String parameterName,
               Object x,
               int targetSqlType,
               int scale)
               throws SQLException
指定されたパラメータの値を、指定されたオブジェクトで設定します。2 番目の引数は、オブジェクトの型でなければなりません。 必要となるすべての値に対して、等価な java.lang オブジェクトを使用する必要があります。

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

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

パラメータ:
parameterName - パラメータの名前
x - 入力パラメータ値を含むオブジェクト
targetSqlType - データベースに送られる (java.sql.Types で定義される) SQL 型。スケール引数で、さらに型を限定できる
scale - java.sql.Types.DECIMAL や java.sql.Types.NUMERIC 型では、小数点以下の桁数。ほかのすべての型では、この値は無視される
例外:
SQLException - データベースアクセスエラーが発生した場合、またはこのメソッドがクローズされた CallableStatement について呼び出された場合
SQLFeatureNotSupportedException - targetSqlType のデータ型が、ARRAY、BLOB、CLOB、DATALINK、JAVA_OBJECT、NCHAR、NCLOB、NVARCHAR、LONGNVARCHAR、REF、ROWID、SQLXML、または STRUCT で、JDBC ドライバがこのデータ型をサポートしていない場合
導入されたバージョン:
1.4
関連項目:
Types, ResultSet.getObject(int)

setObject

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

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

パラメータ:
parameterIndex - 最初のパラメータは 1、2 番目のパラメータは 2、... となる
x - 入力パラメータ値を含むオブジェクト
targetSqlType - データベースに送られる (java.sql.Types で定義される) SQL 型
例外:
SQLException - データベースアクセスエラーが発生した場合

setObject

void setObject(String parameterName,
               Object x,
               int targetSqlType)
               throws SQLException
指定されたパラメータの値を、指定されたオブジェクトで設定します。このメソッドは、上記のメソッド setObject に似ていますが、スケールに 0 を仮定している点が異なります。

パラメータ:
parameterName - パラメータの名前
x - 入力パラメータ値を含むオブジェクト
targetSqlType - データベースに送られる (java.sql.Types で定義される) SQL 型
例外:
SQLException - データベースアクセスエラーが発生した場合、またはこのメソッドがクローズされた CallableStatement について呼び出された場合
SQLFeatureNotSupportedException - targetSqlType のデータ型が、ARRAY、BLOB、CLOB、DATALINK、JAVA_OBJECT、NCHAR、NCLOB、NVARCHAR、LONGNVARCHAR、REF、ROWID、SQLXML、または STRUCT で、JDBC ドライバがこのデータ型をサポートしていない場合
導入されたバージョン:
1.4
関連項目:
ResultSet.getObject(int)

setObject

void setObject(String parameterName,
               Object x)
               throws SQLException
指定されたパラメータの値を、指定されたオブジェクトで設定します。2 番目のパラメータは、Object の型でなければなりません。 したがって、組み込み型の場合、等価な java.lang オブジェクトを使用する必要があります。

JDBC は、Java の Object 型から SQL 型への標準マッピングを指定しています。指定された引数は、データベースに送られる前に、対応する SQL 型に変換されます。

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

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

パラメータ:
parameterName - パラメータの名前
x - 入力パラメータ値を含むオブジェクト
例外:
SQLException - データベースアクセスエラーが発生した場合、このメソッドがクローズされた CallableStatement で呼び出された場合、または指定された Object パラメータがあいまいな場合
SQLFeatureNotSupportedException - JDBC ドライバがこのメソッドをサポートしない場合
導入されたバージョン:
1.4
関連項目:
ResultSet.getObject(int)

setObject

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

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

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

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

パラメータ:
parameterIndex - 最初のパラメータは 1、2 番目のパラメータは 2、... となる
x - 入力パラメータ値を含むオブジェクト
例外:
SQLException - データベースアクセスエラーが発生した場合

setRef

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

パラメータ:
i - 最初のパラメータは 1、2 番目のパラメータは 2、... となる
x - SQL REF 型のデータを表すオブジェクト
例外:
SQLException - データベースアクセスエラーが発生した場合

setBlob

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

パラメータ:
i - 最初のパラメータは 1、2 番目のパラメータは 2、... となる
x - BLOB を表すオブジェクト
例外:
SQLException - データベースアクセスエラーが発生した場合

setBlob

void setBlob(int parameterIndex,
             InputStream inputStream,
             long length)
             throws SQLException
指定されたパラメータを InputStream オブジェクトに設定します。inputStream には、length で指定される文字数が含まれる必要があります。そうでない場合、PreparedStatement の実行時に SQLException が生成されます。このメソッドは、setBinaryStream (int, InputStream, int) メソッドと異なり、パラメータ値を BLOB としてサーバーに送信しなければならないことをドライバに通知します。setBinaryStream メソッドを使用した場合、ドライバは、パラメータデータがサーバーに LONGVARBINARY または BLOB のどちらの形式で送信されるのかを特定する追加処理を行わなければならないことがあります。

パラメータ:
parameterIndex - 最初のパラメータのインデックスは 1、2 番目のパラメータのインデックスは 2、... となる
inputStream - パラメータ値に設定されるデータを含むオブジェクト
length - パラメータデータ内のバイト数
例外:
SQLException - データベースアクセスエラーが発生した場合、このメソッドがクローズされた PreparedStatement 上で呼び出された場合、parameterIndex が SQL 文のパラメータマーカーと対応していない場合、長さとしてゼロ未満の値が指定された場合、入力ストリーム内のバイト数が指定された長さと一致していない場合
SQLFeatureNotSupportedException - JDBC ドライバがこのメソッドをサポートしない場合
導入されたバージョン:
1.6

setBlob

void setBlob(int parameterIndex,
             InputStream inputStream)
             throws SQLException
指定されたパラメータを InputStream オブジェクトに設定します。このメソッドは、setBinaryStream (int, InputStream) メソッドと異なり、パラメータ値を BLOB としてサーバーに送信しなければならないことをドライバに通知します。setBinaryStream メソッドを使用した場合、ドライバは、パラメータデータがサーバーに LONGVARBINARY または BLOB のどちらの形式で送信されるのかを特定する追加処理を行わなければならないことがあります。

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

パラメータ:
parameterIndex - 最初のパラメータのインデックスは 1、2 番目のパラメータのインデックスは 2、... となる
inputStream - パラメータ値に設定されるデータを含むオブジェクト
例外:
SQLException - データベースアクセスエラーが発生した場合、このメソッドがクローズされた PreparedStatement で呼び出された場合、または parameterIndex が SQL 文のパラメータマーカーと対応していない場合
SQLFeatureNotSupportedException - JDBC ドライバがこのメソッドをサポートしない場合
導入されたバージョン:
1.6

setBlob

void setBlob(String parameterName,
             InputStream inputStream,
             long length)
             throws SQLException
指定されたパラメータを InputStream オブジェクトに設定します。inputstream には、length で指定される文字数が含まれる必要があります。そうでない場合、CallableStatement の実行時に SQLException が生成されます。このメソッドは、setBinaryStream (int, InputStream, int) メソッドと異なり、パラメータ値を BLOB としてサーバーに送信しなければならないことをドライバに通知します。setBinaryStream メソッドを使用した場合、ドライバは、パラメータデータがサーバーに LONGVARBINARY または BLOB のどちらの形式で送信されるのかを特定する追加処理を行わなければならないことがあります。

パラメータ:
parameterName - 2 番目は 2 に設定されるパラメータの名前
inputStream - パラメータ値に設定されるデータを含むオブジェクト
length - パラメータデータ内のバイト数
例外:
SQLException - parameterIndex が SQL 文のパラメータマーカーと対応していない場合、長さとしてゼロ未満の値が指定された場合、入力ストリーム内のバイト数が指定された長さと一致していない場合、データベースアクセスエラーが発生した場合、またはこのメソッドがクローズされた CallableStatement 上で呼び出された場合
SQLFeatureNotSupportedException - JDBC ドライバがこのメソッドをサポートしない場合
導入されたバージョン:
1.6

setBlob

void setBlob(String parameterName,
             Blob x)
             throws SQLException
指定されたパラメータを、指定された java.sql.Blob オブジェクトに設定します。データベースに送るときに、ドライバはこれを SQL BLOB 値に変換します。

パラメータ:
parameterName - パラメータの名前
x - SQL BLOB 値をマッピングする Blob オブジェクト
例外:
SQLException - データベースアクセスエラーが発生した場合、またはこのメソッドがクローズされた CallableStatement について呼び出された場合
SQLFeatureNotSupportedException - JDBC ドライバがこのメソッドをサポートしない場合
導入されたバージョン:
1.6

setBlob

void setBlob(String parameterName,
             InputStream inputStream)
             throws SQLException
指定されたパラメータを InputStream オブジェクトに設定します。このメソッドは、setBinaryStream (int, InputStream) メソッドと異なり、パラメータ値を BLOB としてサーバーに送信しなければならないことをドライバに通知します。setBinaryStream メソッドを使用した場合、ドライバは、パラメータデータがサーバーに LONGVARBINARY または BLOB のどちらの形式で送信されるのかを特定する追加処理を行わなければならないことがあります。

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

パラメータ:
parameterName - パラメータの名前
inputStream - パラメータ値に設定されるデータを含むオブジェクト
例外:
SQLException - データベースアクセスエラーが発生した場合、またはこのメソッドがクローズされた CallableStatement について呼び出された場合
SQLFeatureNotSupportedException - JDBC ドライバがこのメソッドをサポートしない場合
導入されたバージョン:
1.6

setClob

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

パラメータ:
i - 最初のパラメータは 1、2 番目のパラメータは 2、... となる
x - CLOB を表すオブジェクト
例外:
SQLException - データベースアクセスエラーが発生した場合

setClob

void setClob(int parameterIndex,
             Reader reader,
             long length)
             throws SQLException
指定されたパラメータを Reader オブジェクトに設定します。reader には、length で指定される文字数が含まれる必要があります。そうでない場合、PreparedStatement の実行時に SQLException が生成されます。このメソッドは、setCharacterStream (int, Reader, int) メソッドと異なり、パラメータ値を CLOB としてサーバーに送信しなければならないことをドライバに通知します。setCharacterStream メソッドを使用した場合、ドライバは、パラメータデータがサーバーに LONGVARCHAR または CLOB のどちらの形式で送信されるのかを特定する追加処理を行わなければならないことがあります。

パラメータ:
parameterIndex - 最初のパラメータのインデックスは 1、2 番目のパラメータのインデックスは 2、... となる
reader - パラメータ値に設定されるデータを含むオブジェクト
length - パラメータデータ内の文字数
例外:
SQLException - データベースアクセスエラーが発生した場合、このメソッドがクローズされた PreparedStatement で呼び出された場合、parameterIndex が SQL 文のパラメータマーカーと対応していない場合、または長さとしてゼロ未満の値が指定された場合
SQLFeatureNotSupportedException - JDBC ドライバがこのメソッドをサポートしない場合
導入されたバージョン:
1.6

setClob

void setClob(int parameterIndex,
             Reader reader)
             throws SQLException
指定されたパラメータを Reader オブジェクトに設定します。このメソッドは、setCharacterStream (int, Reader) メソッドと異なり、パラメータ値を CLOB としてサーバーに送信しなければならないことをドライバに通知します。setCharacterStream メソッドを使用した場合、ドライバは、パラメータデータがサーバーに LONGVARCHAR または CLOB のどちらの形式で送信されるのかを特定する追加処理を行わなければならないことがあります。

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

パラメータ:
parameterIndex - 最初のパラメータのインデックスは 1、2 番目のパラメータのインデックスは 2、... となる
reader - パラメータ値に設定されるデータを含むオブジェクト
例外:
SQLException - データベースアクセスエラーが発生した場合、このメソッドがクローズされた PreparedStatement で呼び出された場合、または parameterIndex が SQL 文のパラメータマーカーと対応していない場合
SQLFeatureNotSupportedException - JDBC ドライバがこのメソッドをサポートしない場合
導入されたバージョン:
1.6

setClob

void setClob(String parameterName,
             Reader reader,
             long length)
             throws SQLException
指定されたパラメータを Reader オブジェクトに設定します。reader には、length で指定される文字数が含まれる必要があります。そうでない場合、CallableStatement の実行時に SQLException が生成されます。このメソッドは、setCharacterStream (int, Reader, int) メソッドと異なり、パラメータ値を CLOB としてサーバーに送信しなければならないことをドライバに通知します。setCharacterStream メソッドを使用した場合、ドライバは、パラメータデータがサーバーに LONGVARCHAR または CLOB のどちらの形式で送信されるのかを特定する追加処理を行わなければならないことがあります。

パラメータ:
parameterName - 設定されるパラメータの名前
reader - パラメータ値に設定されるデータを含むオブジェクト
length - パラメータデータ内の文字数
例外:
SQLException - parameterIndex が SQL 文のパラメータマーカーと対応していない場合、長さとしてゼロ未満の値が指定された場合、データベースアクセスエラーが発生した場合、このメソッドがクローズされた CallableStatement で呼び出された場合
SQLFeatureNotSupportedException - JDBC ドライバがこのメソッドをサポートしない場合
導入されたバージョン:
1.6

setClob

void setClob(String parameterName,
             Clob x)
             throws SQLException
指定されたパラメータを、指定された java.sql.Clob オブジェクトに設定します。データベースに送るときに、ドライバはこれを SQL CLOB 値に変換します。

パラメータ:
parameterName - パラメータの名前
x - SQL CLOB 値をマッピングする Clob オブジェクト
例外:
SQLException - データベースアクセスエラーが発生した場合、またはこのメソッドがクローズされた CallableStatement について呼び出された場合
SQLFeatureNotSupportedException - JDBC ドライバがこのメソッドをサポートしない場合
導入されたバージョン:
1.6

setClob

void setClob(String parameterName,
             Reader reader)
             throws SQLException
指定されたパラメータを Reader オブジェクトに設定します。このメソッドは、setCharacterStream (int, Reader) メソッドと異なり、パラメータ値を CLOB としてサーバーに送信しなければならないことをドライバに通知します。setCharacterStream メソッドを使用した場合、ドライバは、パラメータデータがサーバーに LONGVARCHAR または CLOB のどちらの形式で送信されるのかを特定する追加処理を行わなければならないことがあります。

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

パラメータ:
parameterName - パラメータの名前
reader - パラメータ値に設定されるデータを含むオブジェクト
例外:
SQLException - データベースアクセスエラーが発生した場合、またはこのメソッドがクローズされた CallableStatement について呼び出された場合
SQLFeatureNotSupportedException - JDBC ドライバがこのメソッドをサポートしない場合
導入されたバージョン:
1.6

setArray

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

パラメータ:
i - 最初のパラメータは 1、2 番目のパラメータは 2、... となる
x - SQL ARRAY を表すオブジェクト
例外:
SQLException - データベースアクセスエラーが発生した場合

setDate

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

パラメータ:
parameterIndex - 最初のパラメータは 1、2 番目のパラメータは 2、... となる
x - パラメータ値
cal - 日付の計算に使用する java.util.Calendar オブジェクト
例外:
SQLException - データベースアクセスエラーが発生した場合

setDate

void setDate(String parameterName,
             Date x)
             throws SQLException
アプリケーションを実行している仮想マシンのデフォルトのタイムゾーンを使用して、指定されたパラメータを指定された java.sql.Date 値に設定します。データベースに送るときに、ドライバはこれを SQL DATE 値に変換します。

パラメータ:
parameterName - パラメータの名前
x - パラメータ値
例外:
SQLException - データベースアクセスエラーが発生した場合、またはこのメソッドがクローズされた CallableStatement について呼び出された場合
SQLFeatureNotSupportedException - JDBC ドライバがこのメソッドをサポートしない場合
導入されたバージョン:
1.4
関連項目:
ResultSet.getDate(int)

setDate

void setDate(String parameterName,
             Date x,
             Calendar cal)
             throws SQLException
指定された Calendar オブジェクトを使用して、指定されたパラメータを指定された java.sql.Date 値に設定します。ドライバは Calendar オブジェクトを使用して SQL DATE 値を作成し、続いてそれをデータベースに送ります。Calendar オブジェクトを使用すると、ドライバはカスタムタイムゾーンを考慮して日付を計算できます。Calendar オブジェクトを指定しない場合、ドライバは、アプリケーションで実行される仮想マシンのタイムゾーンであるデフォルトのタイムゾーンを使用します。

パラメータ:
parameterName - パラメータの名前
x - パラメータ値
cal - ドライバが日付を作成するために使用する Calendar オブジェクト
例外:
SQLException - データベースアクセスエラーが発生した場合、またはこのメソッドがクローズされた CallableStatement について呼び出された場合
SQLFeatureNotSupportedException - JDBC ドライバがこのメソッドをサポートしない場合
導入されたバージョン:
1.4
関連項目:
ResultSet.getDate(int)

setTime

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

パラメータ:
parameterIndex - 最初のパラメータは 1、2 番目のパラメータは 2、... となる
x - パラメータ値
cal - 時刻の計算に使用する java.util.Calendar オブジェクト
例外:
SQLException - データベースアクセスエラーが発生した場合

setTime

void setTime(String parameterName,
             Time x)
             throws SQLException
指定されたパラメータを、指定された java.sql.Time 値に設定します。データベースに送るときに、ドライバはこれを SQL TIME 値に変換します。

パラメータ:
parameterName - パラメータの名前
x - パラメータ値
例外:
SQLException - データベースアクセスエラーが発生した場合、またはこのメソッドがクローズされた CallableStatement について呼び出された場合
SQLFeatureNotSupportedException - JDBC ドライバがこのメソッドをサポートしない場合
導入されたバージョン:
1.4
関連項目:
ResultSet.getTime(int)

setTime

void setTime(String parameterName,
             Time x,
             Calendar cal)
             throws SQLException
指定された Calendar オブジェクトを使用して、指定されたパラメータを指定された java.sql.Time 値に設定します。ドライバは Calendar オブジェクトを使用して SQL java.sql.Time 値を作成し、続いてそれをデータベースに送ります。Calendar オブジェクトを使用すると、ドライバはカスタムタイムゾーンを考慮して時刻を計算できます。Calendar オブジェクトを指定しない場合、ドライバは、アプリケーションで実行される仮想マシンのタイムゾーンであるデフォルトのタイムゾーンを使用します。

パラメータ:
parameterName - パラメータの名前
x - パラメータ値
cal - ドライバが時刻を作成するために使用する Calendar オブジェクト
例外:
SQLException - データベースアクセスエラーが発生した場合、またはこのメソッドがクローズされた CallableStatement について呼び出された場合
SQLFeatureNotSupportedException - JDBC ドライバがこのメソッドをサポートしない場合
導入されたバージョン:
1.4
関連項目:
ResultSet.getTime(int)

setTimestamp

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

パラメータ:
parameterIndex - 最初のパラメータは 1、2 番目のパラメータは 2、... となる
x - パラメータ値
cal - タイムスタンプの計算に使用する java.util.Calendar オブジェクト
例外:
SQLException - データベースアクセスエラーが発生した場合

setTimestamp

void setTimestamp(String parameterName,
                  Timestamp x,
                  Calendar cal)
                  throws SQLException
指定された Calendar オブジェクトを使用して、指定されたパラメータを指定された java.sql.Timestamp 値に設定します。ドライバは Calendar オブジェクトを使用して SQL TIMESTAMP 値を作成し、続いてそれをデータベースに送ります。Calendar オブジェクトを使用すると、ドライバはカスタムタイムゾーンを考慮してタイムスタンプを計算できます。Calendar オブジェクトを指定しない場合、ドライバは、アプリケーションで実行される仮想マシンのタイムゾーンであるデフォルトのタイムゾーンを使用します。

パラメータ:
parameterName - パラメータの名前
x - パラメータ値
cal - ドライバがタイムスタンプを作成するために使用する Calendar オブジェクト
例外:
SQLException - データベースアクセスエラーが発生した場合、またはこのメソッドがクローズされた CallableStatement について呼び出された場合
SQLFeatureNotSupportedException - JDBC ドライバがこのメソッドをサポートしない場合
導入されたバージョン:
1.4
関連項目:
ResultSet.getTimestamp(int)

clearParameters

void clearParameters()
                     throws SQLException
この RowSet オブジェクトのコマンド用のパラメータセットをクリアします。 

通常、RowSet オブジェクトを繰り返し使用するために、パラメータ値は強制的に残されます。パラメータ値を設定すると、前の値は自動的にクリアされます。しかし、現在のパラメータ値によって使用されたリソースをただちに解放した方が役に立つ場合があります。 これは、メソッド clearParameters を呼び出して実行することができます。

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

execute

void execute()
             throws SQLException
この RowSet オブジェクトにデータを格納します。  

execute メソッドは、url、データソース名、ユーザー名、パスワード、トランザクション遮断、型マップなどのプロパティーを使用して、データを読み取るために接続を作成します。 execute メソッドは、コマンド、読み取り専用、最大フィールドサイズ、最大行数、エスケープ処理、クエリータイムアウトなどのプロパティーを使用して、コマンド実行文を作成します。  

要求したプロパティーが設定されていない場合は例外がスローされます。このメソッドの実行が成功すると、行セットの現在の内容は破棄され、行セットのメタデータも (再) 設定されます。未処理の更新がある場合、これらは無視されます。  

この RowSet オブジェクトがデータのソースとの連続した接続を保持できない場合は、リーダー (RowSetReader オブジェクト) がデータを入れるために使用されます。この場合、リーダーはこの RowSet オブジェクトで登録されており、execute メソッドでは、実装の一部としてリーダーの readData メソッドを呼び出します。

例外:
SQLException - データベースアクセスエラーが発生した場合、または、接続を作成し、文を作成するために必要なプロパティーのどれかが設定されていない場合

addRowSetListener

void addRowSetListener(RowSetListener listener)
指定したイベントリスナーを登録して、この RowSet オブジェクトで発生するイベントが通知されるようにします。

パラメータ:
listener - RowSetListener インタフェースを実装し、かつ、この RowSet オブジェクトでイベントが発生したときに通知を受けるコンポーネント
関連項目:
removeRowSetListener(javax.sql.RowSetListener)

removeRowSetListener

void removeRowSetListener(RowSetListener listener)
指定したリスナーを、この RowSet オブジェクトでイベントが発生したときに通知されるコンポーネントのリストから削除します。

パラメータ:
listener - この RowSet オブジェクトのリスナーとして登録されているコンポーネント
関連項目:
addRowSetListener(javax.sql.RowSetListener)

setSQLXML

void setSQLXML(int parameterIndex,
               SQLXML xmlObject)
               throws SQLException
指定されたパラメータを、指定された java.sql.SQLXML オブジェクトに設定します。データベースに送るときに、ドライバはこれを SQL XML 値に変換します。

パラメータ:
parameterIndex - 最初のパラメータのインデックスは 1、2 番目のパラメータのインデックスは 2、... となる
xmlObject - SQL XML 値をマッピングする SQLXML オブジェクト
例外:
SQLException - データベースアクセスエラーが発生した場合、このメソッドがクローズされた結果セットで呼び出された場合、SQLXML オブジェクト用の java.xml.transform.Result、Writer、または OutputStream がクローズされていない場合、あるいは XML 値の処理中にエラーが発生した場合。この例外の getCause メソッドにより、より詳細な例外が提供されることがある (たとえばストリームに有効な XML が含まれていない場合)
導入されたバージョン:
1.6

setSQLXML

void setSQLXML(String parameterName,
               SQLXML xmlObject)
               throws SQLException
指定されたパラメータを、指定された java.sql.SQLXML オブジェクトに設定します。データベースに送るときに、ドライバはこれを SQL XML 値に変換します。

パラメータ:
parameterName - パラメータの名前
xmlObject - SQL XML 値をマッピングする SQLXML オブジェクト
例外:
SQLException - データベースアクセスエラーが発生した場合、このメソッドがクローズされた結果セットで呼び出された場合、SQLXML オブジェクト用の java.xml.transform.Result、Writer、または OutputStream がクローズされていない場合、あるいは XML 値の処理中にエラーが発生した場合。この例外の getCause メソッドにより、より詳細な例外が提供されることがある (たとえばストリームに有効な XML が含まれていない場合)
導入されたバージョン:
1.6

setRowId

void setRowId(int parameterIndex,
              RowId x)
              throws SQLException
指定されたパラメータを、指定された java.sql.RowId オブジェクトに設定します。データベースに送るときに、ドライバはこれを SQL ROWID 値に変換します。

パラメータ:
parameterIndex - 最初のパラメータは 1、2 番目のパラメータは 2、... となる
x - パラメータ値
例外:
SQLException - データベースアクセスエラーが発生した場合
導入されたバージョン:
1.6

setRowId

void setRowId(String parameterName,
              RowId x)
              throws SQLException
指定されたパラメータを、指定された java.sql.RowId オブジェクトに設定します。データベースに送るときに、ドライバはこれを SQL ROWID 値に変換します。

パラメータ:
parameterName - パラメータの名前
x - パラメータ値
例外:
SQLException - データベースアクセスエラーが発生した場合
導入されたバージョン:
1.6

setNString

void setNString(int parameterIndex,
                String value)
                throws SQLException
指定されたパラメータを、指定された Java の String オブジェクトに設定します。データベースに送るときに、ドライバはこれを SQL NCHAR、NVARCHAR、または LONGNVARCHAR 値 (ドライバの NVARCHAR 値に関する制限に関する引数のサイズに依存) に変換します。

パラメータ:
parameterIndex - 最初のパラメータは 1、2 番目のパラメータは 2、... となる
value - パラメータ値
例外:
SQLException - ドライバが各国文字セットをサポートしない場合、ドライバがデータ変換エラーが発生した可能性を検出できる場合、またはデータベースアクセスエラーが発生した場合
導入されたバージョン:
1.6

setNString

void setNString(String parameterName,
                String value)
                throws SQLException
指定されたパラメータを、指定された Java の String オブジェクトに設定します。ドライバはこれを SQL NCHAR、NVARCHAR、または LONGNVARCHAR に変換します。

パラメータ:
parameterName - 設定される列の名前
value - パラメータ値
例外:
SQLException - ドライバが各国文字セットをサポートしない場合、ドライバがデータ変換エラーが発生した可能性を検出できる場合、またはデータベースアクセスエラーが発生した場合
導入されたバージョン:
1.6

setNCharacterStream

void setNCharacterStream(int parameterIndex,
                         Reader value,
                         long length)
                         throws SQLException
指定されたパラメータを Reader オブジェクトに設定します。Reader は、ファイルの終わりに達するまでデータを読み込みます。ドライバは、必要に応じて、Java の文字表現をデータベース内の各国文字セットに変換します。

パラメータ:
parameterIndex - 最初のパラメータは 1、2 番目のパラメータは 2、... となる
value - パラメータ値
length - パラメータデータ内の文字数
例外:
SQLException - ドライバが各国文字セットをサポートしない場合、ドライバがデータ変換エラーが発生した可能性を検出できる場合、またはデータベースアクセスエラーが発生した場合
導入されたバージョン:
1.6

setNCharacterStream

void setNCharacterStream(String parameterName,
                         Reader value,
                         long length)
                         throws SQLException
指定されたパラメータを Reader オブジェクトに設定します。Reader は、ファイルの終わりに達するまでデータを読み込みます。ドライバは、必要に応じて、Java の文字表現をデータベース内の各国文字セットに変換します。

パラメータ:
parameterName - 設定される列の名前
value - パラメータ値
length - パラメータデータ内の文字数
例外:
SQLException - ドライバが各国文字セットをサポートしない場合、ドライバがデータ変換エラーが発生した可能性を検出できる場合、またはデータベースアクセスエラーが発生した場合
導入されたバージョン:
1.6

setNCharacterStream

void setNCharacterStream(String parameterName,
                         Reader value)
                         throws SQLException
指定されたパラメータを Reader オブジェクトに設定します。Reader は、ファイルの終わりに達するまでデータを読み込みます。ドライバは、必要に応じて、Java の文字表現をデータベース内の各国文字セットに変換します。

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

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

パラメータ:
parameterName - パラメータの名前
value - パラメータ値
例外:
SQLException - ドライバが各国文字セットをサポートしない場合、ドライバがデータ変換エラーが発生した可能性を検出できる場合、データベースアクセスエラーが発生した場合、またはこのメソッドがクローズされた CallableStatement 上で呼び出された場合
SQLFeatureNotSupportedException - JDBC ドライバがこのメソッドをサポートしない場合
導入されたバージョン:
1.6

setNClob

void setNClob(String parameterName,
              NClob value)
              throws SQLException
指定されたパラメータを java.sql.NClob オブジェクトに設定します。このオブジェクトは、java.sql.NClob インタフェースを実装します。この NClob オブジェクトは、SQL NCLOB にマッピングされます。

パラメータ:
parameterName - 設定される列の名前
value - パラメータ値
例外:
SQLException - ドライバが各国文字セットをサポートしない場合、ドライバがデータ変換エラーが発生した可能性を検出できる場合、またはデータベースアクセスエラーが発生した場合
導入されたバージョン:
1.6

setNClob

void setNClob(String parameterName,
              Reader reader,
              long length)
              throws SQLException
指定されたパラメータを Reader オブジェクトに設定します。reader には、length で指定される文字数が含まれる必要があります。そうでない場合、CallableStatement の実行時に SQLException が生成されます。このメソッドは、setCharacterStream (int, Reader, int) メソッドと異なり、パラメータ値を NCLOB としてサーバーに送信しなければならないことをドライバに通知します。setCharacterStream メソッドを使用した場合、ドライバは、パラメータデータがサーバーに LONGNVARCHAR または NCLOB のどちらの形式で送信されるのかを特定する追加処理を行わなければならないことがあります。

パラメータ:
parameterName - 設定されるパラメータの名前
reader - パラメータ値に設定されるデータを含むオブジェクト
length - パラメータデータ内の文字数
例外:
SQLException - parameterIndex が SQL 文のパラメータマーカーと対応していない場合、長さとしてゼロ未満の値が指定された場合、ドライバが各国文字セットをサポートしない場合、ドライバがデータ変換エラーが発生した可能性を検出できる場合、データベースアクセスエラーが発生した場合、またはこのメソッドがクローズされた CallableStatement 上で呼び出された場合
SQLFeatureNotSupportedException - JDBC ドライバがこのメソッドをサポートしない場合
導入されたバージョン:
1.6

setNClob

void setNClob(String parameterName,
              Reader reader)
              throws SQLException
指定されたパラメータを Reader オブジェクトに設定します。このメソッドは、setCharacterStream (int, Reader) メソッドと異なり、パラメータ値を NCLOB としてサーバーに送信しなければならないことをドライバに通知します。setCharacterStream メソッドを使用した場合、ドライバは、パラメータデータがサーバーに LONGNVARCHAR または NCLOB のどちらの形式で送信されるのかを特定する追加処理を行わなければならないことがあります。

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

パラメータ:
parameterName - パラメータの名前
reader - パラメータ値に設定されるデータを含むオブジェクト
例外:
SQLException - ドライバが各国文字セットをサポートしない場合、ドライバがデータ変換エラーが発生した可能性を検出できる場合、データベースアクセスエラーが発生した場合、またはこのメソッドがクローズされた CallableStatement 上で呼び出された場合
SQLFeatureNotSupportedException - JDBC ドライバがこのメソッドをサポートしない場合
導入されたバージョン:
1.6

setNClob

void setNClob(int parameterIndex,
              Reader reader,
              long length)
              throws SQLException
指定されたパラメータを Reader オブジェクトに設定します。reader には、length で指定される文字数が含まれる必要があります。そうでない場合、PreparedStatement の実行時に SQLException が生成されます。このメソッドは、setCharacterStream (int, Reader, int) メソッドと異なり、パラメータ値を NCLOB としてサーバーに送信しなければならないことをドライバに通知します。setCharacterStream メソッドを使用した場合、ドライバは、パラメータデータがサーバーに LONGNVARCHAR または NCLOB のどちらの形式で送信されるのかを特定する追加処理を行わなければならないことがあります。

パラメータ:
parameterIndex - 最初のパラメータのインデックスは 1、2 番目のパラメータのインデックスは 2、... となる
reader - パラメータ値に設定されるデータを含むオブジェクト
length - パラメータデータ内の文字数
例外:
SQLException - parameterIndex が SQL 文のパラメータマーカーと対応していない場合、長さとしてゼロ未満の値が指定された場合、ドライバが各国文字セットをサポートしない場合、ドライバがデータ変換エラーが発生した可能性を検出できる場合、データベースアクセスエラーが発生した場合、またはこのメソッドがクローズされた PreparedStatement 上で呼び出された場合
SQLFeatureNotSupportedException - JDBC ドライバがこのメソッドをサポートしない場合
導入されたバージョン:
1.6

setNClob

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

パラメータ:
parameterIndex - 最初のパラメータは 1、2 番目のパラメータは 2、... となる
value - パラメータ値
例外:
SQLException - ドライバが各国文字セットをサポートしない場合、ドライバがデータ変換エラーが発生した可能性を検出できる場合、またはデータベースアクセスエラーが発生した場合
導入されたバージョン:
1.6

setNClob

void setNClob(int parameterIndex,
              Reader reader)
              throws SQLException
指定されたパラメータを Reader オブジェクトに設定します。このメソッドは、setCharacterStream (int, Reader) メソッドと異なり、パラメータ値を NCLOB としてサーバーに送信しなければならないことをドライバに通知します。setCharacterStream メソッドを使用した場合、ドライバは、パラメータデータがサーバーに LONGNVARCHAR または NCLOB のどちらの形式で送信されるのかを特定する追加処理を行わなければならないことがあります。 

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

パラメータ:
parameterIndex - 最初のパラメータのインデックスは 1、2 番目のパラメータのインデックスは 2、... となる
reader - パラメータ値に設定されるデータを含むオブジェクト
例外:
SQLException - parameterIndex が SQL 文のパラメータマーカーと対応していない場合、ドライバが各国文字セットをサポートしない場合、ドライバがデータ変換エラーが発生した可能性を検出できる場合、データベースアクセスエラーが発生した場合、またはこのメソッドがクローズされた PreparedStatement 上で呼び出された場合
SQLFeatureNotSupportedException - JDBC ドライバがこのメソッドをサポートしない場合
導入されたバージョン:
1.6

setURL

void setURL(int parameterIndex,
            URL x)
            throws SQLException
指定されたパラメータを指定された java.net.URL 値に設定します。データベースに送るときに、ドライバはこれを SQL DATALINK 値に変換します。

パラメータ:
parameterIndex - 最初のパラメータは 1、2 番目のパラメータは 2、... となる
x - 設定される java.net.URL オブジェクト
例外:
SQLException - データベースアクセスエラーが発生した場合、またはこのメソッドがクローズされた PreparedStatement について呼び出された場合
SQLFeatureNotSupportedException - JDBC ドライバがこのメソッドをサポートしない場合
導入されたバージョン:
1.4
概要  パッケージ   クラス  使用  階層ツリー  非推奨 API  索引  ヘルプ 
JavaTM Platform
Standard Ed. 6
 前のクラス   次のクラス フレームあり    フレームなし    
概要: 入れ子 | フィールド | コンストラクタ | メソッド 詳細: フィールド | コンストラクタ | メソッド
バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。