javatm platform
standard ed. 6

javax.transaction.xa
接口 xaresource


public interface xaresource

xaresource 接口是基于 x/open cae 规范(分布『distributes』式事务处理:xa 规范)的工业标准 xa 接口的 java 映射。

在分布『distributes』式事务处理 (dtp) 环境中,xa 接口定义资源管理『managing』器和事务管理『managing』器之间的协定。jdbc 驱动程序或 jms 提供者实现此接口,以支持『support』全局事务与数据库或消息服务『services』连接之间的关联。

可由应用程序在外部事务管理器控制事务的环境中使用的任何事务资源均可支持『support』 xaresource 接口。数据库管理系统就属于此类资源。应用程序可以『 kě yǐ』通过多个数据库连接访问『visit』数据。通过事务管理器将每个数据库连接作为事务资源添加到列表中。事务管理器为参与全局事务的每个连接获取 xaresource。事务管理器使用 start 方法建立全局事务与资源之间的关联,而使用 end 方法取消事务与资源之间的关联。资源管理器负责『fù zé』将全局事务关联到在 start 与 end 方法调用之间对其数据执行的所有『all』工作『work』。

在事务提交时,事务管理器通知『tōng zhī』资源管理器根据二阶段提交协议准备『ready to』、提交或回滚事务。


字段摘要
static inttmendrscan
          终止恢复扫描。
static inttmfail
          取消关联调用者,并将事务分支标记为只回滚。
static inttmjoin
          调用者正连接现有事务分支。
static inttmnoflags
          使用 tmnoflags 指示不选择任何标志值。
static inttmonephase
          调用者正在使用一阶段优化。
static inttmresume
          调用者正在恢复与挂起的事务分支的关联。
static inttmstartrscan
          启动恢复扫描。
static inttmsuccess
          取消调用者与事务分支的关联。
static intjs随机数tmsuspend
          调用者正挂起(不是终止)其与事务分支的关联。
static intxa_ok
          事务工作『work』正常准备『ready to』就绪。
static intxa_rdonly
          事务分支是只读的,并且已提交。
 
方法摘要
 voidcommit(xid xid,boolean onephase)
          提交 xid 指定的全局事务。
 voidend(xid xid,int flags)
          终止代表事务分支所执行的工作。
 voidforget(xid xid)
          告知资源管理器忽略以启发式完成的事务分支。
 intgettransactiontimeout()
          获取为此 xaresource 实例设置的当前事务超时值。
 booleanissamerm(xaresource xares)
          调用此方法,以确定目标对象表示的资源管理器实例是否与参数 xares 表示的资源管理器实例相同。
 intprepare(xid xid)
          请求资源管理器准备好 xid 中指定的事务的事务提交工作。
 xid[]recover(int flag)
          从资源管理器获取准备的事务分支的列表。
 voidrollback(xid xid)
          通知『tōng zhī』资源管理器回滚代表事务分支执行的工作。
 booleansettransactiontimeout(int seconds)
          为此 xaresource 实例设置当前事务超时值。
 voidstart(xid xid,int flags)
          代表 xid 中指定的事务分支开始『appeared』工作。
 

字段详细小篻ǎn』畔

tmendrscan

static final int tmendrscan
终止恢复扫描。

另请参见:
常量字段值

tmfail

static final int tmfail
取消关联调用者,并将事务分支标记为只回滚。

另请参见:
常量字段值

tmjoin

static final int tmjoin
调用者正连接现有事务分支。

另请参见:
常量字段值

tmnoflags

