org.eclipse.osgi.framework.internal.core
Class BundleFragment

java.lang.Object
  org.eclipse.osgi.framework.internal.core.AbstractBundle
      org.eclipse.osgi.framework.internal.core.BundleFragment

All Implemented Interfaces:

java.lang.Comparable<Bundle>, KeyedElement, Bundle, BundleReference, BundleStartLevel, BundleRevisions

public class BundleFragment
extends AbstractBundle

Field Summary

protected BundleHost[]

hosts The resolved host that this fragment is attached to

Fields inherited from class org.eclipse.osgi.framework.internal.core.AbstractBundle

bundledata, domain, framework, manifestLocalization, state, statechangeLock, stateChanging

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

Constructor Summary

BundleFragment(BundleData bundledata, Framework framework)

Method Summary

protected BundleLoader	getBundleLoader()
protected BundleContextImpl	getContext() Return the current context for this bundle.
ServiceReference<?>[]	getRegisteredServices() Provides a list of ServiceReferences for the services registered by this bundle or null if the bundle has no registered services.
java.net.URL	getResource(java.lang.String name) Find the specified resource in this bundle.
java.util.Enumeration<java.net.URL>	getResources(java.lang.String name) Find the specified resources from this bundle's class loader.
ServiceReference<?>[]	getServicesInUse() Provides a list of ServiceReferences for the services this bundle is using, or null if the bundle is not using any services.
protected boolean	isFragment()
protected void	load() Load the bundle.
protected java.lang.Class<?>	loadClass(java.lang.String name, boolean checkPermission) This method loads a class from the bundle.
protected void	refresh() Refresh the bundle.
protected boolean	reload(AbstractBundle newBundle) Reload from a new bundle.
protected void	startWorker(int options) Internal worker to start a bundle.
protected void	stopWorker(int options) Internal worker to stop a bundle.
protected boolean	unload() Unload the bundle.

Methods inherited from class org.eclipse.osgi.framework.internal.core.AbstractBundle

adapt, adapt0, beginStateChange, checkValid, close, compare, compareTo, completeStateChange, createBundle, findEntries, getBundle, getBundleContext, getBundleData, getBundleDescription, getBundleId, getDataFile, getEntry, getEntryPaths, getFragments, getFramework, getHeaders, getHeaders, getKey, getKeyHashCode, getLastModified, getLocation, getProtectionDomain, getResolutionFailureException, getResourceBundle, getRevisions, getSignerCertificates, getStartLevel, getState, getStateChanging, getSymbolicName, getVersion, hasPermission, isActivationPolicyUsed, isActive, isPersistentlyStarted, isResolved, loadBundleActivator, loadClass, readyToResume, resolve, resume, setStartLevel, setStatus, start, start, stop, stop, suspend, testStateChanging, toString, uninstall, uninstallWorker, uninstallWorkerPrivileged, update, update, updateWorker, updateWorkerPrivileged

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

hosts

protected BundleHost[] hosts

The resolved host that this fragment is attached to

Constructor Detail

BundleFragment

public BundleFragment(BundleData bundledata,
                      Framework framework)
               throws BundleException

Parameters:

bundledata -

framework -

Throws:

BundleException

Method Detail

load

protected void load()

Load the bundle.

Specified by:

load in class AbstractBundle

reload

protected boolean reload(AbstractBundle newBundle)

Reload from a new bundle. This method must be called while holding the bundles lock.

Specified by:

reload in class AbstractBundle

Parameters:

newBundle - Dummy Bundle which contains new data.

Returns:

true if an exported package is "in use". i.e. it has been imported by a bundle

refresh

protected void refresh()

Refresh the bundle. This is called by Framework.refreshPackages. This method must be called while holding the bundles lock. this.loader.unimportPackages must have already been called before calling this method!

Specified by:

refresh in class AbstractBundle

unload

protected boolean unload()

Unload the bundle. This method must be called while holding the bundles lock.

Specified by:

unload in class AbstractBundle

