OSGi™ Service Platform
Release 4 Version 4.1

org.osgi.service.packageadmin
Interface RequiredBundle


public interface RequiredBundle

A required bundle. Objects implementing this interface are created by the Package Admin service.

The term required bundle refers to a resolved bundle that has a bundle symbolic name and is not a fragment. That is, a bundle that may be required by other bundles. This bundle may or may not be currently required by other bundles.

The information about a required bundle provided by this object may change. A RequiredBundle object becomes stale if an exported package of the bundle it references has been updated or removed as a result of calling PackageAdmin.refreshPackages()). If this object becomes stale, its getSymbolicName() and getVersion() methods continue to return their original values, isRemovalPending() returns true, and getBundle() and getRequiringBundles() return null.

Since:
1.2

Method Summary
 Bundle getBundle()
          Returns the bundle associated with this required bundle.
 Bundle[] getRequiringBundles()
          Returns the bundles that currently require this required bundle.
 java.lang.String getSymbolicName()
          Returns the symbolic name of this required bundle.
 Version getVersion()
          Returns the version of this required bundle.
 boolean isRemovalPending()
          Returns true if the bundle associated with this RequiredBundle object has been updated or uninstalled.
 

Method Detail

getSymbolicName

public java.lang.String getSymbolicName()
Returns the symbolic name of this required bundle.

Returns:
The symbolic name of this required bundle.

getBundle

public Bundle getBundle()
Returns the bundle associated with this required bundle.

Returns:
The bundle, or null if this RequiredBundle object has become stale.

getRequiringBundles

public Bundle[] getRequiringBundles()
Returns the bundles that currently require this required bundle.

If this required bundle is required and then re-exported by another bundle then all the requiring bundles of the re-exporting bundle are included in the returned array.

Returns:
An array of bundles currently requiring this required bundle, or null if this RequiredBundle object has become stale.

getVersion

public Version getVersion()
Returns the version of this required bundle.

Returns:
The version of this required bundle, or Version.emptyVersion if no version information is available.

isRemovalPending

public boolean isRemovalPending()
Returns true if the bundle associated with this RequiredBundle object has been updated or uninstalled.

Returns:
true if the reqiured bundle has been updated or uninstalled, or if the RequiredBundle object has become stale; false otherwise.

OSGi™ Service Platform
Release 4 Version 4.1

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