Java 2 Platform SE 1.3: インタフェース PreparedStatement


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

関連項目:: Connection.prepareStatement(java.lang.String),
Some of the methods in this interface are new in the JDBC 2.0 API.

メソッドの概要

void addBatch()
          この PreparedStatement オブジェクトのコマンドのバッチに、パラメータのセットを追加します。

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

boolean execute()
          あらゆる種類の SQL 文を実行します。

ResultSet executeQuery()
          この PreparedStatement オブジェクトの SQL クエリーを実行し、そのクエリーによって生成された結果セットを返します。

int executeUpdate()
          この PreparedStatement オブジェクトの SQL INSERT 文、UPDATE 文、または DELETE 文を実行します。

ResultSetMetaData getMetaData()
          ResultSet オブジェクトの列の数、型、およびプロパティを取得します。

void setArray(int i, Array x)
          指定されたパラメータを、指定された Array オブジェクトに設定します。

void setAsciiStream(int parameterIndex, InputStream x, int length)
          指定されたパラメータを、指定されたバイト数を持つ指定された入力ストリームに設定します。

void setBigDecimal(int parameterIndex, BigDecimal x)
          指定されたパラメータを java.math.BigDecimal 値に設定します。

void setBinaryStream(int parameterIndex, InputStream x, int length)
          指定されたパラメータを、指定されたバイト数を持つ指定された入力ストリームに設定します。

void setBlob(int i, Blob x)
          指定されたパラメータを、指定された 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, int length)
          指定されたパラメータを、指定された文字数である指定された Reader オブジェクトに設定します。

void setClob(int i, Clob x)
          指定されたパラメータを、指定された Clob オブジェクトに設定します。

void setDate(int parameterIndex, Date x)
          指定されたパラメータを Java の 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 setNull(int parameterIndex, int sqlType)
          指定されたパラメータを SQL NULL に設定します。

void setNull(int paramIndex, 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 scale)
          指定されたパラメータの値を、指定されたオブジェクトを使用して設定します。

void setRef(int i, Ref x)
          指定されたパラメータを、指定された REF(<構造化型>) 値に設定します。

void setShort(int parameterIndex, short x)
          指定されたパラメータを Java の short 値に設定します。

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)
          推奨されていません。

インタフェース java.sql.Statement から継承したメソッド

addBatch, cancel, clearBatch, clearWarnings, close, execute, executeBatch, executeQuery, executeUpdate, getConnection, getFetchDirection, getFetchSize, getMaxFieldSize, getMaxRows, getMoreResults, getQueryTimeout, getResultSet, getResultSetConcurrency, getResultSetType, getUpdateCount, getWarnings, setCursorName, setEscapeProcessing, setFetchDirection, setFetchSize, setMaxFieldSize, setMaxRows, setQueryTimeout

メソッドの詳細

executeQuery

public ResultSet executeQuery()
                       throws SQLException

この PreparedStatement オブジェクトの SQL クエリーを実行し、そのクエリーによって生成された結果セットを返します。

戻り値:: クエリーによって作成されたデータを含む ResultSet オブジェクト。null にはならない
例外:: SQLException - データベースアクセスエラーが発生した場合

executeUpdate

public int executeUpdate()
                  throws SQLException

この PreparedStatement オブジェクトの SQL INSERT 文、UPDATE 文、または DELETE 文を実行します。さらに、SQL DDL 文のような何も返さない SQL 文を実行することもできます。

戻り値:: INSERT 文、UPDATE 文、DELETE 文の場合は行数。何も返さない SQL 文の場合は 0
例外:: SQLException - データベースアクセスエラーが発生した場合

setNull

public void setNull(int parameterIndex,
                    int sqlType)
             throws SQLException

指定されたパラメータを SQL NULL に設定します。

注: パラメータの SQL 型を指定しなければなりません。

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

setBoolean

public void setBoolean(int parameterIndex,
                       boolean x)
                throws SQLException

指定されたパラメータを Java の boolean 値に設定します。データベースに送るときに、ドライバはこれを SQL BIT 値に変換します。

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

setByte

public void setByte(int parameterIndex,
                    byte x)
             throws SQLException

指定されたパラメータを Java の byte 値に設定します。データベースに送るときに、ドライバはこれを SQL TINYINT 値に変換します。

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

