Package org.osgi.jmx.framework
Interface FrameworkMBean
- 
public interface FrameworkMBeanThe FrameworkMbean provides mechanisms to exert control over the framework. For many operations, it provides a batch mechanism to avoid excessive message passing when interacting remotely. 
- 
- 
Field Summary
Fields Modifier and Type Field Description static javax.management.openmbean.CompositeTypeBATCH_ACTION_RESULT_TYPEThe Composite Type for a batch action result.static javax.management.openmbean.CompositeTypeBATCH_INSTALL_RESULT_TYPEThe Composite Type which represents the result of a batch install operation.static javax.management.openmbean.CompositeTypeBATCH_RESOLVE_RESULT_TYPEThe Composite Type which represents the result of a batch resolve operation.static java.lang.StringBUNDLE_IN_ERRORThe key for BUNDLE_IN_ERROR.static ItemBUNDLE_IN_ERROR_ID_ITEMThe item containing the bundle which caused the error during the batch operation.static ItemBUNDLE_IN_ERROR_LOCATION_ITEMThe item containing the bundle which caused the error during the batch operation.static java.lang.StringCOMPLETEDThe key COMPLETED, used inCOMPLETED_ITEM.static ItemCOMPLETED_ITEMThe item containing the list of bundles completing the batch operation.static java.lang.StringERRORThe key ERROR, used inERROR_ITEM.static ItemERROR_ITEMThe item containing the error message of the batch operation.static java.lang.StringOBJECTNAMEThe fully qualified object name of this mbean.static java.lang.StringREMAININGThe key REMAINING, used inREMAINING_ID_ITEMandREMAINING_LOCATION_ITEM.static ItemREMAINING_ID_ITEMThe item containing the list of remaining bundles unprocessed by the failing batch operation.static ItemREMAINING_LOCATION_ITEMThe item containing the list of remaining bundles unprocessed by the failing batch operation.static java.lang.StringSUCCESSThe SUCCESS, used inSUCCESS_ITEM.static ItemSUCCESS_ITEMThe item that indicates if this operation was successful. 
- 
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description long[]getDependencyClosure(long[] bundles)Returns the dependency closure for the specified bundles.intgetFrameworkStartLevel()Retrieve the framework start levelintgetInitialBundleStartLevel()Answer the initial start level assigned to a bundle when it is first startedjava.lang.StringgetProperty(java.lang.String key)Returns the value of the specified property.long[]getRemovalPendingBundles()Returns the bundles IDs that have non-current, in use bundle wirings.longinstallBundle(java.lang.String location)Install the bundle indicated by the bundleLocationslonginstallBundleFromURL(java.lang.String location, java.lang.String url)Install the bundle indicated by the bundleLocationsjavax.management.openmbean.CompositeDatainstallBundles(java.lang.String[] locations)Batch install the bundles indicated by the list of bundleLocationUrlsjavax.management.openmbean.CompositeDatainstallBundlesFromURL(java.lang.String[] locations, java.lang.String[] urls)Batch install the bundles indicated by the list of bundleLocationUrlsvoidrefreshBundle(long bundleIdentifier)Force the update, replacement or removal of the packages identified by the specified bundle.booleanrefreshBundleAndWait(long bundleIdentifier)voidrefreshBundles(long[] bundleIdentifiers)Force the update, replacement or removal of the packages identified by the list of bundles.javax.management.openmbean.CompositeDatarefreshBundlesAndWait(long[] bundleIdentifiers)javax.management.openmbean.CompositeDataresolve(long[] bundleIdentifiers)Same asresolveBundles(long[])but with a more detailed return type.booleanresolveBundle(long bundleIdentifier)Resolve the bundle indicated by the unique symbolic name and versionbooleanresolveBundles(long[] bundleIdentifiers)Batch resolve the bundles indicated by the list of bundle identifiersvoidrestartFramework()Restart the framework by updating the system bundlevoidsetBundleStartLevel(long bundleIdentifier, int newlevel)Set the start level for the bundle identifierjavax.management.openmbean.CompositeDatasetBundleStartLevels(long[] bundleIdentifiers, int[] newlevels)Set the start levels for the list of bundles.voidsetFrameworkStartLevel(int newlevel)Set the start level for the frameworkvoidsetInitialBundleStartLevel(int newlevel)Set the initial start level assigned to a bundle when it is first startedvoidshutdownFramework()Shutdown the framework by stopping the system bundlevoidstartBundle(long bundleIdentifier)Start the bundle indicated by the bundle identifierjavax.management.openmbean.CompositeDatastartBundles(long[] bundleIdentifiers)Batch start the bundles indicated by the list of bundle identifiervoidstopBundle(long bundleIdentifier)Stop the bundle indicated by the bundle identifierjavax.management.openmbean.CompositeDatastopBundles(long[] bundleIdentifiers)Batch stop the bundles indicated by the list of bundle identifiervoiduninstallBundle(long bundleIdentifier)Uninstall the bundle indicated by the bundle identifierjavax.management.openmbean.CompositeDatauninstallBundles(long[] bundleIdentifiers)Batch uninstall the bundles indicated by the list of bundle identifiersvoidupdateBundle(long bundleIdentifier)Update the bundle indicated by the bundle identifiervoidupdateBundleFromURL(long bundleIdentifier, java.lang.String url)Update the bundle identified by the bundle identifierjavax.management.openmbean.CompositeDataupdateBundles(long[] bundleIdentifiers)Batch update the bundles indicated by the list of bundle identifier.javax.management.openmbean.CompositeDataupdateBundlesFromURL(long[] bundleIdentifiers, java.lang.String[] urls)Update the bundle uniquely identified by the bundle symbolic name and version using the contents of the supplied urls.voidupdateFramework()Update the framework by updating the system bundle. 
 - 
 
