OSGi™ Service Platform
Release 4 Version 4.2

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:
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:
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:
for details of the Tabular Data

OSGi™ Service Platform
Release 4 Version 4.2

Copyright © OSGi Alliance (2000, 2010). All Rights Reserved. Licensed under the OSGi Specification License, Version 1.0