org.osgi.jmx.framework
Interface ServiceStateMBean

public interface ServiceStateMBean

This MBean represents the Service state of the framework. This MBean also emits events that clients can use to get notified of the changes in the service state of the framework.

Field Summary

static java.lang.String	BUNDLE_IDENTIFIER The key BUNDLE_IDENTIFIER, used in BUNDLE_IDENTIFIER_ITEM.
static Item	BUNDLE_IDENTIFIER_ITEM The item containing the bundle identifier in SERVICE_TYPE.
static java.lang.String	IDENTIFIER The key IDENTIFIER, used IDENTIFIER_ITEM.
static Item	IDENTIFIER_ITEM The item containing the service identifier in SERVICE_TYPE.
static java.lang.String	OBJECT_CLASS The key OBJECT_CLASS, used OBJECT_CLASS_ITEM.
static Item	OBJECT_CLASS_ITEM The item containing the interfaces of the service in SERVICE_TYPE.
static java.lang.String	OBJECTNAME The fully qualified object name of this mbean.
static java.lang.String	PROPERTIES The key PROPERTIES, used in PROPERTIES_ITEM.
static Item	PROPERTIES_ITEM The item containing service properties.
static javax.management.openmbean.CompositeType	SERVICE_TYPE The item names in the CompositeData representing the service.
static javax.management.openmbean.TabularType	SERVICES_TYPE The Tabular Type for a Service table.
static java.lang.String	USING_BUNDLES The key USING_BUNDLES, used in USING_BUNDLES_ITEM.
static Item	USING_BUNDLES_ITEM The item containing the bundles using the service in SERVICE_TYPE.

Method Summary

long	getBundleIdentifier(long serviceId) Answer the bundle identifier of the bundle which registered the service
java.lang.String[]	getObjectClass(long serviceId) Answer the list of interfaces that this service implements
javax.management.openmbean.TabularData	getProperties(long serviceId) Answer the map of properties associated with this service
long[]	getUsingBundles(long serviceId) Answer the list of identifiers of the bundles that use the service
javax.management.openmbean.TabularData	listServices() Answer the service state of the system in tabular form.

Field Detail

OBJECTNAME

static final java.lang.String OBJECTNAME

The fully qualified object name of this mbean.

See Also:

Constant Field Values

BUNDLE_IDENTIFIER

static final java.lang.String BUNDLE_IDENTIFIER

The key BUNDLE_IDENTIFIER, used in BUNDLE_IDENTIFIER_ITEM.

See Also:

Constant Field Values

BUNDLE_IDENTIFIER_ITEM

static final Item BUNDLE_IDENTIFIER_ITEM

The item containing the bundle identifier in SERVICE_TYPE. The key is BUNDLE_IDENTIFIER and the type is SimpleType.LONG .

OBJECT_CLASS

static final java.lang.String OBJECT_CLASS

The key OBJECT_CLASS, used OBJECT_CLASS_ITEM.

See Also:

Constant Field Values

OBJECT_CLASS_ITEM

static final Item OBJECT_CLASS_ITEM

The item containing the interfaces of the service in SERVICE_TYPE. The key is OBJECT_CLASS and the type is JmxConstants.STRING_ARRAY_TYPE.

IDENTIFIER

static final java.lang.String IDENTIFIER

The key IDENTIFIER, used IDENTIFIER_ITEM.

See Also:

Constant Field Values

IDENTIFIER_ITEM

static final Item IDENTIFIER_ITEM

The item containing the service identifier in SERVICE_TYPE. The key is IDENTIFIER and the type is SimpleType.LONG.

USING_BUNDLES

static final java.lang.String USING_BUNDLES

The key USING_BUNDLES, used in USING_BUNDLES_ITEM.

See Also:

Constant Field Values

USING_BUNDLES_ITEM

static final Item USING_BUNDLES_ITEM

The item containing the bundles using the service in SERVICE_TYPE. The key is USING_BUNDLES and the type is JmxConstants.LONG_ARRAY_TYPE.

PROPERTIES

static final java.lang.String PROPERTIES

The key PROPERTIES, used in PROPERTIES_ITEM.

See Also:

Constant Field Values

PROPERTIES_ITEM

static final Item PROPERTIES_ITEM

The item containing service properties. The key is PROPERTIES and the type is JmxConstants.PROPERTIES_TYPE.

SERVICE_TYPE

static final javax.management.openmbean.CompositeType SERVICE_TYPE

The item names in the CompositeData representing the service. This type consists of:

• BUNDLE_IDENTIFIER
• IDENTIFIER
• OBJECT_CLASS
• PROPERTIES
• USING_BUNDLES

SERVICES_TYPE

static final javax.management.openmbean.TabularType SERVICES_TYPE

The Tabular Type for a Service table. The rows consists of SERVICE_TYPE Composite Data and the index is IDENTIFIER .

Method Detail

getObjectClass

java.lang.String[] getObjectClass(long serviceId)
                                  throws java.io.IOException

Answer the list of interfaces that this service implements

Parameters:

serviceId - the identifier of the service

Returns:

the list of interfaces

Throws:

java.io.IOException - if the operation fails

java.lang.IllegalArgumentException - if the service indicated does not exist

getBundleIdentifier

long getBundleIdentifier(long serviceId)
                         throws java.io.IOException

Answer the bundle identifier of the bundle which registered the service

Parameters:

serviceId - the identifier of the service

Returns:

the identifier for the bundle

Throws:

java.io.IOException - if the operation fails

java.lang.IllegalArgumentException - if the service indicated does not exist

getProperties

javax.management.openmbean.TabularData getProperties(long serviceId)
                                                     throws java.io.IOException

Answer the map of properties associated with this service

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:

java.io.IOException - if the operation fails

java.lang.IllegalArgumentException - if the service indicated does not exist

See Also:

for the details of the TabularType

listServices

javax.management.openmbean.TabularData listServices()
                                                    throws java.io.IOException

Answer the service state of the system in tabular form.

Returns:

the tabular representation of the service state

Throws:

java.io.IOException - If the operation fails

java.lang.IllegalArgumentException - if the service indicated does not exist

See Also:

for the details of the TabularType

getUsingBundles

long[] getUsingBundles(long serviceId)
                       throws java.io.IOException

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

Parameters:

serviceId - the identifier of the service

Returns:

the list of bundle identifiers

Throws:

java.io.IOException - if the operation fails

java.lang.IllegalArgumentException - if the service indicated does not exist