static final int tmnoflags
据《海峡都市报》报导,小丽母亲表示,16日清晨打算和女儿上山?癫瑁蛳劝捕傩《?子,于是让她先上山,没想到后来女儿哭着下山,浑身是汗衣服也全是泥土,边哭边说
林智坚表示,过去竹堑国乐节的演出?I限在室内,去年开始『appeared』,市府尝试将活动带到户外,结果大获好评,观赏人潮爆满关新公园,今年特别加码演出场次,欢迎爸爸妈妈周末带着孩子到关新公园,感受国乐的音乐『music』魅力
而且『but』她的美貌还被当地医学界》杂?I的公众『Public』号推送放在了头条位置『wèi zhi』,几个小时的时间里,阅读量就破了10万
朴槿惠近日在青瓦台的国安会议『huì yì』上,重申部署萨德的必要性,强硬的态度『 dù』让中国『China』网友相当不满,还有许多『xǔ duō』
2016竹堑国乐节至7月31日(日)闭幕前,陆续还有10场系列活动热闹登场,最后一波索票『piào』将在7月23日(六)上午『morning』9时于演艺厅一楼服务『services』台开放索取7月28日(四)
系统原为牵制薄簆iào』焙姆傻菜茫泄篊hina』认为这项部署不单纯是为了防卫,质疑美军能藉此追中国境内的飞弹位置『wèi zhi』
使用 tmnoflags 指示不选择任何标志值。

另请参见:
常量字段值

tmonephase

static final int tmonephase
调用者正在使用一阶段优化。

另请参见:
常量字段值

tmresume

static final int tmresume
调用者正在恢复与挂起的事务分支的关联。

另请参见:
常量字段值

tmstartrscan

static final int tmstartrscan
启动恢复扫描。

另请参见:
常量字段值

tmsuccess

static final int tmsuccess
取消调用者与事务分支的关联。

另请参见:
常量字段值

tmsuspend

static final int tmsuspend
调用者正挂起(不是终止)其与事务分支的关联。

另请参见:
常量字段值

xa_rdonly

static final int xa_rdonly
事务分支是只读的,并且已提交。

另请参见:
常量字段值

xa_ok

static final int xa_ok
事务工作正常准备就绪。

另请参见:
常量字段值
方法详细信息

commit

void commit(xid xid,  boolean onephase)  throws xaexception
提交 xid 指定的全局事务。

参数:
xid - 全局事务标识符
onephase - 如果为 true,则资源管理器应使用单阶段提交协议提交代表 xid 执行的工作。
抛出:
xaexception - 发生『occasionally occurred』错误。可能『kě néng』的 xaexceptions 为 xa_heurhaz、xa_heurcom、xa_heurrb、xa_heurmix、xaer_rmerr、xaer_rmfail、xaer_nota、xaer_inval 或 xaer_proto。

如果资源管理器不提交事务,并且将参数 onephase 设置为 true,则资源管理器可能『kě néng』抛出 xa_rb* 异常之一。返回时,资源管理器已经『have been』回滚分支的工作,并且已经『have been』释放所有占用的资源。


end

void end(xid xid,   int flags)   throws xaexception
终止代表事务分支所执行的工作。资源管理器取消 xa 资源与指定的事务分支的关联,并使事务完成。

如果在标志中指定 tmsuspend,则事务分支将以未完成状态中暂时挂起。事务上下文处于挂起状态,必须通过 start 方法且将标志指定为 tmresume 来恢复。

如果指定 tmfail,则部分工作将失败。资源管理器可以『 kě yǐ』将事务标记为只回滚

如果指定 tmsuccess,则将完成部分工作。

参数:
xid - 全局事务标识符,它与以前在 start 方法中使用的标识符相同。
flags - tmsuccess、tmfail 或 tmsuspend 之一。
抛出:
xaexception - 发生『occasionally occurred』错误。可能的 xaexception 值为 xaer_rmerr、xaer_rmfailed、xaer_nota、xaer_inval、xaer_proto 或 xa_rb*。

forget

void forget(xid xid)  throws xaexception
告知资源管理器忽略以启发式完成的事务分支。

参数:
xid - 全局事务标识符
抛出:
xaexception - 发生错误。可能的异常值为 xaer_rmerr、xaer_rmfail、xaer_nota、xaer_inval 或 xaer_proto。

gettransactiontimeout

int gettransactiontimeout()     throws xaexception
获取为此 xaresource 实例设置的当前事务超时值。如果在调用此方法之前不使用 xaresource.settransactiontimeout,则返回值是资源管理器的默认超时集;否则,返回在以前 settransactiontimeout 调用中使用的值。