setShort

public void setShort(int parameterIndex,
                     short x)
              throws SQLException

指定されたパラメータを Java の short 値に設定します。データベースに送るときに、ドライバはこれを SQL SMALLINT 値に変換します。

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

setInt

public void setInt(int parameterIndex,
                   int x)
            throws SQLException

指定されたパラメータを Java の int 値に設定します。データベースに送るときに、ドライバはこれを SQL INTEGER 値に変換します。

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

setLong

public void setLong(int parameterIndex,
                    long x)
             throws SQLException

指定されたパラメータを Java の long 値に設定します。データベースに送るときに、ドライバはこれを SQL BIGINT 値に変換します。

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

setFloat

public void setFloat(int parameterIndex,
                     float x)
              throws SQLException

指定されたパラメータを Java の float 値に設定します。データベースに送るときに、ドライバはこれを SQL FLOAT 値に変換します。

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

setDouble

public void setDouble(int parameterIndex,
                      double x)
               throws SQLException

指定されたパラメータを Java の double 値に設定します。データベースに送るときに、ドライバはこれを SQL DOUBLE 値に変換します。

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

setBigDecimal

public void setBigDecimal(int parameterIndex,
                          BigDecimal x)
                   throws SQLException

指定されたパラメータを java.math.BigDecimal 値に設定します。データベースに送るときに、ドライバはこれを SQL NUMERIC 値に変換します。

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

setString

public void setString(int parameterIndex,
                      String x)
               throws SQLException

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

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

setBytes

public void setBytes(int parameterIndex,
                     byte[] x)
              throws SQLException

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

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

setDate

public void setDate(int parameterIndex,
                    Date x)
             throws SQLException

指定されたパラメータを Java の java.sql.Date 値に設定します。データベースに送るときに、ドライバはこれを SQL DATE 値に変換します。

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

setTime

public void setTime(int parameterIndex,
                    Time x)
             throws SQLException

指定されたパラメータを java.sql.Time 値に設定します。データベースに送るときに、ドライバはこれを SQL TIME 値に変換します。

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

setTimestamp

public void setTimestamp(int parameterIndex,
                         Timestamp x)
                  throws SQLException

指定されたパラメータを java.sql.Timestamp 値に設定します。データベースに送るときに、ドライバはこれを SQL TIMESTAMP 値に変換します。

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

setAsciiStream

public 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 - データベースアクセスエラーが発生した場合

setUnicodeStream

public void setUnicodeStream(int parameterIndex,
                             InputStream x,
                             int length)
                      throws SQLException

推奨されていません。

指定されたパラメータを、指定されたバイト数を持つ指定された入力ストリームに設定します。LONGVARCHAR パラメータに、非常に大きな UNICODE 値が入力されるときには、java.io.InputStream オブジェクトを介して送るのが現実的です。ファイルの終わりに達するまで必要に応じてストリームからデータが読み込まれます。JDBC ドライバは、データを UNICODE からデータベースの char 形式に変換します。Unicode ストリームのバイト形式は、Java Virtual Machine 仕様で定義されているとおり、Java UTF-8 でなければなりません。

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

setBinaryStream

public void setBinaryStream(int parameterIndex,
                            InputStream x,
                            int length)
                     throws SQLException

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

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

clearParameters

public void clearParameters()
                     throws SQLException

現在のパラメータ値をすぐにクリアします。

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

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

setObject

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

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

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

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

パラメータ:: parameterIndex - 最初のパラメータは 1、2 番目のパラメータは 2、などとする; x - 入力パラメータ値を含むオブジェクト; targetSqlType - データベースに送られる (java.sql.Types で定義される) SQL 型。スケール引数で、さらに型を限定できる; scale - java.sql.Types.DECIMAL や java.sql.Types.NUMERIC 型では、小数点以下の桁数。ほかのすべての型では、この値は無視される
例外:: SQLException - データベースアクセスエラーが発生した場合
関連項目:: Types

setObject

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

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

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

setObject

public void setObject(int parameterIndex,
                      Object x)
               throws SQLException

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

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

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

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

execute

public boolean execute()
                throws SQLException

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

