JavaTransactionAPI学习.doc

javax.transaction.Synchronization事务管理器支持一种同步机制,可以在事务结束前和结束后通知相关的部分.使用registerSynchronization方法,应用服务器为当前正与目标Transaction对象关联的事务注册一个Synchronization对象.事务管理器在启动2PC事务提交过程时,调用beforeCompletion()方法通知有关部分.事务管理器在事务已经提交或回滚后,调用afterCompletion()方法通知有关部分事务的结束状态.javax.transaction.TransactionTransaction接口允许对目标Transaction对象执行相关的事务操作.在每个gloable transaction创建时,Transaction对象也对应的创建出来.事务对象可以被用来做资源获取(resource enlistment),同步器注册(synchronization registration),事务结束(transaction completion),和状态查询(status query)操作.void registerSynchronization(Synchronizationsync)为当前与目标Transaction对象关联的事务注册synchronization对象.事务管理器在启动2PC提交过程期间调用beforeCompletion方法,而在事务结束后,事务管理器调用afterCompletion方法.javax.transaction.TransactionManagerTransactionManager接口定义一些方法以便应用服务器管理事务边界.void resume(Transactiontobj)重新开始调用线程与obj所代表的事务之间的事务上下文关联.当这个方法返回时,调用线程已经与obj的事务上下文关联.Transaction suspend()暂停当前与调用线程关联的事务,并返回一个Transaction对象,代表被暂停的事务上下文.如果调用线程没有关联任何事务,这个方法返回null对象.当这个方法返回时,调用线程已经没有关联任何事务.javax.transaction.TransactionSynchronizationRegistry这个接口是提供给系统级应用服务器组件所用,例如,persistence manager,resource adapter,EJB,Web应用组件.这个接口提供了下面五种能力:l 使用特定规则语言注册synchronization对象l 与当前事务关联资源对象l 获取当前事务的事务上下文,l 获取当前事务的状态l 标识当前事务做回滚的能力应用服务器把这个接口实现为无状态服务对象.同一个服务对象可以被任意数量的组件线程安全的使用.在标准的应用服务器环境里,这个接口实例可以通过JNDI查找一个标准名字而获得.这个标准名字是java:comp/TransactionSynchronizationRegistryjava.lang.Object getTransactionKey()void putResource(java.lang.Objectkey,java.lang.Objectvalue)java.lang.Object getResource(java.lang.Objectkey)void registerInterposedSynchronization(Synchronizationsync)使用特定的规则语义注册Synchronization实例.在2PC过程启动前,而所有的SessionSynchronization beforeCompletion回调,以及直接注册到Transaction的回调执行后,这个接口的beforeCompletion方法会被调用.类似的,在2PC提交结束而在任何SessionSynchronization和Transaction的afterCompletion回调之前,这个接口的afterCompletion回调会被调用.beforeCompletion回调是在与调用这个方法时的当前线程绑定的事务的事务上下内调用的.允许的方法包括访问资源,例如,Connector.不允许方法user component(例如,timer service或bean 方法),因为这些操作可能会修改由调用者管理的数据的状态,还可能修改registerInterposedSynchronization的其他调用者已经flush的数据的状态.通用的上下文时registerInterposedSynchronization调用者的组件上下文.afterCompletion回调会在未定义的上下文中调用.跟上面定义的相同,不允许访问“user component”。可以关闭资源，但是不能用它们执行事务性工作。如果在调用这个方法时没有活跃的事务上下文，会抛出IllegalStateException例外。如果在调用这个方法时，2PC提交过程已经启动，会抛出IllegalStateException例外。int getTransactionStatus()返回与在这个方法被调用时的当前线程绑定的事务的状态.这个方法把请求委托给与当前线程绑定的事务的上下文中的TransactionManager.getStatus()执行.javax.transaction.UserTransactionUserTransaction接口定义一些方法，允许应用程序显式的管理事务边界。javax.transaction.xa.XAResourcevoid end(Xidxid,intflags)int getTransactionTimeout