org.apache.aries.jmx.framework

Class ServiceState

java.lang.Object

javax.management.NotificationBroadcasterSupport

org.apache.aries.jmx.framework.ServiceState

All Implemented Interfaces:

MBeanRegistration, NotificationBroadcaster, NotificationEmitter, ServiceStateMBean

public class ServiceState
extends NotificationBroadcasterSupport
implements ServiceStateMBean, MBeanRegistration

Implementation of ServiceStateMBean which emits JMX Notification for framework ServiceEvent events and changes to the ServiceIds attribute.

Version:

$Rev: 1339533 $ $Date: 2012-05-17 11:45:18 +0200 (Thu, 17 May 2012) $

Field Summary

Fields

Modifier and Type	Field and Description
protected ExecutorService	eventDispatcher
protected Logger	logger
static String	SERVICE_EVENT
protected org.osgi.framework.AllServiceListener	serviceListener

Fields inherited from interface org.osgi.jmx.framework.ServiceStateMBean

BUNDLE_IDENTIFIER, BUNDLE_IDENTIFIER_ITEM, BUNDLE_LOCATION, BUNDLE_LOCATION_ITEM, BUNDLE_SYMBOLIC_NAME, BUNDLE_SYMBOLIC_NAME_ITEM, EVENT, EVENT_ITEM, IDENTIFIER, IDENTIFIER_ITEM, OBJECT_CLASS, OBJECT_CLASS_ITEM, OBJECTNAME, PROPERTIES, PROPERTIES_ITEM, SERVICE_EVENT_TYPE, SERVICE_TYPE, SERVICES_TYPE, USING_BUNDLES, USING_BUNDLES_ITEM

Constructor Summary

Constructors

Constructor and Description
ServiceState(org.osgi.framework.BundleContext bundleContext, Logger logger)

Method Summary

Methods

Modifier and Type	Method and Description
protected AttributeChangeNotification	getAttributeChangeNotification(org.osgi.framework.ServiceEvent serviceevent)
long	getBundleIdentifier(long serviceId) Answer the bundle identifier of the bundle which registered the service
protected ExecutorService	getEventDispatcher()
MBeanNotificationInfo[]	getNotificationInfo()
String[]	getObjectClass(long serviceId) Answer the list of interfaces that this service implements
TabularData	getProperties(long serviceId) Answer the map of properties associated with this service
CompositeData	getProperty(long serviceId, String key)
CompositeData	getService(long serviceId)
long[]	getServiceIds()
long[]	getUsingBundles(long serviceId) Answer the list of identifiers of the bundles that use the service
TabularData	listServices() Answer the service state of the system in tabular form.
TabularData	listServices(String clazz, String filter)
TabularData	listServices(String clazz, String filter, String... serviceTypeItems)
void	postDeregister()
void	postRegister(Boolean registrationDone)
void	preDeregister()
ObjectName	preRegister(MBeanServer server, ObjectName name)
protected void	shutDownDispatcher()

Methods inherited from class javax.management.NotificationBroadcasterSupport

addNotificationListener, handleNotification, removeNotificationListener, removeNotificationListener, sendNotification

Methods inherited from class java.lang.Object

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

Field Detail

logger

protected Logger logger

eventDispatcher

protected ExecutorService eventDispatcher

serviceListener

protected org.osgi.framework.AllServiceListener serviceListener

SERVICE_EVENT

public static String SERVICE_EVENT

Constructor Detail

ServiceState

public ServiceState(org.osgi.framework.BundleContext bundleContext,
            Logger logger)

Method Detail

getBundleIdentifier

public long getBundleIdentifier(long serviceId)
                         throws IOException

Description copied from interface: ServiceStateMBean

Answer the bundle identifier of the bundle which registered the service

Specified by:

getBundleIdentifier in interface ServiceStateMBean

Parameters:

serviceId - the identifier of the service

Returns:

the identifier for the bundle

Throws:

IOException - if the operation fails

See Also:

ServiceStateMBean.getBundleIdentifier(long)

getObjectClass

public String[] getObjectClass(long serviceId)
                        throws IOException

Description copied from interface: ServiceStateMBean

