インタフェースPreparedStatement

すべてのスーパー・インタフェース:
AutoCloseable, Statement, Wrapper
既知のすべてのサブインタフェース:
CallableStatement
public interface PreparedStatement extends Statement
プリコンパイルされたSQL文を表すオブジェクトです。

SQL文は、プリコンパイルされ、PreparedStatementオブジェクトに格納されます。 その後、このオブジェクトは、この文を複数回効率的に実行するために使用できます。

ノート: INパラメータ値を設定する設定機能メソッド(setShort、setStringなど)は、入力パラメータの定義されたSQL型と互換のある型を指定する必要があります。 たとえば、INパラメータがINTEGERというSQL型の場合、setIntメソッドを使用するようにしてください。

任意のパラメータ型変換が必要な場合は、目的のSQL型を指定してsetObjectメソッドを使用するようにしてください。

パラメータ設定の例を次に示します。conはアクティブな接続を表します。 

  BigDecimal sal = new BigDecimal("153833.00");
  PreparedStatement pstmt = con.prepareStatement("UPDATE EMPLOYEES
                                    SET SALARY = ? WHERE ID = ?");
  pstmt.setBigDecimal(1, sal);
  pstmt.setInt(2, 110592);

導入されたバージョン:
1.1
関連項目:

  • フィールドのサマリー

    インタフェース文で宣言されたフィールド

    CLOSE_ALL_RESULTS, CLOSE_CURRENT_RESULT, EXECUTE_FAILED, KEEP_CURRENT_RESULT, NO_GENERATED_KEYS, RETURN_GENERATED_KEYS, SUCCESS_NO_INFO
    修飾子と型
    フィールド
    説明
    static final int
    CLOSE_ALL_RESULTS
    getMoreResultsが呼び出されたときに、直前までオープンされていたすべてのResultSetオブジェクトがクローズされることを示す定数です。
    static final int
    CLOSE_CURRENT_RESULT
    getMoreResultsが呼び出されたときに、現在のResultSetオブジェクトがクローズされることを示す定数です。
    static final int
    EXECUTE_FAILED
    バッチ文の実行中にエラーが発生したことを示す定数です。
    static final int
    KEEP_CURRENT_RESULT
    getMoreResultsが呼び出されたときに、現在のResultSetオブジェクトがクローズされないことを示す定数です。
    static final int
    NO_GENERATED_KEYS
    生成されたキーを検索可能にしないことを示す定数です。
    static final int
    RETURN_GENERATED_KEYS
    生成されたキーを検索可能にすることを示す定数です。
    static final int
    SUCCESS_NO_INFO
    バッチ文が正常に実行されたが、影響を受けた行数が不明なことを示す定数です。

  • メソッドのサマリー

    修飾子と型
    メソッド
    説明
    void
    addBatch()
    このPreparedStatementオブジェクトのコマンドのバッチに、パラメータのセットを追加します。
    void
    clearParameters()
    現在のパラメータ値をすぐにクリアします。
    boolean
    execute()
    このPreparedStatementオブジェクトの、あらゆる種類のSQL文を実行します。
    default long
    executeLargeUpdate()
    このPreparedStatementオブジェクトのSQL文を実行します。それはSQLデータ操作言語(DML)文(INSERT文、UPDATE文、DELETE文など)であるか、DDL文のような何も返さないSQL文でなければなりません。
    ResultSet
    executeQuery()
    このPreparedStatementオブジェクトのSQLクエリーを実行し、そのクエリーによって生成されたResultSetオブジェクトを返します。
    int
    executeUpdate()
    このPreparedStatementオブジェクトのSQL文を実行します。それはSQLデータ操作言語(DML)文(INSERT文、UPDATE文、DELETE文など)であるか、DDL文のような何も返さないSQL文でなければなりません。
    ResultSetMetaData
    getMetaData()
    このPreparedStatementオブジェクトが実行されるときに返されるResultSetオブジェクトの列に関する情報を格納するResultSetMetaDataオブジェクトを取得します。
    ParameterMetaData
    getParameterMetaData()
    このPreparedStatementオブジェクトのパラメータの数、型、およびプロパティを取得します。
    void
    setArray(int parameterIndex, Array x)
    指定されたパラメータを指定されたjava.sql.Arrayオブジェクトに設定します。
    void
    setAsciiStream(int parameterIndex, InputStream x)
    指定されたパラメータを指定された入力ストリームに設定します。
    void
    setAsciiStream(int parameterIndex, InputStream x, int length)
    指定されたパラメータを、指定されたバイト数を持つ指定された入力ストリームに設定します。
    void
    setAsciiStream(int parameterIndex, InputStream x, long length)
    指定されたパラメータを、指定されたバイト数を持つ指定された入力ストリームに設定します。
    void
    setBigDecimal(int parameterIndex, BigDecimal x)
    指定されたパラメータを、指定されたjava.math.BigDecimal値に設定します。
    void
    setBinaryStream(int parameterIndex, InputStream x)
    指定されたパラメータを指定された入力ストリームに設定します。
    void
    setBinaryStream(int parameterIndex, InputStream x, int length)
    指定されたパラメータを、指定されたバイト数を持つ指定された入力ストリームに設定します。
    void
    setBinaryStream(int parameterIndex, InputStream x, long length)
    指定されたパラメータを、指定されたバイト数を持つ指定された入力ストリームに設定します。
    void
    setBlob(int parameterIndex, InputStream inputStream)
    指定されたパラメータをInputStreamオブジェクトに設定します。
    void
    setBlob(int parameterIndex, InputStream inputStream, long length)
    指定されたパラメータをInputStreamオブジェクトに設定します。
    void
    setBlob(int parameterIndex, Blob x)
    指定されたパラメータを指定されたjava.sql.Blobオブジェクトに設定します。
    void
    setBoolean(int parameterIndex, boolean x)
    指定されたパラメータを指定されたJavaのboolean値に設定します。
    void
    setByte(int parameterIndex, byte x)
    指定されたパラメータを指定されたJavaのbyte値に設定します。
    void
    setBytes(int parameterIndex, byte[] x)
    指定されたパラメータを指定されたJavaのバイト配列に設定します。
    void
    setCharacterStream(int parameterIndex, Reader reader)
    指定されたパラメータを指定されたReaderオブジェクトに設定します。
    void
    setCharacterStream(int parameterIndex, Reader reader, int length)
    指定されたパラメータを、指定された文字数である指定されたReaderオブジェクトに設定します。
    void
    setCharacterStream(int parameterIndex, Reader reader, long length)
    指定されたパラメータを、指定された文字数である指定されたReaderオブジェクトに設定します。
    void
    setClob(int parameterIndex, Reader reader)
    指定されたパラメータをReaderオブジェクトに設定します。
    void
    setClob(int parameterIndex, Reader reader, long length)
    指定されたパラメータをReaderオブジェクトに設定します。
    void
    setClob(int parameterIndex, Clob x)
    指定されたパラメータを指定されたjava.sql.Clobオブジェクトに設定します。
    void
    setDate(int parameterIndex, Date x)
    アプリケーションを実行している仮想マシンのデフォルトのタイムゾーンを使用して、指定されたパラメータを指定されたjava.sql.Date値に設定します。
    void
    setDate(int parameterIndex, Date x, Calendar cal)
    指定されたCalendarオブジェクトを使用して、指定されたパラメータを指定されたjava.sql.Date値に設定します。
    void
    setDouble(int parameterIndex, double x)
    指定されたパラメータを指定されたJavaのdouble値に設定します。
    void
    setFloat(int parameterIndex, float x)
    指定されたパラメータを指定されたJavaのfloat値に設定します。
    void
    setInt(int parameterIndex, int x)
    指定されたパラメータを指定されたJavaのint値に設定します。
    void
    setLong(int parameterIndex, long x)
    指定されたパラメータを指定されたJavaのlong値に設定します。
    void
    setNCharacterStream(int parameterIndex, Reader value)
    指定されたパラメータをReaderオブジェクトに設定します。
    void
    setNCharacterStream(int parameterIndex, Reader value, long length)
    指定されたパラメータをReaderオブジェクトに設定します。
    void
    setNClob(int parameterIndex, Reader reader)
    指定されたパラメータをReaderオブジェクトに設定します。
    void
    setNClob(int parameterIndex, Reader reader, long length)
    指定されたパラメータをReaderオブジェクトに設定します。
    void
    setNClob(int parameterIndex, NClob value)
    指定されたパラメータをjava.sql.NClobオブジェクトに設定します。
    void
    setNString(int parameterIndex, String value)
    指定されたパラメータを指定されたStringオブジェクトに設定します。
    void
    setNull(int parameterIndex, int sqlType)
    指定されたパラメータをSQL NULLに設定します。
    void
    setNull(int parameterIndex, int sqlType, String typeName)
    指定されたパラメータをSQL NULLに設定します。
    void
    setObject(int parameterIndex, Object x)
    指定されたパラメータの値を、指定されたオブジェクトを使用して設定します。
    void
    setObject(int parameterIndex, Object x, int targetSqlType)
    指定されたパラメータの値を、指定されたオブジェクトで設定します。
    void
    setObject(int parameterIndex, Object x, int targetSqlType, int scaleOrLength)
    指定されたパラメータの値を、指定されたオブジェクトで設定します。
    default void
    setObject(int parameterIndex, Object x, SQLType targetSqlType)
    指定されたパラメータの値を、指定されたオブジェクトで設定します。
    default void
    setObject(int parameterIndex, Object x, SQLType targetSqlType, int scaleOrLength)
    指定されたパラメータの値を、指定されたオブジェクトで設定します。
    void
    setRef(int parameterIndex, Ref x)
    指定されたパラメータを、指定されたREF(<structured-type>)値に設定します。
    void
    setRowId(int parameterIndex, RowId x)
    指定されたパラメータを指定されたjava.sql.RowIdオブジェクトに設定します。
    void
    setShort(int parameterIndex, short x)
    指定されたパラメータを指定されたJavaのshort値に設定します。
    void
    setSQLXML(int parameterIndex, SQLXML xmlObject)
    指定されたパラメータを指定されたjava.sql.SQLXMLオブジェクトに設定します。
    void
    setString(int parameterIndex, String x)
    指定されたパラメータを指定されたJavaのString値に設定します。
    void
    setTime(int parameterIndex, Time x)
    指定されたパラメータを、指定されたjava.sql.Time値に設定します。
    void
    setTime(int parameterIndex, Time x, Calendar cal)
    指定されたCalendarオブジェクトを使用して、指定されたパラメータを指定されたjava.sql.Time値に設定します。
    void
    setTimestamp(int parameterIndex, Timestamp x)
    指定されたパラメータを、指定されたjava.sql.Timestamp値に設定します。
    void
    setTimestamp(int parameterIndex, Timestamp x, Calendar cal)
    指定されたCalendarオブジェクトを使用して、指定されたパラメータを指定されたjava.sql.Timestamp値に設定します。
    void
    setUnicodeStream(int parameterIndex, InputStream x, int length)
    非推奨。
    setCharacterStreamを使用
    void
    setURL(int parameterIndex, URL x)
    指定されたパラメータを、指定されたjava.net.URL値に設定します。

    インタフェースStatementで宣言されたメソッド

    addBatch, cancel, clearBatch, clearWarnings, close, closeOnCompletion, enquoteIdentifier, enquoteLiteral, enquoteNCharLiteral, execute, execute, execute, execute, executeBatch, executeLargeBatch, executeLargeUpdate, executeLargeUpdate, executeLargeUpdate, executeLargeUpdate, executeQuery, executeUpdate, executeUpdate, executeUpdate, executeUpdate, getConnection, getFetchDirection, getFetchSize, getGeneratedKeys, getLargeMaxRows, getLargeUpdateCount, getMaxFieldSize, getMaxRows, getMoreResults, getMoreResults, getQueryTimeout, getResultSet, getResultSetConcurrency, getResultSetHoldability, getResultSetType, getUpdateCount, getWarnings, isClosed, isCloseOnCompletion, isPoolable, isSimpleIdentifier, setCursorName, setEscapeProcessing, setFetchDirection, setFetchSize, setLargeMaxRows, setMaxFieldSize, setMaxRows, setPoolable, setQueryTimeout
    修飾子と型
    メソッド
    説明
    void
    addBatch(String sql)
    このStatementオブジェクトの現在のコマンドのリストに、指定されたSQLコマンドを追加します。
    void
    cancel()
    DBMSおよびドライバの両方がSQL文の終了をサポートする場合に、このStatementオブジェクトを取り消します。
    void
    clearBatch()
    このStatementオブジェクトの現在のSQLコマンド・リストを空にします。
    void
    clearWarnings()
    このStatementオブジェクトに関して報告されたすべての警告をクリアします。
    void
    close()
    自動的にクローズされるときにStatementオブジェクトのデータベースとJDBCリソースが解放されるのを待つのではなく、ただちにそれらを解放します。
    void
    closeOnCompletion()
    このStatementに依存するすべての結果セットがクローズされたときにこのStatementがクローズされることを示します。
    default String
    enquoteIdentifier(String identifier, boolean alwaysDelimit)
    simple SQL identifierまたはデリミタ付き識別子を返します。
    default String
    enquoteLiteral(String val)
    一重引用符で囲まれたStringを返します。
    default String
    enquoteNCharLiteral(String val)
    一重引用符で囲まれ、先頭に大文字のNが付いた各国語文字セット・リテラルを表すStringを返します。
    boolean
    execute(String sql)
    複数の結果を返す可能性のある指定されたSQL文を実行します。
    boolean
    execute(String sql, int autoGeneratedKeys)
    複数の結果を返す可能性のある指定されたSQL文を実行し、すべての自動生成キーを検索可能にするかどうかについてドライバに通知します。
    boolean
    execute(String sql, int[] columnIndexes)
    複数の結果を返す可能性のある指定されたSQL文を実行し、指定された配列で示された自動生成キーを検索可能にすることをドライバに通知します。
    boolean
    execute(String sql, String[] columnNames)
    複数の結果を返す可能性のある指定されたSQL文を実行し、指定された配列で示された自動生成キーを検索可能にすることをドライバに通知します。
    int[]
    executeBatch()
    コマンドのバッチをデータベースに送信して実行し、すべてのコマンドが正常に実行されると、更新カウントの配列を返します。
    default long[]
    executeLargeBatch()
    コマンドのバッチをデータベースに送信して実行し、すべてのコマンドが正常に実行されると、更新カウントの配列を返します。
    default long
    executeLargeUpdate(String sql)
    指定されたSQL文を実行します。SQL文は、INSERT文、UPDATE文、DELETE文、またはSQL DDL文のような何も返さないSQL文の場合があります。
    default long
    executeLargeUpdate(String sql, int autoGeneratedKeys)
    指定されたSQL文を実行し、このStatementオブジェクトによって生成された自動生成キーを検索可能にするかどうかについて指定されたフラグでドライバに通知します。
    default long
    executeLargeUpdate(String sql, int[] columnIndexes)
    指定されたSQL文を実行し、指定された配列で示された自動生成キーを検索可能にすることをドライバに通知します。
    default long
    executeLargeUpdate(String sql, String[] columnNames)
    指定されたSQL文を実行し、指定された配列で示された自動生成キーを検索可能にすることをドライバに通知します。
    ResultSet
    executeQuery(String sql)
    単一のResultSetオブジェクトを返す、指定されたSQL文を実行します。
    int
    executeUpdate(String sql)
    指定されたSQL文を実行します。SQL文は、INSERT文、UPDATE文、DELETE文、またはSQL DDL文のような何も返さないSQL文の場合があります。
    int
    executeUpdate(String sql, int autoGeneratedKeys)
    指定されたSQL文を実行し、このStatementオブジェクトによって生成された自動生成キーを検索可能にするかどうかについて指定されたフラグでドライバに通知します。
    int
    executeUpdate(String sql, int[] columnIndexes)
    指定されたSQL文を実行し、指定された配列で示された自動生成キーを検索可能にすることをドライバに通知します。
    int
    executeUpdate(String sql, String[] columnNames)
    指定されたSQL文を実行し、指定された配列で示された自動生成キーを検索可能にすることをドライバに通知します。
    Connection
    getConnection()
    このStatementオブジェクトを生成したConnectionオブジェクトを取得します。
    int
    getFetchDirection()
    このStatementオブジェクトから生成された結果セットのデフォルトである、データベース表から行をフェッチする方向を取得します。
    int
    getFetchSize()
    このStatementオブジェクトから生成されたResultSetオブジェクトのデフォルトのフェッチ・サイズである、結果セットの行数を取得します。
    ResultSet
    getGeneratedKeys()
    このStatementオブジェクトを実行した結果として作成された自動生成キーを取得します。
    default long
    getLargeMaxRows()
    このStatementオブジェクトによって生成されるResultSetオブジェクトに含めることのできる最大行数を取得します。
    default long
    getLargeUpdateCount()
    更新カウントとして現在の結果を取得します。結果がResultSetオブジェクトであるか、または結果がない場合は -1を返します。
    int
    getMaxFieldSize()
    このStatementオブジェクトによって生成されるResultSetオブジェクトの文字およびバイナリの各列値に対し返される最大バイト数を取得します。
    int
    getMaxRows()
    このStatementオブジェクトによって生成されるResultSetオブジェクトに含めることのできる最大行数を取得します。
    boolean
    getMoreResults()
    Statementオブジェクトの次の結果に移動します。この結果がResultSetオブジェクトの場合はtrueを返し、getResultSetメソッドで得られた現在のResultSetオブジェクトをすべて暗黙にクローズします。
    boolean
    getMoreResults(int current)
    Statementオブジェクトの次の結果に移動します。指定されたフラグによって指定された命令に従ってすべての現在のResultSetオブジェクトを処理し、次の結果がResultSetオブジェクトの場合はtrueを返します。
    int
    getQueryTimeout()
    ドライバがStatementオブジェクトの実行を待つ秒数を取得します。
    ResultSet
    getResultSet()
    ResultSetオブジェクトとして現在の結果を取得します。
    int
    getResultSetConcurrency()
    このStatementオブジェクトから生成されたResultSetオブジェクトの結果セットの並行処理を取得します。
    int
    getResultSetHoldability()
    このStatementオブジェクトから生成されたResultSetオブジェクトの結果セットの保持機能を取得します。
    int
    getResultSetType()
    このStatementオブジェクトから生成されたResultSetオブジェクトの結果セットのタイプを取得します。
    int
    getUpdateCount()
    更新カウントとして現在の結果を取得します。結果がResultSetオブジェクトであるか、または結果がない場合は -1を返します。
    SQLWarning
    getWarnings()
    このStatementオブジェクトに関する呼出しによって報告される最初の警告を取得します。
    boolean
    isClosed()
    このStatementオブジェクトがクローズされているかどうかを取得します。
    boolean
    isCloseOnCompletion()
    このStatementに依存するすべての結果セットがクローズされたときにこのStatementがクローズされるかどうかを示す値を取得します。
    boolean
    isPoolable()
    Statementがプール可能かどうかを示す値を返します。
    default boolean
    isSimpleIdentifier(String identifier)
    identifierが単純なSQL識別子かどうかを返します。
    void
    setCursorName(String name)
    後続のStatementオブジェクトのexecuteメソッドによって使用されるSQLカーソル名を指定されたStringに設定します。
    void
    setEscapeProcessing(boolean enable)
    エスケープの処理をオンまたはオフに設定します。
    void
    setFetchDirection(int direction)
    Statementオブジェクトを使用して作成されたResultSetオブジェクトの行が処理される方向についてのヒントをドライバに提供します。
    void
    setFetchSize(int rows)
    このStatementで作成されたResultSetオブジェクトでより多くの行が必要なときにデータベースから取り出す必要がある行数についてのヒントをJDBCドライバに提供します。
    default void
    setLargeMaxRows(long max)
    このStatementオブジェクトで作成された任意のResultSetオブジェクトが含むことのできる最大行数の制限値を、指定された数に設定します。
    void
    setMaxFieldSize(int max)
    このStatementオブジェクトによって生成されるResultSetオブジェクトの文字およびバイナリの各列値に対し返される最大バイト数の制限を設定します。
    void
    setMaxRows(int max)
    このStatementオブジェクトで作成された任意のResultSetオブジェクトが含むことのできる最大行数の制限値を、指定された数に設定します。
    void
    setPoolable(boolean poolable)
    Statementをプールすること、またはプールしないことを要求します。
    void
    setQueryTimeout(int seconds)
    ドライバがStatementオブジェクトの実行を待つ秒数を、指定された秒数に設定します。

    インタフェースWrapperで宣言されたメソッド

    isWrapperFor, unwrap
    修飾子と型
    メソッド
    説明
    boolean
    isWrapperFor(Class<?> iface)
    これが、指定されたインタフェースを実装している場合や、そのようなオブジェクトの直接的または間接的なラッパーである場合は、trueを返します。
    <T> T
    unwrap(Class<T> iface)
    標準以外のメソッド、またはプロキシによって公開されない標準メソッドにアクセスできるようにするために、指定されたインタフェースを実装しているオブジェクトを返します。

  • メソッドの詳細

    • executeQuery

      ResultSet executeQuery() throws SQLException
      このPreparedStatementオブジェクトのSQLクエリーを実行し、そのクエリーによって生成されたResultSetオブジェクトを返します。
      戻り値:
      クエリーによって作成されたデータを含むResultSetオブジェクト。nullにはならない
      スロー:
      SQLException - データベース・アクセス・エラーが発生した場合、このメソッドがクローズされたPreparedStatementで呼び出された場合、またはSQL文がResultSetオブジェクトを返さない場合
      SQLTimeoutException - ドライバが、setQueryTimeoutメソッドで指定されたタイム・アウト値が経過したと判定し、少なくとも現在実行中のStatementの取消しを試みたとき

    • executeUpdate

      int executeUpdate() throws SQLException
      このPreparedStatementオブジェクトのSQL文を実行します。それはSQLデータ操作言語(DML)文(INSERT文、UPDATE文、DELETE文など)であるか、DDL文のような何も返さないSQL文でなければなりません。
      戻り値:
      (1) SQLデータ操作言語(DML)文の場合は行数、(2)何も返さないSQL文の場合は0
      スロー:
      SQLException - データベース・アクセス・エラーが発生した場合、このメソッドがクローズされたPreparedStatementで呼び出された場合、またはSQL文がResultSetオブジェクトを返した場合
      SQLTimeoutException - ドライバが、setQueryTimeoutメソッドで指定されたタイム・アウト値が経過したと判定し、少なくとも現在実行中のStatementの取消しを試みたとき

    • setNull

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

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

      パラメータ:
      parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となる
      sqlType - java.sql.Typesで定義されるSQL型コード
      スロー:
      SQLException - parameterIndexがSQL文のパラメータ・マーカーに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたPreparedStatementで呼び出された場合
      SQLFeatureNotSupportedException - sqlTypeのデータ型が、ARRAY、BLOB、CLOB、DATALINK、JAVA_OBJECT、NCHAR、NCLOB、NVARCHAR、LONGNVARCHAR、REF、ROWID、SQLXML、またはSTRUCTで、JDBCドライバがこのデータ型をサポートしていない場合

    • setBoolean

      void setBoolean(int parameterIndex, boolean x) throws SQLException
      指定されたパラメータを指定されたJavaのboolean値に設定します。 データベースに送るときに、ドライバはこれをSQL BITまたはBOOLEAN値に変換します。
      パラメータ:
      parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となる
      x - パラメータ値
      スロー:
      SQLException - parameterIndexがSQL文のパラメータ・マーカーに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたPreparedStatementで呼び出された場合

    • setByte

      void setByte(int parameterIndex, byte x) throws SQLException
      指定されたパラメータを指定されたJavaのbyte値に設定します。 データベースに送るときに、ドライバはこれをSQL TINYINT値に変換します。
      パラメータ:
      parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となる
      x - パラメータ値
      スロー:
      SQLException - parameterIndexがSQL文のパラメータ・マーカーに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたPreparedStatementで呼び出された場合

    • setShort

      void setShort(int parameterIndex, short x) throws SQLException
      指定されたパラメータを指定されたJavaのshort値に設定します。 データベースに送るときに、ドライバはこれをSQL SMALLINT値に変換します。
      パラメータ:
      parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となる
      x - パラメータ値
      スロー:
      SQLException - parameterIndexがSQL文のパラメータ・マーカーに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたPreparedStatementで呼び出された場合

    • setInt

      void setInt(int parameterIndex, int x) throws SQLException
      指定されたパラメータを指定されたJavaのint値に設定します。 データベースに送るときに、ドライバはこれをSQL INTEGER値に変換します。
      パラメータ:
      parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となる
      x - パラメータ値
      スロー:
      SQLException - parameterIndexがSQL文のパラメータ・マーカーに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたPreparedStatementで呼び出された場合

    • setLong

      void setLong(int parameterIndex, long x) throws SQLException
      指定されたパラメータを指定されたJavaのlong値に設定します。 データベースに送るときに、ドライバはこれをSQL BIGINT値に変換します。
      パラメータ:
      parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となる
      x - パラメータ値
      スロー:
      SQLException - parameterIndexがSQL文のパラメータ・マーカーに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたPreparedStatementで呼び出された場合

    • setFloat

      void setFloat(int parameterIndex, float x) throws SQLException
      指定されたパラメータを指定されたJavaのfloat値に設定します。 データベースに送るときに、ドライバはこれをSQL REAL値に変換します。
      パラメータ:
      parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となる
      x - パラメータ値
      スロー:
      SQLException - parameterIndexがSQL文のパラメータ・マーカーに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたPreparedStatementで呼び出された場合

    • setDouble

      void setDouble(int parameterIndex, double x) throws SQLException
      指定されたパラメータを指定されたJavaのdouble値に設定します。 データベースに送るときに、ドライバはこれをSQL DOUBLE値に変換します。
      パラメータ:
      parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となる
      x - パラメータ値
      スロー:
      SQLException - parameterIndexがSQL文のパラメータ・マーカーに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたPreparedStatementで呼び出された場合

    • setBigDecimal

      void setBigDecimal(int parameterIndex, BigDecimal x) throws SQLException
      指定されたパラメータを、指定されたjava.math.BigDecimal値に設定します。 データベースに送るときに、ドライバはこれをSQL NUMERIC値に変換します。
      パラメータ:
      parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となる
      x - パラメータ値
      スロー:
      SQLException - parameterIndexがSQL文のパラメータ・マーカーに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたPreparedStatementで呼び出された場合

    • setString

      void setString(int parameterIndex, String x) throws SQLException
      指定されたパラメータを指定されたJavaのString値に設定します。 データベースに送るときに、ドライバはこれをSQL VARCHARまたはLONGVARCHAR値(ドライバのVARCHAR値の制限に対する引数のサイズに依存)に変換します。
      パラメータ:
      parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となる
      x - パラメータ値
      スロー:
      SQLException - parameterIndexがSQL文のパラメータ・マーカーに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたPreparedStatementで呼び出された場合

    • setBytes

      void setBytes(int parameterIndex, byte[] x) throws SQLException
      指定されたパラメータを指定されたJavaのバイト配列に設定します。 データベースに送るときに、ドライバはこれをSQL VARBINARYまたはLONGVARBINARY (ドライバのVARBINARY値の制限に対する引数のサイズに依存)に変換します。
      パラメータ:
      parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となる
      x - パラメータ値
      スロー:
      SQLException - parameterIndexがSQL文のパラメータ・マーカーに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたPreparedStatementで呼び出された場合

    • setDate

      void setDate(int parameterIndex, Date x) throws SQLException
      アプリケーションを実行している仮想マシンのデフォルトのタイムゾーンを使用して、指定されたパラメータを指定されたjava.sql.Date値に設定します。 データベースに送るときに、ドライバはこれをSQL DATE値に変換します。
      パラメータ:
      parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となる
      x - パラメータ値
      スロー:
      SQLException - parameterIndexがSQL文のパラメータ・マーカーに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたPreparedStatementで呼び出された場合

    • setTime

      void setTime(int parameterIndex, Time x) throws SQLException
      指定されたパラメータを、指定されたjava.sql.Time値に設定します。 データベースに送るときに、ドライバはこれをSQL TIME値に変換します。
      パラメータ:
      parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となる
      x - パラメータ値
      スロー:
      SQLException - parameterIndexがSQL文のパラメータ・マーカーに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたPreparedStatementで呼び出された場合

    • setTimestamp

      void setTimestamp(int parameterIndex, Timestamp x) throws SQLException
      指定されたパラメータを、指定されたjava.sql.Timestamp値に設定します。 データベースに送るときに、ドライバはこれをSQL TIMESTAMP値に変換します。
      パラメータ:
      parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となる
      x - パラメータ値
      スロー:
      SQLException - parameterIndexがSQL文のパラメータ・マーカーに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたPreparedStatementで呼び出された場合

    • setAsciiStream

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

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

      パラメータ:
      parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となる
      x - ASCIIパラメータ値を含むJava入力ストリーム
      length - ストリームのバイト数
      スロー:
      SQLException - parameterIndexがSQL文のパラメータ・マーカーに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたPreparedStatementで呼び出された場合

    • setUnicodeStream

      @Deprecated(since="1.2") void setUnicodeStream(int parameterIndex, InputStream x, int length) throws SQLException
      非推奨。
      setCharacterStreamを使用
      指定されたパラメータを、指定されたバイト数を持つ指定された入力ストリームに設定します。 LONGVARCHARパラメータに非常に大きなUnicode値が入力されるときには、java.io.InputStreamオブジェクトを介して送るのが現実的です。 ファイルの終わりに達するまで必要に応じてストリームからデータが読み込まれます。 JDBCドライバは、データをUnicodeからデータベースのchar形式に変換します。 Unicodeストリームのバイト形式は、Java仮想マシン仕様に定義されているJava UTF-8である必要があります。

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

      パラメータ:
      parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となる
      x - Unicodeパラメータ値を含むjava.io.InputStreamオブジェクト
      length - ストリームのバイト数
      スロー:
      SQLException - parameterIndexがSQL文のパラメータ・マーカーに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたPreparedStatementで呼び出された場合
      SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合

    • setBinaryStream

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

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

      パラメータ:
      parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となる
      x - バイナリ・パラメータ値を含むJava入力ストリーム
      length - ストリームのバイト数
      スロー:
      SQLException - parameterIndexがSQL文のパラメータ・マーカーに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたPreparedStatementで呼び出された場合

    • clearParameters

      void clearParameters() throws SQLException
      現在のパラメータ値をすぐにクリアします。

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

      スロー:
      SQLException - データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたPreparedStatementについて呼び出された場合

    • setObject

      void setObject(int parameterIndex, Object x, int targetSqlType) throws SQLException
      指定されたパラメータの値を、指定されたオブジェクトで設定します。 このメソッドは、setObject(int parameterIndex, Object x, int targetSqlType, int scaleOrLength)に似ていますが、scaleに0を仮定している点が異なります。
      パラメータ:
      parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となる
      x - 入力パラメータ値を含むオブジェクト
      targetSqlType - データベースに送られる(java.sql.Typesで定義される) SQL型
      スロー:
      SQLException - parameterIndexがSQL文のパラメータ・マーカーに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたPreparedStatementで呼び出された場合
      SQLFeatureNotSupportedException - JDBCドライバが指定されたtargetSqlTypeをサポートしない場合
      関連項目:

    • setObject

      void setObject(int parameterIndex, Object x) throws SQLException

      指定されたパラメータの値を、指定されたオブジェクトを使用して設定します。

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

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

      ノート: すべてのデータベースで、バックエンドに対する型のないNullの送信が許可されるわけではありません。 移植性を最大限にするには、setObject(int parameterIndex, Object x)の代わりにsetNullメソッドまたはsetObject(int parameterIndex, Object x, int sqlType)メソッドを使用するようにしてください。

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

      パラメータ:
      parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となる
      x - 入力パラメータ値を含むオブジェクト
      スロー:
      SQLException - parameterIndexがSQL文のパラメータ・マーカーに対応しない場合、データベース・アクセス・エラーが発生した場合、このメソッドがクローズされたPreparedStatementで呼び出された場合、または指定されたオブジェクトの型があいまいな場合

    • execute

      boolean execute() throws SQLException
      このPreparedStatementオブジェクトの、あらゆる種類のSQL文を実行します。 プリペアド文オブジェクトで用意された文には複数の結果を返すものがあります。executeメソッドは、executeQueryメソッドとexecuteUpdateメソッドによって処理される、より簡単な形式の文と同様に、複雑な文も処理します。

      executeメソッドは、booleanを返し最初の結果の形式を示します。 getResultSetまたはgetUpdateCountメソッドを呼び出して結果を取得します。後続の結果がある場合はgetMoreResultsを呼び出してその結果に移動します。

      戻り値:
      最初の結果がResultSetオブジェクトの場合はtrue。更新カウントであるか、または結果がない場合はfalse
      スロー:
      SQLException - データベース・アクセス・エラーが発生した場合、このメソッドがクローズされたPreparedStatementで呼び出された場合、または引数がこのメソッドに指定された場合
      SQLTimeoutException - ドライバが、setQueryTimeoutメソッドで指定されたタイム・アウト値が経過したと判定し、少なくとも現在実行中のStatementの取消しを試みたとき
      関連項目:

    • addBatch

      void addBatch() throws SQLException
      このPreparedStatementオブジェクトのコマンドのバッチに、パラメータのセットを追加します。
      スロー:
      SQLException - データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたPreparedStatementについて呼び出された場合
      導入されたバージョン:
      1.2
      関連項目:

    • setCharacterStream

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

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

      パラメータ:
      parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となる
      reader - Unicodeデータを格納するjava.io.Readerオブジェクト
      length - ストリーム内の文字数
      スロー:
      SQLException - parameterIndexがSQL文のパラメータ・マーカーに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたPreparedStatementで呼び出された場合
      導入されたバージョン:
      1.2

    • setRef

      void setRef(int parameterIndex, Ref x) throws SQLException
      指定されたパラメータを、指定されたREF(<structured-type>)値に設定します。 データベースに送るときに、ドライバはこれをSQL REF値に変換します。
      パラメータ:
      parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となる
      x - SQL REF値
      スロー:
      SQLException - parameterIndexがSQL文のパラメータ・マーカーに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたPreparedStatementで呼び出された場合
      SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合
      導入されたバージョン:
      1.2

    • setBlob

      void setBlob(int parameterIndex, Blob x) throws SQLException
      指定されたパラメータを指定されたjava.sql.Blobオブジェクトに設定します。 データベースに送るときに、ドライバはこれをSQL BLOB値に変換します。
      パラメータ:
      parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となる
      x - SQL BLOB値をマッピングするBlobオブジェクト
      スロー:
      SQLException - parameterIndexがSQL文のパラメータ・マーカーに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたPreparedStatementで呼び出された場合
      SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合
      導入されたバージョン:
      1.2

    • setClob

      void setClob(int parameterIndex, Clob x) throws SQLException
      指定されたパラメータを指定されたjava.sql.Clobオブジェクトに設定します。 データベースに送るときに、ドライバはこれをSQL CLOB値に変換します。
      パラメータ:
      parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となる
      x - SQL CLOB値をマッピングするClobオブジェクト
      スロー:
      SQLException - parameterIndexがSQL文のパラメータ・マーカーに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたPreparedStatementで呼び出された場合
      SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合
      導入されたバージョン:
      1.2

    • setArray

      void setArray(int parameterIndex, Array x) throws SQLException
      指定されたパラメータを指定されたjava.sql.Arrayオブジェクトに設定します。 データベースに送るときに、ドライバはこれをSQL ARRAY値に変換します。
      パラメータ:
      parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となる
      x - SQL ARRAY値をマッピングするArrayオブジェクト
      スロー:
      SQLException - parameterIndexがSQL文のパラメータ・マーカーに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたPreparedStatementで呼び出された場合
      SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合
      導入されたバージョン:
      1.2

    • getMetaData

      ResultSetMetaData getMetaData() throws SQLException
      このPreparedStatementオブジェクトが実行されるときに返されるResultSetオブジェクトの列に関する情報を格納するResultSetMetaDataオブジェクトを取得します。

      PreparedStatementオブジェクトはプリコンパイルされるので、実行せずに、返されるResultSetオブジェクトについて知ることが可能です。 したがって、PreparedStatementオブジェクトのgetMetaDataメソッドを呼び出すことができます。その実行を待ち、それから返されたResultSetオブジェクトに対してResultSet.getMetaDataメソッドを呼び出す必要はありません。

      ノート: このメソッドの使用は、ドライバによっては基本となるDBMSサポートが不足しているため負荷が大きくなる場合があります。

      戻り値:
      ResultSetオブジェクトの列の記述、またはドライバがResultSetMetaDataオブジェクトを返すことができない場合はnull
      スロー:
      SQLException - データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたPreparedStatementについて呼び出された場合
      SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合
      導入されたバージョン:
      1.2

    • setDate

      void setDate(int parameterIndex, Date x, Calendar cal) throws SQLException
      指定されたCalendarオブジェクトを使用して、指定されたパラメータを指定されたjava.sql.Date値に設定します。 ドライバはCalendarオブジェクトを使用してSQL DATE値を作成し、続いてそれをデータベースに送ります。 Calendarオブジェクトを使用すると、ドライバはカスタム・タイムゾーンを考慮して日付を計算できます。 Calendarオブジェクトを指定しない場合、ドライバは、アプリケーションを実行している仮想マシンのタイムゾーンであるデフォルトのタイムゾーンを使用します。
      パラメータ:
      parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となる
      x - パラメータ値
      cal - ドライバが日付を作成するために使用するCalendarオブジェクト
      スロー:
      SQLException - parameterIndexがSQL文のパラメータ・マーカーに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたPreparedStatementで呼び出された場合
      導入されたバージョン:
      1.2

    • setTime

      void setTime(int parameterIndex, Time x, Calendar cal) throws SQLException
      指定されたCalendarオブジェクトを使用して、指定されたパラメータを指定されたjava.sql.Time値に設定します。 ドライバはCalendarオブジェクトを使用してSQL TIME値を作成し、続いてそれをデータベースに送ります。 Calendarオブジェクトを使用すると、ドライバはカスタム・タイムゾーンを考慮して時間を計算できます。 Calendarオブジェクトを指定しない場合、ドライバは、アプリケーションを実行している仮想マシンのタイムゾーンであるデフォルトのタイムゾーンを使用します。
      パラメータ:
      parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となる
      x - パラメータ値
      cal - ドライバが時間を作成するために使用するCalendarオブジェクト
      スロー:
      SQLException - parameterIndexがSQL文のパラメータ・マーカーに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたPreparedStatementで呼び出された場合
      導入されたバージョン:
      1.2

    • setTimestamp

      void setTimestamp(int parameterIndex, Timestamp x, Calendar cal) throws SQLException
      指定されたCalendarオブジェクトを使用して、指定されたパラメータを指定されたjava.sql.Timestamp値に設定します。 ドライバはCalendarオブジェクトを使用してSQL TIMESTAMP値を作成し、続いてそれをデータベースに送ります。 Calendarオブジェクトを使用すると、ドライバはカスタム・タイムゾーンを考慮してタイムスタンプを計算できます。 Calendarオブジェクトを指定しない場合、ドライバは、アプリケーションを実行している仮想マシンのタイムゾーンであるデフォルトのタイムゾーンを使用します。
      パラメータ:
      parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となる
      x - パラメータ値
      cal - ドライバがタイムスタンプを作成するために使用するCalendarオブジェクト
      スロー:
      SQLException - parameterIndexがSQL文のパラメータ・マーカーに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたPreparedStatementで呼び出された場合
      導入されたバージョン:
      1.2

    • setNull

      void setNull(int parameterIndex, 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は無視されます。

      パラメータ:
      parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となる
      sqlType - java.sql.Typesからの値
      typeName - SQLユーザー定義型の完全指定の名前。パラメータがユーザー定義型でもREFでもない場合は無視される
      スロー:
      SQLException - parameterIndexがSQL文のパラメータ・マーカーに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたPreparedStatementで呼び出された場合
      SQLFeatureNotSupportedException - sqlTypeのデータ型が、ARRAY、BLOB、CLOB、DATALINK、JAVA_OBJECT、NCHAR、NCLOB、NVARCHAR、LONGNVARCHAR、REF、ROWID、SQLXML、またはSTRUCTで、JDBCドライバがこのデータ型をサポートしていない場合。またはJDBCドライバがこのメソッドをサポートしていない場合
      導入されたバージョン:
      1.2

    • setURL

      void setURL(int parameterIndex, URL x) throws SQLException
      指定されたパラメータを、指定されたjava.net.URL値に設定します。 データベースに送るときに、ドライバはこれをSQL DATALINK値に変換します。
      パラメータ:
      parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となる
      x - 設定されるjava.net.URLオブジェクト
      スロー:
      SQLException - parameterIndexがSQL文のパラメータ・マーカーに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたPreparedStatementで呼び出された場合
      SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合
      導入されたバージョン:
      1.4

    • getParameterMetaData

      ParameterMetaData getParameterMetaData() throws SQLException
      このPreparedStatementオブジェクトのパラメータの数、型、およびプロパティを取得します。
      戻り値:
      このPreparedStatementオブジェクトの各パラメータ・マーカーの数、型、およびプロパティについての情報を格納するParameterMetaDataオブジェクト
      スロー:
      SQLException - データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたPreparedStatementについて呼び出された場合
      導入されたバージョン:
      1.4
      関連項目:

    • setRowId

      void setRowId(int parameterIndex, RowId x) throws SQLException
      指定されたパラメータを指定されたjava.sql.RowIdオブジェクトに設定します。 データベースに送るときに、ドライバはこれをSQL ROWID値に変換します。
      パラメータ:
      parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となる
      x - パラメータ値
      スロー:
      SQLException - parameterIndexがSQL文のパラメータ・マーカーに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたPreparedStatementで呼び出された場合
      SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合
      導入されたバージョン:
      1.6

    • setNString

      void setNString(int parameterIndex, String value) throws SQLException
      指定されたパラメータを指定されたStringオブジェクトに設定します。 データベースに送るときに、ドライバはこれをSQL NCHAR、NVARCHAR、またはLONGNVARCHAR値(ドライバのNVARCHAR値に関する制限に関する引数のサイズに依存)に変換します。
      パラメータ:
      parameterIndex - 最初のパラメータのインデックスは1、2番目のパラメータのインデックスは2、... となる
      value - パラメータ値
      スロー:
      SQLException - parameterIndexがSQL文のパラメータ・マーカーに対応しない場合、ドライバが各国の文字セットをサポートしない場合、ドライバがデータ変換エラーが発生したことを検出できる場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたPreparedStatementで呼び出された場合
      SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合
      導入されたバージョン:
      1.6

    • setNCharacterStream

      void setNCharacterStream(int parameterIndex, Reader value, long length) throws SQLException
      指定されたパラメータをReaderオブジェクトに設定します。 Readerは、ファイルの終わりに達するまでデータを読み込みます。 ドライバは、必要に応じて、Javaの文字表現をデータベース内の各国文字セットに変換します。
      パラメータ:
      parameterIndex - 最初のパラメータのインデックスは1、2番目のパラメータのインデックスは2、... となる
      value - パラメータ値
      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 - parameterIndexがSQL文のパラメータ・マーカーに対応しない場合、ドライバが各国の文字セットをサポートしない場合、ドライバがデータ変換エラーが発生したことを検出できる場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたPreparedStatementで呼び出された場合
      SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合
      導入されたバージョン:
      1.6

    • setClob

      void setClob(int parameterIndex, Reader reader, long length) throws SQLException
      指定されたパラメータをReaderオブジェクトに設定します。 readerには、lengthで指定された文字数が含まれている必要があります。そうでない場合、PreparedStatementの実行時にSQLExceptionが生成されます。 このメソッドは、setCharacterStream (int, Reader, int)メソッドと異なり、パラメータ値をCLOBとしてサーバーに送信するべきであることをドライバに通知します。 setCharacterStreamメソッドを使用すると、ドライバは、パラメータ・データをLONGVARCHARとCLOBのどちらとしてサーバーに送信するべきかを判断するために余計な作業を行う必要がある可能性があります。
      パラメータ:
      parameterIndex - 最初のパラメータのインデックスは1、2番目のパラメータのインデックスは2、... となる
      reader - パラメータ値に設定されるデータを含むオブジェクト。
      length - パラメータ・データ内の文字数。
      スロー:
      SQLException - parameterIndexがSQL文のパラメータ・マーカーに対応しない場合、データベース・アクセス・エラーが発生した場合、このメソッドがクローズされたPreparedStatementで呼び出された場合、または指定されたlengthが0より小さい場合。
      SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合
      導入されたバージョン:
      1.6

    • setBlob

      void setBlob(int parameterIndex, InputStream inputStream, long length) throws SQLException
      指定されたパラメータをInputStreamオブジェクトに設定します。 Inputstreamには、長さで指定された文字数が含まれている必要があります。そうでない場合、PreparedStatementの実行時にSQLExceptionが生成されます。 このメソッドは、setBinaryStream (int, InputStream, int)メソッドと異なり、パラメータ値をBLOBとしてサーバーに送信するべきであることをドライバに通知します。 setBinaryStreamメソッドを使用すると、ドライバは、パラメータ・データをLONGVARBINARYとBLOBのどちらとしてサーバーに送信するべきかを判断するために余計な作業を行う必要がある可能性があります。
      パラメータ:
      parameterIndex - 最初のパラメータのインデックスは1、2番目のパラメータのインデックスは2、... となる
      inputStream - パラメータ値に設定されるデータを含むオブジェクト。
      length - パラメータ・データ内のバイト数。
      スロー:
      SQLException - parameterIndexがSQL文のパラメータ・マーカーに対応していない場合、データベース・アクセス・エラーが発生した場合、このメソッドはクローズされたPreparedStatementでコールされます。指定された長さがゼロ未満の場合、またはInputStreamのバイト数が指定された長さと一致しない場合。
      SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合
      導入されたバージョン:
      1.6

    • setNClob

      void setNClob(int parameterIndex, Reader reader, long length) throws SQLException
      指定されたパラメータをReaderオブジェクトに設定します。 readerには、lengthで指定された文字数が含まれている必要があります。そうでない場合、PreparedStatementの実行時にSQLExceptionが生成されます。 このメソッドは、setCharacterStream (int, Reader, int)メソッドと異なり、パラメータ値をNCLOBとしてサーバーに送信するべきであることをドライバに通知します。 setCharacterStreamメソッドを使用すると、ドライバは、パラメータ・データをLONGNVARCHARとNCLOBのどちらとしてサーバーに送信するべきかを判断するために余計な作業を行う必要がある可能性があります。
      パラメータ:
      parameterIndex - 最初のパラメータのインデックスは1、2番目のパラメータのインデックスは2、... となる
      reader - パラメータ値に設定されるデータを含むオブジェクト。
      length - パラメータ・データ内の文字数。
      スロー:
      SQLException - parameterIndexがSQL文のパラメータ・マーカーと対応していない場合、長さとしてゼロ未満の値が指定された場合、ドライバが各国文字セットをサポートしない場合、ドライバがデータ変換エラーが発生した可能性を検出できる場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたPreparedStatement上で呼び出された場合
      SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合
      導入されたバージョン:
      1.6

    • setSQLXML

      void setSQLXML(int parameterIndex, SQLXML xmlObject) throws SQLException
      指定されたパラメータを指定されたjava.sql.SQLXMLオブジェクトに設定します。 データベースに送るときに、ドライバはこれをSQL XML値に変換します。
      パラメータ:
      parameterIndex - 最初のパラメータのインデックスは1、2番目のパラメータのインデックスは2、... となる
      xmlObject - SQL XML値をマッピングするSQLXMLオブジェクト
      スロー:
      SQLException - parameterIndexが指定されたSQL文のパラメータ・マーカーに対応しない場合、データベース・アクセス・エラーが発生した場合、このメソッドがクローズされたPreparedStatementまたはjava.xml.transform.Resultで呼び出された場合、WriterまたはOutputStreamがSQLXMLオブジェクトに対してクローズされていない場合
      SQLFeatureNotSupportedException - JDBCドライバがこのメソッドをサポートしない場合
      導入されたバージョン:
      1.6

    • setObject

      void setObject(int parameterIndex, Object x, int targetSqlType, int scaleOrLength) throws SQLException

      指定されたパラメータの値を、指定されたオブジェクトで設定します。 2番目の引数がInputStreamである場合、ストリームにはscaleOrLengthで指定されるバイト数が含まれる必要があります。 2番目の引数がReaderである場合、リーダーにはscaleOrLengthで指定される文字数が含まれる必要があります。 これらの条件がtrueではない場合、準備された文の実行時にドライバはSQLExceptionを生成します。

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

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

      パラメータ:
      parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となる
      x - 入力パラメータ値を含むオブジェクト
      targetSqlType - データベースに送られる(java.sql.Typesで定義される) SQL型。 scale引数で、さらにこの型を限定できる。
      scaleOrLength - java.sql.Types.DECIMALまたはjava.sql.Types.NUMERIC typesの場合、これは小数点のあとの桁数になる。 Javaオブジェクト型InputStreamおよびReaderの場合は、ストリームまたはリーダーのデータ長。 ほかのすべての型では、この値は無視される。
      スロー:
      SQLException - parameterIndexがSQL文のパラメータ・マーカーに対応しない場合、データベース・アクセス・エラーが発生した場合、このメソッドがクローズされたPreparedStatementで呼び出された場合、またはxで指定されたJavaオブジェクトがInputStreamオブジェクトかReaderオブジェクトで、かつscaleパラメータの値が0より小さい場合
      SQLFeatureNotSupportedException - JDBCドライバが指定されたtargetSqlTypeをサポートしない場合
      関連項目:

    • setAsciiStream

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

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

      パラメータ:
      parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となる
      x - ASCIIパラメータ値を含むJava入力ストリーム
      length - ストリームのバイト数
      スロー:
      SQLException - parameterIndexがSQL文のパラメータ・マーカーに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたPreparedStatementで呼び出された場合
      導入されたバージョン:
      1.6

    • setBinaryStream

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

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

      パラメータ:
      parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となる
      x - バイナリ・パラメータ値を含むJava入力ストリーム
      length - ストリームのバイト数
      スロー:
      SQLException - parameterIndexがSQL文のパラメータ・マーカーに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたPreparedStatementで呼び出された場合
      導入されたバージョン:
      1.6

    • setCharacterStream

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

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

      パラメータ:
      parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となる
      reader - Unicodeデータを格納するjava.io.Readerオブジェクト
      length - ストリーム内の文字数
      スロー:
      SQLException - parameterIndexがSQL文のパラメータ・マーカーに対応しない場合、データベース・アクセス・エラーが発生した場合、またはこのメソッドがクローズされたPreparedStatementで呼び出された場合
      導入されたバージョン:
      1.6

    • setAsciiStream

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

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

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

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

    • setBinaryStream

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

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

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

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

    • setCharacterStream

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

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

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

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

    • setNCharacterStream

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

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

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

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

    • setClob

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

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

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

    • setBlob

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

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

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

    • setNClob

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

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

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

    • setObject

      default void setObject(int parameterIndex, Object x, SQLType targetSqlType, int scaleOrLength) throws SQLException

      指定されたパラメータの値を、指定されたオブジェクトで設定します。 2番目の引数がInputStreamである場合、ストリームにはscaleOrLengthで指定されるバイト数が含まれる必要があります。 2番目の引数がReaderである場合、リーダーにはscaleOrLengthで指定される文字数が含まれる必要があります。 これらの条件がtrueではない場合、準備された文の実行時にドライバはSQLExceptionを生成します。

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

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

      デフォルト実装はSQLFeatureNotSupportedExceptionをスローします

      パラメータ:
      parameterIndex - 最初のパラメータは1、2番目のパラメータは2、... となる
      x - 入力パラメータ値を含むオブジェクト
      targetSqlType - データベースに送られるSQL型。 scale引数で、さらにこの型を限定できる。
      scaleOrLength - java.sql.JDBCType.DECIMALまたはjava.sql.JDBCType.NUMERIC型の場合、これは小数点の後の桁数になる。 Javaオブジェクト型InputStreamおよびReaderの場合は、ストリームまたはリーダーのデータ長。 ほかのすべての型では、この値は無視される。
      スロー:
      SQLException - parameterIndexがSQL文のパラメータ・マーカーに対応しない場合、データベース・アクセス・エラーが発生した場合、このメソッドがクローズされたPreparedStatementで呼び出された場合、またはxで指定されたJavaオブジェクトがInputStreamオブジェクトかReaderオブジェクトで、かつscaleパラメータの値が0より小さい場合
      SQLFeatureNotSupportedException - JDBCドライバが指定されたtargetSqlTypeをサポートしない場合
      導入されたバージョン:
      1.8
      関連項目:

    • setObject

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

      デフォルト実装はSQLFeatureNotSupportedExceptionをスローします

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

    • executeLargeUpdate

      default long executeLargeUpdate() throws SQLException
      このPreparedStatementオブジェクトのSQL文を実行します。それはSQLデータ操作言語(DML)文(INSERT文、UPDATE文、DELETE文など)であるか、DDL文のような何も返さないSQL文でなければなりません。

      返される行数がInteger.MAX_VALUEを超える可能性がある場合は、このメソッドを使用するようにしてください。

      デフォルト実装はUnsupportedOperationExceptionをスローします

      戻り値:
      (1) SQLデータ操作言語(DML)文の場合は行数、(2)何も返さないSQL文の場合は0
      スロー:
      SQLException - データベース・アクセス・エラーが発生した場合、このメソッドがクローズされたPreparedStatementで呼び出された場合、またはSQL文がResultSetオブジェクトを返した場合
      SQLTimeoutException - ドライバが、setQueryTimeoutメソッドで指定されたタイム・アウト値が経過したと判定し、少なくとも現在実行中のStatementの取消しを試みたとき
      導入されたバージョン:
      1.8