|
JavaTM 2 Platform Std. Ed. v1.4.0 |
||||||||||
前のクラス 次のクラス | フレームあり フレームなし | ||||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
特定のデータベースとの接続 (セッション) を表現します。接続のコンテキスト内で SQL 文が実行され結果が返されます。
Connection
オブジェクト中のデータベースは、テーブル、サポートしている SQL 文法、ストアドプロシージャ、およびこの接続の能力などについての情報を提供します。この情報は、getMetaData
メソッドで取得できます。
注: 各文を実行後、デフォルトでは、Connection
オブジェクトは自動コミットモードになり、自動的に変更をコミットします。自動コミットモードが無効にされている場合、変更をコミットするにはメソッド commit
を明示的に呼び出す必要があります。そうしないとデータベースの変更は保存されません。
JDBC 2.1 コア API を使用して生成された新しい Connection
オブジェクトには、このオブジェクトに関連する、初期状態が空の型マップがあります。ユーザはこの型マップの UDT にカスタムマッピングを入力できます。メソッド ResultSet.getObject
によってデータソースから UDT が取得されると、getObject
メソッドは接続の型マップをチェックして、その UDT にエントリがあるかどうかを調べます。エントリがある場合、getObject
メソッドは指示されたクラスに UDT をマッピングします。エントリがない場合、UDT は標準マッピングを使用してマッピングされます。
ユーザは java.util.Map
オブジェクトとなる新しい型マップを作成し、それにエントリを作成し、カスタムマッピングを実行できる java.sql
メソッドにそのエントリを渡すことができます。この場合、メソッドは、接続に関連した型マップではなく指定された型マップを使用します。
たとえば、次のコードフラグメントは、SQL 型 ATHLETES
が Java プログラミング言語のクラス Athletes
にマッピングされることを指定します。コードフラグメントは Connection
オブジェクト con
の型マップを取得し、それにエントリを挿入し、その新しいエントリでその型マップを接続の型マップとして設定します。
java.util.Map map = con.getTypeMap(); map.put("mySchemaName.ATHLETES", Class.forName("Athletes")); con.setTypeMap(map);
DriverManager.getConnection(java.lang.String, java.util.Properties)
,
Statement
,
ResultSet
,
DatabaseMetaData
フィールドの概要 | |
static int |
TRANSACTION_NONE
トランザクションがサポートされていないことを示す定数です。 |
static int |
TRANSACTION_READ_COMMITTED
ダーティー読み込みは抑制され、繰り返し不可の読み込みおよびファントム読み込みが起こることを示す定数です。 |
static int |
TRANSACTION_READ_UNCOMMITTED
ダーティー読み込み、繰り返し不可の読み込み、およびファントム読み込みが起こることを示す定数です。 |
static int |
TRANSACTION_REPEATABLE_READ
ダーティー読み込みおよび繰り返し不可の読み込みは抑制され、ファントム読み込みが起こることを示す定数です。 |
static int |
TRANSACTION_SERIALIZABLE
ダーティー読み込み、繰り返し不可の読み込み、およびファントム読み込みが抑制されることを示す定数です。 |
メソッドの概要 | |
void |
clearWarnings()
この Connection オブジェクトに関して通知されたすべての警告をクリアします。 |
void |
close()
自動的な解除を待たずに、ただちにこの Connection オブジェクトのデータベースと JDBC リソースを解除します。
|
void |
commit()
直前のコミット/ロールバック以降に行われた変更をすべて有効とし、この Connection オブジェクトが現在保持するデータベースロックをすべて解除します。 |
Statement |
createStatement()
SQL 文をデータベースに送るための Statement オブジェクトを生成します。 |
Statement |
createStatement(int resultSetType,
int resultSetConcurrency)
指定された型と並行処理で ResultSet オブジェクトを生成する Statement オブジェクトを生成します。 |
Statement |
createStatement(int resultSetType,
int resultSetConcurrency,
int resultSetHoldability)
指定された型、並行処理、および holdability で ResultSet オブジェクトを生成する Statement オブジェクトを生成します。 |
boolean |
getAutoCommit()
この Connection オブジェクトの現在の自動コミットモードを取得します。 |
String |
getCatalog()
この Connection オブジェクトの現在のカタログ名を取得します。 |
int |
getHoldability()
この Connection オブジェクトを使用して生成された ResultSet オブジェクトの現在の保持機能を取得します。 |
DatabaseMetaData |
getMetaData()
この Connection オブジェクトが接続を表すデータベースに関するメタデータを格納する DatabaseMetaData オブジェクトを取得します。 |
int |
getTransactionIsolation()
この Connection オブジェクトの現在のトランザクション遮断レベルを取得します。 |
Map |
getTypeMap()
この Connection に関連した Map オブジェクトを取得します。 |
SQLWarning |
getWarnings()
この Connection オブジェクトに関する呼び出しによって報告される最初の警告を取得します。 |
boolean |
isClosed()
この Connection オブジェクトがクローズされているかどうかを取得します。 |
boolean |
isReadOnly()
この Connection オブジェクトが読み込み専用モードかどうかを取得します。 |
String |
nativeSQL(String sql)
指定された SQL 文をシステムの本来の SQL 文法に変換します。 |
CallableStatement |
prepareCall(String sql)
データベースのストアドプロシージャを呼び出すための CallableStatement オブジェクトを生成します。 |
CallableStatement |
prepareCall(String sql,
int resultSetType,
int resultSetConcurrency)
指定された型と並行処理で ResultSet オブジェクトを生成する CallableStatement オブジェクトを生成します。 |
CallableStatement |
prepareCall(String sql,
int resultSetType,
int resultSetConcurrency,
int resultSetHoldability)
指定された型と並行処理で ResultSet オブジェクトを生成する CallableStatement オブジェクトを生成します。 |
PreparedStatement |
prepareStatement(String sql)
パラメータ付き SQL 文をデータベースに送るための PreparedStatement オブジェクトを作成します。
|
PreparedStatement |
prepareStatement(String sql,
int autoGeneratedKeys)
自動生成キーを取得する機能を持つデフォルトの PreparedStatement オブジェクトを生成します。 |
PreparedStatement |
prepareStatement(String sql,
int[] columnIndexes)
指定された配列によって指定された自動生成キーを返す機能を持つデフォルトの PreparedStatement オブジェクトを生成します。 |
PreparedStatement |
prepareStatement(String sql,
int resultSetType,
int resultSetConcurrency)
指定された型と並行処理で ResultSet オブジェクトを生成する PreparedStatement オブジェクトを生成します。 |
PreparedStatement |
prepareStatement(String sql,
int resultSetType,
int resultSetConcurrency,
int resultSetHoldability)
指定された型、並行処理、および保持機能で ResultSet オブジェクトを生成する PreparedStatement オブジェクトを生成します。
|
PreparedStatement |
prepareStatement(String sql,
String[] columnNames)
指定された配列によって指定された自動生成キーを返す機能を持つデフォルトの PreparedStatement オブジェクトを生成します。 |
void |
releaseSavepoint(Savepoint savepoint)
現在のトランザクションから指定された Savepoint オブジェクトを削除します。 |
void |
rollback()
現在のトランザクションで行われた変更をすべて元に戻し、この Connection オブジェクトが現在保持するデータベースロックをすべて解除します。 |
void |
rollback(Savepoint savepoint)
指定された Savepoint オブジェクトが設定されたあとに行われたすべての変更を元に戻します。
|
void |
setAutoCommit(boolean autoCommit)
この接続の自動コミットモードを指定された状態に設定します。 |
void |
setCatalog(String catalog)
この Connection オブジェクトのデータベースに作業のためのサブスペースを選択するために、カタログ名を設定します。
|
void |
setHoldability(int holdability)
この Connection オブジェクトを使用して生成された ResultSet オブジェクトの保持機能を指定された保持機能へ変更します。 |
void |
setReadOnly(boolean readOnly)
この Connection を読み込み専用モードに設定して、データベース最適化を実行するドライバのヒントとします。 |
Savepoint |
setSavepoint()
現在のトランザクションで名前のないセーブポイントを作成し、それを表す新しい Savepoint オブジェクトを返します。 |
Savepoint |
setSavepoint(String name)
現在のトランザクションで指定された名前のセーブポイントを作成し、それを表す新しい Savepoint オブジェクトを返します。 |
void |
setTransactionIsolation(int level)
この Connection のトランザクション遮断レベルを指定されたものに変更することを試みます。 |
void |
setTypeMap(Map map)
この Connection オブジェクトの型マップとして指定された TypeMap オブジェクトをインストールします。 |
フィールドの詳細 |
public static final int TRANSACTION_NONE
public static final int TRANSACTION_READ_UNCOMMITTED
public static final int TRANSACTION_READ_COMMITTED
public static final int TRANSACTION_REPEATABLE_READ
public static final int TRANSACTION_SERIALIZABLE
TRANSACTION_REPEATABLE_READ
での禁止に加え、1 つのトランザクションが WHERE
条件を満たすすべての行を読み出し、2 番目のトランザクションが WHERE
条件を満たす行を挿入したあとに、最初のトランザクションが同一の条件で読み込みし直した場合に、2 番目の読み込みでは追加された「ファントム」行を取り出すという状況が禁止されます。
メソッドの詳細 |
public Statement createStatement() throws SQLException
Statement
オブジェクトを生成します。パラメータなしの SQL 文は通常、Statement
オブジェクトを使用して実行されます。同じ SQL 文が多数回実行される場合は、PreparedStatement
オブジェクトを使用する方が効率的です。
返される Statement
オブジェクトを使って作成された結果セットは、デフォルトでは、TYPE_FORWARD_ONLY
の型で、CONCUR_READ_ONLY
の並行処理レベルを持ちます。
Statement
オブジェクト
SQLException
- データベースアクセスエラーが発生した場合public PreparedStatement prepareStatement(String sql) throws SQLException
PreparedStatement
オブジェクトを作成します。
IN パラメータ付きまたは IN パラメータなしの SQL 文は、プリコンパイルして、PreparedStatement
オブジェクトに格納できます。したがって、このオブジェクトは、この文を複数回、効率的に実行するのに使用できます。
注: このメソッドは、プリコンパイルが効果のある、パラメータ付き SQL 文を処理するために最適化されています。ドライバが、プリコンパイルをサポートしている場合、prepareStatement
メソッドは、その文をプリコンパイル用としてデータベースに送ります。ドライバによっては、プリコンパイルをサポートしていないものがあります。この場合、PreparedStatement
が実行されるまで、文はデータベースに送られません。これはユーザに直接的な影響はありませんが、どのメソッドが、どの SQLException
オブジェクトをスローしたかに関して影響があります。
返される PreparedStatement
オブジェクトを使って作成された結果セットは、デフォルトでは、TYPE_FORWARD_ONLY
の型で、CONCUR_READ_ONLY
の並行処理レベルを持ちます。
sql
- 1 つ以上の '?' IN パラメータプレースホルダーを含めることができる SQL 文
PreparedStatement
オブジェクト
SQLException
- データベースアクセスエラーが発生した場合public CallableStatement prepareCall(String sql) throws SQLException
CallableStatement
オブジェクトを生成します。CallableStatement
オブジェクトは、その IN と OUT パラメータを設定するメソッドとストアドプロシージャの呼び出しを実行するメソッドを提供します。
注: このメソッドは、ストアドプロシージャ呼び出し文を処理するために最適化されています。ドライバによっては、prepareCall
メソッドが実行されるときにデータベースに呼び出し文を送るものがあります。その他のドライバは、CallableStatement
オブジェクトが実行されるまで待ちます。これはユーザに直接的な影響はありませんが、どのメソッドが、どの SQLException をスローしたかに関して影響があります。
返される CallableStatement
オブジェクトを使って作成された結果セットは、デフォルトでは、TYPE_FORWARD_ONLY
の型で、CONCUR_READ_ONLY
の並行処理レベルを持ちます。
sql
- 1 つ以上の '?' パラメータプレースホルダーを含めることができる SQL 文。通常この文は、JBDC 関数呼び出しのエスケープ文字列である
CallableStatement
オブジェクト
SQLException
- データベースアクセスエラーが発生した場合public String nativeSQL(String sql) throws SQLException
sql
- 1 つ以上の '?' パラメータプレースホルダーを含めることができる SQL 文
SQLException
- データベースアクセスエラーが発生した場合public void setAutoCommit(boolean autoCommit) throws SQLException
commit
メソッドまたは rollback
メソッドへの呼び出しによって終了されるトランザクションにグループ化されます。デフォルトでは、新しい接続は自動コミットモードです。
コミットは、文の完了または次の実行の発生のどちらが先に起こっても発生します。文が、ResultSet
オブジェクトを返す場合には、ResultSet
オブジェクトの最後の行が取り出されるかクローズされたときに文は完了します。進んだ用法では、単一の文が出力パラメータと同様に、複数の結果を返すこともあります。この場合は、すべての結果と出力パラメータ値が取り出された時にコミットが発生します。
注: トランザクションの途中でこのメソッドが呼び出されると、そのトランザクションはコミットされます。
autoCommit
- 自動コミットモードを有効にする場合は true
、無効にする場合は false
SQLException
- データベースアクセスエラーが発生した場合getAutoCommit()
public boolean getAutoCommit() throws SQLException
Connection
オブジェクトの現在の自動コミットモードを取得します。
Connection
オブジェクトの現在の自動コミットモードの状態
SQLException
- データベースアクセスエラーが発生した場合setAutoCommit(boolean)
public void commit() throws SQLException
Connection
オブジェクトが現在保持するデータベースロックをすべて解除します。このメソッドは、自動コミットモードが無効にされているときにのみ使用します。
SQLException
- データベースアクセスエラーが発生した場合、またはこの Connection
オブジェクトが自動コミットモードである場合setAutoCommit(boolean)
public void rollback() throws SQLException
Connection
オブジェクトが現在保持するデータベースロックをすべて解除します。このメソッドは、自動コミットモードが無効にされているときにのみ使用します。
SQLException
- データベースアクセスエラーが発生した場合、またはこの Connection
オブジェクトが自動コミットモードである場合setAutoCommit(boolean)
public void close() throws SQLException
Connection
オブジェクトのデータベースと JDBC リソースを解除します。
すでにクローズされた Connection
オブジェクトで close
メソッドを呼び出すと、操作は行われません。
注: Connection
オブジェクトは、ガベージコレクトされるときに自動的にクローズされます。特定の致命的エラーの場合も、Connection
オブジェクトはクローズされます。
SQLException
- データベースアクセスエラーが発生した場合public boolean isClosed() throws SQLException
Connection
オブジェクトがクローズされているかどうかを取得します。接続は、close
メソッドが呼び出されるか、特定の致命的エラーが発生した場合にクローズされます。このメソッドは、Connection.close
メソッドが呼び出されたあとに呼び出された場合にだけ true
を返すことが保証されています。
このメソッドは通常、データベースへの接続が有効か無効かを判定するために呼び出すことはできません。一般のクライアントでは、操作を実行したときにスローされる例外をキャッチすることにより、接続が無効であると判定します。
Connection
オブジェクトがクローズされている場合は true
、まだオープンの状態の場合は false
SQLException
- データベースアクセスエラーが発生した場合public DatabaseMetaData getMetaData() throws SQLException
Connection
オブジェクトが接続を表すデータベースに関するメタデータを格納する DatabaseMetaData
オブジェクトを取得します。メタデータは、データベースのテーブル、サポートしている SQL 文法、ストアドプロシージャ、およびこの接続の能力などについての情報を含んでいます。
Connection
オブジェクトに対する DatabaseMetaData
オブジェクト
SQLException
- データベースアクセスエラーが発生した場合public void setReadOnly(boolean readOnly) throws SQLException
注: トランザクションの途中では、このメソッドを呼び出すことはできません。
readOnly
- true
の場合は読み込み専用モードを使用可能にし、false
の場合は使用不可にする
SQLException
- データベースアクセスエラーが発生した場合、またはこのメソッドがトランザクションの途中で呼び出された場合public boolean isReadOnly() throws SQLException
Connection
オブジェクトが読み込み専用モードかどうかを取得します。
Connection
オブジェクトが読み込み専用モードの場合は true
、そうでない場合は false
SQLException
- データベースアクセスエラーが発生した場合public void setCatalog(String catalog) throws SQLException
Connection
オブジェクトのデータベースに作業のためのサブスペースを選択するために、カタログ名を設定します。
ドライバがカタログをサポートしていない場合は、この要求を無視します。
catalog
- 作業のためのカタログ名。カタログは、この Connection
オブジェクトのデータベースのサブスペース
SQLException
- データベースアクセスエラーが発生した場合getCatalog()
public String getCatalog() throws SQLException
Connection
オブジェクトの現在のカタログ名を取得します。
null
SQLException
- データベースアクセスエラーが発生した場合setCatalog(java.lang.String)
public void setTransactionIsolation(int level) throws SQLException
Connection
のトランザクション遮断レベルを指定されたものに変更することを試みます。指定できるトランザクション遮断レベルの定数は、Connection
インタフェースで定義されています。
注: トランザクションの途中でこのメソッドが呼び出されると、その結果は実装で定義されたものになります。
level
- 次の Connection
定数のうちの 1 つ。Connection.TRANSACTION_READ_UNCOMMITTED
、Connection.TRANSACTION_READ_COMMITTED
、Connection.TRANSACTION_REPEATABLE_READ
、または Connection.TRANSACTION_SERIALIZABLE
。(Connection.TRANSACTION_NONE
はトランザクションがサポートされていないことを指定するので使用できない)
SQLException
- データベースアクセスエラーが発生した場合、または指定されたパラメータが Connection
定数のどれでもない場合DatabaseMetaData.supportsTransactionIsolationLevel(int)
,
getTransactionIsolation()
public int getTransactionIsolation() throws SQLException
Connection
オブジェクトの現在のトランザクション遮断レベルを取得します。
Connection.TRANSACTION_READ_UNCOMMITTED
、Connection.TRANSACTION_READ_COMMITTED
、Connection.TRANSACTION_REPEATABLE_READ
、Connection.TRANSACTION_SERIALIZABLE
、または Connection.TRANSACTION_NONE
SQLException
- データベースアクセスエラーが発生した場合setTransactionIsolation(int)
public SQLWarning getWarnings() throws SQLException
Connection
オブジェクトに関する呼び出しによって報告される最初の警告を取得します。2 つ以上の警告がある場合、後続の警告は最初の警告にチェーンされ、直前に取得された警告の SQLWarning.getNextWarning
メソッドを呼び出すことによって取得されます。
このメソッドはクローズされた接続の呼び出しには使用しません。使用するとSQLException
がスローされます。
注: 引き続く警告は、この SQLWarning にチェーンされます。
SQLWarning
オブジェクト。ない場合は null
SQLException
- データベースアクセスエラーが発生した場合、またはこのメソッドがクローズされた接続について呼び出された場合SQLWarning
public void clearWarnings() throws SQLException
Connection
オブジェクトに関して通知されたすべての警告をクリアします。このメソッドを呼び出したあと、この Connection
オブジェクトに対する新しい警告が通知されるまで、getWarnings
は null
を返します。
SQLException
- データベースアクセスエラーが発生した場合public Statement createStatement(int resultSetType, int resultSetConcurrency) throws SQLException
ResultSet
オブジェクトを生成する Statement
オブジェクトを生成します。このメソッドは上記の createStatement
メソッドと同じですが、デフォルトの結果セットの型および並行処理をオーバーライドできます。
resultSetType
- 結果セットの型。ResultSet.TYPE_FORWARD_ONLY
、ResultSet.TYPE_SCROLL_INSENSITIVE
、または ResultSet.TYPE_SCROLL_SENSITIVE
のうちの 1 つresultSetConcurrency
- 並行処理の種類。ResultSet.CONCUR_READ_ONLY
または ResultSet.CONCUR_UPDATABLE
ResultSet
オブジェクトを生成する新しい Statement
オブジェクト
SQLException
- データベースアクセスエラーが発生した場合、または指定されたパラメータが型および並行処理を示す ResultSet
定数でない場合public PreparedStatement prepareStatement(String sql, int resultSetType, int resultSetConcurrency) throws SQLException
ResultSet
オブジェクトを生成する PreparedStatement
オブジェクトを生成します。このメソッドは上記の prepareStatement
メソッドと同じですが、デフォルトの結果セットの型および並行処理をオーバーライドできます。
sql
- SQL 文がデータベースへ送られる String
オブジェクト。1 つ以上の ? IN パラメータを含めることができるresultSetType
- 結果セットの型。ResultSet.TYPE_FORWARD_ONLY
、ResultSet.TYPE_SCROLL_INSENSITIVE
、または ResultSet.TYPE_SCROLL_SENSITIVE
のうちの 1 つresultSetConcurrency
- 並行処理の種類。ResultSet.CONCUR_READ_ONLY
または ResultSet.CONCUR_UPDATABLE
PreparedStatement
オブジェクト。指定された型および並行処理で ResultSet
オブジェクトを生成する
SQLException
- データベースアクセスエラーが発生した場合、または指定されたパラメータが型および並行処理を示す ResultSet
定数でない場合public CallableStatement prepareCall(String sql, int resultSetType, int resultSetConcurrency) throws SQLException
ResultSet
オブジェクトを生成する CallableStatement
オブジェクトを生成します。このメソッドは上記の prepareCall
メソッドと同じですが、デフォルトの結果セットの型および並行処理をオーバーライドできます。
sql
- SQL 文がデータベースへ送られる String
オブジェクト。1 つ以上の ? パラメータを含めることができるresultSetType
- 結果セットの型。ResultSet.TYPE_FORWARD_ONLY
、ResultSet.TYPE_SCROLL_INSENSITIVE
、または ResultSet.TYPE_SCROLL_SENSITIVE
のうちの 1 つresultSetConcurrency
- 並行処理の種類。ResultSet.CONCUR_READ_ONLY
または ResultSet.CONCUR_UPDATABLE
CallableStatement
オブジェクト。指定された型および並行処理で ResultSet
オブジェクトを生成する
SQLException
- データベースアクセスエラーが発生した場合、または指定されたパラメータが型および並行処理を示す ResultSet
定数でない場合public Map getTypeMap() throws SQLException
Connection
に関連した Map
オブジェクトを取得します。アプリケーションがエントリを追加していないかぎり、空のマップが返されます。
Connection
オブジェクトに関連した java.util.Map
オブジェクト
SQLException
- データベースアクセスエラーが発生した場合setTypeMap(java.util.Map)
public void setTypeMap(Map map) throws SQLException
Connection
オブジェクトの型マップとして指定された TypeMap
オブジェクトをインストールします。型マップは、SQL 構造化型および個別の型のカスタムマッピングに使用されます。
map
- この Connection
オブジェクトのデフォルトの型マップの代わりとしてインストールする java.util.Map
オブジェクト
SQLException
- データベースアクセスエラーが発生した場合、または指定されたパラメータが java.util.Map
でない場合getTypeMap()
public void setHoldability(int holdability) throws SQLException
Connection
オブジェクトを使用して生成された ResultSet
オブジェクトの保持機能を指定された保持機能へ変更します。
holdability
- ResultSet
の保持機能定数。ResultSet.HOLD_CURSORS_OVER_COMMIT
または ResultSet.CLOSE_CURSORS_AT_COMMIT
SQLException
- データベースアクセスエラーが発生した場合、指定されたパラメータが保持機能を示す ResultSet
定数でない場合、または指定された保持機能がサポートされていない場合getHoldability()
,
ResultSet
public int getHoldability() throws SQLException
Connection
オブジェクトを使用して生成された ResultSet
オブジェクトの現在の保持機能を取得します。
ResultSet.HOLD_CURSORS_OVER_COMMIT
または ResultSet.CLOSE_CURSORS_AT_COMMIT
SQLException
- データベースアクセスエラーが発生した場合setHoldability(int)
,
ResultSet
public Savepoint setSavepoint() throws SQLException
Savepoint
オブジェクトを返します。
Savepoint
オブジェクト
SQLException
- データベースアクセスエラーが発生した場合、または現在この Connection
オブジェクトが自動コミットモードである場合Savepoint
public Savepoint setSavepoint(String name) throws SQLException
Savepoint
オブジェクトを返します。
name
- セーブポイントの名前を格納する String
Savepoint
オブジェクト
SQLException
- データベースアクセスエラーが発生した場合、または現在この Connection
オブジェクトが自動コミットモードである場合Savepoint
public void rollback(Savepoint savepoint) throws SQLException
Savepoint
オブジェクトが設定されたあとに行われたすべての変更を元に戻します。
このメソッドは自動コミットが無効のときにだけ使用します。
savepoint
- ロールバックする Savepoint
オブジェクト
SQLException
- データベースアクセスエラーが発生した場合、Savepoint
オブジェクトが有効でなくなった場合、または現在この Connection
オブジェクトが自動コミットモードである場合Savepoint
,
rollback()
public void releaseSavepoint(Savepoint savepoint) throws SQLException
Savepoint
オブジェクトを削除します。削除されたあとでセーブポイントを参照すると SQLException
がスローされます。
savepoint
- 削除される Savepoint
オブジェクト
SQLException
- データベースアクセスエラーが発生した場合、または指定された Savepoint
オブジェクトが現在のトランザクションで有効なセーブポイントでない場合public Statement createStatement(int resultSetType, int resultSetConcurrency, int resultSetHoldability) throws SQLException
ResultSet
オブジェクトを生成する Statement
オブジェクトを生成します。このメソッドは上記の createStatement
メソッドと同じですが、デフォルトの結果セットの型、並行処理、および保持機能をオーバーライドできます。
resultSetType
- ResultSet
定数。ResultSet.TYPE_FORWARD_ONLY
、ResultSet.TYPE_SCROLL_INSENSITIVE
、または ResultSet.TYPE_SCROLL_SENSITIVE
のうちの 1 つresultSetConcurrency
- ResultSet
定数。ResultSet.CONCUR_READ_ONLY
または ResultSet.CONCUR_UPDATABLE
resultSetHoldability
- ResultSet
定数。ResultSet.HOLD_CURSORS_OVER_COMMIT
または ResultSet.CLOSE_CURSORS_AT_COMMIT
ResultSet
オブジェクトを生成する新しい Statement
オブジェクト
SQLException
- データベースアクセスエラーが発生した場合、または指定されたパラメータが型、並行処理、および保持機能を示す ResultSet
定数でない場合ResultSet
public PreparedStatement prepareStatement(String sql, int resultSetType, int resultSetConcurrency, int resultSetHoldability) throws SQLException
ResultSet
オブジェクトを生成する PreparedStatement
オブジェクトを生成します。
このメソッドは上記の prepareStatement
メソッドと同じですが、デフォルトの結果セットの型、並行処理、および保持機能をオーバーライドできます。
sql
- SQL 文がデータベースへ送られる String
オブジェクト。1 つ以上の ? IN パラメータを含めることができるresultSetType
- ResultSet
定数。ResultSet.TYPE_FORWARD_ONLY
、ResultSet.TYPE_SCROLL_INSENSITIVE
、または ResultSet.TYPE_SCROLL_SENSITIVE
のうちの 1 つresultSetConcurrency
- ResultSet
定数。ResultSet.CONCUR_READ_ONLY
または ResultSet.CONCUR_UPDATABLE
resultSetHoldability
- ResultSet
定数。ResultSet.HOLD_CURSORS_OVER_COMMIT
または ResultSet.CLOSE_CURSORS_AT_COMMIT
PreparedStatement
オブジェクト。指定された型、並行処理、および保持機能で ResultSet
オブジェクトを生成する
SQLException
- データベースアクセスエラーが発生した場合、または指定されたパラメータが型、並行処理、および保持機能を示す ResultSet
定数でない場合ResultSet
public CallableStatement prepareCall(String sql, int resultSetType, int resultSetConcurrency, int resultSetHoldability) throws SQLException
ResultSet
オブジェクトを生成する CallableStatement
オブジェクトを生成します。このメソッドは上記の prepareCall
メソッドと同じですが、デフォルトの結果セットの型、結果セットの並行処理の種類、および保持機能をオーバーライドできます。
sql
- SQL 文がデータベースへ送られる String
オブジェクト。1 つ以上の ? パラメータを含めることができるresultSetType
- ResultSet
定数。ResultSet.TYPE_FORWARD_ONLY
、ResultSet.TYPE_SCROLL_INSENSITIVE
、または ResultSet.TYPE_SCROLL_SENSITIVE
のうちの 1 つresultSetConcurrency
- ResultSet
定数。ResultSet.CONCUR_READ_ONLY
または ResultSet.CONCUR_UPDATABLE
resultSetHoldability
- ResultSet
定数。ResultSet.HOLD_CURSORS_OVER_COMMIT
または ResultSet.CLOSE_CURSORS_AT_COMMIT
CallableStatement
オブジェクト。指定された型、並行処理、および保持機能で ResultSet
オブジェクトを生成する
SQLException
- データベースアクセスエラーが発生した場合、または指定されたパラメータが型、並行処理、および保持機能を示す ResultSet
定数でない場合ResultSet
public PreparedStatement prepareStatement(String sql, int autoGeneratedKeys) throws SQLException
PreparedStatement
オブジェクトを生成します。指定された定数によって、ドライバが自動生成キーを取得可能にするかどうかが指定されます。SQL 文が INSERT
文でない場合、このパラメータは無視されます。
注: このメソッドは、プリコンパイルが効果のある、パラメータ付き SQL 文を処理するために最適化されています。ドライバが、プリコンパイルをサポートしている場合、prepareStatement
メソッドは、その文をプリコンパイル用としてデータベースに送ります。ドライバによっては、プリコンパイルをサポートしていないものがあります。この場合、PreparedStatement
が実行されるまで、文はデータベースに送られません。これはユーザに直接的な影響はありませんが、どのメソッドが、どの SQLException をスローしたかに関して影響があります。
返される PreparedStatement
オブジェクトを使って作成された結果セットは、デフォルトでは、TYPE_FORWARD_ONLY
の型で、CONCUR_READ_ONLY
の並行処理レベルを持ちます。
sql
- 1 つ以上の '?' IN パラメータプレースホルダーを含めることができる SQL 文autoGeneratedKeys
- 自動生成キーを返すかどうかを示すフラグ。次の Statement
定数のうちの 1 つ
PreparedStatement
オブジェクト。自動生成キーを返す機能を持つ
SQLException
- データベースアクセスエラーが発生した場合、または指定されたパラメータが自動生成キーを返すかどうかを示す Statement
定数でない場合public PreparedStatement prepareStatement(String sql, int[] columnIndexes) throws SQLException
PreparedStatement
オブジェクトを生成します。この配列は、使用可能にされる自動生成キーを含むターゲットテーブルの列のインデックスを含みます。SQL 文が INSERT
文でない場合、この配列は無視されます。
IN パラメータ付きまたは IN パラメータなしの SQL 文は、プリコンパイルして、PreparedStatement
オブジェクトに格納できます。したがって、このオブジェクトは、この文を複数回、効率的に実行するのに使用できます。
注: このメソッドは、プリコンパイルが効果のある、パラメータ付き SQL 文を処理するために最適化されています。ドライバが、プリコンパイルをサポートしている場合、prepareStatement
メソッドは、その文をプリコンパイル用としてデータベースに送ります。ドライバによっては、プリコンパイルをサポートしていないものがあります。この場合、PreparedStatement
が実行されるまで、文はデータベースに送られません。これはユーザに直接的な影響はありませんが、どのメソッドが、どの SQLException をスローしたかに関して影響があります。
返される PreparedStatement
オブジェクトを使って作成された結果セットは、デフォルトでは、TYPE_FORWARD_ONLY
の型で、CONCUR_READ_ONLY
の並行処理レベルを持ちます。
sql
- 1 つ以上の '?' IN パラメータプレースホルダーを含めることができる SQL 文columnIndexes
- 挿入された行から返される列を示す列インデックスの配列
PreparedStatement
オブジェクト。指定された列インデックスの配列によって指定される自動生成キーを返す機能を持つ
SQLException
- データベースアクセスエラーが発生した場合public PreparedStatement prepareStatement(String sql, String[] columnNames) throws SQLException
PreparedStatement
オブジェクトを生成します。この配列は、返される自動生成キーを含むターゲットテーブルの列の名前を含みます。SQL 文が INSERT
文でない場合、この配列は無視されます。
IN パラメータ付きまたは IN パラメータなしの SQL 文は、プリコンパイルして、PreparedStatement
オブジェクトに格納できます。したがって、このオブジェクトは、この文を複数回、効率的に実行するのに使用できます。
注: このメソッドは、プリコンパイルが効果のある、パラメータ付き SQL 文を処理するために最適化されています。ドライバが、プリコンパイルをサポートしている場合、prepareStatement
メソッドは、その文をプリコンパイル用としてデータベースに送ります。ドライバによっては、プリコンパイルをサポートしていないものがあります。この場合、PreparedStatement
が実行されるまで、文はデータベースに送られません。これはユーザに直接的な影響はありませんが、どのメソッドが、どの SQLException をスローしたかに関して影響があります。
返される PreparedStatement
オブジェクトを使って作成された結果セットは、デフォルトでは、TYPE_FORWARD_ONLY
の型で、CONCUR_READ_ONLY
の並行処理レベルを持ちます。
sql
- 1 つ以上の '?' IN パラメータプレースホルダーを含めることができる SQL 文columnNames
- 挿入された行から返される列を示す列名の配列
PreparedStatement
オブジェクト。指定された列名の配列によって指定される自動生成キーを返す機能を持つ
SQLException
- データベースアクセスエラーが発生した場合
|
JavaTM 2 Platform Std. Ed. v1.4.0 |
||||||||||
前のクラス 次のクラス | フレームあり フレームなし | ||||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
Java、Java 2D、および JDBC は米国ならびにその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 1993-2002 Sun Microsystems, Inc. 901 San Antonio Road
Palo Alto, California, 94303, U.S.A. All Rights Reserved.