|
Java プラットフォーム 1.2 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 内部クラス | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
特定のデータベースとの接続 (セッション) を表現します。Connection のコンテキスト内で SQL 文が実行され結果が返されます。
Connection 中のデータベースは、テーブル、サポートしている SQL 文法、ストアドプロシージャ、およびこの接続の能力などについての情報を提供します。この情報は、getMetaData
メソッドで取得できます。
注: 各文を実行後、デフォルトでは、Connection は自動的に変更をコミットします。自動コミットが無効にされている場合、明示的なコミットを行わないとデータベースの変更は保存されません。
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)
JDBC 2.0 指定されたタイプと平行処理で ResultSet オブジェクトを作成する Statement オブジェクトを作成します。 |
boolean |
getAutoCommit()
現在の自動コミットの状態を取得します。 |
String |
getCatalog()
Connection の現在のカタログ名を返します。 |
DatabaseMetaData |
getMetaData()
この接続のデータベースに関するメタデータを取得します。 |
int |
getTransactionIsolation()
この Connection の現在のトランザクションアイソレーションレベルを取得します。 |
Map |
getTypeMap()
JDBC 2.0 この接続に関連付けられている型マッピングオブジェクトを取得します。 |
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)
JDBC 2.0 指定されたタイプと並行処理で ResultSet オブジェクトを作成する CallableStatement オブジェクトを作成します。 |
PreparedStatement |
prepareStatement(String sql)
パラメータ付き SQL 文をデータベースに送るための PreparedStatement オブジェクトを作成します。
|
PreparedStatement |
prepareStatement(String sql,
int resultSetType,
int resultSetConcurrency)
JDBC 2.0 指定されたタイプと並行処理で ResultSet オブジェクトを作成する PreparedStatement オブジェクトを作成します。 |
void |
rollback()
直前のコミット/ロールバック以降に行われた変更をすべて無効とし、この Connection が現在保持するデータベースロックをすべて解除します。 |
void |
setAutoCommit(boolean autoCommit)
この接続の自動コミットモードを設定します。 |
void |
setCatalog(String catalog)
この Connection のデータベースに作業のためのサブスペースを選択するために、カタログ名を設定します。 |
void |
setReadOnly(boolean readOnly)
この Connection を読み込み専用モードに設定して、データベース最適化を実行するヒントとします。 |
void |
setTransactionIsolation(int level)
トランザクションアイソレーションレベルを指定されたものに変更することを試みます。 |
void |
setTypeMap(Map map)
JDBC 2.0 この接続の型マッピングとして指定された型マッピングをインストールします。 |
フィールドの詳細 |
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
メソッドの詳細 |
public Statement createStatement() throws SQLException
Statement
オブジェクトを作成します。パラメータなしの SQL 文は通常、Statement オブジェクトを使用して実行されます。同じ SQL 文が多数回実行される場合は、PreparedStatement を使用する方が効率的です。
JDBC 2.0
返される Statement を使って作成された結果セットは、デフォルトでは、順方向専用タイプで、読み取り専用の並行処理ができます。
public PreparedStatement prepareStatement(String sql) throws SQLException
PreparedStatement
オブジェクトを作成します。
IN パラメータ付きまたは IN パラメータなしの SQL 文は、プリコンパイルして、PreparedStatement オブジェクトに格納できます。したがって、このオブジェクトは、この文を複数回、効率的に実行するのに使用できます。
注: このメソッドは、プリコンパイルが効果のある、パラメータ付き SQL 文を処理するために最適化されています。ドライバが、プリコンパイルをサポートしている場合、prepareStatement
メソッドは、その文をプリコンパイル用としてデータベースに送ります。ドライバによっては、プリコンパイルをサポートしていないものがあります。この場合、PreparedStatement
が実行されるまで、文はデータベースに送られません。これはユーザに直接的な影響はありませんが、どのメソッドが、どの SQLException をスローしたかに関して影響があります。
JDBC 2.0
返される PreparedStatement を使って作成された結果セットは、デフォルトでは、順方向専用タイプで、読み取り専用の並行処理ができます。
sql
- 1 つ以上の '?' IN パラメータプレースホルダーを含めることができる SQL 文public CallableStatement prepareCall(String sql) throws SQLException
CallableStatement
オブジェクトを作成します。CallableStatement は、その IN と OUT パラメータを設定するメソッドとストアドプロシージャの呼び出しを実行するメソッドを提供します。
注: このメソッドは、ストアドプロシージャ呼び出し文を処理するために最適化されています。ドライバによっては、prepareCall
メソッドが実行されるときにデータベースに呼び出し文を送るものがあります。その他のドライバは、CallableStatement が実行されるまで待ちます。これはユーザに直接的な影響はありませんが、どのメソッドが、どの SQLException をスローしたかに関して影響があります。
JDBC 2.0
返される CallableStatement を使って作成された結果セットは、デフォルトでは、順方向専用タイプで、読み取り専用の並行処理ができます。
sql
- 1 つ以上の '?' パラメータプレースホルダーを含めることができる SQL 文。通常この文は、JBDC 関数呼び出しのエスケープ文字列であるpublic String nativeSQL(String sql) throws SQLException
sql
- 1 つ以上の '?' パラメータプレースホルダーを含めることができる SQL 文public void setAutoCommit(boolean autoCommit) throws SQLException
commit
メソッドまたは rollback
メソッドへの呼び出しによって終了されるトランザクションにグループ化されます。デフォルトでは、新しい接続は自動コミットモードです。
コミットは、文の完了または次の実行の発生のどちらが先に起こっても発生します。文が、ResultSet を返す場合には、ResultSet の最後の行が取り出されるかクローズされたときに文は完了します。進んだ用法では、単一の文が出力パラメータと同様に、複数の結果を返すこともあります。この場合は、すべての結果と出力パラメータ値が取り出された時にコミットが発生します。
autoCommit
- true の場合は自動コミットが有効、false の場合は自動コミットが無効public boolean getAutoCommit() throws SQLException
setAutoCommit(boolean)
public void commit() throws SQLException
setAutoCommit(boolean)
public void rollback() throws SQLException
setAutoCommit(boolean)
public void close() throws SQLException
注: Connection は、ガベージとして回収されるときに自動的にクローズされます。特定の致命的エラーでは、結果的に Connection をクローズすることになります。
public boolean isClosed() throws SQLException
public DatabaseMetaData getMetaData() throws SQLException
public void setReadOnly(boolean readOnly) throws SQLException
注: トランザクションの途中で、このメソッドを呼び出すことはできません。
readOnly
- true の場合は読み込み専用モードが有効、false の場合は読み込み専用モードが無効public boolean isReadOnly() throws SQLException
public void setCatalog(String catalog) throws SQLException
public String getCatalog() throws SQLException
public void setTransactionIsolation(int level) throws SQLException
Connection
インタフェースで定義されています。
注: トランザクションの途中では、このメソッドを呼び出すことはできません。
level
- TRANSACTION_NONE を除く TRANSACTION_* アイソレーション値の 1 つ。データベースによっては、ほかの値をサポートしないものがあるDatabaseMetaData.supportsTransactionIsolationLevel(int)
public int getTransactionIsolation() throws SQLException
public SQLWarning getWarnings() throws SQLException
注: 引き続く警告は、この SQLWarning にチェーンされます。
public void clearWarnings() throws SQLException
Connection
オブジェクトに関して通知されたすべての警告をクリアします。このメソッドを呼び出したあと、Connection に対する新しい警告が通知されるまで、getWarnings
は null を返します。public Statement createStatement(int resultSetType, int resultSetConcurrency) throws SQLException
指定されたタイプと平行処理で ResultSet
オブジェクトを作成する Statement
オブジェクトを作成します。このメソッドは上記の createStatement
メソッドと同じですが、デフォルトの結果セットのタイプおよび結果セットの並行処理の種類をオーバーライドできます。
resultSetType
- 結果セットのタイプ。ResultSet.TYPE_XXX を参照resultSetConcurrency
- 並行処理の種類。ResultSet.CONCUR_XXX を参照public PreparedStatement prepareStatement(String sql, int resultSetType, int resultSetConcurrency) throws SQLException
指定されたタイプと並行処理で ResultSet
オブジェクトを作成する PreparedStatement
オブジェクトを作成します。このメソッドは上記の prepareStatement
メソッドと同じですが、デフォルトの結果セットのタイプおよび結果セットの並行処理の種類をオーバーライドできます。
resultSetType
- 結果セットのタイプ。ResultSet.TYPE_XXX を参照resultSetConcurrency
- 並行処理の種類。ResultSet.CONCUR_XXX を参照public CallableStatement prepareCall(String sql, int resultSetType, int resultSetConcurrency) throws SQLException
指定されたタイプと並行処理で ResultSet
オブジェクトを作成する CallableStatement
オブジェクトを作成します。このメソッドは上記の prepareCall
メソッドと同じ様ですが、デフォルトの結果セットのタイプおよび結果セットの並行処理の種類をオーバーライドできます。
resultSetType
- 結果セットのタイプ。ResultSet.TYPE_XXX を参照resultSetConcurrency
- 並行処理の種類。ResultSet.CONCUR_XXX を参照public Map getTypeMap() throws SQLException
この接続に関連付けられている型マッピングオブジェクトを取得します。アプリケーションが型マッピングにエントリを追加していない限り、空のマッピングが返されます。
Connection
オブジェクトに関連付けられている java.util.Map
オブジェクトpublic void setTypeMap(Map map) throws SQLException
この接続の型マッピングとして指定された型マッピングをインストールします。型マッピングは、SQL 構造化型および個別の型のカスタムマッピングに使用されます。
map
- この Connection
オブジェクトのデフォルトの型マッピングの代わりとしてインストールする java.util.Map
オブジェクト
|
Java プラットフォーム 1.2 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 内部クラス | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |