javax.sql
인터페이스 ConnectionPoolDataSource

public interface ConnectionPoolDataSource

PooledConnection 객체의 팩토리입니다. 이 인터페이스를 구현하는 객체는 일반적으로 Java^TM Naming and Directory Interface (JNDI)를 기본으로 한 네임 서비스로 등록되어 있습니다.

도입된 버전 :

1.4

메서드 개요

int	getLoginTimeout () 데이타베이스에의 접속 시행중에 이 ConnectionPoolDataSource 객체가 대기하는 최장 시간 (초)을 취득합니다.
PrintWriter	getLogWriter () 이 ConnectionPoolDataSource 객체의 로그 라이터를 취득합니다.
PooledConnection	getPooledConnection () 풀 된 접속으로서 사용 가능한, 데이타베이스에의 물리 접속의 확립을 시도합니다.
PooledConnection	getPooledConnection (String user, String password) 풀 된 접속으로서 사용 가능한, 데이타베이스에의 물리 접속의 확립을 시도합니다.
void	setLoginTimeout (int seconds) 데이타베이스에의 접속 시행중에 이 ConnectionPoolDataSource 객체가 대기하는 최장 시간 (초)을 지정합니다.
void	setLogWriter (PrintWriter out) 이 ConnectionPoolDataSource 객체의 로그 라이터를 java.io.PrintWriter 객체로 설정합니다.

메서드의 상세

getPooledConnection

PooledConnection  getPooledConnection()
                                     throws SQLException 

풀 된 접속으로서 사용 가능한, 데이타베이스에의 물리 접속의 확립을 시도합니다.

반환값:

이 ConnectionPoolDataSource 객체가 나타내는 데이타베이스에의 물리 접속인 PooledConnection 객체

예외:

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

getPooledConnection

PooledConnection  getPooledConnection(String  user,
                                     String  password)
                                     throws SQLException 

풀 된 접속으로서 사용 가능한, 데이타베이스에의 물리 접속의 확립을 시도합니다.

파라미터:

user - 그 대리로서 접속을 하는 데이타베이스 사용자

password - 사용자 의 패스워드

반환값:

이 ConnectionPoolDataSource 객체가 나타내는 데이타베이스에의 물리 접속인 PooledConnection 객체

예외:

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

getLogWriter

PrintWriter  getLogWriter()
                         throws SQLException 

이 ConnectionPoolDataSource 객체의 로그 라이터를 취득합니다.

로그 라이터란 이 ConnectionPoolDataSource 객체에 대해서 로그가 기록되거나 트레이스 된, 모든 메세지가 표시되는 캐릭터 출력 스트림입니다. 이 객체의 메서드에 한 메세지나, 이 객체가 작성한 것 외의 객체에 한 메세지등도 포함됩니다. 데이터 소스에 특유의 로그 Writer에 표시된 메세지는 java.sql.DriverManager 클래스에 관련된 로그 Writer에는 표시되지 않습니다. 데이터 소스 객체가 작성되면, 로그 라이터는 null에 초기화됩니다. 즉, 디폴트에서는 로그의 취득은 무효입니다.

반환값:

이 ConnectionPoolDataSource 로그 라이터. 로그의 취득이 무효의 경우는 null

예외:

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

관련 항목:

setLogWriter(java.io.PrintWriter)

setLogWriter

void setLogWriter(PrintWriter  out)
                  throws SQLException 

이 ConnectionPoolDataSource 객체의 로그 라이터를 java.io.PrintWriter 객체로 설정합니다.

로그 라이터란 이 ConnectionPoolDataSource 객체에 대해서 로그가 기록되거나 트레이스 된, 모든 메세지가 표시되는 캐릭터 출력 스트림입니다. 이 객체의 메서드에 한 메세지나, 이 객체가 작성한 것 외의 객체에 한 메세지등도 포함됩니다. 데이터 소스에 특유의 로그 Writer에 표시된 메세지는 java.sql.DriverManager 클래스에 관련된 로그 Writer에는 표시되지 않습니다. 데이터 소스 객체가 작성되면, 로그 라이터는 null에 초기화됩니다. 즉, 디폴트에서는 로그의 취득은 무효입니다.

파라미터:

out - 새로운 로그 라이터. 로그의 취득을 무효로 하는 경우는 null

예외:

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

관련 항목:

getLogWriter()

setLoginTimeout

void setLoginTimeout(int seconds)
                     throws SQLException 

데이타베이스에의 접속 시행중에 이 ConnectionPoolDataSource 객체가 대기하는 최장 시간 (초)을 지정합니다. 값이 0 때, 디폴트의 시스템 타임 아웃이 설정되어 있는 경우는 그 값이 됩니다. 그렇지 않은 경우는 타임 아웃 하지 않는 것을의미합니다. ConnectionPoolDataSource 객체가 작성되면, 로그인 타임 아웃은 0에 초기화됩니다.

파라미터:

seconds - 데이터 소스의 로그인 제한 시간

예외:

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

관련 항목:

getLoginTimeout()

getLoginTimeout

int getLoginTimeout()
                    throws SQLException 

데이타베이스에의 접속 시행중에 이 ConnectionPoolDataSource 객체가 대기하는 최장 시간 (초)을 취득합니다. 값이 0 때, 디폴트의 시스템 타임 아웃이 설정되어 있는 경우는 그 값이 됩니다. 그렇지 않은 경우는 타임 아웃 하지 않는 것을의미합니다. DataSource 객체가 작성되면, 로그인 타임 아웃은 0에 초기화됩니다.

반환값:

데이터 소스의 로그인 제한 시간

예외:

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

관련 항목:

setLoginTimeout(int)