javax.sql
인터페이스 CommonDataSource

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

ConnectionPoolDataSource , DataSource , XADataSource

public interface CommonDataSource

DataSource,XADataSource, 및 ConnectionPoolDataSource 에 공통의 메소드를 정의하는 인터페이스입니다.

메소드의 개요

int	getLoginTimeout () 데이타베이스에의 접속 시행중에, 이 데이터 소스가 대기하는 최장 시간 (초)을 가져옵니다.
PrintWriter	getLogWriter () 이 DataSource 객체의 로그 라이터를 가져옵니다.
void	setLoginTimeout (int seconds) 데이타베이스에의 접속 시행중에, 이 데이터 소스가 대기하는 최장 시간 (초)을 지정합니다.
void	setLogWriter (PrintWriter out) 이 DataSource 객체의 로그 라이터를 java.io.PrintWriter 객체로 설정합니다.

메소드의 상세

getLogWriter

PrintWriter  getLogWriter()
                         throws SQLException 

이 DataSource 객체의 로그 라이터를 가져옵니다.

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

반환값:

이 데이터 소스의 로그 라이터. 로그의 취득이 무효의 경우는 null

예외:

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

도입된 버젼:

1.4

관련 항목:

setLogWriter(java.io.PrintWriter)

setLogWriter

void setLogWriter(PrintWriter  out)
                  throws SQLException 

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

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

파라미터:

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

예외:

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

도입된 버젼:

1.4

관련 항목:

getLogWriter()

setLoginTimeout

void setLoginTimeout(int seconds)
                     throws SQLException 

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

파라미터:

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

예외:

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

도입된 버젼:

1.4

관련 항목:

getLoginTimeout()

getLoginTimeout

int getLoginTimeout()
                    throws SQLException 

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

반환값:

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

예외:

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

도입된 버젼:

1.4

관련 항목:

setLoginTimeout(int)