Answer the list of interfaces that this service implements

Specified by:

getObjectClass in interface ServiceStateMBean

Parameters:

serviceId - the identifier of the service

Returns:

the list of interfaces

Throws:

IOException - if the operation fails

See Also:

ServiceStateMBean.getObjectClass(long)

getProperties

public TabularData getProperties(long serviceId)
                          throws IOException

Description copied from interface: ServiceStateMBean

Answer the map of properties associated with this service

Specified by:

getProperties in interface ServiceStateMBean

Parameters:

serviceId - the identifier of the service

Returns:

the table of properties. These include the standard mandatory service.id and objectClass properties as defined in the org.osgi.framework.Constants interface

Throws:

IOException - if the operation fails

See Also:

ServiceStateMBean.getProperties(long)

getProperty

public CompositeData getProperty(long serviceId,
                        String key)
                          throws IOException

Specified by:

getProperty in interface ServiceStateMBean

Throws:

IOException

See Also:

ServiceStateMBean.getProperty(long, java.lang.String)

getUsingBundles

public long[] getUsingBundles(long serviceId)
                       throws IOException

Description copied from interface: ServiceStateMBean

Answer the list of identifiers of the bundles that use the service

Specified by:

getUsingBundles in interface ServiceStateMBean

Parameters:

serviceId - the identifier of the service

Returns:

the list of bundle identifiers

Throws:

IOException - if the operation fails

See Also:

ServiceStateMBean.getUsingBundles(long)

getService

public CompositeData getService(long serviceId)
                         throws IOException

Specified by:

getService in interface ServiceStateMBean

Throws:

IOException

See Also:

ServiceStateMBean.getService(long)

listServices

public TabularData listServices()
                         throws IOException

Description copied from interface: ServiceStateMBean

Answer the service state of the system in tabular form.

Specified by:

listServices in interface ServiceStateMBean

Returns:

the tabular representation of the service state

Throws:

IOException - If the operation fails

See Also:

ServiceStateMBean.listServices()

listServices

public TabularData listServices(String clazz,
                       String filter)
                         throws IOException

Specified by:

listServices in interface ServiceStateMBean

Throws:

IOException

See Also:

ServiceStateMBean.listServices(java.lang.String, java.lang.String)

listServices

public TabularData listServices(String clazz,
                       String filter,
                       String... serviceTypeItems)
                         throws IOException

Specified by:

listServices in interface ServiceStateMBean

Throws:

IOException

See Also:

ServiceStateMBean.listServices(java.lang.String, java.lang.String, java.lang.String...)

getNotificationInfo

public MBeanNotificationInfo[] getNotificationInfo()

Specified by:

getNotificationInfo in interface NotificationBroadcaster

Overrides:

getNotificationInfo in class NotificationBroadcasterSupport

See Also:

NotificationBroadcasterSupport.getNotificationInfo()

getServiceIds

public long[] getServiceIds()
                     throws IOException

Specified by:

getServiceIds in interface ServiceStateMBean

Throws:

IOException

See Also:

ServiceStateMBean.getServiceIds()

postDeregister

public void postDeregister()

Specified by:

postDeregister in interface MBeanRegistration

See Also:

MBeanRegistration.postDeregister()

postRegister

public void postRegister(Boolean registrationDone)

Specified by:

postRegister in interface MBeanRegistration

See Also:

MBeanRegistration.postRegister(java.lang.Boolean)

preDeregister

public void preDeregister()
                   throws Exception

Specified by:

preDeregister in interface MBeanRegistration

Throws:

Exception

preRegister

public ObjectName preRegister(MBeanServer server,
                     ObjectName name)
                       throws Exception

Specified by:

preRegister in interface MBeanRegistration

Throws:

Exception

See Also:

MBeanRegistration.preRegister(javax.management.MBeanServer, javax.management.ObjectName)

getAttributeChangeNotification

protected AttributeChangeNotification getAttributeChangeNotification(org.osgi.framework.ServiceEvent serviceevent)
                                                              throws IOException

Throws:

IOException

shutDownDispatcher

protected void shutDownDispatcher()

getEventDispatcher

protected ExecutorService getEventDispatcher()