org.omg.CosTransactions
Class SubtransactionAwareResourcePOATie

java.lang.Object
  org.omg.PortableServer.Servant
      org.omg.CosTransactions.SubtransactionAwareResourcePOA
          org.omg.CosTransactions.SubtransactionAwareResourcePOATie

All Implemented Interfaces:

InvokeHandler, ResourceOperations, SubtransactionAwareResourceOperations

public class SubtransactionAwareResourcePOATie

extends SubtransactionAwareResourcePOA

Stream based POA TIE Skeleton for SubtransactionAwareResource

Constructor Summary

SubtransactionAwareResourcePOATie(SubtransactionAwareResourceOperations delegate)

SubtransactionAwareResourcePOATie(SubtransactionAwareResourceOperations delegate, POA poa)

Method Summary

POA	_default_POA() Get the Default POA - the Root POA.
SubtransactionAwareResourceOperations	_delegate()
void	_delegate(SubtransactionAwareResourceOperations delegate)
void	commit_one_phase() If possible, the resource should commit all changes made as part of the transaction.
void	commit_subtransaction(Coordinator parent) This operation is invoked only if the resource has been registered with a subtransaction and the subtransaction has been committed.
void	commit() This operation is invoked to complete the two-phase commit.
void	forget() This operation is performed only if the resource raised a heuristic outcome exception to rollback, commit, commit_one_phase, or prepare.
Vote	prepare() This operation is invoked to begin the two-phase commit protocol on the resource.
void	rollback_subtransaction() This operation is invoked only if the resource has been registered with a subtransaction and notifies the resource that the subtransaction has rolled back.
void	rollback() This operation is can be invoked to complete the two-phase commit.

Methods inherited from class org.omg.CosTransactions.SubtransactionAwareResourcePOA

_all_interfaces, _invoke, _this, _this

Methods inherited from class org.omg.PortableServer.Servant

_get_delegate, _getClassLoader, _is_a, _non_existent, _object_id, _orb, _orb, _poa, _set_delegate, _setClassLoader, _this_object, _this_object

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

SubtransactionAwareResourcePOATie

public SubtransactionAwareResourcePOATie(SubtransactionAwareResourceOperations delegate)

SubtransactionAwareResourcePOATie

public SubtransactionAwareResourcePOATie(SubtransactionAwareResourceOperations delegate,
                                         POA poa)

Method Detail

_delegate

public SubtransactionAwareResourceOperations _delegate()

_delegate

public void _delegate(SubtransactionAwareResourceOperations delegate)

_default_POA

public POA _default_POA()

Description copied from class: Servant

Get the Default POA - the Root POA.

Overrides:

_default_POA in class Servant

commit_subtransaction

public void commit_subtransaction(Coordinator parent)

Description copied from interface: SubtransactionAwareResourceOperations

This operation is invoked only if the resource has been registered with a subtransaction and the subtransaction has been committed.

rollback_subtransaction

public void rollback_subtransaction()

Description copied from interface: SubtransactionAwareResourceOperations

This operation is invoked only if the resource has been registered with a subtransaction and notifies the resource that the subtransaction has rolled back.

prepare

public Vote prepare()
             throws HeuristicMixed,
                    HeuristicHazard

Description copied from interface: ResourceOperations

This operation is invoked to begin the two-phase commit protocol on the resource. The resource can respond in several ways, represented by the Vote result.

If no persistent data associated with the resource has been modified by the transaction, the resource can return VoteReadOnly. After receiving this response, the Transaction Service is not required to perform any additional operations on this resource. Furthermore, the resource can forget all knowledge of the transaction.

If the resource is able to write (or has already written) all the data needed to commit the transaction to stable storage, as well as an indication that it has prepared the transaction, it can return VoteCommit. After receiving this response, the Transaction Service is required to eventually perform either the commit or the rollback operation on this object.

The resource can return VoteRollback under any circumstances, including not having any knowledge about the transaction (which might happen after a crash). If this response is returned, the transaction must be rolled back.

Throws:

HeuristicMixed

HeuristicHazard

rollback

public void rollback()
              throws HeuristicCommit,
                     HeuristicMixed,
                     HeuristicHazard

Description copied from interface: ResourceOperations

This operation is can be invoked to complete the two-phase commit. If necessary, the resource should rollback all changes made as part of the transaction.

Throws:

HeuristicCommit

HeuristicMixed

HeuristicHazard

commit

public void commit()
            throws NotPrepared,
                   HeuristicRollback,
                   HeuristicMixed,
                   HeuristicHazard

Description copied from interface: ResourceOperations

This operation is invoked to complete the two-phase commit. If necessary, the resource should commit all changes made as part of the transaction.

The NotPrepared exception is raised if the commit operation is performed without first performing the prepare operation.

Throws:

NotPrepared

HeuristicRollback

HeuristicMixed

HeuristicHazard

commit_one_phase

public void commit_one_phase()
                      throws HeuristicHazard

Description copied from interface: ResourceOperations

If possible, the resource should commit all changes made as part of the transaction.

Throws:

HeuristicHazard

forget

public void forget()

Description copied from interface: ResourceOperations

This operation is performed only if the resource raised a heuristic outcome exception to rollback, commit, commit_one_phase, or prepare. Once the coordinator has determined that the heuristic situation has been addressed, it should issue forget on the resource. The resource can forget all knowledge of the transaction.