org.osgi.service.framework
Interface SurrogateBundle

All Superinterfaces:

Bundle

All Known Implementing Classes:

SurrogateImpl

Deprecated. This is proposed API. As a result, this API may never be published or the final API may change substantially by the time of final publication. You are cautioned against relying upon this API.

public interface SurrogateBundle
extends Bundle

A surrogate bundle is installed in a child framework, and is the child-facing representation of the composite bundle in the parent framework.

A surrogate bundle does the following as specified by the composite manifest:

• Exports packages to the child framework from the parent framework. These packages are imported by the composite bundle installed in the parent framework.
• Imports packages from the child framework. These packages are exported by the composite bundle installed in the parent framework.
• Registers services from the parent framework with the child framework. These services are acquired by the composite bundle installed in the parent framework.
• Acquires services from the child framework. These services are registered by the composite bundle installed in the parent framework.

See Also:

CompositeBundle

Field Summary

Fields inherited from interface org.osgi.framework.Bundle

ACTIVE, INSTALLED, RESOLVED, SIGNERS_ALL, SIGNERS_TRUSTED, START_ACTIVATION_POLICY, START_TRANSIENT, STARTING, STOP_TRANSIENT, STOPPING, UNINSTALLED

Method Summary

BundleContext	getCompositeBundleContext() Deprecated. Returns the bundle context of the associated composite bundle.
void	uninstall() Deprecated. This operation is not supported for surrogate bundles.
void	update() Deprecated. This operation is not supported for surrogate bundles.
void	update(java.io.InputStream input) Deprecated. This operation is not supported for surrogate bundles.

Methods inherited from interface org.osgi.framework.Bundle

findEntries, getBundleContext, getBundleId, getEntry, getEntryPaths, getHeaders, getHeaders, getLastModified, getLocation, getRegisteredServices, getResource, getResources, getServicesInUse, getSignerCertificates, getState, getSymbolicName, getVersion, hasPermission, loadClass, start, start, stop, stop

Method Detail

getCompositeBundleContext

BundleContext getCompositeBundleContext()

Deprecated.

Returns the bundle context of the associated composite bundle.

Returns:

the bundle context of the composite bundle. A value of null is returned if the composite bundle does not have a valid bundle context.

update

void update()
            throws BundleException

Deprecated.

This operation is not supported for surrogate bundles. A BundleException of type invalid operation must be thrown.

Specified by:

update in interface Bundle

Throws:

BundleException - If the update fails.

See Also:

Bundle.update(InputStream)

update

void update(java.io.InputStream input)
            throws BundleException

Deprecated.

This operation is not supported for surrogate bundles. A BundleException of type invalid operation must be thrown.

Specified by:

update in interface Bundle

Parameters:

input - The InputStream from which to read the new bundle or null to indicate the Framework must create the input stream from this bundle's Bundle-UpdateLocation Manifest header, if present, or this bundle's original location. The input stream must always be closed when this method completes, even if an exception is thrown.

Throws:

BundleException - If the input stream cannot be read or the update fails.

See Also:

Bundle.stop(), Bundle.start()

uninstall

void uninstall()
               throws BundleException

Deprecated.

This operation is not supported for surrogate bundles. A BundleException of type invalid operation must be thrown.

Specified by:

uninstall in interface Bundle

Throws:

BundleException - If the uninstall failed. This can occur if another thread is attempting to change this bundle's state and does not complete in a timely manner.

See Also:

Bundle.stop()