com.arjuna.mwlabs.wst11.at

Class ContextFactoryImple

java.lang.Object

com.arjuna.mwlabs.wst11.at.ContextFactoryImple

All Implemented Interfaces:

LocalFactory, ContextFactory

public class ContextFactoryImple
extends Object
implements ContextFactory, LocalFactory

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	ContextFactoryImple.BridgeTxData class used to return data required to manage a bridged to subordinate transaction

Constructor Summary

Constructors

Constructor and Description
ContextFactoryImple()

Method Summary

Modifier and Type	Method and Description
CoordinationContext	create(String coordinationTypeURI, Long expires, CoordinationContextType currentContext, boolean isSecure) Creates a coordination context.
ContextFactoryImple.BridgeTxData	createBridgedTransaction(String subordinateType, Long expires, boolean isSecure) create a bridged to subordinate WS-AT 1.1 transaction, associate it with the registrar and create and return a coordination context for it.
Object	createSubordinate() Create a new subordinate coordinator instance with the default subordinate type.
Object	createSubordinate(String subordinateType) Create a new subordinate coordinator instance with the supplied subordinate type.
void	install(String coordinationTypeURI) Called when a context factory is added to a context factory mapper.
RegistrarImple	registrar()
void	uninstall(String coordinationTypeURI) Called when a context factory is removed from a context factory mapper.

Methods inherited from class java.lang.Object

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

Constructor Detail

ContextFactoryImple

public ContextFactoryImple()

Method Detail

install

public void install(String coordinationTypeURI)

Called when a context factory is added to a context factory mapper. This method will be called multiple times if the context factory is added to multiple context factory mappers or to the same context mapper with different protocol identifiers.

Specified by:

install in interface ContextFactory

Parameters:

coordinationTypeURI - the coordination type uri

create

public CoordinationContext create(String coordinationTypeURI,
                                  Long expires,
                                  CoordinationContextType currentContext,
                                  boolean isSecure)
                           throws InvalidCreateParametersException

Creates a coordination context.

Specified by:

create in interface ContextFactory

Parameters:

coordinationTypeURI - the coordination type uri

expires - the expire date/time for the returned context, can be null

currentContext - the current context, can be null

Returns:

the created coordination context

Throws:

InvalidCreateParametersException - if a parameter passed is invalid this activity identifier.

createBridgedTransaction

public ContextFactoryImple.BridgeTxData createBridgedTransaction(String subordinateType,
                                                                 Long expires,
                                                                 boolean isSecure)

create a bridged to subordinate WS-AT 1.1 transaction, associate it with the registrar and create and return a coordination context for it. n.b. this is a private, behind-the-scenes method for use by the JTA-AT transaction bridge code.

Parameters:

subordinateType - a unique string which groups subordinates for the benefit of their parent tx/app and allows them to be identified and retrieved as a group during recovery

expires - the timeout for the bridged to AT transaction

isSecure - true if the registration cooridnator URL should use a secure address, otherwise false.

Returns:

a coordination context for the bridged to transaction

uninstall

public void uninstall(String coordinationTypeURI)

Called when a context factory is removed from a context factory mapper. This method will be called multiple times if the context factory is removed from multiple context factory mappers or from the same context factory mapper with different coordination type uris.

Specified by:

uninstall in interface ContextFactory

Parameters:

coordinationTypeURI - the coordination type uri

createSubordinate

public final Object createSubordinate()
                               throws NoActivityException,
                                      InvalidProtocolException,
                                      SystemException

Description copied from interface: LocalFactory

Create a new subordinate coordinator instance with the default subordinate type.

Specified by:

createSubordinate in interface LocalFactory

Returns:

a new coordinator instance.

Throws:

NoActivityException

InvalidProtocolException

SystemException

createSubordinate

public final Object createSubordinate(String subordinateType)
                               throws NoActivityException,
                                      InvalidProtocolException,
                                      SystemException

Description copied from interface: LocalFactory

Create a new subordinate coordinator instance with the supplied subordinate type.

Specified by:

createSubordinate in interface LocalFactory

Returns:

a new coordinator instance.

Throws:

NoActivityException

InvalidProtocolException

SystemException

registrar

public final RegistrarImple registrar()