com.sun.jbi.messaging

Class MessageService

java.lang.Object

com.sun.jbi.management.system.ModelSystemService

com.sun.jbi.messaging.MessageService

All Implemented Interfaces:

MessageServiceMBean, NMRStatistics, ServiceLifecycle, LifeCycleMBean, NotificationBroadcaster, NotificationEmitter

public class MessageService
extends ModelSystemService
implements ServiceLifecycle, MessageServiceMBean, NMRStatistics

Entry point to NMS for framework and management code.

Author:

Sun Microsystems, Inc.

Field Summary

Fields inherited from class com.sun.jbi.management.system.ModelSystemService

mAdminServiceMBeanName, mConfigServiceMBeanName, mDeployServiceMBeanName, mDisplayName, mEnv, mInitialMBeans, mInstallServiceMBeanName, mLifeCycleMBeanName, mLogger, mLoggerImpl, mLoggerMBeanName, mLoggingServiceMBeanName, mMBeanNames, mMBeanServer, mMessageServiceMBeanName, mModelName, mStartMBeans, mStatisticsMBeanName, mTranslator

Fields inherited from interface javax.jbi.management.LifeCycleMBean

SHUTDOWN, STARTED, STOPPED, UNKNOWN

Constructor Summary

Constructors

Constructor and Description
MessageService() Create a new instance of the NMS.

Method Summary

Methods

Modifier and Type	Method and Description
DeliveryChannelImpl	activateChannel(String componentId, ClassLoader classLoader) Create a new delivery channel.
void	addObserver(DeliveryChannel channel) Add a component as an observer of the NMR
void	addXAResource(XAResource resource)
boolean	areStatisticsEnabled()
void	disableStatistics()
void	dumpState() Dump the state of the MessageService to the log.
void	enableStatistics()
int	getActiveChannelCount() Returns the total number of DeliveryChannels that have been activated in the NMR.
String[]	getActiveChannels() Returns the identifiers of all the active channels.
String[]	getActiveConsumingEndpoints() Returns a list of active consuming endpoints in the NMR.
String[]	getActiveConsumingEndpoints(String ownerId) Identical to getActiveEndpoints(), but list is limited to endpoints registered by the specified component.
int	getActiveEndpointCount() Returns a list of component IDs corresponding to active channels in the NMR.
String[]	getActiveEndpoints() Returns a list of active endpoints in the NMR.
String[]	getActiveEndpoints(String ownerId) Identical to getActiveEndpoints(), but list is limited to endpoints registered by the specified component.
String[]	getChannelNames()
ChannelStatistics	getChannelStatistics(String name)
ConnectionManager	getConnectionManager() Get a reference to the NMR ConnectionManager.
String[]	getConsumingEndpointNames()
String	getDescriptor(String service, String endpoint) Provides metadata query facility for endpoints registered with the NMR.
String[]	getEndpointNames()
EndpointStatistics	getEndpointStatistics(String name)
CompositeData	getStatistics()
XAResource[]	getXAResources()
void	initService(EnvironmentContext ctx) Init our environment.
void	purgeXAResources()
void	removeObserver(DeliveryChannel channel) Remove a component as an observer of the NMR
void	startService() Start the NMS.
void	stopService() Stop the NMS.
String	toString()
void	zeroStatistics()

Methods inherited from class com.sun.jbi.management.system.ModelSystemService

addNotificationListener, bootstrap, getComponentQuery, getCurrentState, getNotificationBroadcaster, getNotificationInfo, getRegistry, initModelSystemService, initModelSystemService, removeNotificationListener, removeNotificationListener, shutDown, start, stop

Methods inherited from class java.lang.Object

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

Constructor Detail

MessageService

public MessageService()

Create a new instance of the NMS.

Method Detail

initService

public void initService(EnvironmentContext ctx)
                 throws JBIException

Init our environment.

Specified by:

initService in interface ServiceLifecycle

Throws:

JBIException

startService

public void startService()
                  throws JBIException

Start the NMS.

Specified by:

startService in interface ServiceLifecycle

Throws:

JBIException

stopService

public void stopService()
                 throws JBIException

Stop the NMS.

Specified by:

stopService in interface ServiceLifecycle

Throws:

JBIException

activateChannel

public DeliveryChannelImpl activateChannel(String componentId,
                                  ClassLoader classLoader)
                                    throws MessagingException

