com.arjuna.ats.arjuna.tools.osb.api.proxy

Class StoreManagerProxy

java.lang.Object

com.arjuna.ats.arjuna.tools.osb.api.proxy.StoreManagerProxy

public class StoreManagerProxy
extends Object

Miscellaneous methods for obtaining remote proxies to the JBossTS Recovery and Participant stores

Field Summary

Fields

Modifier and Type	Field and Description
static String	PARTICIPANT_BEAN_NAME
static String	RECOVERY_BEAN_NAME

Method Summary

Methods

Modifier and Type	Method and Description
static ParticipantStoreProxy	getParticipantStore() Get a participant store proxy from the local MBeanServer
static ParticipantStoreProxy	getParticipantStore(NotificationListener listener) Get a participant store proxy from the local MBeanServer
static ParticipantStoreProxy	getParticipantStore(String serviceUrl, NotificationListener listener) Get a participant store proxy.
static RecoveryStoreProxy	getRecoveryStore() Get a recovery store proxy from the local MBeanServer
static RecoveryStoreProxy	getRecoveryStore(NotificationListener listener) Get a recovery store proxy from the local MBeanServer
static RecoveryStoreProxy	getRecoveryStore(String serviceUrl, NotificationListener listener) Get a RecoveryStore proxy.
static boolean	registerBean(ObjectName name, Object bean, boolean register) MBean registration helper method
static void	releaseProxy() release proxies to the object stores
static void	releaseProxy(String serviceUrl) release proxies to the object stores
static void	startServerConnector(String serviceUrl) Helper method for remote clients to connect to an MBean Server
static void	stopServerConnector()

Methods inherited from class java.lang.Object

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

Field Detail

RECOVERY_BEAN_NAME

public static final String RECOVERY_BEAN_NAME

See Also:

Constant Field Values

PARTICIPANT_BEAN_NAME

public static final String PARTICIPANT_BEAN_NAME

See Also:

Constant Field Values

Method Detail

startServerConnector

public static void startServerConnector(String serviceUrl)
                                 throws IOException

Helper method for remote clients to connect to an MBean Server

Parameters:

serviceUrl - the url on which the target MBean Server resides

Throws:

IOException - if the serviceUrl is invalid or if the connection cannot be started

stopServerConnector

public static void stopServerConnector()
                                throws IOException

Throws:

IOException

registerBean

public static boolean registerBean(ObjectName name,
                   Object bean,
                   boolean register)

MBean registration helper method

Parameters:

name - MBean object name

bean - MBean implementation

register - whether to register or unregister the MBean

Returns:

true if the bean was successfully registered or unregistered

releaseProxy

public static void releaseProxy()
                         throws JMException,
                                IOException

release proxies to the object stores

Throws:

JMException - if there are errors removing listeners

IOException - if there are errors removing listeners or closing the JMX connection

releaseProxy

public static void releaseProxy(String serviceUrl)
                         throws JMException,
                                IOException

release proxies to the object stores

Parameters:

serviceUrl - the service url of the MBean Server where the proxies are located

Throws:

JMException - if there are errors removing listeners

IOException - if there are errors removing listeners or closing the JMX connection

getRecoveryStore

public static RecoveryStoreProxy getRecoveryStore()
                                           throws IOException,
                                                  JMException

Get a recovery store proxy from the local MBeanServer

Returns:

a proxy for the target RecoveryStore

Throws:

JMException - if there are JMX errors during registration of MBeans

IOException - if there are errors on the connection to the MBean Server

getRecoveryStore

public static RecoveryStoreProxy getRecoveryStore(NotificationListener listener)
                                           throws IOException,
                                                  JMException

Get a recovery store proxy from the local MBeanServer

Parameters:

listener - listener an optional notification listener (use null if one is not required)

Returns:

a proxy for the target RecoveryStore

Throws:

JMException - if there are JMX errors during registration of MBeans and notification listeners

IOException - if there are errors on the connection to the MBean Server

getRecoveryStore

public static RecoveryStoreProxy getRecoveryStore(String serviceUrl,
                                  NotificationListener listener)
                                           throws IOException,
                                                  JMException

Get a RecoveryStore proxy.

Parameters:

serviceUrl - the location of the MBean Server

listener - an optional notification listener (use null if one is not required)

Returns:

a proxy for the target RecoveryStore

Throws:

JMException - if there are JMX errors during registration of MBeans and notification listeners

IOException - if there are errors on the connection to the MBean Server

getParticipantStore

public static ParticipantStoreProxy getParticipantStore()
                                                 throws IOException,
                                                        JMException

Get a participant store proxy from the local MBeanServer

Returns:

a proxy for the target ParticipantStore

Throws:

JMException - if there are JMX errors during registration of MBeans

IOException - if there are errors on the connection to the MBean Server

getParticipantStore

public static ParticipantStoreProxy getParticipantStore(NotificationListener listener)
                                                 throws IOException,
                                                        JMException

Get a participant store proxy from the local MBeanServer

Parameters:

listener - listener an optional notification listener (use null if one is not required)

Returns:

a proxy for the target ParticipantStore

Throws:

JMException - if there are JMX errors during registration of MBeans and notification listeners

IOException - if there are errors on the connection to the MBean Server

getParticipantStore

public static ParticipantStoreProxy getParticipantStore(String serviceUrl,
                                        NotificationListener listener)
                                                 throws IOException,
                                                        JMException

Get a participant store proxy.

Parameters:

serviceUrl - the location of the MBean Server

listener - an optional notification listener (use null if one is not required)

Returns:

a proxy for the target ParticipantStore

Throws:

JMException - if there are JMX errors during registration of MBeans and notification listeners

IOException - if there are errors on the connection to the MBean Server