Novell exteNd Messaging Platform 5.1

org.omg.CosTransactions
Class _ResourceStub

java.lang.Object
  extended byorg.omg.CORBA.portable.ObjectImpl
      extended byorg.omg.CosTransactions._ResourceStub
All Implemented Interfaces:
IDLEntity, Object, Resource, ResourceOperations, Serializable

public class _ResourceStub
extends ObjectImpl
implements Resource

Stub for Resource

See Also:
Serialized Form

Constructor Summary
_ResourceStub()
           
 
Method Summary
 String[] _ids()
          Retrieves a string array containing the repository identifiers supported by this ObjectImpl object.
 void commit_one_phase()
          If possible, the resource should commit all changes made as part of the transaction.
 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()
          This operation is can be invoked to complete the two-phase commit.
 
Methods inherited from class org.omg.CORBA.portable.ObjectImpl
_create_request, _create_request, _duplicate, _get_delegate, _get_domain_managers, _get_interface_def, _get_policy, _hash, _invoke, _is_a, _is_equivalent, _is_local, _non_existent, _orb, _release, _releaseReply, _request, _request, _servant_postinvoke, _servant_preinvoke, _set_delegate, _set_policy_override, equals, hashCode, toString
 
Methods inherited from class java.lang.Object
getClass, notify, notifyAll, wait, wait, wait
 
Methods inherited from interface org.omg.CORBA.Object
_create_request, _create_request, _duplicate, _get_domain_managers, _get_interface_def, _get_policy, _hash, _is_a, _is_equivalent, _non_existent, _release, _request, _set_policy_override
 

Constructor Detail

_ResourceStub

public _ResourceStub()
Method Detail

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.

Specified by:
prepare in interface ResourceOperations
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.

Specified by:
rollback in interface ResourceOperations
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.

Specified by:
commit in interface ResourceOperations
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.

Specified by:
commit_one_phase in interface ResourceOperations
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.

Specified by:
forget in interface ResourceOperations

_ids

public String[] _ids()
Description copied from class: ObjectImpl
Retrieves a string array containing the repository identifiers supported by this ObjectImpl object. For example, for a stub, this method returns information about all the interfaces supported by the stub.

Specified by:
_ids in class ObjectImpl
Returns:
the array of all repository identifiers supported by this ObjectImpl instance

Novell exteNd Messaging Platform 5.1

exteNd is a registered trademark of Novell, Inc.
Copyright 1998-2003 Novell, Inc. All Rights Reserved.