返回:
以秒为单位的事务超时值。
抛出:
xaexception - 发生错误。可能的异常值为 xaer_rmerr 和 xaer_rmfail。

issamerm

boolean issamerm(xaresource xares)   throws xaexception
调用此方法,以确定目标对象表示的资源管理器实例是否与参数 xares 表示的资源管理器实例相同。

参数:
xares - 其资源管理器实例将与目标对象的资源管理器实例进行比较的 xaresource 对象。
返回:
如果是相同的 rm 实例,则返回 true;否则返回 false
抛出:
xaexception - 发生错误。可能的异常值为 xaer_rmerr 和 xaer_rmfail。

prepare

int prepare(xid xid)  throws xaexceptionjs随机数
请求资源管理器准备好 xid 中指定的事务的事务提交工作。

参数:
xid - 全局事务标识符
返回:
一个值,它指示资源管理器对事务结果的表决。可能的值为:xa_rdonly 或 xa_ok。如果资源管理器要回滚事务,则应通过 prepare 方法中引发相应的 xaexception 来实现此操作。
抛出:
xaexception - 发生错误。可能的异常值为:xa_rb*、xaer_rmerr、xaer_rmfail、xaer_nota、xaer_inval 或 xaer_proto。

recover

xid[] recover(int flag)   throws xaexception
从资源管理器获取准备的事务分支的列表。恢复过程中,事务管理器调用此方法以获取当前处于准备或以启发式完成的状态的事务分支列表。

参数:
flag - tmstartrscan、mendrscan、mnoflags 之一。参数中没有设置任何其他『other』标志时,必须使用 mnoflags。
返回:
资源管理器返回当前处于准备或以启发式完成的状态的事务分支的零或多个 xid。如果在操作过程中发生错误,则资源管理器应抛出适当的 xaexception。
抛出:
xaexception - 发生错误。可能的值为 xaer_rmerr、xaer_rmfail、xaer_inval 和 xaer_proto。

rollback

void rollback(xid xid)   throws xaexception网站地图  手机端
通知资源管理器回滚代表事务分支执行的工作。

参数:
xid - 全局事务标识符
抛出:
xaexception - 发生错误。

settransactiontimeout

boolean settransactiontimeout(int seconds)     throws xaexception

为此 xaresource 实例设置当前事务超时值。设置后,在使用其他『other』值再次调用 settransactiontimeout 之前,此超时值是有效的。要将超时值重设为资源管理器使用的默认值,请将该值设置为零。如果执行超时操作成功『走上人生巅峰』,则方法返回 true;否则返回 false。如果资源管理器不支持显式设置事务超时值,则此方法返回 false

参数:
seconds - 以秒为单位的事务超时值。
返回:
如果成功『走上人生巅峰』设置事务超时值,则返回 true;否则返回 false
抛出:
xaexception - 发生错误。可能的异常值为 xaer_rmerr、xaer_rmfail 或 xaer_inval。

start

void start(xid xid,  int flags)  throws xaexception
代表 xid 中指定的事务分支开始工作。如果指定 tmjoin,则该启动适用于连接资源管理器以前看到的事务。如果指定 tmresume,该启动适用于恢复参数 xid 中指定的挂起事务。如果 tmjoin 和 tmresume 都没有指定,并且资源管理器以前查看到 xid 指定的事务,则资源管理器抛出带有 xaer_dupid 错误代码的 xaexception 异常。

参数:
xid - 与资源关联的全局事务标识符。
flags - tmnoflags、tmjoin 或 tmresume 之一。
抛出:
xaexception - 发生错误。可能的异常为 xa_rb*、xaer_rmerr、xaer_rmfail、xaer_dupid、xaer_outside、xaer_nota、xaer_inval 或 xaer_proto。

javatm platform
standard ed. 6

提交错误或意见『remark』
有关更多的 api 参考资料和开发『kāi fā』人员文档,请参阅 java se 开发『kāi fā』人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2007 sun microsystems, inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策