|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
| 이전 클래스 다음 클래스 | 프레임으로 프레임 없이 | |||||||||
| 개요: NESTED | 필드 | constructor | 메서드 | 상세: 필드 | constructor | 메서드 | |||||||||
public interface XAResource
XAResource 인터페이스는 X/Open CAE 사양 (분산 트랜잭션(transaction) 처리: XA 사양)에 근거하는 업계표준의 XA 인터페이스의 Java 매핑입니다.
XA 인터페이스는 분산 트랜잭션(transaction) 처리 (DTP) 환경에서의 자원 매니저와 트랜잭션(transaction) 매니저의 사이의 규약을 정의합니다. JDBC 드라이버 또는 JMS 프로바이더는 이 인터페이스를 구현해, 글로벌 트랜잭션(transaction)와 데이타베이스 또는 메세지 서비스 접속동안이 관련짓고를 지원 합니다.
XAResource 인터페이스는 트랜잭션(transaction)가 외부의 트랜잭션(transaction) 매니저에 의해 제어되는 환경에서
응용 프로그램에 의해 사용되는 모든 트랜잭션(transaction) 자원에 의해 지원
할 수 있습니다. 이러한 자원의 예로서는 데이타베이스 관리 시스템이 있습니다. 어플리케이션은 복수의 데이타베이스 접속을 개입시켜 데이터에 액세스 할 수 있습니다. 각 데이타베이스 접속은 트랜잭션(transaction) 매니저에 의해 트랜잭션(transaction) 자원으로서 등록됩니다. 트랜잭션(transaction) 매니저는 글로벌 트랜잭션(transaction)에 관련된 각 접속의 XAResource를 취득합니다. 트랜잭션(transaction) 매니저는 start 메서드를 사용해 글로벌 트랜잭션(transaction)를 자원에 관련지어end 메서드를 사용해 트랜잭션(transaction)와 자원이 관련짓고를 해제합니다. 자원 매니저는 글로벌 트랜잭션(transaction)를 start 메서드의 호출과 end 메서드의 호출동안에 그 데이터에 대해서 실행되는 모든 처리에 관련짓습니다.
트랜잭션(transaction)의 위탁시에 자원 매니저는 2 단계의 위탁 프로토콜에 따라, 트랜잭션(transaction)를 준비, 위탁, 또는 롤백(rollback) 하도록 트랜잭션(transaction) 매니저로부터 통지됩니다.
| 필드 개요 | |
|---|---|
static int |
TMENDRSCAN
회복 주사를 종료합니다. |
static int |
TMFAIL
호출측이 관련짓고를 해제해, 트랜잭션(transaction) 브랜치(branch)에 롤백(rollback)만의 마크를 붙입니다. |
static int |
TMJOIN
호출측이 기존의 트랜잭션(transaction) 브랜치(branch)에 참가합니다. |
static int |
TMNOFLAGS
TMNOFLAGS를 사용해, 플래그값이 선택되어 있지 않은 것을 나타냅니다. |
static int |
TMONEPHASE
호출측은 1 단계의 최적화를 사용하고 있습니다. |
static int |
TMRESUME
호출측은 중단된 트랜잭션(transaction) 브랜치(branch)와의 관련짓고를 재개합니다. |
static int |
TMSTARTRSCAN
회복 주사를 개시합니다. |
static int |
TMSUCCESS
호출측과 트랜잭션(transaction) 브랜치(branch)와의 관련짓고를 해제합니다. |
static int |
TMSUSPEND
호출측은 트랜잭션(transaction) 브랜치(branch)와의 관련짓고를 중단합니다 (종료는 아니다). |
static int |
XA_OK
트랜잭션(transaction) 처리가 정상적으로 준비되었습니다. |
static int |
XA_RDONLY
트랜잭션(transaction) 브랜치(branch)에서는 독해 밖에 행해지지 않고, 위탁되었습니다. |
| 메서드 개요 | |
|---|---|
void |
commit (Xid xid,
boolean onePhase)
xid 로 지정된 글로벌 트랜잭션(transaction)를 위탁합니다. |
void |
end (Xid xid,
int flags)
트랜잭션(transaction) 브랜치(branch)를 위해서 실행된 처리를 종료합니다. |
void |
forget (Xid xid)
휴리스틱에 결착된 트랜잭션(transaction) 브랜치(branch)를 무시하도록 자원 매니저에 통지합니다. |
int |
getTransactionTimeout ()
이 XAResource 인스턴스에 대해서 설정된 현재의 트랜잭션(transaction) 타임 아웃치를 취득합니다. |
boolean |
isSameRM (XAResource xares)
이 메서드를 호출해, 타겟 객체로 나타내지는 자원 매니저 인스턴스가 파라미터 xares 로 나타내지는 자원 매니저 인스턴스와 같은가 어떤가를 판정할 수 있습니다. |
int |
prepare (Xid xid)
xid 로 지정된 트랜잭션(transaction)의 트랜잭션(transaction) 위탁의 준비를 하도록 자원 매니저에 요구합니다. |
Xid [] |
recover (int flag)
자원 매니저로부터 준비된 트랜잭션(transaction) 브랜치(branch)의 리스트를 취득합니다. |
void |
rollback (Xid xid)
트랜잭션(transaction) 브랜치(branch)를 위해서 실행된 처리를 롤백(rollback) 하도록 자원 매니저에 통지합니다. |
boolean |
setTransactionTimeout (int seconds)
이 XAResource 인스턴스의 현재의 트랜잭션(transaction) 타임 아웃치를 설정합니다. |
void |
start (Xid xid,
int flags)
xid로
지정된 트랜잭션(transaction) 브랜치(branch)를 위한 처리를 개시합니다. |
| 필드의 상세 |
|---|
static final int TMENDRSCAN
static final int TMFAIL
static final int TMJOIN
static final int TMNOFLAGS
static final int TMONEPHASE
static final int TMRESUME
static final int TMSTARTRSCAN
static final int TMSUCCESS
static final int TMSUSPEND
static final int XA_RDONLY
static final int XA_OK
| 메서드의 상세 |
|---|
void commit(Xid xid,
boolean onePhase)
throws XAException
xid - 글로벌 트랜잭션(transaction) 식별자onePhase - true인 경우, 자원 매니저는 1 단계의 위탁 프로토콜을 사용해, xid를 위해서 행해진 처리를 위탁할 필요가 있다
XAException - 에러가 발생한 것을 나타낸다. 취할 수 있는 XAException 치는 XA_HEURHAZ, XA_HEURCOM, XA_HEURRB, XA_HEURMIX, XAER_RMERR, XAER_RMFAIL, XAER_NOTA, XAER_INVAL, 또는 XAER_PROTO자원 매니저가 트랜잭션(transaction)를 위탁하고 있지 않고, 파라미터 onePhase가 true 로 설정되어 있는 경우, 자원 매니저는 XA_RB* 예외의 1개를 Throw 하는 일이 있습니다. 이 경우 돌아올 때에 자원 매니저는 트랜잭션(transaction) 브랜치(branch)의 처리를 롤백(rollback) 해, 보관 유지하고 있던 모든 자원을 해방했습니다.
void end(Xid xid,
int flags)
throws XAException
TMSUSPEND가 플래그로 지정되면, 트랜잭션(transaction) 브랜치(branch)는 불완전한 상태로 일시적으로 중단됩니다. 트랜잭션(transaction) 컨텍스트은 중단 상태이며, TMRESUME를 지정한 start 메서드를 개입시켜 재개할 필요가 있습니다.
TMFAIL가 가리키는 경우, 처리 부분은 실패했습니다. 자원 매니저는 트랜잭션(transaction)에 롤백(rollback) 전용의 마크를 붙이는 일이 있습니다.
TMSUCCESS가 가리키는 경우, 처리 부분은 정상적으로 완료했습니다.
xid - 이전에 start 메서드로 사용된 식별자와 같은 글로벌 트랜잭션(transaction) 식별자flags - TMSUCCESS, TMFAIL, 또는 TMSUSPEND
언젠가
XAException - 에러가 발생한 것을 나타낸다. 취할 수 있는 XAException 치는 XAER_RMERR, XAER_RMFAILED, XAER_NOTA, XAER_INVAL, XAER_PROTO, 또는 XA_RB*
void forget(Xid xid)
throws XAException
xid - 글로벌 트랜잭션(transaction) 식별자
XAException - 에러가 발생한 것을 나타낸다. 취할 수 있는 예외치는 XAER_RMERR, XAER_RMFAIL, XAER_NOTA, XAER_INVAL, 또는 XAER_PROTO
int getTransactionTimeout()
throws XAException
XAResource.setTransactionTimeout가 사용되어 있지 않았던 경우, 반환값은 자원 매니저에 대해서 설정된 디폴트의 타임 아웃입니다. 그렇지 않은 경우는 이전의 setTransactionTimeout 호출로 사용된 값이 리턴됩니다
.
XAException - 에러가 발생한 것을 나타낸다. 가능성이 있는 예외치는 XAER_RMERR 및 XAER_RMFAIL
boolean isSameRM(XAResource xares)
throws XAException
xares - 타겟 객체의 자원 매니저 인스턴스라고 비교되는 자원 매니저 인스턴스를 가지는 XAResource 객체XAException - 에러가 발생한 것을 나타낸다. 가능성이 있는 예외치는 XAER_RMERR 및 XAER_RMFAIL
int prepare(Xid xid)
throws XAException
xid - 글로벌 트랜잭션(transaction) 식별자
XAException - 에러가 발생한 것을 나타낸다. 취할 수 있는 예외치는 XA_RB*, XAER_RMERR, XAER_RMFAIL, XAER_NOTA, XAER_INVAL, 또는 XAER_PROTO
Xid [] recover(int flag)
throws XAException
flag - 파라미터에 다른 플래그가 설정되어 있지 않은 경우는 TMSTARTRSCAN, TMENDRSCAN, TMNOFLAGS, TMNOFLAGS
어느쪽이든을 사용할 필요가 있다
XAException - 에러가 발생한 것을 나타낸다. 취할 수 있는 값은 XAER_RMERR, XAER_RMFAIL, XAER_INVAL, 또는 XAER_PROTO
void rollback(Xid xid)
throws XAException
xid - 글로벌 트랜잭션(transaction) 식별자
XAException - 에러가 발생한 것을 나타냅니다.
boolean setTransactionTimeout(int seconds)
throws XAException
이 XAResource 인스턴스의 현재의 트랜잭션(transaction) 타임 아웃치를 설정합니다. 이 타임 아웃치는 한 번 설정되면, 다른 값을 사용해 setTransactionTimeout이 재차 불려 갈 때까지 유효합니다. 타임 아웃치를 자원 매니저로 사용되는 기본값에 리셋 하려면,
값을 제로로 설정합니다.
타임 아웃 조작이 정상적으로 실행되면, 이 메서드는 true를 돌려주고, 그렇지 않은 경우는 false를 리턴합니다. 자원 매니저가 트랜잭션(transaction) 타임 아웃치의 명시적인 설정을 지원
하고 있지 않는 경우는 false를 리턴합니다.
seconds - 초단위의 트랜잭션(transaction) 타임 아웃치
XAException - 에러가 발생한 것을 나타낸다. 취할 수 있는 예외치는 XAER_RMERR, XAER_RMFAIL, 또는 XAER_INVAL
void start(Xid xid,
int flags)
throws XAException
xid로
지정된 트랜잭션(transaction) 브랜치(branch)를 위한 처리를 개시합니다. TMJOIN가 지정되는 경우는 자원 매니저로 이전에 사용된 트랜잭션(transaction)의 참가를 개시합니다. TMRESUME가 지정되는 경우는 파라미터 xid로
지정된 중단 트랜잭션(transaction)를 재개합니다.
TMJOIN도
TMRESUME도
지정되지 않고, xid로
지정된 트랜잭션(transaction)가 이전에 자원 매니저로 사용되었던 적이 있는 경우, 자원 매니저는 에러 코드 XAER_DUPID 로 XAException 예외를 Throw 합니다.
xid - 자원에 관련된
글로벌 트랜잭션(transaction) 식별자flags - TMNOFLAGS, TMJOIN, 또는 TMRESUME
언젠가
XAException - 에러가 발생한 것을 나타낸다. 취할 수 있는 예외치는 XA_RB*, XAER_RMERR, XAER_RMFAIL, XAER_DUPID, XAER_OUTSIDE, XAER_NOTA, XAER_INVAL, 또는 XAER_PROTO
|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
| 이전 클래스 다음 클래스 | 프레임으로 프레임 없이 | |||||||||
| 개요: NESTED | 필드 | constructor | 메서드 | 상세: 필드 | constructor | 메서드 | |||||||||
Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms . Documentation Redistribution Policy 도 참조하십시오.