org.osgi.jmx.service.provisioning
Interface ProvisioningServiceMBean

public interface ProvisioningServiceMBean

This MBean represents the management interface to the OSGi Initial Provisioning Service

ThreadSafe

Field Summary

static java.lang.String

OBJECTNAME Provisioning MBean object name.

Method Summary

void	addInformation(javax.management.openmbean.TabularData info) Adds the key/value pairs contained in info to the Provisioning Information dictionary.
void	addInformationFromZip(java.lang.String zipURL) Processes the ZipInputStream contents of the provided zipURL and extracts information to add to the Provisioning Information dictionary, as well as, install/update and start bundles.
javax.management.openmbean.TabularData	listInformation() Returns a table representing the Provisioning Information Dictionary.
void	setInformation(javax.management.openmbean.TabularData info) Replaces the Provisioning Information dictionary with the entries of the supplied table.

Field Detail

OBJECTNAME

static final java.lang.String OBJECTNAME

Provisioning MBean object name.

See Also:

Constant Field Values

Method Detail

addInformationFromZip

void addInformationFromZip(java.lang.String zipURL)
                           throws java.io.IOException

Processes the ZipInputStream contents of the provided zipURL and extracts information to add to the Provisioning Information dictionary, as well as, install/update and start bundles. This method causes the PROVISIONING_UPDATE_COUNT to be incremented.

Parameters:

zipURL - the String form of the URL that will be resolved into a ZipInputStream which will be used to add key/value pairs to the Provisioning Information dictionary and install and start bundles. If a ZipEntry does not have an Extra field that corresponds to one of the four defined MIME types ( MIME_STRING, MIME_BYTE_ARRAY,MIME_BUNDLE, and MIME_BUNDLE_URL) in will be silently ignored.

Throws:

java.io.IOException - if an error occurs while processing the ZipInputStream of the URL. No additions will be made to the Provisioning Information dictionary and no bundles must be started or installed.

addInformation

void addInformation(javax.management.openmbean.TabularData info)
                    throws java.io.IOException

Adds the key/value pairs contained in info to the Provisioning Information dictionary. This method causes the PROVISIONING_UPDATE_COUNT to be incremented.

Parameters:

info - the set of Provisioning Information key/value pairs to add to the Provisioning Information dictionary. Any keys are values that are of an invalid type will be silently ignored.

Throws:

java.io.IOException - if the operation fails

See Also:

JmxConstants.PROPERTIES_TYPE for details of the Tabular Data

listInformation

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

Returns a table representing the Provisioning Information Dictionary.

Returns:

The table representing the manager dictionary.

Throws:

java.io.IOException - if the operation fails

See Also:

JmxConstants.PROPERTIES_TYPE for details of the Tabular Data

setInformation

void setInformation(javax.management.openmbean.TabularData info)
                    throws java.io.IOException

Replaces the Provisioning Information dictionary with the entries of the supplied table. This method causes the PROVISIONING_UPDATE_COUNT to be incremented.

Parameters:

info - the new set of Provisioning Information key/value pairs. Any keys are values that are of an invalid type will be silently ignored.

Throws:

java.io.IOException - if the operation fails

See Also:

JmxConstants.PROPERTIES_TYPE for details of the Tabular Data