モジュール 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()
      • 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