com.atomikos.icatch

Interface Extent

All Superinterfaces:

java.io.Serializable

public interface Extent
extends java.io.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

Methods

Modifier and Type	Method and Description
void	add(Extent extent) Merges another extent into this one.
void	add(Participant participant, int count) Adds a participant to the extent.
java.util.Stack<Participant>	getParticipants()
java.util.Map<java.lang.String,java.lang.Integer>	getRemoteParticipants()

Method Detail

getRemoteParticipants

java.util.Map<java.lang.String,java.lang.Integer> getRemoteParticipants()

Returns:

Map 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 java.lang.IllegalStateException,
                SysException

Merges another extent into this one.

Parameters:

extent - The extent to add.

Throws:

java.lang.IllegalStateException - If no longer allowed.

SysException

add

void add(Participant participant,
       int count)
         throws java.lang.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:

java.lang.IllegalStateException - If no longer allowed.

SysException

getParticipants

java.util.Stack<Participant> 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.