Returns:

true if an exported package is "in use". i.e. it has been imported by a bundle

loadClass

protected java.lang.Class<?> loadClass(java.lang.String name,
                                       boolean checkPermission)
                                throws java.lang.ClassNotFoundException

This method loads a class from the bundle.

Specified by:

loadClass in class AbstractBundle

Parameters:

name - the name of the desired Class.

checkPermission - indicates whether a permission check should be done.

Returns:

the resulting Class

Throws:

java.lang.ClassNotFoundException - if the class definition was not found.

getResource

public java.net.URL getResource(java.lang.String name)

Find the specified resource in this bundle. This bundle's class loader is called to search for the named resource. If this bundle's state is INSTALLED, then only this bundle will be searched for the specified resource. Imported packages cannot be searched when a bundle has not been resolved.

Parameters:

name - The name of the resource. See java.lang.ClassLoader.getResource for a description of the format of a resource name.

Returns:

a URL to the named resource, or null if the resource could not be found or if the caller does not have the AdminPermission, and the Java Runtime Environment supports permissions.

Throws:

java.lang.IllegalStateException - If this bundle has been uninstalled.

See Also:

Bundle.getEntry(java.lang.String), Bundle.findEntries(java.lang.String, java.lang.String, boolean)

getResources

public java.util.Enumeration<java.net.URL> getResources(java.lang.String name)

Description copied from interface: Bundle

Find the specified resources from this bundle's class loader. This bundle's class loader is called to search for the specified resources. If this bundle's state is INSTALLED, this method must attempt to resolve this bundle before attempting to get the specified resources. If this bundle cannot be resolved, then only this bundle must be searched for the specified resources. Imported packages cannot be searched when a bundle has not been resolved. If this bundle is a fragment bundle then null is returned.

Note: Jar and zip files are not required to include directory entries. URLs to directory entries will not be returned if the bundle contents do not contain directory entries.

Parameters:

name - The name of the resource. See ClassLoader.getResources for a description of the format of a resource name.

Returns:

An enumeration of URLs to the named resources, or null if the resource could not be found or if this bundle is a fragment bundle or if the caller does not have the appropriate AdminPermission[this,RESOURCE], and the Java Runtime Environment supports permissions.

startWorker

protected void startWorker(int options)
                    throws BundleException

Internal worker to start a bundle.

Specified by:

startWorker in class AbstractBundle

Parameters:

options -

Throws:

BundleException

stopWorker

protected void stopWorker(int options)
                   throws BundleException

Internal worker to stop a bundle.

Specified by:

stopWorker in class AbstractBundle

Parameters:

options -

Throws:

BundleException

getRegisteredServices

public ServiceReference<?>[] getRegisteredServices()

Provides a list of ServiceReferences for the services registered by this bundle or null if the bundle has no registered services.

The list is valid at the time of the call to this method, but the framework is a very dynamic environment and services can be modified or unregistered at anytime.

Returns:

An array of ServiceReference or null.

Throws:

java.lang.IllegalStateException - If the bundle has been uninstalled.

See Also:

ServiceRegistration, ServiceReference

getServicesInUse

public ServiceReference<?>[] getServicesInUse()

Provides a list of ServiceReferences for the services this bundle is using, or null if the bundle is not using any services. A bundle is considered to be using a service if the bundle's use count for the service is greater than zero.

The list is valid at the time of the call to this method, but the framework is a very dynamic environment and services can be modified or unregistered at anytime.

Returns:

An array of ServiceReference or null.

Throws:

java.lang.IllegalStateException - If the bundle has been uninstalled.

See Also:

ServiceReference

isFragment

protected boolean isFragment()

Overrides:

isFragment in class AbstractBundle

getBundleLoader

protected BundleLoader getBundleLoader()

Specified by:

getBundleLoader in class AbstractBundle

getContext

protected BundleContextImpl getContext()

Return the current context for this bundle.

Specified by:

getContext in class AbstractBundle

Returns:

BundleContext for this bundle.