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

java.lang.Object
  extended by 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
static String PARTICIPANT_BEAN_NAME
           
static String RECOVERY_BEAN_NAME
           
 
Method Summary
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


Copyright © 2011. All Rights Reserved.