例外:: SQLException - データベースアクセスエラーが発生した場合
関連項目:: Statement.execute(java.lang.String)

addBatch

public void addBatch()
              throws SQLException

この PreparedStatement オブジェクトのコマンドのバッチに、パラメータのセットを追加します。

例外:: SQLException - データベースアクセスエラーが発生した場合
導入されたバージョン:: 1.2
関連項目:: Statement.addBatch(java.lang.String), 「JDBC 2.0 API に含まれるもの」

setCharacterStream

public void setCharacterStream(int parameterIndex,
                               Reader reader,
                               int length)
                        throws SQLException

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

パラメータ:: parameterIndex - 最初のパラメータは 1、2 番目のパラメータは 2、などとする; x - UNICODE データを含む Java リーダ; length - ストリーム内の文字数
例外:: SQLException - データベースアクセスエラーが発生した場合
導入されたバージョン:: 1.2
関連項目:: 「JDBC 2.0 API に含まれるもの」

setRef

public void setRef(int i,
                   Ref x)
            throws SQLException

指定されたパラメータを、指定された REF(<構造化型>) 値に設定します。

パラメータ:: i - 最初のパラメータは 1、2 番目のパラメータは 2、などとする; x - SQL REF 値
例外:: SQLException - データベースアクセスエラーが発生した場合
導入されたバージョン:: 1.2
関連項目:: 「JDBC 2.0 API に含まれるもの」

setBlob

public void setBlob(int i,
                    Blob x)
             throws SQLException

指定されたパラメータを、指定された Blob オブジェクトに設定します。

パラメータ:: i - 最初のパラメータは 1、2 番目のパラメータは 2、などとする; x - SQL BLOB 値をマッピングする Blob オブジェクト
例外:: SQLException - データベースアクセスエラーが発生した場合
導入されたバージョン:: 1.2
関連項目:: 「JDBC 2.0 API に含まれるもの」

setClob

public void setClob(int i,
                    Clob x)
             throws SQLException

指定されたパラメータを、指定された Clob オブジェクトに設定します。

パラメータ:: i - 最初のパラメータは 1、2 番目のパラメータは 2、などとする; x - SQL CLOB 値をマッピングする Clob オブジェクト
例外:: SQLException - データベースアクセスエラーが発生した場合
導入されたバージョン:: 1.2
関連項目:: 「JDBC 2.0 API に含まれるもの」

setArray

public void setArray(int i,
                     Array x)
              throws SQLException

指定されたパラメータを、指定された Array オブジェクトに設定します。Array パラメータを設定します。

パラメータ:: i - 最初のパラメータは 1、2 番目のパラメータは 2、などとする; x - SQL ARRAY 値をマッピングする Array オブジェクト
例外:: SQLException - データベースアクセスエラーが発生した場合
導入されたバージョン:: 1.2
関連項目:: 「JDBC 2.0 API に含まれるもの」

getMetaData

public ResultSetMetaData getMetaData()
                              throws SQLException

ResultSet オブジェクトの列の数、型、およびプロパティを取得します。

戻り値:: ResultSet オブジェクトのカラムの記述
例外:: SQLException - データベースアクセスエラーが発生した場合
導入されたバージョン:: 1.2
関連項目:: 「JDBC 2.0 API に含まれるもの」

setDate

public void setDate(int parameterIndex,
                    Date x,
                    Calendar cal)
             throws SQLException

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

パラメータ:: parameterIndex - 最初のパラメータは 1、2 番目のパラメータは 2、などとする; x - パラメータ値; cal - ドライバが日付を作成するために使用する Calendar オブジェクト
例外:: SQLException - データベースアクセスエラーが発生した場合
導入されたバージョン:: 1.2
関連項目:: 「JDBC 2.0 API に含まれるもの」

setTime

public void setTime(int parameterIndex,
                    Time x,
                    Calendar cal)
             throws SQLException

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

パラメータ:: parameterIndex - 最初のパラメータは 1、2 番目のパラメータは 2、などとする; x - パラメータ値; cal - ドライバが時間を作成するために使用する Calendar オブジェクト
例外:: SQLException - データベースアクセスエラーが発生した場合
導入されたバージョン:: 1.2
関連項目:: 「JDBC 2.0 API に含まれるもの」

