OSGi™ Service Platform
Release 4 Version 4.2

org.osgi.service.packageadmin
Interface ExportedPackage


public interface ExportedPackage

An exported package. Objects implementing this interface are created by the Package Admin service.

The term exported package refers to a package that has been exported from a resolved bundle. This package may or may not be currently wired to other bundles.

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

ThreadSafe

Method Summary
 Bundle getExportingBundle()
          Returns the bundle exporting the package associated with this exported package.
 Bundle[] getImportingBundles()
          Returns the resolved bundles that are currently wired to this exported package.
 java.lang.String getName()
          Returns the name of the package associated with this exported package.
 java.lang.String getSpecificationVersion()
          Deprecated. As of 1.2, replaced by getVersion().
 Version getVersion()
          Returns the version of this exported package.
 boolean isRemovalPending()
          Returns true if the package associated with this ExportedPackage object has been exported by a bundle that has been updated or uninstalled.
 

Method Detail

getName

java.lang.String getName()
Returns the name of the package associated with this exported package.

Returns:
The name of this exported package.

getExportingBundle

Bundle getExportingBundle()
Returns the bundle exporting the package associated with this exported package.

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

getImportingBundles

Bundle[] getImportingBundles()
Returns the resolved bundles that are currently wired to this exported package.

Bundles which require the exporting bundle associated with this exported package are considered to be wired to this exported package are included in the returned array. See RequiredBundle.getRequiringBundles().

Returns:
The array of resolved bundles currently wired to this exported package, or null if this ExportedPackage object has become stale. The array will be empty if no bundles are wired to this exported package.

getSpecificationVersion

java.lang.String getSpecificationVersion()
Deprecated. As of 1.2, replaced by getVersion().

Returns the version of this exported package.

Returns:
The version of this exported package, or null if no version information is available.

getVersion

Version getVersion()
Returns the version of this exported package.

Returns:
The version of this exported package, or Version.emptyVersion if no version information is available.
Since:
1.2

isRemovalPending

boolean isRemovalPending()
Returns true if the package associated with this ExportedPackage object has been exported by a bundle that has been updated or uninstalled.

Returns:
true if the associated package is being exported by a bundle that has been updated or uninstalled, or if this ExportedPackage object has become stale; false otherwise.

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