org.jboss.osgi.testing
Interface OSGiBundle

public interface OSGiBundle

An abstraction of an OSGi Bundle.

Since:

25-Sep-2008

Author:

Thomas.Diesler@jboss.org

Method Summary

long	getBundleId() Returns this bundle's unique identifier.
java.io.File	getDataFile(java.lang.String filename) Creates a File object for a file in the persistent storage area provided for the bundle by the Framework.
java.net.URL	getEntry(java.lang.String path) Returns a URL to the entry at the specified path in this bundle.
java.util.Dictionary<java.lang.String,java.lang.String>	getHeaders() Returns this bundle's Manifest headers and values.
java.util.Dictionary<java.lang.String,java.lang.String>	getHeaders(java.lang.String locale) Returns this bundle's Manifest headers and values localized to the specified locale.
java.lang.String	getLocation() Returns this bundle's location.
java.lang.String	getProperty(java.lang.String key) Returns the value of the specified property.
java.net.URL	getResource(java.lang.String name) Find the specified resource from this bundle's class loader.
OSGiRuntime	getRuntime() Get the runtime associated with this bundle.
int	getState() Returns this bundle's current state.
java.lang.String	getSymbolicName() Returns the symbolic name of this bundle as specified by its Bundle-SymbolicName manifest header.
org.osgi.framework.Version	getVersion() Returns the version of this bundle.
OSGiBundle	loadClass(java.lang.String name) Loads the specified class using this bundle's class loader.
void	start() Starts this bundle.
void	stop() Stops this bundle.
void	uninstall() Uninstalls this bundle.

Method Detail

getRuntime

OSGiRuntime getRuntime()

Get the runtime associated with this bundle.

getBundleId

long getBundleId()

Returns this bundle's unique identifier.

getSymbolicName

java.lang.String getSymbolicName()

Returns the symbolic name of this bundle as specified by its Bundle-SymbolicName manifest header.

getVersion

org.osgi.framework.Version getVersion()

Returns the version of this bundle.

getLocation

java.lang.String getLocation()

Returns this bundle's location.

getHeaders

java.util.Dictionary<java.lang.String,java.lang.String> getHeaders()

Returns this bundle's Manifest headers and values.

getHeaders

java.util.Dictionary<java.lang.String,java.lang.String> getHeaders(java.lang.String locale)

Returns this bundle's Manifest headers and values localized to the specified locale.

getState

int getState()

Returns this bundle's current state.

getProperty

java.lang.String getProperty(java.lang.String key)

Returns the value of the specified property.

getDataFile

java.io.File getDataFile(java.lang.String filename)

Creates a File object for a file in the persistent storage area provided for the bundle by the Framework.

loadClass

OSGiBundle loadClass(java.lang.String name)
                     throws java.lang.ClassNotFoundException

Loads the specified class using this bundle's class loader.

Parameters:

name - The name of the class to load

Returns:

The OSGiBundle that is wired to this bundle class loader and contains the class.

Throws:

java.lang.ClassNotFoundException - If no such class can be found or if this bundle is a fragment bundle

getEntry

java.net.URL getEntry(java.lang.String path)

Returns a URL to the entry at the specified path in this bundle.

Parameters:

path - The path name of the entry

Returns:

A URL to the entry, or null if no entry could be found

getResource

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

Find the specified resource from this bundle's class loader.

Parameters:

name - The name of the resource.

Returns:

A URL to the named resource, or null if the resource could not be found

start

void start()
           throws org.osgi.framework.BundleException

Starts this bundle.

Throws:

org.osgi.framework.BundleException

stop

void stop()
          throws org.osgi.framework.BundleException

Stops this bundle.

Throws:

org.osgi.framework.BundleException

uninstall

void uninstall()
               throws org.osgi.framework.BundleException

Uninstalls this bundle.

Throws:

org.osgi.framework.BundleException