インタフェースConnection
- すべてのスーパー・インタフェース:
AutoCloseable,Wrapper
特定のデータベースとの接続(セッション)を表現します。 接続のコンテキスト内でSQL文が実行され結果が返されます。
Connectionオブジェクト中のデータベースは、表、サポートしているSQL文法、ストアド・プロシージャ、およびこの接続の能力などについての情 を提供します。 この情 は、getMetaDataメソッドで取得できます。
ノート: JDBCアプリケーションでConnectionを構成するときは、setAutoCommitやsetTransactionIsolationなどの適切なConnectionメソッドを使用するようにしてく さい。 利用できるJDBCのメソッドがある 合は、アプリケーションでSQLコマンドを直接呼び出して接続の構成を変更しないようにしてく さい。 各文を実行後、デフォルトでは、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);
- 導入されたバージョン:
- 1.1
- 関連 目:
-
フィールドのサマリー
フィールド修飾子と型フィールド説明static final intトランザクションがサポートされていないことを示す定数です。static final intダーティ読込みは抑制され、繰返し不可の読み込みおよびファント 読込みが起こることを示す定数です。static final intダーティ読み込み、繰返し不可の読み込み、およびファント 読込みが起こることを示す定数です。static final intダーティ読み込みおよび繰返し不可の読込みは抑制され、ファント 読込みが起こることを示す定数です。static final intダーティ読み込み、繰返し不可の読み込み、およびファント 読込みが抑制されることを示す定数です。 -
メソッドのサマリー
修飾子と型メソッド説明voidオープン接続を終了します。default voidリクエスト(独立した作業単位)がこの接続から始まっていることを示す、ドライバへのヒント。voidこのConnectionオブジェクトに関して 告されたすべての警告をクリアします。voidclose()自動的な解除を待たずに、た ちにこのConnectionオブジェクトのデータベースとJDBCリソースを解除します。voidcommit()直前のコミット/ロールバック以降に行われた変更をすべて永続的なものにし、このConnectionオブジェクトが現在保持するデータベース・ロックをすべて解除します。createArrayOf(String typeName, Object[] elements) Arrayオブジェクトを生成するファクトリ・メソッドです。Blobインタフェースを実装しているオブジェクトを構築します。Clobインタフェースを実装しているオブジェクトを構築します。NClobインタフェースを実装しているオブジェクトを構築します。SQLXMLインタフェースを実装しているオブジェクトを構築します。SQL文をデータベースに送るためのStatementオブジェクトを生成します。createStatement(int resultSetType, int resultSetConcurrency) 指定された型と並行処理でResultSetオブジェクトを生成するStatementオブジェクトを生成します。createStatement(int resultSetType, int resultSetConcurrency, int resultSetHoldability) 指定された型、並行処理、および保持機能でResultSetオブジェクトを生成するStatementオブジェクトを生成します。createStruct(String typeName, Object[] attributes) Structオブジェクトを生成するファクトリ・メソッドです。default void独立した作業単位であるリクエストが完了したドライバへのヒント。booleanこのConnectionオブジェクトの現在の自動コミット・モードを取得します。このConnectionオブジェクトの現在のカタログ名を取得します。ドライバでサポートされる各クライアント情 プロパティの名前と現在の値が含まれるリストを返します。getClientInfo(String name) 名前で指定されたをクライアント情 プロパティの値を返します。intこのConnectionオブジェクトを使用して生成されたResultSetオブジェクトの現在の保持機能を取得します。このConnectionオブジェクトが接続を表すデータベースに関するメタデータを 納するDatabaseMetaDataオブジェクトを取得します。intドライバがデータベース要求の完了を待つミリ秒数を取得します。このConnectionオブジェクトの現在のスキーマ名を取得します。intこのConnectionオブジェクトの現在のトランザクション遮断レベルを取得します。このConnectionオブジェクトに関連付けられたMapオブジェクトを取得します。このConnectionオブジェクトに関する呼出しによって 告される最初の警告を取得します。booleanisClosed()このConnectionオブジェクトがクローズされているかどうかを取得します。booleanこのConnectionオブジェクトが読込み専用モードかどうかを取得します。booleanisValid(int timeout) 接続がクローズされておらず、ま 有効である 合は、trueを返します。指定されたSQL文をシステ の本来のSQL文法に変換します。prepareCall(String sql) データベースのストアド・プロシージャを呼び出すためのCallableStatementオブジェクトを生成します。prepareCall(String sql, int resultSetType, int resultSetConcurrency) 指定された型と並行処理でResultSetオブジェクトを生成するCallableStatementオブジェクトを生成します。prepareCall(String sql, int resultSetType, int resultSetConcurrency, int resultSetHoldability) 指定された型と並行処理でResultSetオブジェクトを生成するCallableStatementオブジェクトを生成します。prepareStatement(String sql) パラメータ付きSQL文をデータベースに送るためのPreparedStatementオブジェクトを生成します。prepareStatement(String sql, int autoGeneratedKeys) 自動生成キーを取得する機能を持つデフォルトのPreparedStatementオブジェクトを生成します。prepareStatement(String sql, int[] columnIndexes) 指定された配列によって指定された自動生成キーを返す機能を持つデフォルトのPreparedStatementオブジェクトを生成します。prepareStatement(String sql, int resultSetType, int resultSetConcurrency) 指定された型と並行処理でResultSetオブジェクトを生成するPreparedStatementオブジェクトを生成します。prepareStatement(String sql, int resultSetType, int resultSetConcurrency, int resultSetHoldability) 指定された型、並行処理、および保持機能でResultSetオブジェクトを生成するPreparedStatementオブジェクトを生成します。prepareStatement(String sql, String[] columnNames) 指定された配列によって指定された自動生成キーを返す機能を持つデフォルトのPreparedStatementオブジェクトを生成します。voidreleaseSavepoint(Savepoint savepoint) 現在のトランザクションから指定されたSavepointオブジェクトと以降のSavepointオブジェクトを削除します。voidrollback()現在のトランザクションにおけるすべての変更を取り消し、現在このConnectionオブジェクトが保持しているすべてのデータベース・ロックを解除します。void指定されたSavepointオブジェクトが設定されたあとに行われたすべての変更を元に戻します。voidsetAutoCommit(boolean autoCommit) この接続の自動コミット・モードを指定された状態に設定します。voidsetCatalog(String catalog) このConnectionオブジェクトのデータベースに作業のためのサブスペースを選択するために、カタログ名を設定します。voidsetClientInfo(String name, String value) 名前で指定されたクライアント情 プロパティの値を、値で指定された値に設定します。voidsetClientInfo(Properties properties) 接続のクライアント情 プロパティの値を設定します。voidsetHoldability(int holdability) このConnectionオブジェクトを使用して生成されたResultSetオブジェクトのデフォルトの保持機能を指定された保持機能へ変更します。voidsetNetworkTimeout(Executor executor, int milliseconds) ConnectionまたはConnectionから作成されたオブジェクトが、データベースが任意の1つの要求に応答するのを待つ最大期間を設定します。voidsetReadOnly(boolean readOnly) ドライバがデータベースの最適化を有効にできるように、ヒントとして、この接続を読込み専用モードに設定します。現在のトランザクションで名前のないセーブポイントを作成し、それを表す新しいSavepointオブジェクトを返します。setSavepoint(String name) 現在のトランザクションで指定された名前のセーブポイントを作成し、それを表す新しいSavepointオブジェクトを返します。voidアクセスするスキーマ名を設定します。default voidsetShardingKey(ShardingKey shardingKey) このConnectionで使用するshardingKeyを指定default voidsetShardingKey(ShardingKey shardingKey, ShardingKey superShardingKey) このConnectionで使用するshardingKeyおよびsuperShardingKeyを指定default booleansetShardingKeyIfValid(ShardingKey shardingKey, int timeout) この接続のシャーディング・キーを設定および検証します。default booleansetShardingKeyIfValid(ShardingKey shardingKey, ShardingKey superShardingKey, int timeout) この接続のシャーディング・キーを設定および検証します。voidsetTransactionIsolation(int level) このConnectionオブジェクトのトランザクション遮断レベルを指定されたものに変更することを試みます。voidsetTypeMap(Map<String, Class<?>> map) このConnectionオブジェクトの型マップとして、指定されたTypeMapオブジェクトをインストールします。インタフェースjava.sql.Wrapperで宣言されたメソッド
isWrapperFor, unwrap
-
フィールド詳細
-
TRANSACTION_NONE
static final int TRANSACTION_NONEトランザクションがサポートされていないことを示す定数です。- 関連 目:
-
TRANSACTION_READ_UNCOMMITTED
static final int TRANSACTION_READ_UNCOMMITTEDダーティ読み込み、繰返し不可の読み込み、およびファント 読込みが起こることを示す定数です。 このレベルでは1つのトランザクションによって変更された行を、その行の変更がコミットされる前に、ほかのトランザクションによって読み取ることがあります(ダーティ読み込み)。 変更がロールバックされると、2番目のトランザクションは無効な行を取り出すことになります。- 関連 目:
-
TRANSACTION_READ_COMMITTED
static final int TRANSACTION_READ_COMMITTEDダーティ読込みは抑制され、繰返し不可の読み込みおよびファント 読込みが起こることを示す定数です。 このレベルは、コミットされていない変更がある行をトランザクションが読み取ることを禁止する けです。- 関連 目:
-
TRANSACTION_REPEATABLE_READ
static final int TRANSACTION_REPEATABLE_READダーティ読み込みおよび繰返し不可の読込みは抑制され、ファント 読込みが起こることを示す定数です。 このレベルでは、コミットされていない変更がある行をトランザクションが読み取ること、および1つのトランザクションがある行を読み込み、2番目のトランザクションがその行を変更した 合に、最初のトランザクションがその行を読込みし直したときに2度目は異なる値を取得するという状況が禁止されます(繰返し不可の読み込み)。- 関連 目:
-
TRANSACTION_SERIALIZABLE
static final int TRANSACTION_SERIALIZABLEダーティ読み込み、繰返し不可の読み込み、およびファント 読込みが抑制されることを示す定数です。 このレベルには、TRANSACTION_REPEATABLE_READでの禁止に え、1つのトランザクションがWHERE条件を満たすすべての行を読み出し、2番目のトランザクションがWHERE条件を満たす行を挿入したあとに、最初のトランザクションが同一の条件で読込みし直した 合に、2番目の読込みでは追 された「ファント 」行を取り出すという状況が禁止されます。- 関連 目:
-
-
メソッドの詳細
-
createStatement
Statement createStatement() throws SQLExceptionSQL文をデータベースに送るためのStatementオブジェクトを生成します。 パラメータなしのSQL文は通常、Statementオブジェクトを使用して実行されます。 同じSQL文が多数回実行される 合は、PreparedStatementオブジェクトを使用する方が効率的なことがあります。返される
Statementオブジェクトを使って作成された結果セットは、デフォルトでは、TYPE_FORWARD_ONLYの型で、CONCUR_READ_ONLYの並行処理レベルを持ちます。 作成された結果セットの保持機能は、getHoldability()を呼び出すことで判断できます。- 戻り値:
- 新しいデフォルトの
Statementオブジェクト - スロー:
SQLException- データベース・アクセス・エラーが発生した 合、またはこのメソッドがクローズされた接続について呼び出された 合
-
prepareStatement
パラメータ付きSQL文をデータベースに送るためのPreparedStatementオブジェクトを生成します。INパラメータ付きまたはINパラメータなしのSQL文は、プリコンパイルして、
PreparedStatementオブジェクトに 納できます。 その後、このオブジェクトは、この文を複数回効率的に実行するために使用できます。ノート: このメソッドは、プリコンパイルが効果のある、パラメータ付きSQL文を処理するために最適化されています。 ドライバが、プリコンパイルをサポートしている 合、
prepareStatementメソッドは、その文をプリコンパイル用としてデータベースに送ります。 ドライバによっては、プリコンパイルをサポートしていないものがあります。 この 合、PreparedStatementオブジェクトが実行されるまで、文はデータベースに送られません。 これはユーザーに直接的な影響はありませんが、どのメソッドが、どのSQLExceptionオブジェクトをスローするかに関して影響があります。返される
PreparedStatementオブジェクトを使って作成された結果セットは、デフォルトでは、TYPE_FORWARD_ONLYの型で、CONCUR_READ_ONLYの並行処理レベルを持ちます。 作成された結果セットの保持機能は、getHoldability()を呼び出すことで判断できます。- パラメータ:
sql- 1つ以上の'?'を含めることができるSQL文 INパラメータ・プレースホルダー- 戻り値:
- プリコンパイルされたSQL文を含む新しいデフォルトの
PreparedStatementオブジェクト - スロー:
SQLException- データベース・アクセス・エラーが発生した 合、またはこのメソッドがクローズされた接続について呼び出された 合
-
prepareCall
CallableStatement prepareCall( String sql) throws SQLExceptionデータベースのストアド・プロシージャを呼び出すためのCallableStatementオブジェクトを生成します。CallableStatementオブジェクトは、そのINとOUTパラメータを設定するメソッドとストアド・プロシージャの呼出しを実行するメソッドを提供します。ノート: このメソッドは、ストアド・プロシージャ呼出し文を処理するために最適化されています。 ドライバによっては、
prepareCallメソッドが実行されるときにデータベースに呼出し文を送るものがあります。その他のドライバは、CallableStatementオブジェクトが実行されるまで待ちます。 これはユーザーに直接的な影響はありませんが、どのメソッドが特定のSQLExceptionをスローするかに関して影響があります。返される
CallableStatementオブジェクトを使って作成された結果セットは、デフォルトでは、TYPE_FORWARD_ONLYの型で、CONCUR_READ_ONLYの並行処理レベルを持ちます。 作成された結果セットの保持機能は、getHoldability()を呼び出すことで判断できます。- パラメータ:
sql- 1つ以上の「?」パラメータ・プレースホルダーを含めることができるSQL文。 通常この文は、JDBC呼出しのエスケープ構文を使用して指定される- 戻り値:
- プリコンパイルされたSQL文を含む新しいデフォルトの
CallableStatementオブジェクト - スロー:
SQLException- データベース・アクセス・エラーが発生した 合、またはこのメソッドがクローズされた接続について呼び出された 合
-
nativeSQL
String nativeSQL( String sql) throws SQLException指定されたSQL文をシステ の本来のSQL文法に変換します。 ドライバは、送信前にJDBC SQL文法をシステ の本来のSQL文法に変換できます。 このメソッドは、ドライバが送る文のシステ 本来の形式を返します。- パラメータ:
sql- 1つ以上の「?」パラメータ・プレースホルダーを含めることができるSQL文- 戻り値:
- この文の元のフォー
- スロー:
SQLException- データベース・アクセス・エラーが発生した 合、またはこのメソッドがクローズされた接続について呼び出された 合
-
setAutoCommit
void setAutoCommit(boolean autoCommit) throws SQLException この接続の自動コミット・モードを指定された状態に設定します。 接続が自動コミット・モードの 合、そのすべてのSQL文は実行され、個別のトランザクションとしてコミットされます。 そうでない 合、そのSQL文は、commitメソッドまたはrollbackメソッドへの呼出しによって終了されるトランザクションにグループ化されます。 デフォルトでは、新しい接続は自動コミット・モードです。コミットは、文が完了すると発生します。 文が完了するタイミングは、SQL文の種類によって異なります。
- DML文(INSERT文、UPDATE文、またはDELETE文、DDL文など)の 合、文は実行を終了するとすぐに完了します。
- Select文の 合、文は関連する結果セットが閉じられると完了します。
CallableStatementオブジェクトの 合、または複数の結果を返す文の 合、文は関連するすべての結果セットが閉じられて、すべての更新カウントと出力パラメータが取得されると完了します。
ノート: トランザクションの途中でこのメソッドが呼び出され、自動コミット・モードが変更されると、そのトランザクションはコミットされます。
setAutoCommitが呼び出され、自動コミット・モードが変更されないと、呼出しによる操作は行われません。- パラメータ:
autoCommit- 自動コミット・モードを有効にする 合はtrue、無効にする 合はfalse- スロー:
SQLException- データベース・アクセス・エラーが発生した 合、分散トランザクションに関係している間にsetAutoCommit(true)が呼び出された 合、またはこのメソッドがクローズされた接続について呼び出された 合- 関連 目:
-
getAutoCommit
boolean getAutoCommit() throws SQLExceptionこのConnectionオブジェクトの現在の自動コミット・モードを取得します。- 戻り値:
- この
Connectionオブジェクトの現在の自動コミット・モードの状態 - スロー:
SQLException- データベース・アクセス・エラーが発生した 合、またはこのメソッドがクローズされた接続について呼び出された 合- 関連 目:
-
commit
void commit() throws SQLException直前のコミット/ロールバック以降に行われた変更をすべて永続的なものにし、このConnectionオブジェクトが現在保持するデータベース・ロックをすべて解除します。 このメソッドは自動コミット・モードが無効になっているときしか使用できません。- スロー:
SQLException- データベース・アクセス・エラーが発生した 合、分散トランザクションに関係している間にこのメソッドが呼び出された 合、このメソッドがクローズされた接続について呼び出された 合、またはこのConnectionオブジェクトが自動コミット・モードである 合- 関連 目:
-
rollback
void rollback() throws SQLException現在のトランザクションにおけるすべての変更を取り消し、現在このConnectionオブジェクトが保持しているすべてのデータベース・ロックを解除します。 このメソッドは自動コミット・モードが無効になっているときしか使用できません。- スロー:
SQLException- データベース・アクセス・エラーが発生した 合、分散トランザクションに関係している間にこのメソッドが呼び出された 合、このメソッドがクローズされた接続について呼び出された 合、またはこのConnectionオブジェクトが自動コミット・モードである 合- 関連 目:
-
close
void close() throws SQLException自動的な解除を待たずに、た ちにこのConnectionオブジェクトのデータベースとJDBCリソースを解除します。すでにクローズされた
Connectionオブジェクトでcloseメソッドを呼び出すと、操作は行われません。closeメソッドの呼出し前に、アプリケーションでアクティブなトランザクションを明示的にコミットまたはロールバックすることを強くお薦めします。closeメソッドが呼び出され、かつアクティブなトランザクションが存在する 合、その結果は実装で定義されたものになります。- 定義:
close、インタフェースAutoCloseable- スロー:
SQLException- データベース・アクセス・エラーが発生した 合
-
isClosed
boolean isClosed() throws SQLExceptionこのConnectionオブジェクトがクローズされているかどうかを取得します。 接続は、closeメソッドが呼び出されるか、特定の致命的エラーが発生した 合にクローズされます。 このメソッドは、Connection.closeメソッドが呼び出されたあとに呼び出された 合に けtrueを返すことが保証されています。このメソッドは通常、データベースへの接続が有効か無効かを判定するために呼び出すことはできません。 一般のクライアントでは、操作を実行したときにスローされる例外をキャッチすることにより、接続が無効であると判定します。
- 戻り値:
- この
Connectionオブジェクトがクローズされている 合はtrue、ま オープンの状態の 合はfalse - スロー:
SQLException- データベース・アクセス・エラーが発生した 合
-
getMetaData
DatabaseMetaData getMetaData() throws SQLExceptionこのConnectionオブジェクトが接続を表すデータベースに関するメタデータを 納するDatabaseMetaDataオブジェクトを取得します。 メタデータは、データベースの表、サポートしているSQL文法、ストアド・プロシージャ、およびこの接続の能力などについての情 を含んでいます。- 戻り値:
- この
ConnectionオブジェクトのDatabaseMetaDataオブジェクト - スロー:
SQLException- データベース・アクセス・エラーが発生した 合、またはこのメソッドがクローズされた接続について呼び出された 合
-
setReadOnly
void setReadOnly(boolean readOnly) throws SQLException ドライバがデータベースの最適化を有効にできるように、ヒントとして、この接続を読込み専用モードに設定します。ノート: トランザクションの途中では、このメソッドを呼び出すことはできません。
- パラメータ:
readOnly-trueの 合は読込み専用モードを使用可能にし、falseの 合は使用不可にする- スロー:
SQLException- データベース・アクセス・エラーが発生した 合、このメソッドがクローズされた接続について呼び出された 合、またはこのメソッドがトランザクション中に呼び出された 合
-
isReadOnly
boolean isReadOnly() throws SQLExceptionこのConnectionオブジェクトが読込み専用モードかどうかを取得します。- 戻り値:
- この
Connectionオブジェクトが読込み専用モードの 合はtrue、そうでない 合はfalse - スロー:
SQLException- データベース・アクセス・エラーが発生した 合、またはこのメソッドがクローズされた接続について呼び出された 合
-
setCatalog
void setCatalog(String catalog) throws SQLException このConnectionオブジェクトのデータベースに作業のためのサブスペースを選択するために、カタログ名を設定します。ドライバがカタログをサポートしていない 合は、この要求を無視します。
setCatalogの呼出しは、前に作成または準備されたStatementオブジェクトには影響を与えません。ConnectionメソッドprepareStatementまたはprepareCallが呼び出されたときにDBMS準備操作がた ちに実行されるかどうかは、実装で定義されます。 移植性を最大限にするには、Statementの作成または準備の前にsetCatalogを呼び出す必要があります。- パラメータ:
catalog- 作業のためのカタログ名。カタログは、このConnectionオブジェクトのデータベースのサブスペース- スロー:
SQLException- データベース・アクセス・エラーが発生した 合、またはこのメソッドがクローズされた接続について呼び出された 合- 関連 目:
-
getCatalog
String getCatalog() throws SQLExceptionこのConnectionオブジェクトの現在のカタログ名を取得します。- 戻り値:
- 現在のカタログ名。存在しない 合は
null - スロー:
SQLException- データベース・アクセス・エラーが発生した 合、またはこのメソッドがクローズされた接続について呼び出された 合- 関連 目:
-
setTransactionIsolation
void setTransactionIsolation(int level) throws SQLException このConnectionオブジェクトのトランザクション遮断レベルを指定されたものに変更することを試みます。 指定できるトランザクション遮断レベルの定数は、Connectionインタフェースで定義されています。ノート: トランザクションの途中でこのメソッドが呼び出されると、その結果は実装で定義されたものになります。
- パラメータ:
level- 次のConnection定数。Connection.TRANSACTION_READ_UNCOMMITTED、Connection.TRANSACTION_READ_COMMITTED、Connection.TRANSACTION_REPEATABLE_READ、またはConnection.TRANSACTION_SERIALIZABLEのいずれかです。Connection.TRANSACTION_NONEはトランザクションがサポートされていないことを指定するので使用できない。- スロー:
SQLException- データベース・アクセス・エラーが発生した 合、このメソッドがクローズされた接続に対して呼び出された 合、または指定されたパラメータがConnection定数のどれでもない 合- 関連 目:
-
getTransactionIsolation
int getTransactionIsolation() throws SQLExceptionこのConnectionオブジェクトの現在のトランザクション遮断レベルを取得します。- 戻り値:
- 現在のトランザクション遮断レベル。次の定数のうちの1つ。
Connection.TRANSACTION_READ_UNCOMMITTED、Connection.TRANSACTION_READ_COMMITTED、Connection.TRANSACTION_REPEATABLE_READ、Connection.TRANSACTION_SERIALIZABLE、またはConnection.TRANSACTION_NONE。 - スロー:
SQLException- データベース・アクセス・エラーが発生した 合、またはこのメソッドがクローズされた接続について呼び出された 合- 関連 目:
-
getWarnings
SQLWarning getWarnings() throws SQLExceptionこのConnectionオブジェクトに関する呼出しによって 告される最初の警告を取得します。 2つ以上の警告がある 合、後続の警告は最初の警告にチェーンされ、直前に取得された警告のSQLWarning.getNextWarningメソッドを呼び出すことによって取得されます。このメソッドはクローズされた接続の呼出しには使用しません。使用すると
SQLExceptionがスローされます。ノート: 後続の警告は、このSQLWarningにチェーンされます。
- 戻り値:
- 最初の
SQLWarningオブジェクト。ない 合はnull - スロー:
SQLException- データベース・アクセス・エラーが発生した 合、またはこのメソッドがクローズされた接続について呼び出された 合- 関連 目:
-
clearWarnings
void clearWarnings() throws SQLExceptionこのConnectionオブジェクトに関して 告されたすべての警告をクリアします。 このメソッドを呼び出したあと、このConnectionオブジェクトに対する新しい警告が通知されるまで、getWarningsはnullを返します。- スロー:
SQLException- データベース・アクセス・エラーが発生した 合、またはこのメソッドがクローズされた接続について呼び出された 合
-
createStatement
指定された型と並行処理でResultSetオブジェクトを生成するStatementオブジェクトを生成します。 このメソッドは上記のcreateStatementメソッドと同じですが、デフォルトの結果セットの型および並行処理をオーバーライドできます。 作成された結果セットの保持機能は、getHoldability()を呼び出すことで判断できます。- パラメータ:
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定数でない 合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない 合、またはこのメソッドが指定された結果セットのタイプと結果セットの並行処理でサポートされない 合- 導入されたバージョン:
- 1.2
-
prepareStatement
PreparedStatement prepareStatement( String sql, int resultSetType, int resultSetConcurrency) throws SQLException指定された型と並行処理でResultSetオブジェクトを生成するPreparedStatementオブジェクトを生成します。 このメソッドは上記のprepareStatementメソッドと同じですが、デフォルトの結果セットの型および並行処理をオーバーライドできます。 作成された結果セットの保持機能は、getHoldability()を呼び出すことで判断できます。- パラメータ:
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- 戻り値:
- プリコンパイルされたSQL文を含む新しいPreparedStatementオブジェクト。指定された型および並行処理で
ResultSetオブジェクトを生成する - スロー:
SQLException- データベース・アクセス・エラーが発生した 合、このメソッドがクローズされた接続に対して呼び出された 合、または指定されたパラメータが型および並行処理を示すResultSet定数でない 合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない 合、またはこのメソッドが指定された結果セットのタイプと結果セットの並行処理でサポートされない 合- 導入されたバージョン:
- 1.2
-
prepareCall
CallableStatement prepareCall( String sql, int resultSetType, int resultSetConcurrency) throws SQLException指定された型と並行処理でResultSetオブジェクトを生成するCallableStatementオブジェクトを生成します。 このメソッドは上記のprepareCallメソッドと同じですが、デフォルトの結果セットの型および並行処理をオーバーライドできます。 作成された結果セットの保持機能は、getHoldability()を呼び出すことで判断できます。- パラメータ:
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- 戻り値:
- プリコンパイルされたSQL文を含む新しい
CallableStatementオブジェクト。指定された型および並行処理でResultSetオブジェクトを生成する - スロー:
SQLException- データベース・アクセス・エラーが発生した 合、このメソッドがクローズされた接続に対して呼び出された 合、または指定されたパラメータが型および並行処理を示すResultSet定数でない 合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない 合、またはこのメソッドが指定された結果セットのタイプと結果セットの並行処理でサポートされない 合- 導入されたバージョン:
- 1.2
-
getTypeMap
Map<String,Class<?>> getTypeMap() throws SQLExceptionこのConnectionオブジェクトに関連付けられたMapオブジェクトを取得します。 アプリケーションがエントリを追 していないかぎり、空のマップが返されます。JDBCドライバは、
setTypeMapに渡されたMapオブジェクトの内部コピーを作成することがあるため、getTypeMapから返されたMapオブジェクトの変更後、setTypeMapを呼び出す必要があります。Map<String,Class<?>> myMap = con.getTypeMap(); myMap.put("mySchemaName.ATHLETES", Athletes.class); con.setTypeMap(myMap);- 戻り値:
- この
Connectionオブジェクトに関連付けられたjava.util.Mapオブジェクト - スロー:
SQLException- データベース・アクセス・エラーが発生した 合、またはこのメソッドがクローズされた接続について呼び出された 合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない 合- 導入されたバージョン:
- 1.2
- 関連 目:
-
setTypeMap
void setTypeMap(Map<String, Class<?>> map) throws SQLExceptionこのConnectionオブジェクトの型マップとして、指定されたTypeMapオブジェクトをインストールします。 型マップは、SQL構 化型および個別の型のカスタ ・マッピングに使用されます。JDBCドライバとして
setMapをコールする前に、TypeMapの値を設定する必要があります。これにより、TypeMapの内部コピーが作成される 合があります:Map myMap<String,Class<?>> = new HashMap<String,Class<?>>(); myMap.put("mySchemaName.ATHLETES", Athletes.class); con.setTypeMap(myMap);- パラメータ:
map- このConnectionオブジェクトのデフォルトの型マップの代わりとしてインストールするjava.util.Mapオブジェクト- スロー:
SQLException- データベース・アクセス・エラーが発生した 合、このメソッドがクローズされた接続に対して呼び出された 合、または指定されたパラメータがjava.util.Mapオブジェクトではない 合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない 合- 導入されたバージョン:
- 1.2
- 関連 目:
-
setHoldability
void setHoldability(int holdability) throws SQLException このConnectionオブジェクトを使用して生成されたResultSetオブジェクトのデフォルトの保持機能を指定された保持機能へ変更します。ResultSetオブジェクトのデフォルトの保持可能性は、DatabaseMetaData.getResultSetHoldability()を呼び出すことによって判断できます。- パラメータ:
holdability-ResultSet保持機能定数。ResultSet.HOLD_CURSORS_OVER_COMMITまたはResultSet.CLOSE_CURSORS_AT_COMMIT- スロー:
SQLException- データベース・アクセス・エラーが発生した 合、このメソッドがクローズされた接続に対して呼び出された 合、または指定されたパラメータが保持機能を示すResultSet定数ではない 合SQLFeatureNotSupportedException- 指定された保持機能がサポートされていない 合- 導入されたバージョン:
- 1.4
- 関連 目:
-
getHoldability
int getHoldability() throws SQLExceptionこのConnectionオブジェクトを使用して生成されたResultSetオブジェクトの現在の保持機能を取得します。- 戻り値:
- 保持機能。
ResultSet.HOLD_CURSORS_OVER_COMMITまたはResultSet.CLOSE_CURSORS_AT_COMMIT - スロー:
SQLException- データベース・アクセス・エラーが発生した 合、またはこのメソッドがクローズされた接続について呼び出された 合- 導入されたバージョン:
- 1.4
- 関連 目:
-
setSavepoint
Savepoint setSavepoint() throws SQLException現在のトランザクションで名前のないセーブポイントを作成し、それを表す新しいSavepointオブジェクトを返します。アクティブなトランザクションの外部でsetSavepointが呼び出されると、この新しく作成されたセーブポイントでトランザクションが開始されます。
- 戻り値:
- 新しい
Savepointオブジェクト - スロー:
SQLException- データベース・アクセス・エラーが発生した 合、分散トランザクションに関係している間にこのメソッドが呼び出された 合、このメソッドがクローズされた接続について呼び出された 合、またはこのConnectionオブジェクトが現在自動コミット・モードである 合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない 合- 導入されたバージョン:
- 1.4
- 関連 目:
-
setSavepoint
Savepoint setSavepoint( String name) throws SQLException現在のトランザクションで指定された名前のセーブポイントを作成し、それを表す新しいSavepointオブジェクトを返します。アクティブなトランザクションの外部でsetSavepointが呼び出されると、この新しく作成されたセーブポイントでトランザクションが開始されます。
- パラメータ:
name- セーブポイントの名前を 納するString- 戻り値:
- 新しい
Savepointオブジェクト - スロー:
SQLException- データベース・アクセス・エラーが発生した 合、分散トランザクションに関係している間にこのメソッドが呼び出された 合、このメソッドがクローズされた接続について呼び出された 合、またはこのConnectionオブジェクトが現在自動コミット・モードである 合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない 合- 導入されたバージョン:
- 1.4
- 関連 目:
-
rollback
void rollback(Savepoint savepoint) throws SQLException 指定されたSavepointオブジェクトが設定されたあとに行われたすべての変更を元に戻します。このメソッドは自動コミットが無効のときに け使用します。
- パラメータ:
savepoint- ロールバックするSavepointオブジェクト- スロー:
SQLException- データベース・アクセス・エラーが発生した 合、分散トランザクションに関係している間にこのメソッドが呼び出された 合、このメソッドがクローズされた接続について呼び出された 合、Savepointオブジェクトが有効でなくなった 合、またはこのConnectionオブジェクトが現在自動コミット・モードである 合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない 合- 導入されたバージョン:
- 1.4
- 関連 目:
-
releaseSavepoint
void releaseSavepoint(Savepoint savepoint) throws SQLException 現在のトランザクションから指定されたSavepointオブジェクトと以降のSavepointオブジェクトを削除します。 削除されたあとでセーブポイントを参照するとSQLExceptionがスローされます。- パラメータ:
savepoint- 削除するSavepointオブジェクト- スロー:
SQLException- データベース・アクセス・エラーが発生した 合、このメソッドがクローズされた接続に対して呼び出された 合、または指定されたSavepointオブジェクトが現在のトランザクションで有効なセーブポイントでない 合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない 合- 導入されたバージョン:
- 1.4
-
createStatement
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_UPDATABLEresultSetHoldability-ResultSet定数。ResultSet.HOLD_CURSORS_OVER_COMMITまたはResultSet.CLOSE_CURSORS_AT_COMMIT- 戻り値:
- 指定された型、並行処理、および保持機能で
ResultSetオブジェクトを生成する新しいStatementオブジェクト - スロー:
SQLException- データベース・アクセス・エラーが発生した 合、このメソッドがクローズされた接続に対して呼び出された 合、または指定されたパラメータが型、並行処理、および保持機能を示すResultSet定数でない 合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない 合、またはこのメソッドが指定された結果セットの型、結果セットの保持機能、および結果セットの並行処理でサポートされない 合- 導入されたバージョン:
- 1.4
- 関連 目:
-
prepareStatement
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_UPDATABLEresultSetHoldability-ResultSet定数。ResultSet.HOLD_CURSORS_OVER_COMMITまたはResultSet.CLOSE_CURSORS_AT_COMMIT- 戻り値:
- プリコンパイルされたSQL文を含む新しい
PreparedStatementオブジェクト。指定された型、並行処理、および保持機能でResultSetオブジェクトを生成する - スロー:
SQLException- データベース・アクセス・エラーが発生した 合、このメソッドがクローズされた接続に対して呼び出された 合、または指定されたパラメータが型、並行処理、および保持機能を示すResultSet定数でない 合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない 合、またはこのメソッドが指定された結果セットの型、結果セットの保持機能、および結果セットの並行処理でサポートされない 合- 導入されたバージョン:
- 1.4
- 関連 目:
-
prepareCall
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_UPDATABLEresultSetHoldability-ResultSet定数。ResultSet.HOLD_CURSORS_OVER_COMMITまたはResultSet.CLOSE_CURSORS_AT_COMMIT- 戻り値:
- プリコンパイルされたSQL文を含む新しい
CallableStatementオブジェクト。指定された型、並行処理、および保持機能でResultSetオブジェクトを生成する - スロー:
SQLException- データベース・アクセス・エラーが発生した 合、このメソッドがクローズされた接続に対して呼び出された 合、または指定されたパラメータが型、並行処理、および保持機能を示すResultSet定数でない 合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない 合、またはこのメソッドが指定された結果セットの型、結果セットの保持機能、および結果セットの並行処理でサポートされない 合- 導入されたバージョン:
- 1.4
- 関連 目:
-
prepareStatement
PreparedStatement prepareStatement( String sql, int autoGeneratedKeys) throws SQLException自動生成キーを取得する機能を持つデフォルトのPreparedStatementオブジェクトを生成します。 指定された定数によって、ドライバが自動生成キーを取得可能にするかどうかが指定されます。 SQL文がINSERT文でない 合、または自動生成キーを返すことができるSQL文でない 合、このパラメータは無視されます。このような文のリストはベンダー固有です。ノート: このメソッドは、プリコンパイルが効果のある、パラメータ付きSQL文を処理するために最適化されています。 ドライバが、プリコンパイルをサポートしている 合、
prepareStatementメソッドは、その文をプリコンパイル用としてデータベースに送ります。 ドライバによっては、プリコンパイルをサポートしていないものがあります。 この 合、PreparedStatementオブジェクトが実行されるまで、文はデータベースに送られません。 これはユーザーに直接的な影響はありませんが、どのメソッドが特定のSQLExceptionをスローするかに関して影響があります。返される
PreparedStatementオブジェクトを使って作成された結果セットは、デフォルトでは、TYPE_FORWARD_ONLYの型で、CONCUR_READ_ONLYの並行処理レベルを持ちます。 作成された結果セットの保持機能は、getHoldability()を呼び出すことで判断できます。- パラメータ:
sql- 1つ以上の'?'を含めることができるSQL文 INパラメータ・プレースホルダーautoGeneratedKeys- 自動生成キーを返すかどうかを示すフラグ。Statement.RETURN_GENERATED_KEYSまたはStatement.NO_GENERATED_KEYS- 戻り値:
- プリコンパイルされたSQL文を含む新しい
PreparedStatementオブジェクト。自動生成キーを返す機能を持つ - スロー:
SQLException- データベース・アクセス・エラーが発生した 合、このメソッドがクローズされた接続に対して呼び出された 合、または指定されたパラメータが自動生成キーを返すかどうかを示すStatement定数でない 合SQLFeatureNotSupportedException- JDBCドライバが定数Statement.RETURN_GENERATED_KEYSを指定したこのメソッドをサポートしない 合- 導入されたバージョン:
- 1.4
-
prepareStatement
PreparedStatement prepareStatement( String sql, int[] columnIndexes) throws SQLException指定された配列によって指定された自動生成キーを返す機能を持つデフォルトのPreparedStatementオブジェクトを生成します。 この配列は検索可能にされる自動生成キーを含むターゲット表の列のインデックスを含みます。 SQL文がINSERT文でない 合、または自動生成キーを返すことができるSQL文でない 合(そのような文のリストはベンダー固有)、ドライバはこの配列を無視します。INパラメータ付きまたはINパラメータなしのSQL文は、プリコンパイルして、
PreparedStatementオブジェクトに 納できます。 その後、このオブジェクトは、この文を複数回効率的に実行するために使用できます。ノート: このメソッドは、プリコンパイルが効果のある、パラメータ付きSQL文を処理するために最適化されています。 ドライバが、プリコンパイルをサポートしている 合、
prepareStatementメソッドは、その文をプリコンパイル用としてデータベースに送ります。 ドライバによっては、プリコンパイルをサポートしていないものがあります。 この 合、PreparedStatementオブジェクトが実行されるまで、文はデータベースに送られません。 これはユーザーに直接的な影響はありませんが、どのメソッドが特定のSQLExceptionをスローするかに関して影響があります。返される
PreparedStatementオブジェクトを使って作成された結果セットは、デフォルトでは、TYPE_FORWARD_ONLYの型で、CONCUR_READ_ONLYの並行処理レベルを持ちます。 作成された結果セットの保持機能は、getHoldability()を呼び出すことで判断できます。- パラメータ:
sql- 1つ以上の'?'を含めることができるSQL文 INパラメータ・プレースホルダーcolumnIndexes- 挿入された行から返される列を示す列インデックスの配列- 戻り値:
- プリコンパイルされた文を含む新しい
PreparedStatementオブジェクト。指定された列インデックスの配列によって指定される自動生成キーを返す機能を持つ - スロー:
SQLException- データベース・アクセス・エラーが発生した 合、またはこのメソッドがクローズされた接続について呼び出された 合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない 合- 導入されたバージョン:
- 1.4
-
prepareStatement
PreparedStatement prepareStatement( String sql, String[] columnNames) throws SQLException指定された配列によって指定された自動生成キーを返す機能を持つデフォルトのPreparedStatementオブジェクトを生成します。 この配列は、返される自動生成キーを含むターゲット表の列の名前を含みます。 SQL文がINSERT文でない 合、または自動生成キーを返すことができるSQL文でない 合(そのような文のリストはベンダー固有)、ドライバはこの配列を無視します。INパラメータ付きまたはINパラメータなしのSQL文は、プリコンパイルして、
PreparedStatementオブジェクトに 納できます。 その後、このオブジェクトは、この文を複数回効率的に実行するために使用できます。ノート: このメソッドは、プリコンパイルが効果のある、パラメータ付きSQL文を処理するために最適化されています。 ドライバが、プリコンパイルをサポートしている 合、
prepareStatementメソッドは、その文をプリコンパイル用としてデータベースに送ります。 ドライバによっては、プリコンパイルをサポートしていないものがあります。 この 合、PreparedStatementオブジェクトが実行されるまで、文はデータベースに送られません。 これはユーザーに直接的な影響はありませんが、どのメソッドが特定のSQLExceptionをスローするかに関して影響があります。返される
PreparedStatementオブジェクトを使って作成された結果セットは、デフォルトでは、TYPE_FORWARD_ONLYの型で、CONCUR_READ_ONLYの並行処理レベルを持ちます。 作成された結果セットの保持機能は、getHoldability()を呼び出すことで判断できます。- パラメータ:
sql- 1つ以上の'?'を含めることができるSQL文 INパラメータ・プレースホルダーcolumnNames- 挿入された行から返される列を示す列名の配列- 戻り値:
- プリコンパイルされた文を含む新しい
PreparedStatementオブジェクト。指定された列名の配列によって指定される自動生成キーを返す機能を持つ - スロー:
SQLException- データベース・アクセス・エラーが発生した 合、またはこのメソッドがクローズされた接続について呼び出された 合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない 合- 導入されたバージョン:
- 1.4
-
createClob
Clob createClob() throws SQLExceptionClobインタフェースを実装しているオブジェクトを構築します。 返されるオブジェクトは、初期状態ではデータが 納されていません。 データをClobに追 するには、ClobインタフェースのsetAsciiStream、setCharacterStream、setStringの各メソッドを使用できます。- 戻り値:
Clobインタフェースを実装しているオブジェクト- スロー:
SQLException-Clobインタフェースを実装するオブジェクトを構築できなかった 合、このメソッドがクローズされた接続に対して呼び出された 合、またはデータベース・アクセス・エラーが発生した 合SQLFeatureNotSupportedException- JDBCドライバがこのデータ型をサポートしない 合- 導入されたバージョン:
- 1.6
-
createBlob
Blob createBlob() throws SQLExceptionBlobインタフェースを実装しているオブジェクトを構築します。 返されるオブジェクトは、初期状態ではデータが 納されていません。 データをBlobに追 するには、BlobインタフェースのsetBinaryStreamおよびsetBytesメソッドを使用できます。- 戻り値:
Blobインタフェースを実装しているオブジェクト- スロー:
SQLException-Blobインタフェースを実装するオブジェクトを構築できなかった 合、このメソッドがクローズされた接続に対して呼び出された 合、またはデータベース・アクセス・エラーが発生した 合SQLFeatureNotSupportedException- JDBCドライバがこのデータ型をサポートしない 合- 導入されたバージョン:
- 1.6
-
createNClob
NClob createNClob() throws SQLExceptionNClobインタフェースを実装しているオブジェクトを構築します。 返されるオブジェクトは、初期状態ではデータが 納されていません。 データをNClobに追 するには、NClobインタフェースのsetAsciiStream、setCharacterStream、setStringの各メソッドを使用できます。- 戻り値:
NClobインタフェースを実装しているオブジェクト- スロー:
SQLException-NClobインタフェースを実装するオブジェクトを構築できなかった 合、このメソッドがクローズされた接続に対して呼び出された 合、またはデータベース・アクセス・エラーが発生した 合SQLFeatureNotSupportedException- JDBCドライバがこのデータ型をサポートしない 合- 導入されたバージョン:
- 1.6
-
createSQLXML
SQLXML createSQLXML() throws SQLExceptionSQLXMLインタフェースを実装しているオブジェクトを構築します。 返されるオブジェクトは、初期状態ではデータが 納されていません。 データをSQLXMLオブジェクトに追 するには、SQLXMLインタフェースのcreateXmlStreamWriterオブジェクトとsetStringメソッドを使用できます。- 戻り値:
SQLXMLインタフェースを実装しているオブジェクト- スロー:
SQLException-SQLXMLインタフェースを実装するオブジェクトを構築できなかった 合、このメソッドがクローズされた接続に対して呼び出された 合、またはデータベース・アクセス・エラーが発生した 合SQLFeatureNotSupportedException- JDBCドライバがこのデータ型をサポートしない 合- 導入されたバージョン:
- 1.6
-
isValid
boolean isValid(int timeout) throws SQLException 接続がクローズされておらず、ま 有効である 合は、trueを返します。 ドライバは、接続に対するクエリーを送信するか、またはこのメソッドが呼び出されるときに接続がま 有効であることを明確に検証するその他のメカニズ を使用します。接続を検証するためにドライバによって送信されるクエリーは、現在のトランザクションのコンテキストで実行されます。
- パラメータ:
timeout- 接続の検証に使用されるデータベース操作が完了するまで待機する時間(秒)。 操作の完了前にタイ アウト期間が経過すると、このメソッドはfalseを返します。 値0は、タイ ・アウトがこのデータベース操作に適用されないことを示す- 戻り値:
- 接続が有効な 合はtrue、そうでない 合はfalse
- スロー:
SQLException-timeoutに指定された値が0より小さい 合- 導入されたバージョン:
- 1.6
- 関連 目:
-
setClientInfo
void setClientInfo(String name, String value) throws SQLClientInfoException 名前で指定されたクライアント情 プロパティの値を、値で指定された値に設定します。アプリケーションでは、ドライバでサポートされるクライアント情 プロパティ、および各プロパティに指定できる最大長を判断するために、
DatabaseMetaData.getClientInfoPropertiesメソッドを使用できます。ドライバは、指定された値をデータベース内の適切な 所に 納します。 たとえば、特殊なレジスタ、セッション・パラメータ、システ 表の列などです。 効率性の観点から、次に文が実行または準備されるまで、ドライバはデータベースへの値の設定を保留することがあります。 クライアント情 をデータベース内の適切な 所に 納すること以外に、これらのメソッドが接続の動作を変更することはありません。 これらのメソッドに指定された値は、検討、診断、およびデバッグの目的のみに使用されます。
指定されたクライアント情 名がドライバで認識されない 合、ドライバは警告を生成します。
このメソッドに指定された値がプロパティの最大長よりも長い 合、ドライバは値を切詰め、警告を生成するか、または
SQLClientInfoExceptionを生成する 合があります。 ドライバがSQLClientInfoExceptionを生成した 合、指定された値は接続に設定されていません。標準のクライアント情 プロパティを次に示します。 ドライバでこれらのプロパティをサポートする必要はありませんが、いずれかの標準プロパティによって記述できるクライアント情 プロパティをサポートしている 合は、その標準プロパティ名を使用するようにしてく さい。
- ApplicationName - 現在接続を利用しているアプリケーションの名前
- ClientUser - 接続を使用しているアプリケーションが実行している処理のユーザーの名前。 接続を確立するために使用されたユーザー名と同じにならない 合があります。
- ClientHostname - 接続を使用しているアプリケーションが実行されているコンピュータのホスト名
- パラメータ:
name- 設定するクライアント情 プロパティの名前value- クライアント情 プロパティに設定する値。 値がnullの 合、指定されたプロパティの現在の値がクリアされる- スロー:
SQLClientInfoException- データベース・サーバーでクライアント情 値の設定中にデータベース・サーバーがエラーを返した 合、またはこのメソッドがクローズされた接続について呼び出された 合- 導入されたバージョン:
- 1.6
-
setClientInfo
void setClientInfo(Properties properties) throws SQLClientInfoException 接続のクライアント情 プロパティの値を設定します。Propertiesオブジェクトには、設定されるクライアント情 プロパティの名前と値が 納されています。 プロパティ・リストに含まれるクライアント情 プロパティのセットによって、接続のクライアント情 プロパティの現在のセットが置き換えられます。 現在接続で設定されているプロパティがプロパティ・リストに存在しない 合、そのプロパティはクリアされます。 空のプロパティ・リストを指定すると、接続のすべてのプロパティがクリアされます。 詳細は、setClientInfo (String, String)を参照してく さい。いずれかのクライアント情 プロパティの設定時にエラーが発生した 合、
SQLClientInfoExceptionがスローされます。SQLClientInfoExceptionには、設定されなかったクライアント情 プロパティを示す情 が 納されています。 一部のデータベースでは、複数のクライアント情 プロパティを原子的に設定することが許可されないため、クライアント情 の状態は不明です。 そのようなデータベースでは、エラーが起きる前に1つ以上のプロパティが設定された可能性があります。- パラメータ:
properties- 設定するクライアント情 プロパティのリスト- スロー:
SQLClientInfoException- データベース・サーバーでクライアント情 値の設定中にデータベース・サーバーがエラーを返した 合、またはこのメソッドがクローズされた接続について呼び出された 合- 導入されたバージョン:
- 1.6
- 関連 目:
-
getClientInfo
String getClientInfo( String name) throws SQLException名前で指定されたをクライアント情 プロパティの値を返します。 指定されたクライアント情 プロパティが設定されていなくて、かつデフォルト値がない 合、このメソッドはnullを返すことがあります。 また、指定されたクライアント情 プロパティ名がドライバでサポートされていない 合もnullを返します。アプリケーションでは、ドライバでサポートされるクライアント情 プロパティを判断するために、
DatabaseMetaData.getClientInfoPropertiesメソッドを使用できます。- パラメータ:
name- 取得するクライアント情 プロパティの名前- 戻り値:
- 指定されたクライアント情 プロパティの値
- スロー:
SQLException- データベースからクライアント情 値のフェッチ中にデータベース・サーバーがエラーを返した 合、またはこのメソッドがクローズされた接続について呼び出された 合- 導入されたバージョン:
- 1.6
- 関連 目:
-
getClientInfo
Properties getClientInfo() throws SQLExceptionドライバでサポートされる各クライアント情 プロパティの名前と現在の値が含まれるリストを返します。 クライアント情 プロパティが設定されていなくて、かつデフォルト値がない 合、このプロパティの値はnullになることがあります。- 戻り値:
- ドライバでサポートされる各クライアント情 プロパティの名前と現在の値が含まれる
Propertiesオブジェクト。 - スロー:
SQLException- データベースからクライアント情 値のフェッチ中にデータベース・サーバーがエラーを返した 合、またはこのメソッドがクローズされた接続について呼び出された 合- 導入されたバージョン:
- 1.6
-
createArrayOf
Array createArrayOf( String typeName, Object[] elements) throws SQLExceptionArrayオブジェクトを生成するファクトリ・メソッドです。ノート:
createArrayOfを使用して、プリミティブ・データ型にマッピングする配列オブジェクトを生成する 合、Arrayオブジェクトがそのプリミティブ・データ型の配列とObjectの配列のどちらであるかは実装で定義されます。ノート: JDBCドライバは、
Object配列の要 を、Objectの指定されたクラスについてjava.sql.Typesで定義されたデフォルトのJDBC SQL型にマッピングします。 デフォルトのマッピングは、JDBC仕様の付録Bで指定されています。 結果として得られるJDBC型が指定されたtypeNameに適した型ではない 合、SQLExceptionがスローされるか、それともドライバが結果として得られる変換をサポートするかについては、実装で定義されています。- パラメータ:
typeName- 配列の要 がマッピングされる型のSQL名。 typeNameはデータベース固有の名前で、組込み型、ユーザー定義型、またはこのデータベースでサポートされる標準SQL型の名前のこと。 これは、Array.getBaseTypeNameで返される値elements- 返されるオブジェクトを生成する要- 戻り値:
- 指定されたSQL型に要 がマッピングされるArrayオブジェクト
- スロー:
SQLException- データベース・エラーが発生した 合、JDBC型がtypeNameに適しておらず、かつ変換がサポートされていない 合、typeNameがnullの 合、またはこのメソッドがクローズされた接続に対して呼び出された 合SQLFeatureNotSupportedException- JDBCドライバがこのデータ型をサポートしない 合- 導入されたバージョン:
- 1.6
-
createStruct
Struct createStruct( String typeName, Object[] attributes) throws SQLExceptionStructオブジェクトを生成するファクトリ・メソッドです。- パラメータ:
typeName- このStructオブジェクトがマッピングされるSQL構 化型のSQL型名。 typeNameは、このデータベースに定義されたユーザー定義型の名前。 これは、Struct.getSQLTypeNameで返される値。attributes- 返されるオブジェクトを生成する属性- 戻り値:
- 指定されたSQL型にマッピングされ、かつ指定された属性で生成されるStructオブジェクト
- スロー:
SQLException- データベース・エラーが発生した 合、typeNameがnullの 合、またはこのメソッドがクローズされた接続について呼び出された 合SQLFeatureNotSupportedException- JDBCドライバがこのデータ型をサポートしない 合- 導入されたバージョン:
- 1.6
-
setSchema
void setSchema(String schema) throws SQLException アクセスするスキーマ名を設定します。ドライバがスキーマをサポートしていない 合は、この要求を無視します。
setSchemaの呼出しは、前に作成または準備されたStatementオブジェクトには影響を与えません。ConnectionメソッドprepareStatementまたはprepareCallが呼び出されたときにDBMS準備操作がた ちに実行されるかどうかは、実装で定義されます。 移植性を最大限にするには、Statementの作成または準備の前にsetSchemaを呼び出す必要があります。- パラメータ:
schema- 作業のためのスキーマ名- スロー:
SQLException- データベース・アクセス・エラーが発生した 合、またはこのメソッドがクローズされた接続について呼び出された 合- 導入されたバージョン:
- 1.7
- 関連 目:
-
getSchema
String getSchema() throws SQLExceptionこのConnectionオブジェクトの現在のスキーマ名を取得します。- 戻り値:
- 現在のスキーマ名。存在しない 合は
null - スロー:
SQLException- データベース・アクセス・エラーが発生した 合、またはこのメソッドがクローズされた接続について呼び出された 合- 導入されたバージョン:
- 1.7
- 関連 目:
-
abort
void abort(Executor executor) throws SQLException オープン接続を終了します。abort呼出しの結果は次のとおりです。- 接続がクローズとマークされる
- データベースへのすべての物理接続をクローズする
- 接続によって使用されているリソースを解放する
- 現在接続にアクセスしているすべてのスレッドを続行して完了させるか、
SQLExceptionをスローさせる。
abortを呼び出すと、接続がクローズとマークされ、すべてのリソースが解放されます。 クローズしている接続に対してabortを呼び出しても何も操作を行いません。接続によって保持されているリソースの中止と解放には、かなりの時間がかかることがあります。
abortメソッドから戻ったときに、接続はクローズとマークされますが、パラメータとしてabortに渡されたExecutorは引き続きタスクを実行し、リソースを解放している 合があります。- パラメータ:
executor-abortで使用されるExecutor実装。- スロー:
SQLException- データベース・アクセス・エラーが発生した 合、またはexecutorがnullの 合- 導入されたバージョン:
- 1.7
- 関連 目:
-
setNetworkTimeout
void setNetworkTimeout(Executor executor, int milliseconds) throws SQLException ConnectionまたはConnectionから作成されたオブジェクトが、データベースが任意の1つの要求に応答するのを待つ最大期間を設定します。 いずれかの要求が応答されないままの 合、待機中のメソッドがSQLExceptionで戻り、ConnectionまたはConnectionから作成されたオブジェクトがクローズとマークされます。 その後のオブジェクトの使用は、close、isClosed、またはConnection.isValidメソッドを除いて、SQLExceptionになります。ノート: このメソッドは、ネットワーク・パーティションがソケット読取りでOS TCP-TIMEOUT (一般に10分)までJDBC呼出しを発行するスレッドを絶えずハング・アップさせる、めったにないが深刻な状況に対処するためのものです。 このメソッドは、JDBC接続が管理者スレッドにアクセスできる 合に、管理者スレッドに、そのようなスレッドを解放する手段を提供する
abort()メソッドに関連しています。setNetworkTimeoutメソッドは、管理者スレッドがない 合や、接続にアクセスできない状況に対処します。 このメソッドは、その効果が重大であるため、トランザクション・タイ アウトなどの通常のタイ ・アウトの前にトリガーされないように、十分に大きな値を指定してく さい。JDBCドライバの実装では、ネットワークが存在しない環境で、
setNetworkTimeoutメソッドをサポートし、データベース応答時間に制限を課すことを選択することもできます。ドライバは、複数のドライバとデータベース間の内部伝送によって、それらのAPI呼出しの一部またはすべてを内部で実装できますが、API呼び出しへの応答またはAPI呼出し時に行われた個々の要求に対し、常に制限を適用するかどうかの決定は、ドライバの実装に任されています。
このメソッドはJDBCコードの 域に制限を設定し、この 域から出るときに、デフォルトにリセットするなど、複数回呼び出すことができます。 このメソッドの呼出しは、未処理の要求には無効です。
Statement.setQueryTimeout()タイ ・アウト値は、setNetworkTimeoutに指定されているタイ ・アウト値から独立しています。 ネットワークのタイ ・アウトの前に、クエリーのタイ ・アウトが期限切れになると、文の実行が取り消されます。 ネットワークがま アクティブな 合、文と接続の両方が使用可能なままになります。 た し、クエリーのタイ ・アウトの前にネットワークのタイ ・アウトが期限切れになるか、ネットワークの問題のために、文のタイ ・アウトが失敗した 合、接続はクローズとマークされ、接続によって保持されているすべてのリソースが解放されて、接続と文の両方が使用不可になります。ドライバが
setNetworkTimeoutタイ ・アウト値が期限切れになったと判断すると、JDBCドライバは接続をクローズとマークして、接続によって保持されているすべてのリソースを解放します。- パラメータ:
executor-setNetworkTimeoutで使用されるExecutor実装。milliseconds- データベース操作の完了を待機する時間(ミリ秒)。 JDBCドライバがミリ秒をサポートしていない 合、秒単位に丸められる。 操作の完了前にタイ ・アウト期間が過ぎると、SQLExceptionがスローされる。 0の値はデータベース操作にタイ ・アウトがないことを示す。- スロー:
SQLException- データベース・アクセス・エラーが発生した 合、このメソッドがクローズされた接続に対して呼び出された 合、executorがnullである 合、またはsecondsに指定された値が0未満の 合。SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない 合- 導入されたバージョン:
- 1.7
- 関連 目:
-
getNetworkTimeout
int getNetworkTimeout() throws SQLExceptionドライバがデータベース要求の完了を待つミリ秒数を取得します。 この制限を超えると、SQLExceptionがスローされます。- 戻り値:
- 現在のタイ ・アウト制限(秒単位)。ゼロは制限なしを意味する
- スロー:
SQLException- データベース・アクセス・エラーが発生した 合、またはこのメソッドがクローズされたConnectionについて呼び出された 合SQLFeatureNotSupportedException- JDBCドライバがこのメソッドをサポートしない 合- 導入されたバージョン:
- 1.7
- 関連 目:
-
beginRequest
default void beginRequest() throws SQLExceptionリクエスト(独立した作業単位)がこの接続から始まっていることを示す、ドライバへのヒント。 各リクエストは、クライアントまたはサーバー上の接続に対してローカルな状態に関して、他のすべてのリクエストから独立しています。beginRequestとendRequestのペア間で実行された作業は、別のリクエストの一部として、またはリクエストの外部で接続に対して実行された他の作業に依存しません。 リクエストには複数のトランザクションが含まれる 合があります。 接続に対してローカルではないため、コミットされたデータベースの状態に依存関係がある可能性があります。ローカル状態は、クライアントまたは透過的に再現できないデータベースのいずれかに、現在の接続にローカルな接続に関連付けられた状態として定義されます。
beginRequestおよびendRequestへのコールはネストされません。endRequestの呼出しが介在しないbeginRequestへの複数の呼出しは、エラーではありません。 最初のbeginRequestコールはリクエストの開始を示し、後続のコールはノー・オペレーションとして扱われますbeginRequestおよびendRequestの使用はオプションであり、ベンダー固有であり、主に透過的であるべきです。 特定の実装では、オープン・トランザクションなどの他の作業への依存を示す条件を検出できます。 アクティブなトランザクションがあり、beginRequestがコールされる 合は、実装でSQLExceptionをスローする必要はありませんが、推奨されます。 これらのメソッドを使用すると、パフォーマンスが向上したり、その他の利点が得られる 合があります。 詳細は、ベンダーのドキュメントを参照してく さい。リクエストの開始時または終了時にオープン・トランザクションがなく、リクエスト境界を越えるローカル状態への依存性がないように、各作業単位を
beginRequest、endRequestペアで囲むことをお薦めします。 コミットされたデータベースの状態がローカルではありません。- APIのノート:
- このメソッドは、接続プーリング・マネージャによって使用されます。
プーリング・マネージャは、接続をコール元に返す前に、基礎となる接続で
beginRequestをコールする必要があります。プーリング・マネージャは、次の 合に
beginRequestを呼び出す必要はありません:- 接続プールは、
PooledConnectionオブジェクトをキャッシュ getConnectionがアプリケーションによって呼び出されたときに論理接続ハンドルを返します。- 論理
Connectionは、PooledConnectionをキャッシュに戻す前にConnection.closeをコールしてクローズされます。
- 接続プールは、
- 実装要件:
- デフォルトの実装はno-opです。
- スロー:
SQLException- エラーが発生した 合- 導入されたバージョン:
- 9
- 関連 目:
-
endRequest
default void endRequest() throws SQLException独立した作業単位であるリクエストが完了したドライバへのヒント。beginRequestおよびendRequestへのコールはネストされません。beginRequestの呼出しが介在しないendRequestへの複数の呼出しは、エラーではありません。 最初のendRequestコールではリクエストが完了し、後続のコールでは操作なしとして扱われます。beginRequestへの初期コールなしでendRequestがコールされた 合、no-opとなります。このメソッドの正確な動作はベンダー固有です。 特定の実装では、オープン・トランザクションなどの他の作業への依存を示す条件を検出できます。 アクティブなトランザクションがあり、
endRequestがコールされる 合は、実装でSQLExceptionをスローする必要はありませんが、推奨されます。- APIのノート:
- このメソッドは、接続プーリング・マネージャによって使用されます。
プーリング・マネージャは、アプリケーションが接続を接続プールに戻すときに、基礎となる接続で
endRequestをコールする必要があります。プーリング・マネージャは、次の 合に
endRequestを呼び出す必要はありません:- 接続プールは、
PooledConnectionオブジェクトをキャッシュ getConnectionがアプリケーションによって呼び出されたときに論理接続ハンドルを返します。- 論理
Connectionは、PooledConnectionをキャッシュに戻す前にConnection.closeをコールしてクローズされます。
- 接続プールは、
- 実装要件:
- デフォルトの実装はno-opです。
- スロー:
SQLException- エラーが発生した 合- 導入されたバージョン:
- 9
- 関連 目:
-
setShardingKeyIfValid
default boolean setShardingKeyIfValid(ShardingKey shardingKey, ShardingKey superShardingKey, int timeout) throws SQLException この接続のシャーディング・キーを設定および検証します。 シャーディング・キーには、null値を指定できます。nullシャーディング・キーの妥当性はベンダー固有です。 詳細は、ベンダーのドキュメントを参照してく さい。- APIのノート:
- このメソッドは、shardingキーが
Connectionに対して有効であることを検証します。 タイ アウト値は、setShardingKeyIfValidがfalseを返す前に、Connectionがシャーディング・キーが有効であることを確認するまでドライバが待機する時間を示します。 - 実装要件:
- デフォルトの実装では、
SQLFeatureNotSupportedExceptionがスローされます。 - パラメータ:
shardingKey- この接続に対して検証されるシャーディング・キー。 シャーディング・キーは、nullsuperShardingKey- この接続に対して検証されるスーパー・シャーディング・キー。 スーパー・シャーディング・キーは、nullであってもよい。timeout- 検証プロセスが完了するまでの時間(秒)。それ以外の 合、検証プロセスは中断されます。 値0は、検証プロセスがタイ アウトしないことを示します。- 戻り値:
- 接続が有効で、シャーディング・キーが有効で、この接続で設定されている 合はtrue。シャーディング・キーが有効でない 合、または操作の完了前にタイ アウト期間が期限切れになる 合はfalse。
- スロー:
SQLException- この検証の実行中にエラーが発生した 合、shardingKeyなしでsuperShardingKeyが指定されます。このメソッドは、閉じられたconnectionでコールされるか、timeout値が になります。SQLFeatureNotSupportedException- 運転手がシャーディングをサポートしていない 合- 導入されたバージョン:
- 9
- 関連 目:
-
setShardingKeyIfValid
default boolean setShardingKeyIfValid(ShardingKey shardingKey, int timeout) throws SQLException この接続のシャーディング・キーを設定および検証します。 シャーディング・キーには、null値を指定できます。nullシャーディング・キーの妥当性はベンダー固有です。 詳細は、ベンダーのドキュメントを参照してく さい。- APIのノート:
- このメソッドは、shardingキーが
Connectionに対して有効であることを検証します。 タイ アウト値は、setShardingKeyIfValidがfalseを返す前に、Connectionがシャーディング・キーが有効であることを確認するまでドライバが待機する時間を示します。 - 実装要件:
- デフォルトの実装では、
SQLFeatureNotSupportedExceptionがスローされます。 - パラメータ:
shardingKey- この接続に対して検証されるシャーディング・キー。 シャーディング・キーは、nulltimeout- 検証プロセスが完了するまでの時間(秒)。検証プロセスは中断されます。 値0は、検証プロセスがタイ アウトしないことを示します。- 戻り値:
- 接続が有効で、この接続にシャーディング・キーを設定できる 合はtrue、シャーディング・キーが有効でない 合、または操作が完了する前にタイ アウト期間が期限切れになる 合はfalse。
- スロー:
SQLException- この検証の実行中にエラーが発生した 合、このメソッドはクローズされたconnectionでコールされるか、またはtimeout値が の値になります。SQLFeatureNotSupportedException- 運転手がシャーディングをサポートしていない 合- 導入されたバージョン:
- 9
- 関連 目:
-
setShardingKey
default void setShardingKey(ShardingKey shardingKey, ShardingKey superShardingKey) throws SQLException このConnectionで使用するshardingKeyおよびsuperShardingKeyを指定- APIのノート:
- このメソッドは、指定されたシャーディング・キーを設定しますが、シャーディング・キーが
Connectionに対して有効であることを検証するためにデータベースへのラウンドトリップは必要ありません。 - 実装要件:
- デフォルトの実装では、
SQLFeatureNotSupportedExceptionがスローされます。 - パラメータ:
shardingKey- この接続に設定するシャーディング・キー。 シャーディング・キーは、nullsuperShardingKey- この接続で設定するスーパー・シャーディング・キー。 スーパー・シャーディング・キーは、null- スロー:
SQLException- シャーディング・キーの設定にエラーが発生した 合。このメソッドは閉じられたconnectionで呼び出されます。またはsuperShardingKeyがshardingKeyなしで指定されているSQLFeatureNotSupportedException- 運転手がシャーディングをサポートしていない 合- 導入されたバージョン:
- 9
- 関連 目:
-
setShardingKey
default void setShardingKey(ShardingKey shardingKey) throws SQLException このConnectionで使用するshardingKeyを指定- APIのノート:
- このメソッドは、指定されたシャーディング・キーを設定しますが、シャーディング・キーが
Connectionに対して有効であることを検証するためにデータベースへのラウンドトリップは必要ありません。 - 実装要件:
- デフォルトの実装では、
SQLFeatureNotSupportedExceptionがスローされます。 - パラメータ:
shardingKey- この接続に設定するシャーディング・キー。 シャーディング・キーは、null- スロー:
SQLException- シャーディング・キーの設定にエラーが発生した 合。またはこのメソッドは閉じられたconnectionで呼び出されますSQLFeatureNotSupportedException- 運転手がシャーディングをサポートしていない 合- 導入されたバージョン:
- 9
- 関連 目:
-