- 
- 
Field Detail
- 
OBJECTNAME
static final java.lang.String OBJECTNAME
The fully qualified object name of this mbean.- See Also:
 - Constant Field Values
 
 
- 
SUCCESS
static final java.lang.String SUCCESS
The SUCCESS, used inSUCCESS_ITEM.- See Also:
 - Constant Field Values
 
 
- 
SUCCESS_ITEM
static final Item SUCCESS_ITEM
The item that indicates if this operation was successful. The key isSUCCESSand the type isSimpleType.BOOLEAN. It is used inBATCH_ACTION_RESULT_TYPEandBATCH_INSTALL_RESULT_TYPE. 
- 
ERROR
static final java.lang.String ERROR
The key ERROR, used inERROR_ITEM.- See Also:
 - Constant Field Values
 
 
- 
ERROR_ITEM
static final Item ERROR_ITEM
The item containing the error message of the batch operation. The key isERRORand the type isSimpleType.STRING. It is used inBATCH_ACTION_RESULT_TYPEandBATCH_INSTALL_RESULT_TYPE. 
- 
COMPLETED
static final java.lang.String COMPLETED
The key COMPLETED, used inCOMPLETED_ITEM.- See Also:
 - Constant Field Values
 
 
- 
COMPLETED_ITEM
static final Item COMPLETED_ITEM
The item containing the list of bundles completing the batch operation. The key isCOMPLETEDand the type isJmxConstants.LONG_ARRAY_TYPE. It is used inBATCH_ACTION_RESULT_TYPEandBATCH_INSTALL_RESULT_TYPE. 
- 
BUNDLE_IN_ERROR
static final java.lang.String BUNDLE_IN_ERROR
The key for BUNDLE_IN_ERROR. This key is used with two different items:BUNDLE_IN_ERROR_ID_ITEMandBUNDLE_IN_ERROR_LOCATION_ITEMthat each have a different type for this key. It is used inBATCH_ACTION_RESULT_TYPEandBATCH_INSTALL_RESULT_TYPE.- See Also:
 - Constant Field Values
 
 
- 
BUNDLE_IN_ERROR_ID_ITEM
static final Item BUNDLE_IN_ERROR_ID_ITEM
The item containing the bundle which caused the error during the batch operation. This item describes the bundle in error as an id. The key isBUNDLE_IN_ERRORand the type isSimpleType.LONG. It is used inBATCH_ACTION_RESULT_TYPE. 
- 
REMAINING
static final java.lang.String REMAINING
The key REMAINING, used inREMAINING_ID_ITEMandREMAINING_LOCATION_ITEM.- See Also:
 - Constant Field Values
 
 
