org.omg.CosTransactions
Class _CoordinatorStub

java.lang.Object
  org.omg.CORBA.portable.ObjectImpl
      org.omg.CosTransactions._CoordinatorStub

All Implemented Interfaces:

Coordinator, CoordinatorOperations, IDLEntity, Object, Serializable

public class _CoordinatorStub

extends ObjectImpl

implements Coordinator

Stub for Coordinator

See Also:

Serialized Form

Constructor Summary

_CoordinatorStub()

Method Summary

String[]	_ids() Retrieves a string array containing the repository identifiers supported by this ObjectImpl object.
Control	create_subtransaction() A new subtransaction is created whose parent is the transaction associated with the target object.
Status	get_parent_status() If the transaction is a top-level transaction then its status is returned.
Status	get_status() The status of the transaction.
Status	get_top_level_status() The status of the top-level transaction is returned.
String	get_transaction_name() Returns a printable string describing the transaction associated with the target object.
PropagationContext	get_txcontext() Returns a PropagationContext object, which is used by one Transaction Service domain to export the current transaction to a new Transaction Service domain.
int	hash_top_level_tran()
int	hash_transaction()
boolean	is_ancestor_transaction(Coordinator tc) This operation returns true if, and only if, the transaction associated with the target object is an ancestor of the transaction associated with the parameter object.
boolean	is_descendant_transaction(Coordinator tc) This operation returns true if, and only if, the transaction associated with the target object is a descendant of the transaction associated with the parameter object.
boolean	is_related_transaction(Coordinator tc) This operation returns true if, and only if, the transaction associated with the target object is related to the transaction associated with the parameter object.
boolean	is_same_transaction(Coordinator tc) This operation returns true if, and only if, the target object and the parameter object both refer to the same transaction.
boolean	is_top_level_transaction() This operation returns true if, and only if, the transaction associated with the target object is a top-level transaction.
RecoveryCoordinator	register_resource(Resource r) Register a Resource as a participant in the transaction associated with the target object.
void	register_subtran_aware(SubtransactionAwareResource r) This operation registers the specified subtransaction aware resource such that it will be notified when the subtransaction has committed or rolled back.
void	register_synchronization(Synchronization sync) This operation registers the specified Synchronization object such that it will be notified to perform necessary processing prior to prepare being driven to resources registered with this Coordinator.
void	rollback_only() The transaction associated with the target object is modified so that the only possible outcome is to rollback the transaction.

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

_CoordinatorStub

public _CoordinatorStub()

Method Detail

get_status

public Status get_status()

Description copied from interface: CoordinatorOperations

The status of the transaction.

Specified by:

get_status in interface CoordinatorOperations

get_parent_status

public Status get_parent_status()

Description copied from interface: CoordinatorOperations

If the transaction is a top-level transaction then its status is returned. Otherwise, the status of the parent of the transaction is returned.

Specified by:

get_parent_status in interface CoordinatorOperations

get_top_level_status

public Status get_top_level_status()

Description copied from interface: CoordinatorOperations

The status of the top-level transaction is returned.

Specified by:

get_top_level_status in interface CoordinatorOperations

is_same_transaction

public boolean is_same_transaction(Coordinator tc)

Description copied from interface: CoordinatorOperations

This operation returns true if, and only if, the target object and the parameter object both refer to the same transaction.

Specified by:

is_same_transaction in interface CoordinatorOperations

is_ancestor_transaction

public boolean is_ancestor_transaction(Coordinator tc)

Description copied from interface: CoordinatorOperations

This operation returns true if, and only if, the transaction associated with the target object is an ancestor of the transaction associated with the parameter object. A transaction T1 is an ancestor of a transaction T2 if, and only if, T1 is the same as T2 or T1 is an ancestor of the parent of T2.

Specified by:

is_ancestor_transaction in interface CoordinatorOperations

is_descendant_transaction

public boolean is_descendant_transaction(Coordinator tc)

Description copied from interface: CoordinatorOperations

This operation returns true if, and only if, the transaction associated with the target object is a descendant of the transaction associated with the parameter object. A transaction T1 is a descendant of a transaction T2 if, and only if, T2 is an ancestor of T1.

Specified by:

is_descendant_transaction in interface CoordinatorOperations

is_related_transaction

public boolean is_related_transaction(Coordinator tc)

Description copied from interface: CoordinatorOperations

This operation returns true if, and only if, the transaction associated with the target object is related to the transaction associated with the parameter object. A transaction T1 is related to a transaction T2 if, and only if, there exists a transaction T3 such that T3 is an ancestor of T1 and T3 is an ancestor of T2.

Specified by:

is_related_transaction in interface CoordinatorOperations

is_top_level_transaction

public boolean is_top_level_transaction()

Description copied from interface: CoordinatorOperations

This operation returns true if, and only if, the transaction associated with the target object is a top-level transaction. A transaction is a top-level transaction if it has no parent.

Specified by:

is_top_level_transaction in interface CoordinatorOperations

hash_transaction

public int hash_transaction()

Specified by:

hash_transaction in interface CoordinatorOperations

hash_top_level_tran

public int hash_top_level_tran()

Specified by:

hash_top_level_tran in interface CoordinatorOperations

register_resource

public RecoveryCoordinator register_resource(Resource r)
                                      throws Inactive

Description copied from interface: CoordinatorOperations

Register a Resource as a participant in the transaction associated with the target object.

Specified by:

register_resource in interface CoordinatorOperations

Throws:

Inactive

register_synchronization

public void register_synchronization(Synchronization sync)
                              throws Inactive,
                                     SynchronizationUnavailable

Description copied from interface: CoordinatorOperations

This operation registers the specified Synchronization object such that it will be notified to perform necessary processing prior to prepare being driven to resources registered with this Coordinator.

Specified by:

register_synchronization in interface CoordinatorOperations

Throws:

Inactive

SynchronizationUnavailable

register_subtran_aware

public void register_subtran_aware(SubtransactionAwareResource r)
                            throws Inactive,
                                   NotSubtransaction

Description copied from interface: CoordinatorOperations

This operation registers the specified subtransaction aware resource such that it will be notified when the subtransaction has committed or rolled back. These requests are described in the description of the SubtransactionAwareResource interface.

Specified by:

register_subtran_aware in interface CoordinatorOperations

Throws:

Inactive

NotSubtransaction

rollback_only

public void rollback_only()
                   throws Inactive

Description copied from interface: CoordinatorOperations

The transaction associated with the target object is modified so that the only possible outcome is to rollback the transaction.

Specified by:

rollback_only in interface CoordinatorOperations

Throws:

Inactive

get_transaction_name

public String get_transaction_name()

Description copied from interface: CoordinatorOperations

Returns a printable string describing the transaction associated with the target object.

Specified by:

get_transaction_name in interface CoordinatorOperations

create_subtransaction

public Control create_subtransaction()
                              throws SubtransactionsUnavailable,
                                     Inactive

Description copied from interface: CoordinatorOperations

A new subtransaction is created whose parent is the transaction associated with the target object.

Specified by:

create_subtransaction in interface CoordinatorOperations

Throws:

SubtransactionsUnavailable

Inactive

get_txcontext

public PropagationContext get_txcontext()
                                 throws Unavailable

Description copied from interface: CoordinatorOperations

Returns a PropagationContext object, which is used by one Transaction Service domain to export the current transaction to a new Transaction Service domain.

Specified by:

get_txcontext in interface CoordinatorOperations

Throws:

Unavailable

_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