Java 2 Platform EE v1.3: Interface PooledConnection - Java Platform, Enterprise Edition v1.3.1 API Specifications

Overview

Package

Class

Tree

Deprecated

Index

Help

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: INNER | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

javax.sql
Interface PooledConnection

All Known Subinterfaces:: XAConnection

public interface PooledConnection

A PooledConnection object is a connection object that provides hooks for connection pool management. A PooledConnection object represents a physical connection to a data source.

Method Summary

void addConnectionEventListener(ConnectionEventListener listener)
           Add an event listener.

void close()
          Close the physical connection.

java.sql.Connection getConnection()
          Create an object handle for this physical connection.

void removeConnectionEventListener(ConnectionEventListener listener)
           Remove an event listener.

Method Detail

getConnection

public java.sql.Connection getConnection()
                                  throws java.sql.SQLException

Create an object handle for this physical connection. The object returned is a temporary handle used by application code to refer to a physical connection that is being pooled.

Returns:: a Connection object
Throws:: java.sql.SQLException - if a database-access error occurs.

close

public void close()
           throws java.sql.SQLException

Close the physical connection.

Throws:: java.sql.SQLException - if a database-access error occurs.

addConnectionEventListener

public void addConnectionEventListener(ConnectionEventListener listener)

Add an event listener.

removeConnectionEventListener

public void removeConnectionEventListener(ConnectionEventListener listener)

Remove an event listener.