- 
REMAINING_ID_ITEM
static final Item REMAINING_ID_ITEM
The item containing the list of remaining bundles unprocessed by the failing batch operation. The key isREMAININGand the type isJmxConstants.LONG_ARRAY_TYPE. It is used inBATCH_ACTION_RESULT_TYPEandBATCH_INSTALL_RESULT_TYPE. 
- 
BATCH_ACTION_RESULT_TYPE
static final javax.management.openmbean.CompositeType BATCH_ACTION_RESULT_TYPE
The Composite Type for a batch action result.refreshBundle(long)andrefreshBundles(long[]). Notice that a batch action result returns uses an id for theBUNDLE_IN_ERRORwhile theBATCH_INSTALL_RESULT_TYPEuses a location. This Composite Type consists of the following items: 
- 
BUNDLE_IN_ERROR_LOCATION_ITEM
static final Item BUNDLE_IN_ERROR_LOCATION_ITEM
The item containing the bundle which caused the error during the batch operation. This item describes the bundle in error as a location. The key isBUNDLE_IN_ERRORand the type isSimpleType.STRING. It is used inBATCH_INSTALL_RESULT_TYPE. 
- 
REMAINING_LOCATION_ITEM
static final Item REMAINING_LOCATION_ITEM
The item containing the list of remaining bundles unprocessed by the failing batch operation. The key isREMAININGand the type isJmxConstants.STRING_ARRAY_TYPE. It is used inBATCH_ACTION_RESULT_TYPEandBATCH_INSTALL_RESULT_TYPE. 
- 
BATCH_INSTALL_RESULT_TYPE
static final javax.management.openmbean.CompositeType BATCH_INSTALL_RESULT_TYPE
The Composite Type which represents the result of a batch install operation. It is used ininstallBundles(String[])andinstallBundlesFromURL(String[], String[]). This Composite Type consists of the following items: 
- 
BATCH_RESOLVE_RESULT_TYPE
static final javax.management.openmbean.CompositeType BATCH_RESOLVE_RESULT_TYPE
The Composite Type which represents the result of a batch resolve operation. It is used in#refreshBundlesAndWait(String[]). This Composite Type consists of the following items: 
 - 
 
- 
Method Detail
- 
getDependencyClosure
long[] getDependencyClosure(long[] bundles) throws java.io.IOExceptionReturns the dependency closure for the specified bundles.A graph of bundles is computed starting with the specified bundles. The graph is expanded by adding any bundle that is either wired to a package that is currently exported by a bundle in the graph or requires a bundle in the graph. The graph is fully constructed when there is no bundle outside the graph that is wired to a bundle in the graph. The graph may contain
UNINSTALLEDbundles that areremoval pending.- Parameters:
 bundles- The initial bundles IDs for which to generate the dependency closure.- Returns:
 - A bundle ID array containing a snapshot of the dependency closure of the specified bundles, or an empty array if there were no specified bundles.
 - Throws:
 java.io.IOException- if the operation failed
 
- 
getFrameworkStartLevel
int getFrameworkStartLevel() throws java.io.IOExceptionRetrieve the framework start level- Returns:
 - the framework start level
 - Throws:
 java.io.IOException- if the operation failed
 
- 
getInitialBundleStartLevel
int getInitialBundleStartLevel() throws java.io.IOExceptionAnswer the initial start level assigned to a bundle when it is first started- Returns:
 - the start level
 - Throws:
 java.io.IOException- if the operation failed
 
- 
getProperty
java.lang.String getProperty(java.lang.String key) throws java.io.IOExceptionReturns the value of the specified property. If the key is not found in the Framework properties, the system properties are then searched. The method returnsnullif the property is not found.- Parameters:
 key- The name of the requested property.- Returns:
 - The value of the requested property, or 
nullif the property is undefined. - Throws:
 java.io.IOException- if the operation failed
 
- 
getRemovalPendingBundles
long[] getRemovalPendingBundles() throws java.io.IOExceptionReturns the bundles IDs that have non-current, in use bundle wirings. This is typically the bundles which have been updated or uninstalled since the last call torefreshBundles(long[]).- Returns:
 - A bundle ID array containing a snapshot of the bundles which have non-current, in use bundle wirings, or an empty array if there are no such bundles.
 - Throws:
 java.io.IOException- if the operation failed
 
- 
installBundle
long installBundle(java.lang.String location) throws java.io.IOExceptionInstall the bundle indicated by the bundleLocations- Parameters:
 location- the location of the bundle to install- Returns:
 - the bundle id the installed bundle
 - Throws:
 java.io.IOException- if the operation does not succeed
 
- 
installBundleFromURL
long installBundleFromURL(java.lang.String location, java.lang.String url) throws java.io.IOExceptionInstall the bundle indicated by the bundleLocations- Parameters:
 location- the location to assign to the bundleurl- the URL which will supply the bytes for the bundle- Returns:
 - the bundle id the installed bundle
 - Throws:
 java.io.IOException- if the operation does not succeed
 
- 
installBundles
javax.management.openmbean.CompositeData installBundles(java.lang.String[] locations) throws java.io.IOExceptionBatch install the bundles indicated by the list of bundleLocationUrls- Parameters:
 locations- the array of locations of the bundles to install- Returns:
 - the resulting state from executing the operation
 - Throws:
 java.io.IOException- if the operation does not succeed- See Also:
 BATCH_INSTALL_RESULT_TYPE for the precise specification of the CompositeData type representing the returned result.
 