setTimestamp

public void setTimestamp(int parameterIndex,
                         Timestamp x,
                         Calendar cal)
                  throws SQLException

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

パラメータ:: parameterIndex - 最初のパラメータは 1、2 番目のパラメータは 2、などとする; x - パラメータ値; cal - ドライバがタイムスタンプを作成するために使用する Calendar オブジェクト
例外:: SQLException - データベースアクセスエラーが発生した場合
導入されたバージョン:: 1.2
関連項目:: 「JDBC 2.0 API に含まれるもの」

setNull

public void setNull(int paramIndex,
                    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 - データベースアクセスエラーが発生した場合
導入されたバージョン:: 1.2
関連項目:: 「JDBC 2.0 API に含まれるもの」

概要

パッケージ

クラス

使用

階層ツリー

非推奨 API

索引

ヘルプ

Java^TM 2 Platform
Std. Ed. v1.3

前のクラス 次のクラス

フレームあり フレームなし

概要: 内部クラス | フィールド | コンストラクタ | メソッド

詳細: フィールド | コンストラクタ | メソッド

バグや機能要求の報告
さらに詳しい API リファレンスおよび開発者ドキュメントについては、 Java 2 SDK SE Developer Documentation を参照してください。このドキュメントには、概念、用語の定義、回避策、実用的なコード例など、開発者を対象にした詳細な解説が掲載されています。

メソッドの概要
`void`	`addBatch()` この `PreparedStatement` オブジェクトのコマンドのバッチに、パラメータのセットを追加します。
`void`	`clearParameters()` 現在のパラメータ値をすぐにクリアします。
`boolean`	`execute()` あらゆる種類の SQL 文を実行します。
`ResultSet`	`executeQuery()` この `PreparedStatement` オブジェクトの SQL クエリーを実行し、そのクエリーによって生成された結果セットを返します。
`int`	`executeUpdate()` この `PreparedStatement` オブジェクトの SQL INSERT 文、UPDATE 文、または DELETE 文を実行します。
`ResultSetMetaData`	`getMetaData()` `ResultSet` オブジェクトの列の数、型、およびプロパティを取得します。
`void`	`setArray(int i, Array x)` 指定されたパラメータを、指定された `Array` オブジェクトに設定します。
`void`	`setAsciiStream(int parameterIndex, InputStream x, int length)` 指定されたパラメータを、指定されたバイト数を持つ指定された入力ストリームに設定します。
`void`	`setBigDecimal(int parameterIndex, BigDecimal x)` 指定されたパラメータを `java.math.BigDecimal` 値に設定します。
`void`	`setBinaryStream(int parameterIndex, InputStream x, int length)` 指定されたパラメータを、指定されたバイト数を持つ指定された入力ストリームに設定します。
`void`	`setBlob(int i, Blob x)` 指定されたパラメータを、指定された `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, int length)` 指定されたパラメータを、指定された文字数である指定された `Reader` オブジェクトに設定します。
`void`	`setClob(int i, Clob x)` 指定されたパラメータを、指定された `Clob` オブジェクトに設定します。
`void`	`setDate(int parameterIndex, Date x)` 指定されたパラメータを Java の `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`	`setNull(int parameterIndex, int sqlType)` 指定されたパラメータを SQL `NULL` に設定します。
`void`	`setNull(int paramIndex, 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 scale)` 指定されたパラメータの値を、指定されたオブジェクトを使用して設定します。
`void`	`setRef(int i, Ref x)` 指定されたパラメータを、指定された `REF(<構造化型>)` 値に設定します。
`void`	`setShort(int parameterIndex, short x)` 指定されたパラメータを Java の `short` 値に設定します。
`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)` 推奨されていません。

java.sql インタフェース PreparedStatement

executeQuery

executeUpdate

setNull

setBoolean

setByte

setShort

setInt

setLong

setFloat

setDouble

setBigDecimal

setString

setBytes

setDate

setTime

setTimestamp

setAsciiStream

setUnicodeStream

setBinaryStream

clearParameters

setObject

setObject

setObject

execute

addBatch

setCharacterStream

setRef

setBlob

setClob

setArray

getMetaData

setDate

setTime

setTimestamp

setNull

java.sql
インタフェース PreparedStatement