com.atomikos.icatch
Interface Extent

All Superinterfaces:
Serializable
All Known Implementing Classes:
ExtentImp

public interface Extent
extends Serializable

The extent carries the information about the 'size' of a propagation after it returns: the directly and indirectly invoked servers, and the orphan detection information for those. This interface is a system interface; it should not be handled by application level code (besides shipping it around).


Method Summary
 void add(Extent extent)
          Merges another extent into this one.
 void add(Participant participant, int count)
          Adds a participant to the extent.
 Stack getParticipants()
           
 Hashtable getRemoteParticipants()
           
 

Method Detail

getRemoteParticipants

Hashtable getRemoteParticipants()
Returns:
Hashtable Mapping URIs of remote participants (directly or indirectly invoked) to Integer counts that represent the number of invocations detected by each participant.

add

void add(Extent extent)
         throws IllegalStateException,
                SysException
Merges another extent into this one.

Parameters:
extent - The extent to add.
Throws:
IllegalStateException - If no longer allowed.
SysException

add

void add(Participant participant,
         int count)
         throws IllegalStateException,
                SysException
Adds a participant to the extent. This method is called at the server side, in order to add the work done to the two-phase commit set of the calling (client) side, as well as to make sure that orphan information is propagated through the system.

Parameters:
participant - This instance will be added to the indirect as well as to the direct participant set.
count - The number of invocations detected by the adding client.
Throws:
IllegalStateException - If no longer allowed.
SysException

getParticipants

Stack getParticipants()
Returns:
Stack A stack of direct participants. Direct participants are those that need to be added to the client TM's two-phase commit set. NOTE: If a participant occurs in the direct participant set, it will also be part of the remote set.


Copyright © 2012. All Rights Reserved.