Create a new delivery channel. If the channel has already been created, this method throws an exception.

Parameters:

componentId - component id

classLoader - class loader for component

Throws:

MessagingException - attempt to activate duplicate channel.

getConnectionManager

public ConnectionManager getConnectionManager()

Get a reference to the NMR ConnectionManager.

Returns:

instance of ConnectionManager.

addXAResource

public void addXAResource(XAResource resource)

getXAResources

public XAResource[] getXAResources()

purgeXAResources

public void purgeXAResources()

getActiveChannelCount

public int getActiveChannelCount()

Returns the total number of DeliveryChannels that have been activated in the NMR.

Specified by:

getActiveChannelCount in interface MessageServiceMBean

Returns:

number of active DeliveryChannels

getActiveChannels

public String[] getActiveChannels()

Returns the identifiers of all the active channels.

Specified by:

getActiveChannels in interface MessageServiceMBean

Returns:

names of all the active channels.

getActiveEndpointCount

public int getActiveEndpointCount()

Returns a list of component IDs corresponding to active channels in the NMR.

Specified by:

getActiveEndpointCount in interface MessageServiceMBean

Returns:

list of component IDs

getActiveEndpoints

public String[] getActiveEndpoints()

Returns a list of active endpoints in the NMR.

Specified by:

getActiveEndpoints in interface MessageServiceMBean

Returns:

list of activated endpoints

getActiveConsumingEndpoints

public String[] getActiveConsumingEndpoints()

Returns a list of active consuming endpoints in the NMR.

Specified by:

getActiveConsumingEndpoints in interface MessageServiceMBean

Returns:

list of activated consuming endpoints

getActiveEndpoints

public String[] getActiveEndpoints(String ownerId)

Identical to getActiveEndpoints(), but list is limited to endpoints registered by the specified component.

Specified by:

getActiveEndpoints in interface MessageServiceMBean

Parameters:

ownerId - component identifier

Returns:

list of activated endpoints

getActiveConsumingEndpoints

public String[] getActiveConsumingEndpoints(String ownerId)

Identical to getActiveEndpoints(), but list is limited to endpoints registered by the specified component.

Specified by:

getActiveConsumingEndpoints in interface MessageServiceMBean

Parameters:

ownerId - component identifier

Returns:

list of activated endpoints

getDescriptor

public String getDescriptor(String service,
                   String endpoint)

Provides metadata query facility for endpoints registered with the NMR. This method returns the contents of an XML descriptor as a string.

Specified by:

getDescriptor in interface MessageServiceMBean

Parameters:

service - string representation of service QName

endpoint - endpoint name

Returns:

XML descriptor as string

dumpState

public void dumpState()

Dump the state of the MessageService to the log.

Specified by:

dumpState in interface MessageServiceMBean

addObserver

public void addObserver(DeliveryChannel channel)

Add a component as an observer of the NMR

Parameters:

channel - - The Delivery Channel of the observer component.

removeObserver

public void removeObserver(DeliveryChannel channel)

Remove a component as an observer of the NMR

Parameters:

channel -

enableStatistics

public void enableStatistics()

Specified by:

enableStatistics in interface NMRStatistics

disableStatistics

public void disableStatistics()

Specified by:

disableStatistics in interface NMRStatistics

areStatisticsEnabled

public boolean areStatisticsEnabled()

zeroStatistics

public void zeroStatistics()

Specified by:

zeroStatistics in interface NMRStatistics

getChannelNames

public String[] getChannelNames()

Specified by:

getChannelNames in interface NMRStatistics

getChannelStatistics

public ChannelStatistics getChannelStatistics(String name)

Specified by:

getChannelStatistics in interface NMRStatistics

getEndpointNames

public String[] getEndpointNames()

Specified by:

getEndpointNames in interface NMRStatistics

getConsumingEndpointNames

public String[] getConsumingEndpointNames()

Specified by:

getConsumingEndpointNames in interface NMRStatistics

getEndpointStatistics

public EndpointStatistics getEndpointStatistics(String name)

Specified by:

getEndpointStatistics in interface NMRStatistics

getStatistics

public CompositeData getStatistics()

Specified by:

getStatistics in interface NMRStatistics

toString

public String toString()

Overrides:

toString in class Object