org.osgi.service.packageadmin.RequiredBundle Interface Reference

Inheritance diagram for org.osgi.service.packageadmin.RequiredBundle:

org.knopflerfish.framework.RequiredBundleImpl

List of all members.


Detailed Description

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
Version:
Revision
1.11

Definition at line 49 of file RequiredBundle.java.


Public Member Functions

String getSymbolicName ()
 Returns the symbolic name of this required bundle.
Bundle getBundle ()
 Returns the bundle associated with this required bundle.
Bundle[] getRequiringBundles ()
 Returns the bundles that currently require 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.

Member Function Documentation

String org.osgi.service.packageadmin.RequiredBundle.getSymbolicName (  ) 

Returns the symbolic name of this required bundle.

Returns:
The symbolic name of this required bundle.

Implemented in org.knopflerfish.framework.RequiredBundleImpl.

Bundle org.osgi.service.packageadmin.RequiredBundle.getBundle (  ) 

Returns the bundle associated with this required bundle.

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

Implemented in org.knopflerfish.framework.RequiredBundleImpl.

Bundle [] org.osgi.service.packageadmin.RequiredBundle.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.

Implemented in org.knopflerfish.framework.RequiredBundleImpl.

Version org.osgi.service.packageadmin.RequiredBundle.getVersion (  ) 

Returns the version of this required bundle.

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

Implemented in org.knopflerfish.framework.RequiredBundleImpl.

boolean org.osgi.service.packageadmin.RequiredBundle.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.

Implemented in org.knopflerfish.framework.RequiredBundleImpl.


The documentation for this interface was generated from the following file:
Generated on Mon Jan 11 21:19:24 2010 for OpenMobileIS by  doxygen 1.5.4