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

public PooledConnection  getPooledConnection()
                                     throws SQLException 

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

반환값:

이 ConnectionPoolDataSource 오브젝트가 나타내는 데이타베이스에의 물리 접속인 PooledConnection 오브젝트

예외:

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

getPooledConnection

public PooledConnection  getPooledConnection(String  user,
                                            String  password)
                                     throws SQLException 

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

파라미터:

user - 그 대리로서 접속을 하는 데이타베이스 유저

password - 유저의 패스워드

반환값:

이 ConnectionPoolDataSource 오브젝트가 나타내는 데이타베이스에의 물리 접속인 PooledConnection 오브젝트

예외:

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

getLogWriter

public PrintWriter  getLogWriter()
                         throws SQLException 

이 ConnectionPoolDataSource 오브젝트의 로그 라이터를 취득합니다.

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

반환값:

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

예외:

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

관련 항목:

setLogWriter(java.io.PrintWriter)

setLogWriter

public void setLogWriter(PrintWriter  out)
                  throws SQLException 

이 ConnectionPoolDataSource 오브젝트의 로그 라이터를 java.io.PrintWriter 오브젝트로 설정합니다.

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

파라미터:

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

예외:

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

관련 항목:

getLogWriter()

setLoginTimeout

public void setLoginTimeout(int seconds)
                     throws SQLException 

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

파라미터:

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

예외:

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

관련 항목:

getLoginTimeout()

getLoginTimeout

public int getLoginTimeout()
                    throws SQLException 

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

반환값:

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

예외:

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

관련 항목:

setLoginTimeout(int)