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

public XAConnection  getXAConnection()
                             throws SQLException 

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

반환값:

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

예외:

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

getXAConnection

public XAConnection  getXAConnection(String  user,
                                    String  password)
                             throws SQLException 

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

파라미터:

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

password - 유저의 패스워드

반환값:

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

예외:

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

getLogWriter

public PrintWriter  getLogWriter()
                         throws SQLException 

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

반환값:

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

예외:

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

관련 항목:

setLogWriter(java.io.PrintWriter)

setLogWriter

public void setLogWriter(PrintWriter  out)
                  throws SQLException 

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

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

파라미터:

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

예외:

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

관련 항목:

getLogWriter()

setLoginTimeout

public void setLoginTimeout(int seconds)
                     throws SQLException 

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

파라미터:

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

예외:

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

관련 항목:

getLoginTimeout()

getLoginTimeout

public int getLoginTimeout()
                    throws SQLException 

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

반환값:

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

예외:

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

관련 항목:

setLoginTimeout(int)