IPooledConnection Interface

Définition

[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

Attributs

RegisterAttribute

Implémente

IJavaObject IJavaPeerable IDisposable

Remarques

Objet qui fournit des hooks pour la gestion du pool de connexions. Un PooledConnection objet représente une connexion physique à une source de données. La connexion peut être recyclée plutôt que fermée lorsqu’une application est terminée, ce qui réduit le nombre de connexions qui doivent être effectuées.

Un programmeur d’applications n’utilise pas directement l’interface PooledConnection ; il est plutôt utilisé par une infrastructure de niveau intermédiaire qui gère le regroupement des connexions.

Lorsqu’une application appelle la méthode DataSource.getConnection, elle récupère un Connection objet. Si le regroupement de connexions est effectué, cet Connection objet est en fait un handle vers un PooledConnection objet, qui est une connexion physique.

Le gestionnaire de pool de connexions, généralement le serveur d’applications, gère un pool d’objets PooledConnection . S’il existe un PooledConnection objet disponible dans le pool, le gestionnaire de pool de connexions retourne un Connection objet qui est un handle à cette connexion physique. Si aucun objet n’est PooledConnection disponible, le gestionnaire de pool de connexions appelle la ConnectionPoolDataSource méthode getPoolConnection pour créer une connexion physique. Le pilote JDBC implémentant ConnectionPoolDataSource crée un PooledConnection objet et retourne un handle à celui-ci.

Lorsqu’une application ferme une connexion, elle appelle la Connection méthode close. Lorsque le regroupement de connexions est effectué, le gestionnaire de pools de connexions est averti car il s’est inscrit en tant qu’objet ConnectionEventListener à l’aide de la ConnectionPool méthode addConnectionEventListener. Le gestionnaire du pool de connexions désactive le handle sur l’objet PooledConnection et retourne l’objet PooledConnection au pool de connexions afin qu’il puisse être réutilisé. Par conséquent, lorsqu’une application ferme sa connexion, la connexion physique sous-jacente est recyclée plutôt que fermée.

La connexion physique n’est pas fermée tant que le gestionnaire du pool de connexions n’appelle pas la PooledConnection méthode close. Cette méthode est généralement appelée pour avoir un arrêt ordonné du serveur ou si une erreur irrécupérable a rendu la connexion inutilisable.

Un gestionnaire de pool de connexions est souvent un gestionnaire de pool d’instructions, en maintinant un pool d’objets PreparedStatement . Lorsqu’une application ferme une instruction préparée, elle appelle la PreparedStatement méthode close. Lorsque Statement le regroupement est effectué, le gestionnaire de pool est averti car il s’est inscrit en tant qu’objet StatementEventListener à l’aide de la ConnectionPool méthode addStatementEventListener. Ainsi, lorsqu’une application ferme son PreparedStatement, l’instruction préparée sous-jacente est recyclée plutôt que fermée.

Ajouté dans la version 1.4.

Java documentation pour javax.sql.PooledConnection.

Les parties de cette page sont des modifications basées sur le travail créé et partagé par le projet Android Open Source et utilisés en fonction des termes décrits dans la licence d’attribution Creative Commons 2.5.