org.osgi.jmx.compendium
Interface ProvisioningMBean


public interface ProvisioningMBean

Author:
Hal Hildebrand Date: Jan 21, 2008 Time: 10:49:26 AM This MBean represents the management interface to the OSGi Initial Provisioning Service

Method Summary
 void addInformation(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.
 void addInformation(javax.management.openmbean.TabularData info)
          Adds the key/value pairs contained in info to the Provisioning Information dictionary.
 javax.management.openmbean.TabularData getInformation()
          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.
 

Method Detail

addInformation

void addInformation(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 the details of the TabularType

For each entry in the Provisioning Dictionary, the following row is supplied

  • Property Key - the string key
  • Property Value - the stringified version of the property value
  • Property Value Type - the type of the property value

getInformation

javax.management.openmbean.TabularData getInformation()
                                                      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 the details of the TabularType

For each entry in the Provisioning Information Dictionary, the following row is supplied

  • Property Key - the string key
  • Property Value - the stringified version of the property value
  • Property Value Type - the type of the property value

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 the details of the TabularType

For each entry in the table, the following row is supplied

  • Property Key - the string key
  • Property Value - the stringified version of the property value
  • Property Value Type - the type of the property value


Copyright © 2009. All Rights Reserved.