IPooledConnection Schnittstelle

Definition

[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

Attribute

RegisterAttribute

Implementiert

IJavaObject IJavaPeerable IDisposable

Hinweise

Ein Objekt, das Hooks für die Verbindungspoolverwaltung bereitstellt. Ein PooledConnection Objekt stellt eine physische Verbindung zu einer Datenquelle dar. Die Verbindung kann wiederverwendet werden, anstatt geschlossen zu werden, wenn eine Anwendung damit fertig ist, wodurch die Anzahl der Verbindungen reduziert wird, die hergestellt werden müssen.

Ein Anwendungsprogrammierer verwendet die PooledConnection Schnittstelle nicht direkt. Stattdessen wird sie von einer Infrastruktur auf mittlerer Ebene verwendet, die die Poolerstellung von Verbindungen verwaltet.

Wenn eine Anwendung die Methode DataSource.getConnectionaufruft, wird ein Connection Objekt zurückgegeben. Wenn die Verbindungspoolerstellung durchgeführt wird, handelt es sich bei diesem Connection Objekt tatsächlich um ein Handle für ein PooledConnection Objekt, bei dem es sich um eine physische Verbindung handelt.

Der Verbindungspool-Manager, in der Regel der Anwendungsserver, verwaltet einen Pool von PooledConnection Objekten. Wenn ein PooledConnection Objekt im Pool verfügbar ist, gibt der Verbindungspool-Manager ein Connection Objekt zurück, das ein Handle für diese physische Verbindung ist. Wenn kein PooledConnection Objekt verfügbar ist, ruft der Verbindungspool-Manager die ConnectionPoolDataSource Methode getPoolConnection auf, um eine neue physische Verbindung zu erstellen. Der implementierende ConnectionPoolDataSource VORGANGstreiber erstellt ein neues PooledConnection Objekt und gibt einen Handle zurück.

Wenn eine Anwendung eine Verbindung schließt, ruft sie die Connection Methode closeauf. Wenn die Verbindungspoolerstellung durchgeführt wird, wird der Verbindungspool-Manager benachrichtigt, da er sich mit der ConnectionPool Methode addConnectionEventListenerals ConnectionEventListener Objekt registriert hat. Der Verbindungspool-Manager deaktiviert das Handle für das PooledConnection Objekt und gibt das PooledConnection Objekt an den Pool der Verbindungen zurück, damit es wieder verwendet werden kann. Wenn eine Anwendung ihre Verbindung schließt, wird daher die zugrunde liegende physische Verbindung wiederverwendet, anstatt geschlossen zu werden.

Die physische Verbindung wird erst geschlossen, wenn der Verbindungspool-Manager die PooledConnection Methode closeaufruft. Diese Methode wird im Allgemeinen aufgerufen, um ein geordnetes Herunterfahren des Servers zu haben oder wenn ein schwerwiegender Fehler die Verbindung unbrauchbar gemacht hat.

Ein Verbindungspool-Manager ist häufig auch ein Anweisungspool-Manager, der einen Pool mit PreparedStatement Objekten bestimmt. Wenn eine Anwendung eine vorbereitete Anweisung schließt, wird die PreparedStatement Methode closeaufgerufen. Wenn Statement die Poolverwaltung durchgeführt wird, wird der Pool-Manager benachrichtigt, da er sich mithilfe der ConnectionPool Methode addStatementEventListenerals StatementEventListener Objekt registriert hat. Wenn eine Anwendung ihre PreparedStatementAnwendung schließt, wird die zugrunde liegende vorbereitete Anweisung daher wiederverwendet, anstatt geschlossen zu werden.

In 1.4 hinzugefügt.

Java Dokumentation für javax.sql.PooledConnection.

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die von der Android Open Source Project erstellt und gemeinsam verwendet und gemäß den in der 2.5 Attribution License beschriebenen Begriffen verwendet werden.