- 
installBundlesFromURL
javax.management.openmbean.CompositeData installBundlesFromURL(java.lang.String[] locations, java.lang.String[] urls) throws java.io.IOExceptionBatch install the bundles indicated by the list of bundleLocationUrls- Parameters:
 locations- the array of locations to assign to the installed bundlesurls- the array of urls which supply the bundle bytes- Returns:
 - the resulting state from executing the operation
 - Throws:
 java.io.IOException- if the operation does not succeed- See Also:
 BATCH_INSTALL_RESULT_TYPE BatchBundleResult for the precise specification of the CompositeData type representing the returned result.
 
- 
refreshBundle
void refreshBundle(long bundleIdentifier) throws java.io.IOExceptionForce the update, replacement or removal of the packages identified by the specified bundle.- Parameters:
 bundleIdentifier- the bundle identifier- Throws:
 java.io.IOException- if the operation failed
 
- 
refreshBundleAndWait
boolean refreshBundleAndWait(long bundleIdentifier) throws java.io.IOException- Throws:
 java.io.IOException
 
- 
refreshBundles
void refreshBundles(long[] bundleIdentifiers) throws java.io.IOExceptionForce the update, replacement or removal of the packages identified by the list of bundles.- Parameters:
 bundleIdentifiers- The identifiers of the bundles to refresh, ornullfor all bundles with packages pending removal.- Throws:
 java.io.IOException- if the operation failed
 
- 
refreshBundlesAndWait
javax.management.openmbean.CompositeData refreshBundlesAndWait(long[] bundleIdentifiers) throws java.io.IOException- Throws:
 java.io.IOException
 
- 
resolveBundle
boolean resolveBundle(long bundleIdentifier) throws java.io.IOExceptionResolve the bundle indicated by the unique symbolic name and version- Parameters:
 bundleIdentifier- the bundle identifier- Returns:
 trueif the bundle was resolved, false otherwise- Throws:
 java.io.IOException- if the operation does not succeedjava.lang.IllegalArgumentException- if the bundle indicated does not exist
 
- 
resolveBundles
boolean resolveBundles(long[] bundleIdentifiers) throws java.io.IOExceptionBatch resolve the bundles indicated by the list of bundle identifiers- Parameters:
 bundleIdentifiers- The identifiers of the bundles to resolve, ornullto resolve all unresolved bundles.- Returns:
 trueif the bundles were resolved, false otherwise- Throws:
 java.io.IOException- if the operation does not succeed
 
- 
resolve
javax.management.openmbean.CompositeData resolve(long[] bundleIdentifiers) throws java.io.IOExceptionSame asresolveBundles(long[])but with a more detailed return type.- Parameters:
 bundleIdentifiers-- Returns:
 - Throws:
 java.io.IOException
 
- 
restartFramework
void restartFramework() throws java.io.IOExceptionRestart the framework by updating the system bundle- Throws:
 java.io.IOException- if the operation failed
 
- 
setBundleStartLevel
void setBundleStartLevel(long bundleIdentifier, int newlevel) throws java.io.IOExceptionSet the start level for the bundle identifier- Parameters:
 bundleIdentifier- the bundle identifiernewlevel- the new start level for the bundle- Throws:
 java.io.IOException- if the operation failed
 
- 
setBundleStartLevels
javax.management.openmbean.CompositeData setBundleStartLevels(long[] bundleIdentifiers, int[] newlevels) throws java.io.IOExceptionSet the start levels for the list of bundles.- Parameters:
 bundleIdentifiers- the array of bundle identifiersnewlevels- the array of new start level for the bundles- Returns:
 - the resulting state from executing the operation
 - Throws:
 java.io.IOException- if the operation failed- See Also:
 BATCH_ACTION_RESULT_TYPE for the precise specification of the CompositeData type representing the returned result.
 
- 
setFrameworkStartLevel
void setFrameworkStartLevel(int newlevel) throws java.io.IOExceptionSet the start level for the framework- Parameters:
 newlevel- the new start level- Throws:
 java.io.IOException- if the operation failed
 
- 
setInitialBundleStartLevel
void setInitialBundleStartLevel(int newlevel) throws java.io.IOExceptionSet the initial start level assigned to a bundle when it is first started- Parameters:
 newlevel- the new start level- Throws:
 java.io.IOException- if the operation failed
 
- 
shutdownFramework
void shutdownFramework() throws java.io.IOExceptionShutdown the framework by stopping the system bundle- Throws:
 java.io.IOException- if the operation failed
 
