IPooledConnection インターフェイス

定義

[Android.Runtime.Register("javax/sql/PooledConnection", "", "Javax.Sql.IPooledConnectionInvoker")]
public interface IPooledConnection : Android.Runtime.IJavaObject, IDisposable, Java.Interop.IJavaPeerable

[<Android.Runtime.Register("javax/sql/PooledConnection", "", "Javax.Sql.IPooledConnectionInvoker")>]
type IPooledConnection = interface
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable

属性

RegisterAttribute

実装

IJavaObject IJavaPeerable IDisposable

注釈

接続プール管理のフックを提供するオブジェクト。 PooledConnection オブジェクトは、データ ソースへの物理的な接続を表します。 接続は、アプリケーションが終了したときに閉じられるのではなく、リサイクルできるため、作成する必要がある接続の数を減らすことができます。

アプリケーション プログラマは、 PooledConnection インターフェイスを直接使用しません。むしろ、接続のプールを管理する中間層インフラストラクチャによって使用されます。

アプリケーションは、メソッド DataSource.getConnectionを呼び出すと、 Connection オブジェクトを取得します。 接続プーリングが行われている場合、その Connection オブジェクトは、実際には物理接続である PooledConnection オブジェクトへのハンドルです。

接続プール・マネージャー (通常はアプリケーション・サーバー) は、 PooledConnection ・オブジェクトのプールを維持します。 プールに使用可能な PooledConnection オブジェクトがある場合、接続プール マネージャーは、その物理接続へのハンドルである Connection オブジェクトを返します。 使用可能な PooledConnection オブジェクトがない場合、接続プール マネージャーは ConnectionPoolDataSource メソッド getPoolConnection を呼び出して新しい物理接続を作成します。 ConnectionPoolDataSourceを実装する JDBC ドライバーは、新しいPooledConnection オブジェクトを作成し、それにハンドルを返します。

アプリケーションは、接続を閉じると、 Connection メソッド closeを呼び出します。 接続プールが行われている場合、接続プール マネージャーは、ConnectionEventListenerメソッド ConnectionPoolを使用して自身をaddConnectionEventListener オブジェクトとして登録しているため、通知を受け取ります。 接続プール マネージャーは、 PooledConnection オブジェクトへのハンドルを非アクティブ化し、 PooledConnection オブジェクトを接続のプールに返して、再度使用できるようにします。 したがって、アプリケーションがその接続を閉じると、基になる物理接続は閉じられるのではなくリサイクルされます。

物理接続は、接続プール マネージャーが PooledConnection メソッド closeを呼び出すまで閉じません。 このメソッドは、通常、サーバーを順番にシャットダウンするために、または致命的なエラーによって接続が使用できなくなった場合に呼び出されます。

接続プール・マネージャーは、多くの場合、ステートメント・プール・マネージャーでもあり、 PreparedStatement ・オブジェクトのプールをメインにしています。 準備されたステートメントを閉じると、アプリケーションはPreparedStatementcloseメソッドを呼び出します。 プールStatement実行中は、StatementEventListener メソッド ConnectionPoolを使用して自身がaddStatementEventListener オブジェクトとして登録されているため、プール マネージャーに通知されます。 したがって、アプリケーションがその PreparedStatementを閉じると、基になる準備されたステートメントは、閉じられるのではなくリサイクルされます。

1.4 で追加されました。

Javaドキュメント。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。