javax.sql
인터페이스 XADataSource

public interface XADataSource

내부에서 사용되는 XAConnection 객체의 팩토리입니다. XADataSource인터페이스를 구현하는 객체는 일반적으로 Java^TM Naming and Directory Interface (JNDI)를 사용하는 네임 서비스로 등록됩니다.

도입된 버전 :

1.4

메서드 개요

int	getLoginTimeout () 데이터 소스에의 접속 시행중에 이 데이터 소스가 대기하는 최장 시간 (초)을 설정합니다.
PrintWriter	getLogWriter () 이 XADataSource 객체의 로그 라이터를 취득합니다.
XAConnection	getXAConnection () 분산 트랜잭션(transaction)로 사용 가능한, 물리 데이타베이스 접속의 확립을 시도합니다.
XAConnection	getXAConnection (String user, String password) 지정된 사용자 명과 패스워드를 사용해, 물리 데이타베이스 접속의 확립을 시도합니다.
void	setLoginTimeout (int seconds) 데이터 소스에의 접속 시행중에 이 데이터 소스가 대기하는 최장 시간 (초)을 지정합니다.
void	setLogWriter (PrintWriter out) 이 XADataSource 객체의 로그 라이터를 java.io.PrintWriter 객체로 설정합니다.

메서드의 상세

getXAConnection

XAConnection  getXAConnection()
                             throws SQLException 

분산 트랜잭션(transaction)로 사용 가능한, 물리 데이타베이스 접속의 확립을 시도합니다.

반환값:

데이터 소스에의 물리 접속을 나타내는 XAConnection 객체. 이 객체는 분산 트랜잭션(transaction)로 사용된다

예외:

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

getXAConnection

XAConnection  getXAConnection(String  user,
                             String  password)
                             throws SQLException 

지정된 사용자 명과 패스워드를 사용해, 물리 데이타베이스 접속의 확립을 시도합니다. 리턴된 접속은 분산 트랜잭션(transaction)로 사용할 수 있습니다.

파라미터:

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

password - 사용자 의 패스워드

반환값:

데이터 소스에의 물리 접속을 나타내는 XAConnection 객체. 이 객체는 분산 트랜잭션(transaction)로 사용된다

예외:

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

getLogWriter

PrintWriter  getLogWriter()
                         throws SQLException 

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

반환값:

이 데이터 소스의 로그 라이터. 로그 라이터가 설정되어 있지 않은 경우는 로그의 취득이 무효라는 점을 나타내는 null

예외:

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

관련 항목:

setLogWriter(java.io.PrintWriter)

setLogWriter

void setLogWriter(PrintWriter  out)
                  throws SQLException 

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

로그 라이터란 이 XADataSource 객체의 모든 로그 및 트레이스 메세지의 출력처 캐릭터 출력 스트림입니다. 이 객체의 메서드에 한 메세지나, 이 객체가 작성한 것 외의 객체에 한 메세지등도 포함됩니다. 데이터 소스에 고유의 로그 Writer에 출력된 메세지는 java.sql.DriverManager 클래스에 관련된 로그 Writer에는 출력되지 않습니다. 데이터 소스 객체가 작성되면, 로그 라이터는 null에 초기화됩니다.

파라미터:

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

예외:

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

관련 항목:

getLogWriter()

setLoginTimeout

void setLoginTimeout(int seconds)
                     throws SQLException 

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

파라미터:

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

예외:

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

관련 항목:

getLoginTimeout()

getLoginTimeout

int getLoginTimeout()
                    throws SQLException 

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

반환값:

이 XADataSource 객체에 한 로그인의 제한 시간을 나타내는 초수. 타임 아웃의 제한이 없는 경우나, 디폴트의 시스템 타임 아웃인 경우는 0

예외:

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

관련 항목:

setLoginTimeout(int)