|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
public interface PreparedStatement
プリコンパイルされた SQL 文を表すオブジェクトです。
SQL 文は、プリコンパイルされ、PreparedStatement
オブジェクトに格納されます。そこで、このオブジェクトは、この文を複数回効率的に実行する目的で使用できます。
注: IN パラメータ値を設定する設定機能メソッド (setShort
、setString
など) は、入力パラメータの定義された SQL 型と互換のある型を指定しなければなりません。たとえば、IN パラメータに INTEGER
という SQL 型がある場合、setInt
メソッドを使用しなければなりません。
任意のパラメータ型変換が必要な場合は、setObject
メソッドは、目的の SQL 型で使用しなければなりません。
パラメータ設定の例を次に示します。con
はアクティブな接続を表します。
PreparedStatement pstmt = con.prepareStatement("UPDATE EMPLOYEES SET SALARY = ? WHERE ID = ?"); pstmt.setBigDecimal(1, 153833.00) pstmt.setInt(2, 110592)
Connection.prepareStatement(java.lang.String)
,
ResultSet
フィールドの概要 |
---|
インタフェース java.sql.Statement から継承されたフィールド |
---|
CLOSE_ALL_RESULTS, CLOSE_CURRENT_RESULT, EXECUTE_FAILED, KEEP_CURRENT_RESULT, NO_GENERATED_KEYS, RETURN_GENERATED_KEYS, SUCCESS_NO_INFO |
メソッドの概要 | |
---|---|
void |
addBatch()
この PreparedStatement オブジェクトのコマンドのバッチに、パラメータのセットを追加します。 |
void |
clearParameters()
現在のパラメータ値をすぐにクリアします。 |
boolean |
execute()
この PreparedStatement オブジェクトの、あらゆる種類の SQL 文を実行します。 |
ResultSet |
executeQuery()
この PreparedStatement オブジェクトの SQL クエリーを実行し、そのクエリーによって生成された ResultSet オブジェクトを返します。 |
int |
executeUpdate()
この PreparedStatement オブジェクトの SQL INSERT 文、UPDATE 文、または DELETE 文を実行します。 |
ResultSetMetaData |
getMetaData()
この PreparedStatement が実行されるときに返される ResultSet オブジェクトの列に関する情報を格納する ResultSetMetaData オブジェクトを取得します。 |
ParameterMetaData |
getParameterMetaData()
この PreparedStatement オブジェクトのパラメータの数、型、およびプロパティを取得します。 |
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.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(<structured-type>) 値に設定します。 |
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)
推奨されていません。 |
void |
setURL(int parameterIndex,
URL x)
指定されたパラメータを指定された java.net.URL 値に設定します。 |
メソッドの詳細 |
---|
ResultSet executeQuery() throws SQLException
PreparedStatement
オブジェクトの SQL クエリーを実行し、そのクエリーによって生成された ResultSet
オブジェクトを返します。
ResultSet
オブジェクト。null
にはならない
SQLException
- データベースアクセスエラーが発生した場合、または SQL 文が ResultSet
オブジェクトを返さない場合int executeUpdate() throws SQLException
PreparedStatement
オブジェクトの SQL INSERT
文、UPDATE
文、または DELETE
文を実行します。さらに、DDL 文のような何も返さない SQL 文を実行することもできます。
INSERT
文、UPDATE
文、DELETE
文の場合は行数。何も返さない SQL 文の場合は 0
SQLException
- データベースアクセスエラーが発生した場合、または SQL 文が ResultSet
オブジェクトを返す場合void setNull(int parameterIndex, int sqlType) throws SQLException
NULL
に設定します。
注: パラメータの SQL の型を指定する必要があります。
parameterIndex
- 最初のパラメータは 1、2 番目のパラメータは 2、... となるsqlType
- java.sql.Types
で定義される SQL 型コード
SQLException
- データベースアクセスエラーが発生した場合void setBoolean(int parameterIndex, boolean x) throws SQLException
boolean
値に設定します。データベースに送るときに、ドライバはこれを SQL BIT
値に変換します。
parameterIndex
- 最初のパラメータは 1、2 番目のパラメータは 2、... となるx
- パラメータ値
SQLException
- データベースアクセスエラーが発生した場合void setByte(int parameterIndex, byte x) throws SQLException
byte
値に設定します。データベースに送るときに、ドライバはこれを SQL TINYINT
値に変換します。
parameterIndex
- 最初のパラメータは 1、2 番目のパラメータは 2、... となるx
- パラメータ値
SQLException
- データベースアクセスエラーが発生した場合void setShort(int parameterIndex, short x) throws SQLException
short
値に設定します。データベースに送るときに、ドライバはこれを SQL SMALLINT
値に変換します。
parameterIndex
- 最初のパラメータは 1、2 番目のパラメータは 2、... となるx
- パラメータ値
SQLException
- データベースアクセスエラーが発生した場合void setInt(int parameterIndex, int x) throws SQLException
int
値に設定します。データベースに送るときに、ドライバはこれを SQL INTEGER
値に変換します。
parameterIndex
- 最初のパラメータは 1、2 番目のパラメータは 2、... となるx
- パラメータ値
SQLException
- データベースアクセスエラーが発生した場合void setLong(int parameterIndex, long x) throws SQLException
long
値に設定します。データベースに送るときに、ドライバはこれを SQL BIGINT
値に変換します。
parameterIndex
- 最初のパラメータは 1、2 番目のパラメータは 2、... となるx
- パラメータ値
SQLException
- データベースアクセスエラーが発生した場合void setFloat(int parameterIndex, float x) throws SQLException
float
値に設定します。データベースに送るときに、ドライバはこれを SQL FLOAT
値に変換します。
parameterIndex
- 最初のパラメータは 1、2 番目のパラメータは 2、... となるx
- パラメータ値
SQLException
- データベースアクセスエラーが発生した場合void setDouble(int parameterIndex, double x) throws SQLException
double
値に設定します。データベースに送るときに、ドライバはこれを SQL DOUBLE
値に変換します。
parameterIndex
- 最初のパラメータは 1、2 番目のパラメータは 2、... となるx
- パラメータ値
SQLException
- データベースアクセスエラーが発生した場合void setBigDecimal(int parameterIndex, BigDecimal x) throws SQLException
java.math.BigDecimal
値に設定します。データベースに送るときに、ドライバはこれを SQL NUMERIC
値に変換します。
parameterIndex
- 最初のパラメータは 1、2 番目のパラメータは 2、... となるx
- パラメータ値
SQLException
- データベースアクセスエラーが発生した場合void setString(int parameterIndex, String x) throws SQLException
String
値に設定します。データベースに送るときに、ドライバはこれを SQL VARCHAR
または LONGVARCHAR
値 (ドライバの VARCHAR
値に関する制限に関する引数のサイズに依存) に変換します。
parameterIndex
- 最初のパラメータは 1、2 番目のパラメータは 2、... となるx
- パラメータ値
SQLException
- データベースアクセスエラーが発生した場合void setBytes(int parameterIndex, byte[] x) throws SQLException
VARBINARY
または LONGVARBINARY
(ドライバの VARBINARY
値に関する制限に関する引数のサイズに依存) に変換します。
parameterIndex
- 最初のパラメータは 1、2 番目のパラメータは 2、... となるx
- パラメータ値
SQLException
- データベースアクセスエラーが発生した場合void setDate(int parameterIndex, Date x) throws SQLException
java.sql.Date
値に設定します。データベースに送るときに、ドライバはこれを SQL DATE
値に変換します。
parameterIndex
- 最初のパラメータは 1、2 番目のパラメータは 2、... となるx
- パラメータ値
SQLException
- データベースアクセスエラーが発生した場合void setTime(int parameterIndex, Time x) throws SQLException
java.sql.Time
値に設定します。データベースに送るときに、ドライバはこれを SQL TIME
値に変換します。
parameterIndex
- 最初のパラメータは 1、2 番目のパラメータは 2、... となるx
- パラメータ値
SQLException
- データベースアクセスエラーが発生した場合void setTimestamp(int parameterIndex, Timestamp x) throws SQLException
java.sql.Timestamp
値に設定します。データベースに送るときに、ドライバはこれを SQL TIMESTAMP
値に変換します。
parameterIndex
- 最初のパラメータは 1、2 番目のパラメータは 2、... となるx
- パラメータ値
SQLException
- データベースアクセスエラーが発生した場合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
- データベースアクセスエラーが発生した場合@Deprecated void setUnicodeStream(int parameterIndex, InputStream x, int length) throws SQLException
LONGVARCHAR
パラメータに非常に大きな Unicode 値が入力されるときには、java.io.InputStream
を介して送るのが現実的です。ファイルの終わりに達するまで必要に応じてストリームからデータが読み込まれます。JDBC ドライバは、データを Unicode からデータベースの char 形式に変換します。
注: このストリームオブジェクトは、標準の Java ストリームオブジェクト、または標準インタフェースを実装する独自のサブクラスのどちらでもかまいません。
parameterIndex
- 最初のパラメータは 1、2 番目のパラメータは 2、... となるx
- Unicode パラメータを 2 バイトの Unicode 文字として格納する java.io.InputStream
オブジェクトlength
- ストリームのバイト数
SQLException
- データベースアクセスエラーが発生した場合void setBinaryStream(int parameterIndex, InputStream x, int length) throws SQLException
LONGVARBINARY
パラメータに、非常に大きなバイナリ値が入力されるときには、java.io.InputStream
オブジェクトを介して送るのが現実的です。ファイルの終わりに達するまで必要に応じてストリームからデータが読み込まれます。
注: このストリームオブジェクトは、標準の Java ストリームオブジェクト、または標準インタフェースを実装する独自のサブクラスのどちらでもかまいません。
parameterIndex
- 最初のパラメータは 1、2 番目のパラメータは 2、... となるx
- バイナリパラメータ値を含む Java 入力ストリームlength
- ストリームのバイト数
SQLException
- データベースアクセスエラーが発生した場合void clearParameters() throws SQLException
通常、文を繰り返し使用するために、パラメータ値は強制的に残されます。パラメータ値を設定すると、前の値は自動的にクリアされます。しかし、現在のパラメータ値によって使用されたリソースをただちに解放したほうが役に立つ場合があります。これは、メソッド clearParameters
を呼び出して実行することができます。
SQLException
- データベースアクセスエラーが発生した場合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
void setObject(int parameterIndex, Object x, int targetSqlType) throws SQLException
setObject
に似ていますが、スケールに 0 を仮定している点が異なります。
parameterIndex
- 最初のパラメータは 1、2 番目のパラメータは 2、... となるx
- 入力パラメータ値を含むオブジェクトtargetSqlType
- データベースに送られる (java.sql.Types で定義される) SQL 型
SQLException
- データベースアクセスエラーが発生した場合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
- データベースアクセスエラーが発生した場合、または指定されたオブジェクトの型があいまいである場合boolean execute() throws SQLException
PreparedStatement
オブジェクトの、あらゆる種類の SQL 文を実行します。PreparedStatement オブジェクトで用意された文には複数の結果を返すものがあります。execute
メソッドは、executeQuery
メソッドと executeUpdate
メソッドによって処理される、より簡単な形式の文と同様に、複雑な文も処理します。
execute
メソッドは、boolean
を返し最初の結果の形式を示します。getResultSet
または getUpdateCount
メソッドを呼び出して結果を取得します。そして、getMoreResults
を呼び出して引き続き任意の結果の取得 (複数可) に移動します。
ResultSet
オブジェクトの場合は true
。更新カウントであるか、または結果がない場合は false
SQLException
- データベースアクセスエラーが発生した場合、またはこのメソッドに引数が指定された場合Statement.execute(java.lang.String)
,
Statement.getResultSet()
,
Statement.getUpdateCount()
,
Statement.getMoreResults()
void addBatch() throws SQLException
PreparedStatement
オブジェクトのコマンドのバッチに、パラメータのセットを追加します。
SQLException
- データベースアクセスエラーが発生した場合Statement.addBatch(java.lang.String)
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
- データベースアクセスエラーが発生した場合void setRef(int i, Ref x) throws SQLException
REF(<structured-type>)
値に設定します。データベースに送るときに、ドライバはこれを SQL REF
値に変換します。
i
- 最初のパラメータは 1、2 番目のパラメータは 2、... となるx
- SQL REF
値
SQLException
- データベースアクセスエラーが発生した場合void setBlob(int i, Blob x) throws SQLException
Blob
オブジェクトに設定します。データベースに送るときに、ドライバはこれを SQL BLOB
値に変換します。
i
- 最初のパラメータは 1、2 番目のパラメータは 2、... となるx
- SQL BLOB
値をマッピングする Blob
オブジェクト
SQLException
- データベースアクセスエラーが発生した場合void setClob(int i, Clob x) throws SQLException
Clob
オブジェクトに設定します。データベースに送るときに、ドライバはこれを SQL CLOB
値に変換します。
i
- 最初のパラメータは 1、2 番目のパラメータは 2、... となるx
- SQL CLOB
値をマッピングする Clob
オブジェクト
SQLException
- データベースアクセスエラーが発生した場合void setArray(int i, Array x) throws SQLException
Array
オブジェクトに設定します。データベースに送るときに、ドライバはこれを SQL ARRAY
値に変換します。
i
- 最初のパラメータは 1、2 番目のパラメータは 2、... となるx
- SQL ARRAY
値をマッピングする Array
オブジェクト
SQLException
- データベースアクセスエラーが発生した場合ResultSetMetaData getMetaData() throws SQLException
PreparedStatement
が実行されるときに返される ResultSet
オブジェクトの列に関する情報を格納する ResultSetMetaData
オブジェクトを取得します。
PreparedStatement
オブジェクトはプリコンパイルされるので、実行されずに返される ResultSet
について知ることが可能です。したがって、PreparedStatement
について getMetaData
の実行を待ち、それから返された ResultSet
について ResultSet.getMetaData
を呼び出すのではなく、getMetaData
を呼び出すことができます。
注: このメソッドの使用は、ドライバによっては基本となる DBMS サポートが不足しているため負荷が大きくなる場合があります。
ResultSet
オブジェクトの列の記述、またはドライバが ResultSetMetaData
オブジェクトを返すことができない場合は null
SQLException
- データベースアクセスエラーが発生した場合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
- データベースアクセスエラーが発生した場合void setTime(int parameterIndex, Time x, Calendar cal) throws SQLException
Calendar
オブジェクトを使用して、指定されたパラメータを指定された java.sql.Time
値に設定します。ドライバは Calendar
オブジェクトを使用して SQL java.sql.Time
値を作成し、続いてそれをデータベースに送ります。Calendar
オブジェクトを使用すると、ドライバはカスタムタイムゾーンを考慮して時刻を計算できます。Calendar
オブジェクトを指定しない場合、ドライバは、アプリケーションで実行される仮想マシンのタイムゾーンであるデフォルトのタイムゾーンを使用します。
parameterIndex
- 最初のパラメータは 1、2 番目のパラメータは 2、... となるx
- パラメータ値cal
- ドライバが時刻を作成するために使用する Calendar
オブジェクト
SQLException
- データベースアクセスエラーが発生した場合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
- データベースアクセスエラーが発生した場合void setNull(int paramIndex, int sqlType, String typeName) throws SQLException
NULL
に設定します。ユーザ定義型および REF 型のパラメータでは、このバージョンのメソッド setNull
を使用しなければなりません。ユーザ定義型の例には、STRUCT、DISTINCT、JAVA_OBJECT、および名前付き配列があります。
注: 移植性を実現するためには、アプリケーションは NULL のユーザ定義パラメータまたは REF パラメータを指定するときに SQL 型コードおよび完全指定の SQL 型名を指定しなければなりません。ユーザ定義型の場合、名前はパラメータ自体の型名です。REF パラメータの場合、名前は参照される型の型名です。JDBC ドライバが型コードまたは型名の情報を必要としない場合、それは無視されます。 ユーザ定義パラメータおよび REF パラメータを対象としていますが、このメソッドは任意の JDBC 型の null パラメータを設定するために使用できます。パラメータがユーザ定義の型または REF 型を持たない場合、指定された typeName は無視されます。
paramIndex
- 最初のパラメータは 1、2 番目のパラメータは 2、... となるsqlType
- java.sql.Types
からの値typeName
- SQL ユーザ定義型の完全指定の名前。パラメータがユーザ定義型でも REF でもない場合は無視される
SQLException
- データベースアクセスエラーが発生した場合void setURL(int parameterIndex, URL x) throws SQLException
java.net.URL
値に設定します。データベースに送るときに、ドライバはこれを SQL DATALINK
値に変換します。
parameterIndex
- 最初のパラメータは 1、2 番目のパラメータは 2、... となるx
- 設定される java.net.URL
オブジェクト
SQLException
- データベースアクセスエラーが発生した場合ParameterMetaData getParameterMetaData() throws SQLException
PreparedStatement
オブジェクトのパラメータの数、型、およびプロパティを取得します。
PreparedStatement
オブジェクトのパラメータの数、型、およびプロパティについての情報を格納する ParameterMetaData
オブジェクト
SQLException
- データベースアクセスエラーが発生した場合ParameterMetaData
|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。