- 
startBundle
void startBundle(long bundleIdentifier) throws java.io.IOExceptionStart the bundle indicated by the bundle identifier- Parameters:
 bundleIdentifier- the bundle identifier- Throws:
 java.io.IOException- if the operation does not succeedjava.lang.IllegalArgumentException- if the bundle indicated does not exist
 
- 
startBundles
javax.management.openmbean.CompositeData startBundles(long[] bundleIdentifiers) throws java.io.IOExceptionBatch start the bundles indicated by the list of bundle identifier- Parameters:
 bundleIdentifiers- the array of bundle identifiers- Returns:
 - the resulting state from executing the operation
 - Throws:
 java.io.IOException- if the operation does not succeed- See Also:
 BATCH_ACTION_RESULT_TYPE for the precise specification of the CompositeData type representing the returned result.
 
- 
stopBundle
void stopBundle(long bundleIdentifier) throws java.io.IOExceptionStop the bundle indicated by the bundle identifier- Parameters:
 bundleIdentifier- the bundle identifier- Throws:
 java.io.IOException- if the operation does not succeedjava.lang.IllegalArgumentException- if the bundle indicated does not exist
 
- 
stopBundles
javax.management.openmbean.CompositeData stopBundles(long[] bundleIdentifiers) throws java.io.IOExceptionBatch stop the bundles indicated by the list of bundle identifier- Parameters:
 bundleIdentifiers- the array of bundle identifiers- Returns:
 - the resulting state from executing the operation
 - Throws:
 java.io.IOException- if the operation does not succeed- See Also:
 BATCH_ACTION_RESULT_TYPE for the precise specification of the CompositeData type representing the returned result.
 
- 
uninstallBundle
void uninstallBundle(long bundleIdentifier) throws java.io.IOExceptionUninstall the bundle indicated by the bundle identifier- Parameters:
 bundleIdentifier- the bundle identifier- Throws:
 java.io.IOException- if the operation does not succeedjava.lang.IllegalArgumentException- if the bundle indicated does not exist
 
- 
uninstallBundles
javax.management.openmbean.CompositeData uninstallBundles(long[] bundleIdentifiers) throws java.io.IOExceptionBatch uninstall the bundles indicated by the list of bundle identifiers- Parameters:
 bundleIdentifiers- the array of bundle identifiers- Returns:
 - the resulting state from executing the operation
 - Throws:
 java.io.IOException- if the operation does not succeed- See Also:
 BATCH_ACTION_RESULT_TYPE for the precise specification of the CompositeData type representing the returned result.
 
- 
updateBundle
void updateBundle(long bundleIdentifier) throws java.io.IOExceptionUpdate the bundle indicated by the bundle identifier- Parameters:
 bundleIdentifier- the bundle identifier- Throws:
 java.io.IOException- if the operation does not succeedjava.lang.IllegalArgumentException- if the bundle indicated does not exist
 
- 
updateBundleFromURL
void updateBundleFromURL(long bundleIdentifier, java.lang.String url) throws java.io.IOExceptionUpdate the bundle identified by the bundle identifier- Parameters:
 bundleIdentifier- the bundle identifierurl- the URL to use to update the bundle- Throws:
 java.io.IOException- if the operation does not succeedjava.lang.IllegalArgumentException- if the bundle indicated does not exist
 
- 
updateBundles
javax.management.openmbean.CompositeData updateBundles(long[] bundleIdentifiers) throws java.io.IOExceptionBatch update the bundles indicated by the list of bundle identifier.- Parameters:
 bundleIdentifiers- the array of bundle identifiers- Returns:
 - the resulting state from executing the operation
 - Throws:
 java.io.IOException- if the operation does not succeed- See Also:
 BATCH_ACTION_RESULT_TYPE for the precise specification of the CompositeData type representing the returned result.
 
- 
updateBundlesFromURL
javax.management.openmbean.CompositeData updateBundlesFromURL(long[] bundleIdentifiers, java.lang.String[] urls) throws java.io.IOExceptionUpdate the bundle uniquely identified by the bundle symbolic name and version using the contents of the supplied urls.- Parameters:
 bundleIdentifiers- the array of bundle identifiersurls- the array of URLs to use to update the bundles- Returns:
 - the resulting state from executing the operation
 - Throws:
 java.io.IOException- if the operation does not succeedjava.lang.IllegalArgumentException- if the bundle indicated does not exist- See Also:
 BATCH_ACTION_RESULT_TYPE for the precise specification of the CompositeData type representing the returned result.
 
- 
updateFramework
void updateFramework() throws java.io.IOExceptionUpdate the framework by updating the system bundle.- Throws:
 java.io.IOException- if the operation failed
 
 - 
 
 -