|
Java プラットフォーム 1.2 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 内部クラス | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
SQL 文を実行し、作成された結果を得るために使用されるオブジェクトです。
Statement ごとに 1 つの ResultSet だけがいつでもオープンできます。したがって、ひとつの ResultSet の読み込みが、別の読み込みにより割り込まれると、各々は異なった Statement によって生成されたことになります。すべての文の execute
メソッドは、文の現在の ResultSet でオープンされているものが存在すれば、それをクローズします。
Connection.createStatement()
,
ResultSet
メソッドの概要 | |
void |
addBatch(String sql)
JDBC 2.0 Statement の現在のコマンドのバッチに SQL コマンドを追加します。 |
void |
cancel()
DBMS およびドライバの両方が SQL 文の終了をサポートする場合に、この Statement オブジェクトを取り消します。 |
void |
clearBatch()
JDBC 2.0 現在のバッチのコマンドのセットを空にします。 |
void |
clearWarnings()
この Statement オブジェクトに関して報告されたすべての警告をクリアします。 |
void |
close()
自動的にクローズされるときに Statement オブジェクトのデータベースと JDBC リソースが解放されるのを待つのではなく、ただちにそれらを解放します。 |
boolean |
execute(String sql)
複数の結果を返す可能性のある SQL 文を実行します。 |
int[] |
executeBatch()
JDBC 2.0 コマンドのバッチをデータベースに送信して実行します。 |
ResultSet |
executeQuery(String sql)
単一の結果を返す SQL 文を実行します。 |
int |
executeUpdate(String sql)
SQL INSERT 文、UPDATE 文、または DELETE 文を実行します。 |
Connection |
getConnection()
JDBC 2.0 この Statement オブジェクトを生成した Connection オブジェクトを返します。 |
int |
getFetchDirection()
JDBC 2.0 この Statement オブジェクトから生成された結果セットのデフォルトである、データベーステーブルから行をフェッチする方向を取得します。 |
int |
getFetchSize()
JDBC 2.0 この Statement オブジェクトから生成された結果セットのデフォルトのフェッチサイズである、結果セットの行数を取得します。 |
int |
getMaxFieldSize()
任意のカラム値で許可される最大のバイト数を返します。 |
int |
getMaxRows()
ResultSet が含むことのできる最大の行数を取得します。 |
boolean |
getMoreResults()
Statement の次の結果に移動します。 |
int |
getQueryTimeout()
ドライバが Statement の実行を待つ秒数を取得します。 |
ResultSet |
getResultSet()
ResultSet オブジェクトとして現在の結果を返します。 |
int |
getResultSetConcurrency()
JDBC 2.0 結果セットの並行性を取得します。 |
int |
getResultSetType()
JDBC 2.0 結果セットのタイプを判定します。 |
int |
getUpdateCount()
更新カウントとして現在の結果を返します。 |
SQLWarning |
getWarnings()
この Statement に関する呼び出しによって報告される最初の警告を取得します。 |
void |
setCursorName(String name)
後続の Statement execute メソッドによって使用される SQL カーソル名を定義します。 |
void |
setEscapeProcessing(boolean enable)
エスケープの処理をオンまたはオフに設定します。 |
void |
setFetchDirection(int direction)
JDBC 2.0 結果セットの行が処理される方向についてのヒントをドライバに提供します。 |
void |
setFetchSize(int rows)
JDBC 2.0 より多くの行が必要なときに、データベースから取り出す必要がある行数についてのヒントを JDBC ドライバに提供します。 |
void |
setMaxFieldSize(int max)
カラムの最大のバイト数の制限値を、指定されたバイト数に設定します。 |
void |
setMaxRows(int max)
任意の ResultSet が含むことのできる最大の行数を、指定された数に設定します。 |
void |
setQueryTimeout(int seconds)
ドライバが Statement の実行を待つ秒数を、指定された秒数に設定します。 |
メソッドの詳細 |
public ResultSet executeQuery(String sql) throws SQLException
sql
- これは通常、SQL SELECT 文public int executeUpdate(String sql) throws SQLException
sql
- SQL INSERT 文、UPDATE 文、DELETE 文、または何も返さない SQL 文public void close() throws SQLException
Statement
オブジェクトのデータベースと JDBC リソースが解放されるのを待つのではなく、ただちにそれらを解放します。データベースのリソースを占有するのを避けるために、通常は、作業が終了したらすぐにリソースを解放するようにしてください。
注: Statement は、ガベージとして回収されるときは自動的にクローズされます。Statement がクローズされるとき、その現在の ResultSet が存在すれば、それもクローズされます。
public int getMaxFieldSize() throws SQLException
public void setMaxFieldSize(int max) throws SQLException
max
- 新しい最大カラムサイズの制限値。ゼロは無制限を意味するpublic int getMaxRows() throws SQLException
public void setMaxRows(int max) throws SQLException
max
- 新しい最大行数の制限値。ゼロは無制限を意味するpublic void setEscapeProcessing(boolean enable) throws SQLException
注: 用意された文は、通常呼び出す前に構文解析されているので、用意された文に対しエスケープ処理を無効にしても効果はありません。
enable
- 有効にする場合は true、無効にする場合は falsepublic int getQueryTimeout() throws SQLException
public void setQueryTimeout(int seconds) throws SQLException
seconds
- 新しいクエリータイムアウトの制限値の秒数。ゼロは無制限を意味するpublic void cancel() throws SQLException
Statement
オブジェクトを取り消します。このメソッドは、1 つのスレッドが別のスレッドによって実行中の文を取り消すのに使用できます。public SQLWarning getWarnings() throws SQLException
警告チェーンは、文が (再) 実行されるたびに自動的にクリアされます。
注: ResultSet を処理中の場合、ResultSet の読み込みに関連付けられた警告はすべて ResultSet オブジェクトにチェーンされます。
public void clearWarnings() throws SQLException
Statement
オブジェクトに関して報告されたすべての警告をクリアします。このメソッドの呼び出しのあと、この Statement に対する新しい警告が通知されるまで、getWarnings
メソッドは null を返します。public void setCursorName(String name) throws SQLException
execute
メソッドによって使用される SQL カーソル名を定義します。この名前は、SQL で位置決めされた更新/削除文で使用され、この文で作成された ResultSet 中の現在の行を識別できます。データベースが位置決めされた更新/削除をサポートしていない場合、このメソッドは何も実行しません。カーソルが更新をサポートする適切な遮断レベルを持つことが保証されるためには、カーソルの SELECT 文は「select for update ...」という形式である必要があります。「for update」の句が省略されている場合、位置決めされた更新は失敗します。
注: 定義により、位置決めされた更新/削除の実行は、位置決めに使用中の ResultSet を生成した Statement とは異なる Statement によって実行されなければなりません。さらに、カーソル名は接続の中で一意でなければなりません。
name
- 新しいカーソル名。接続の中で一意でなければならないpublic boolean execute(String sql) throws SQLException
execute
、getMoreResults
、getResultSet
、および getUpdateCount
メソッドによって複数の結果をナビゲートできます。
execute
メソッドは、SQL 文を実行し最初の結果のフォームを示します。次いで、getResultSet または getUpdateCount を使用して結果を取得します。そして、getMoreResults により引き続き任意の結果の取得に移動します。
sql
- 任意の SQL 文getResultSet()
,
getUpdateCount()
,
getMoreResults()
public ResultSet getResultSet() throws SQLException
ResultSet
オブジェクトとして現在の結果を返します。このメソッドは、1 つの結果につき 1 回だけ呼び出さなければなりません。execute(java.lang.String)
public int getUpdateCount() throws SQLException
execute(java.lang.String)
public boolean getMoreResults() throws SQLException
(!getMoreResults() && (getUpdateCount() == -1) の場合は、結果はそれ以上ありません。
execute(java.lang.String)
public void setFetchDirection(int direction) throws SQLException
結果セットの行が処理される方向についてのヒントをドライバに提供します。ヒントは、この Statement オブジェクトを使用して作成された結果セットにだけ適用されます。既定値は ResultSet.FETCH_FORWARD です。
このメソッドは、この Statement
オブジェクトによって作成される結果セットのデフォルトのフェッチ方向を設定します。各結果セットは、それ自身のフェッチ方向を取得および設定するための独自のメソッドを持ちます。
direction
- 行を処理する初期方向public int getFetchDirection() throws SQLException
この Statement
オブジェクトから生成された結果セットのデフォルトである、データベーステーブルから行をフェッチする方向を取得します。この Statement
オブジェクトが setFetchDirection
メソッドを呼び出してフェッチ方向を設定していない場合、戻り値は実装に依存します。
Statement
オブジェクトから生成された結果セットのデフォルトのフェッチ方向public void setFetchSize(int rows) throws SQLException
より多くの行が必要なときに、データベースから取り出す必要がある行数についてのヒントを JDBC ドライバに提供します。指定された行数は、この Statement を使って作成された結果セットにだけ影響します。指定された値が 0 の場合、ヒントは無視されます。既定値は 0 です。
rows
- 取り出す行数public int getFetchSize() throws SQLException
この Statement
オブジェクトから生成された結果セットのデフォルトのフェッチサイズである、結果セットの行数を取得します。この Statement
オブジェクトが setFetchSize
メソッドを呼び出してフェッチサイズを設定していない場合、戻り値は実装に依存します。
Statement
オブジェクトから生成された結果セットのデフォルトのフェッチサイズpublic int getResultSetConcurrency() throws SQLException
結果セットの並行性を取得します。
public int getResultSetType() throws SQLException
結果セットのタイプを判定します。
public void addBatch(String sql) throws SQLException
Statement の現在のコマンドのバッチに SQL コマンドを追加します。このメソッドはオプションです。
sql
- 通常は、静的 SQL INSERT または UPDATE 文public void clearBatch() throws SQLException
現在のバッチのコマンドのセットを空にします。このメソッドはオプションです。
public int[] executeBatch() throws SQLException
コマンドのバッチをデータベースに送信して実行します。このメソッドはオプションです。
public Connection getConnection() throws SQLException
この Statement
オブジェクトを生成した Connection
オブジェクトを返します。
|
Java プラットフォーム 1.2 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 内部クラス | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |