javax.sql
인터페이스 PooledConnection

알려진 서브 인터페이스 목록 :

XAConnection

public interface PooledConnection

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

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

어플리케이션은, DataSource.getConnection 메서드를 호출하면, Connection 객체를 되돌립니다. 접속 풀의 실행중, Connection객체는 물리 접속인 PooledConnection 객체의 핸들이 됩니다.

접속 풀 관리 프로그램 (보통 어플리케이션 서버)은, PooledConnection 객체의 풀을 관리합니다. 풀내에 이용 가능한 PooledConnection 객체가 존재하는 경우, 그 물리 접속의 핸들인 Connection 객체를 리턴합니다. 이용 가능한 PooledConnection 객체가 존재하지 않는 경우, PooledConnection 메서드 getConnection을 호출해, 새로운 물리 접속을 작성해, 그 핸들을 리턴합니다.

접속을 닫을 때, 어플리케이션은 Connection 메서드 close를 호출합니다. 접속 풀의 실행중, 접속 풀 관리 프로그램에 통지가 보내집니다. 이것은 접속 풀 관리 프로그램이 ConnectionPool 메서드 addConnectionEventListener를 사용해, ConnectionEventListener 객체로서 등록되어 있기 때문입니다. 접속 풀 관리 프로그램은 PooledConnection 객체의 핸들을 종료해, 접속 풀에 PooledConnection 객체를 리턴합니다. 리턴된 객체는 재이용 가능합니다. 이와 같이, 어플리케이션이 접속을 닫을 때, 배후의 물리 접속은 닫혀지지 않고, 리사이클됩니다.

물리 접속은 접속 풀 관리 프로그램이 PooledConnection 메서드 close를 호출할 때까지 닫혀지지 않습니다. 일반적으로 이 메서드는 보통 대로의 순서로 서버를 종료하는 경우, 또는 치명적인 에러에 의해 접속을 사용할 수 없는 상태가 되었을 경우에 호출합니다.

도입된 버전 :

1.4

메서드 개요

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

메서드의 상세

getConnection

Connection  getConnection()
                         throws SQLException 

Connection 객체 (이 PooledConnection 객체가 나타내는 물리 접속의 핸들)를 작성해, 리턴합니다. 접속 풀 관리 프로그램은 어플리케이션에 의해 DataSource.getConnection 메서드가 불려 갔지만, 이용 가능한 PooledConnection 객체가 존재하지 않는 경우에 이 메서드를 호출합니다. 상세한 것에 대하여는 인터페이스의 설명을 참조하십시오.

반환값:

이 PooledConnection 객체의 핸들인 Connection 객체

예외:

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

close

void close()
           throws SQLException 

이 PooledConnection 객체가 나타내는 물리 접속을 닫습니다. 어플리케이션이 이 메서드를 직접 호출할 것은 없습니다. 이 메서드는 접속 풀 모듈, 또는 접속 풀 관리 프로그램에 의해 호출합니다.

상세한 것에 대하여는 인터페이스의 설명을 참조하십시오.

예외:

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

addConnectionEventListener

void addConnectionEventListener(ConnectionEventListener  listener)

지정한 이벤트 리스너를 등록해, 이 PooledConnection 객체로 이벤트가 발생했을 때에 통지되도록 합니다.

파라미터:

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

관련 항목:

removeConnectionEventListener(javax.sql.ConnectionEventListener)

removeConnectionEventListener

void removeConnectionEventListener(ConnectionEventListener  listener)

지정한 이벤트 리스너를, 이 PooledConnection 객체로 이벤트가 발생했을 때에 통지되는 컴퍼넌트의 리스트로부터 삭제합니다.

파라미터:

listener - ConnectionEventListener인터페이스를 구현해, 이 PooledConnection 객체에 리스너로서 등록된 컴퍼넌트. 일반적으로 접속 풀 관리 프로그램

관련 항목:

addConnectionEventListener(javax.sql.ConnectionEventListener)