モジュール java.sql
パッケージ javax.sql

インタフェースRowSet

すべてのスーパー・インタフェース:
AutoCloseable, ResultSet, Wrapper
既知のすべてのサブインタフェース:
CachedRowSet, FilteredRowSet, JdbcRowSet, JoinRowSet, SyncResolver, WebRowSet

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

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

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

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

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

切断された行セットには、Reader (RowSetReaderオブジェクト)とそれに関連付けられたライター(RowSetWriterオブジェクト)があります。 Readerは、多くの異なる方法で実装され、非リレーショナル・データ・ソースからデータを取得することを含む、行セットにデータを取り込むことができます。 ライターもまたさまざまな方法で実装されており、行セットのデータに加えられた変更を基本となるデータ・ソースへ送り戻すことができます。

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

導入されたバージョン:
1.4
  • メソッドの詳細

    • 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_UNCOMMITTEDConnection.TRANSACTION_READ_COMMITTEDConnection.TRANSACTION_REPEATABLE_READ、またはConnection.TRANSACTION_SERIALIZABLEのうちの1つ
      関連項目:
      setTransactionIsolation(int)
    • setTransactionIsolation

      void setTransactionIsolation(int level) throws SQLException
      このRowSetオブジェクトのトランザクション遮断レベルを設定します。
      パラメータ:
      level - トランザクション遮断レベル。Connection.TRANSACTION_READ_UNCOMMITTEDConnection.TRANSACTION_READ_COMMITTEDConnection.TRANSACTION_REPEATABLE_READ、またはConnection.TRANSACTION_SERIALIZABLEのうちの1つ
      例外:
      SQLException - データベース・アクセス・エラーが発生した場合
      関連項目:
      getTransactionIsolation()
    • getTypeMap

      Map<String,​Class<?>> getTypeMap() throws SQLException
      このRowSetオブジェクトに関連付けられたSQLユーザー定義型のカスタム・マッピングがある場合には、それを指定するMapオブジェクトを取得します。 型マップのデフォルトは空です。
      戻り値:
      SQLユーザー定義型とそれらがマッピングされるJavaクラスが格納されているjava.util.Mapオブジェクト
      例外:
      SQLException - データベース・アクセス・エラーが発生した場合
      関連項目:
      setTypeMap(java.util.Map<java.lang.String, java.lang.Class<?>>)
    • setTypeMap

      void setTypeMap(Map<String,​Class<?>> map) throws SQLException
      このRowSetオブジェクトのデフォルトの型マップとして指定されたjava.util.Mapオブジェクトをインストールします。 別の型マップがメソッドのパラメータとして指定されるまで、この型マップが使用されます。
      パラメータ:
      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
      ある列値で返される最大バイト数を取得します。 この制限値は、BINARYVARBINARYLONGVARBINARYBINARYCHARVARCHARLONGVARCHARNCHAR、およびNVARCHARの各列だけに適用されます。 限度値を超過すると、超過したデータは警告なしで破棄されます。
      戻り値:
      現在の最大列サイズ制限値。0は制限がないことを表す
      例外:
      SQLException - データベース・アクセス・エラーが発生した場合
      関連項目:
      setMaxFieldSize(int)
    • setMaxFieldSize

      void setMaxFieldSize(int max) throws SQLException
      列値に返される最大バイト数を、指定されたバイト数に設定します。 この制限値は、BINARYVARBINARYLONGVARBINARYBINARYCHARVARCHARLONGVARCHARNCHAR、および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_ONLYResultSet.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の例には、STRUCTDISTINCTJAVA_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.BigDecimal値に設定します。 このパラメータは、データベースに送信される前に、ドライバによって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の場合、ReaderにはscaleOrLengthで指定された文字数が含まれている必要があります。 これらの条件がtrueではない場合、準備された文の実行時にドライバはSQLExceptionを生成します。

      指定されたJavaオブジェクトは、データベースに送られる前にtargetSqlTypeに変換されます。

      オブジェクトのクラスがSQLDataを実装する場合は、行セットでSQLData.writeSQLメソッドを呼び出して、オブジェクトをSQLOutputデータ・ストリームに書き込む必要があります。 また、オブジェクトがRefBlobClobNClobStructjava.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の場合、ストリームまたは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データ・ストリームへ書き込む必要があります。 また、オブジェクトがRefBlobClobNClobStructjava.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のデータ型が、ARRAYBLOBCLOBDATALINKJAVA_OBJECTNCHARNCLOBNVARCHARLONGNVARCHARREFROWIDSQLXML、またはSTRUCTで、JDBCドライバがこのデータ型をサポートしていない場合
      導入されたバージョン:
      1.4
      関連項目:
      TypesResultSet.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メソッドに似ていますが、scaleに0を仮定している点が異なります。
      パラメータ:
      parameterName - パラメータの名前
      x - 入力パラメータ値を含むオブジェクト
      targetSqlType - データベースに送られる(java.sql.Typesで定義される) SQL型
      例外:
      SQLException - データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたCallableStatementについて呼び出された場合
      SQLFeatureNotSupportedException - targetSqlTypeのデータ型が、ARRAYBLOBCLOBDATALINKJAVA_OBJECTNCHARNCLOBNVARCHARLONGNVARCHARREFROWIDSQLXML、または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データ・ストリームへ書き込む必要があります。 また、オブジェクトがRefBlobClobNClobStructjava.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データ・ストリームに書き込む必要があります。 また、オブジェクトがRefBlobClobNClobStructjava.net.URL、またはArrayを実装するクラスのオブジェクトである場合、ドライバはこのオブジェクトを対応するSQL型の値としてデータベースに渡す必要があります。

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

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

      void setRef(int i, Ref x) throws SQLException
      このRowSetオブジェクトのコマンドで指定したパラメータを、指定したRef値に設定します。 このパラメータはドライバによって適切なREF(<structured-type>) (構造化型)値に変換されます。
      パラメータ:
      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には、長さで指定された文字数が含まれていなければなりません。それ以外の場合は、PreparedStatementが実行されるときにSQLExceptionが生成されます。 このメソッドは、setBinaryStream (int, InputStream, int)メソッドと異なり、パラメータ値をBLOBとしてサーバーに送信するべきであることをドライバに通知します。 setBinaryStreamメソッドを使用すると、ドライバは、パラメータ・データをLONGVARBINARYBLOBのどちらとしてサーバーに送信するべきかを判断するために余計な作業を行う必要がある可能性があります。
      パラメータ:
      parameterIndex - 最初のパラメータのインデックスは1、2番目のパラメータのインデックスは2、... となる
      inputStream - パラメータ値に設定されるデータを含むオブジェクト。
      length - パラメータ・データ内のバイト数。
      例外:
      SQLException - データベース・アクセス・エラーが発生した場合、parameterIndexがSQL文のパラメータ・マーカーに対応していない場合、指定された長さが0より小さい場合、またはInputStreamのバイト数が一致しない場合、閉じたPreparedStatementに対してこのメソッドが呼び出されます。
      SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合
      導入されたバージョン:
      1.6
    • setBlob

      void setBlob(int parameterIndex, InputStream inputStream) throws SQLException
      指定されたパラメータをInputStreamオブジェクトに設定します。 このメソッドは、setBinaryStream (int, InputStream)メソッドと異なり、パラメータ値をBLOBとしてサーバーに送信しなければならないことをドライバに通知します。 setBinaryStreamメソッドを使用すると、ドライバは、パラメータ・データをLONGVARBINARYBLOBのどちらとしてサーバーに送信するべきかを判断するために余計な作業を行う必要がある可能性があります。

      ノート: 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メソッドを使用すると、ドライバは、パラメータ・データをLONGVARBINARYBLOBのどちらとしてサーバーに送信するべきかを判断するために余計な作業を行う必要がある可能性があります。
      パラメータ:
      parameterName - 2番目は2に設定されるパラメータの名前
      inputStream - パラメータ値に設定されるデータを含むオブジェクト。
      length - パラメータ・データ内のバイト数。
      例外:
      SQLException - parameterIndexがSQL文のパラメータ・マーカーに対応していない場合、または指定された長さがゼロ未満の場合。InputStreamのバイト数が指定された長さと一致しない場合データベース・アクセス・エラーが発生した場合、またはこのメソッドが閉じられた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メソッドを使用すると、ドライバは、パラメータ・データをLONGVARBINARYBLOBのどちらとしてサーバーに送信するかを判断するために余計な作業を行う必要がある可能性があります。

      ノート: 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には、長さで指定された文字数が含まれていなければなりません。それ以外の場合は、PreparedStatementが実行されるときにSQLExceptionが生成されます。 このメソッドは、setCharacterStream (int, Reader, int)メソッドと異なり、パラメータ値をCLOBとしてサーバーに送信するべきであることをドライバに通知します。 setCharacterStreamメソッドを使用すると、ドライバは、パラメータ・データをLONGVARCHARCLOBのどちらとしてサーバーに送信するべきかを判断するために余計な作業を行う必要がある可能性があります。
      パラメータ:
      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メソッドを使用すると、ドライバは、パラメータ・データをLONGVARCHARCLOBのどちらとしてサーバーに送信するべきかを判断するために余計な作業を行う必要がある可能性があります。

      ノート: 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には、長さで指定された文字数が含まれていなければなりません。それ以外の場合は、CallableStatementが実行されるときにSQLExceptionが生成されます。 このメソッドは、setCharacterStream (int, Reader, int)メソッドと異なり、パラメータ値をCLOBとしてサーバーに送信するべきであることをドライバに通知します。 setCharacterStreamメソッドを使用すると、ドライバは、パラメータ・データをLONGVARCHARCLOBのどちらとしてサーバーに送信するかを判断するために余計な作業を行う必要がある可能性があります。
      パラメータ:
      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メソッドを使用すると、ドライバは、パラメータ・データをLONGVARCHARCLOBのどちらとしてサーバーに送信するかを判断するために余計な作業を行う必要がある可能性があります。

      ノート: 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 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オブジェクトがデータソースとの継続的な接続を維持しない場合は、Reader (RowSetReaderオブジェクト)を使用してデータを埋め込むことができます。 この場合、ReaderはこのRowSetオブジェクトに登録され、メソッドexecuteはその実装の一部としてReader 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.ResultWriter、または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.ResultWriter、または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
      指定されたパラメータを指定されたStringオブジェクトに設定します。 データベースに送るときに、ドライバはこれをSQL NCHARNVARCHAR、またはLONGNVARCHAR値(ドライバのNVARCHAR値に関する制限に関する引数のサイズに依存)に変換します。
      パラメータ:
      parameterIndex - 最初のパラメータのインデックスは1、2番目のパラメータのインデックスは2、... となる
      value - パラメータ値
      例外:
      SQLException - ドライバが各国文字セットをサポートしない場合、ドライバがデータ変換エラーが発生した可能性を検出できる場合、またはデータベース・アクセス・エラーが発生した場合
      導入されたバージョン:
      1.6
    • setNString

      void setNString(String parameterName, String value) throws SQLException
      指定されたパラメータを指定されたStringオブジェクトに設定します。 ドライバはこれをSQL NCHARNVARCHAR、または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には、長さで指定された文字数が含まれていなければなりません。それ以外の場合は、CallableStatementが実行されるときにSQLExceptionが生成されます。 このメソッドは、setCharacterStream (int, Reader, int)メソッドと異なり、パラメータ値をNCLOBとしてサーバーに送信するべきであることをドライバに通知します。 setCharacterStreamメソッドを使用すると、ドライバは、パラメータ・データをLONGNVARCHARNCLOBのどちらとしてサーバーに送信するかを判断するために余計な作業を行う必要がある可能性があります。
      パラメータ:
      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メソッドを使用すると、ドライバは、パラメータ・データをLONGNVARCHARNCLOBのどちらとしてサーバーに送信するかを判断するために余計な作業を行う必要がある可能性があります。

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

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

      void setNClob(int parameterIndex, Reader reader, long length) throws SQLException
      指定されたパラメータをReaderオブジェクトに設定します。 Readerには、長さで指定された文字数が含まれていなければなりません。それ以外の場合は、PreparedStatementが実行されるときにSQLExceptionが生成されます。 このメソッドは、setCharacterStream (int, Reader, int)メソッドと異なり、パラメータ値をNCLOBとしてサーバーに送信するべきであることをドライバに通知します。 setCharacterStreamメソッドを使用すると、ドライバは、パラメータ・データをLONGNVARCHARNCLOBのどちらとしてサーバーに送信するべきかを判断するために余計な作業を行う必要がある可能性があります。
      パラメータ:
      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メソッドを使用すると、ドライバは、パラメータ・データをLONGNVARCHARNCLOBのどちらとしてサーバーに送信するべきかを判断するために余計な作業を行う必要がある可能性があります。

      ノート: 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