IPooledConnection Interfaz

Definición

[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

Atributos

RegisterAttribute

Implementaciones

IJavaObject IJavaPeerable IDisposable

Comentarios

Objeto que proporciona enlaces para la administración del grupo de conexiones. Un PooledConnection objeto representa una conexión física a un origen de datos. La conexión se puede reciclar en lugar de cerrarse cuando una aplicación finaliza con ella, lo que reduce el número de conexiones que se deben realizar.

Un programador de aplicaciones no usa la PooledConnection interfaz directamente; en su lugar, se usa mediante una infraestructura de nivel intermedio que administra la agrupación de conexiones.

Cuando una aplicación llama al método DataSource.getConnection, devuelve un Connection objeto . Si se realiza la agrupación de conexiones, ese Connection objeto es realmente un identificador de un PooledConnection objeto , que es una conexión física.

El administrador del grupo de conexiones, normalmente el servidor de aplicaciones, mantiene un grupo de PooledConnection objetos. Si hay un PooledConnection objeto disponible en el grupo, el administrador del grupo de conexiones devuelve un Connection objeto que es un identificador de esa conexión física. Si no hay ningún PooledConnection objeto disponible, el administrador del grupo de conexiones llama al ConnectionPoolDataSource método getPoolConnection para crear una nueva conexión física. El controlador JDBC que implementa ConnectionPoolDataSource crea un nuevo PooledConnection objeto y devuelve un identificador a él.

Cuando una aplicación cierra una conexión, llama al Connection método close. Cuando se realiza la agrupación de conexiones, se notifica al administrador del grupo de conexiones porque se ha registrado como un ConnectionEventListener objeto mediante el ConnectionPool método addConnectionEventListener. El administrador del grupo de conexiones desactiva el identificador del PooledConnection objeto y devuelve el PooledConnection objeto al grupo de conexiones para que se pueda volver a usar. Por lo tanto, cuando una aplicación cierra su conexión, la conexión física subyacente se recicla en lugar de cerrarse.

La conexión física no se cierra hasta que el administrador del grupo de conexiones llama al PooledConnection método close. Por lo general, se llama a este método para tener un apagado ordenado del servidor o si un error irrecuperable ha hecho que la conexión no se pueda usar.

Un administrador de grupos de conexiones suele ser también un administrador de grupos de instrucciones, lo que principal es un grupo de PreparedStatement objetos. Cuando una aplicación cierra una instrucción preparada, llama al PreparedStatement método close. Cuando Statement se realiza la agrupación, se notifica al administrador del grupo porque se ha registrado como un StatementEventListener objeto mediante el ConnectionPool método addStatementEventListener. Por lo tanto, cuando una aplicación cierra su PreparedStatement, la instrucción preparada subyacente se recicla en lugar de cerrarse.

Agregado en la versión 1.4.

Java documentación para javax.sql.PooledConnection.

Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el Android y se usan según los términos descritos en creative Creative Commons 2.5 Attribution License.