javax.sql
인터페이스 PooledConnection

기존의 서브 인터페이스의 일람:

XAConnection

public interface PooledConnection

접속 풀 관리의 훅을 제공하는 오브젝트입니다. PooledConnection 오브젝트는 데이터 소스에의 물리 접속을 나타냅니다. 어플리케이션이 있는 접속으로 종료했을 때, 그 접속은 닫혀지지 않고 리사이클됩니다. 그 때문에, 생성할 필요가 있는 접속수를 줄일 수가 있습니다.

어플리케이션 프로그래머가 PooledConnection 인터페이스를 직접 사용할 것은 없습니다. 오히려,PooledConnection 인터페이스는 접속의 풀링을 관리하는 중간층 인프라스트럭쳐가 사용합니다.

도입된 버젼:

1.4

메소드의 개요

void	addConnectionEventListener (ConnectionEventListener listener) 지정한 이벤트 청취자를 등록해, 이 PooledConnection 오브젝트로 이벤트가 발생했을 때에 통지되도록(듯이) 합니다.
void	close () 이 PooledConnection 오브젝트가 나타내는 물리 접속을 닫습니다.
Connection	getConnection () 이 PooledConnection 오브젝트가 나타내는 물리 접속의 오브젝트 핸들을 작성합니다.
void	removeConnectionEventListener (ConnectionEventListener listener) 지정한 이벤트 청취자를, 이 PooledConnection 오브젝트로 이벤트가 발생했을 때에 통지되는 컴퍼넌트의 리스트로부터 삭제합니다.

메소드의 상세

getConnection

public Connection  getConnection()
                         throws SQLException 

이 PooledConnection 오브젝트가 나타내는 물리 접속의 오브젝트 핸들을 작성합니다. 돌려주어지는 오브젝트는 풀 되고 있는 물리 접속 (이 PooledConnection 오브젝트)을 참조하는 어플리케이션 코드로 사용하는 일시 핸들이 됩니다.

반환값:

이 PooledConnection 오브젝트의 핸들인 Connection 오브젝트

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우

close

public void close()
           throws SQLException 

이 PooledConnection 오브젝트가 나타내는 물리 접속을 닫습니다.

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우

addConnectionEventListener

public void addConnectionEventListener(ConnectionEventListener  listener)

지정한 이벤트 청취자를 등록해, 이 PooledConnection 오브젝트로 이벤트가 발생했을 때에 통지되도록(듯이) 합니다.

파라미터:

listener - ConnectionEventListener 인터페이스를 구현해, 접속이 닫았는지 에러가 발생했을 때에 통지되도록(듯이) 하는 컴퍼넌트. 통상은 접속 풀 관리 프로그램

관련 항목:

removeConnectionEventListener(javax.sql.ConnectionEventListener)

removeConnectionEventListener

public void removeConnectionEventListener(ConnectionEventListener  listener)

지정한 이벤트 청취자를, 이 PooledConnection 오브젝트로 이벤트가 발생했을 때에 통지되는 컴퍼넌트의 리스트로부터 삭제합니다.

파라미터:

listener - ConnectionEventListener 인터페이스를 구현해, 청취자로서 등록된 컴퍼넌트. 통상은 접속 풀 관리 프로그램

관련 항목:

addConnectionEventListener(javax.sql.ConnectionEventListener)