org.apache.brooklyn.util.osgi

Interface SystemFramework

All Known Implementing Classes:

ContainerFramework, EmbeddedFramework

public interface SystemFramework

Method Summary

Modifier and Type	Method and Description
org.osgi.framework.launch.Framework	getFramework(java.lang.String felixCacheDir, boolean clean) Provides an OSGI framework.
<T> java.net.URL	getResourceFromBundle(java.lang.String type, org.osgi.framework.Bundle b) Loads a resource from the passed bundle.
<T> java.util.Enumeration<java.net.URL>	getResourcesFromBundle(java.lang.String type, org.osgi.framework.Bundle b) Loads resources from the passed bundle.
boolean	isSystemBundle(org.osgi.framework.Bundle bundle) Whether the bundle is exporting classes from the application class path.
<T> java.lang.Class<T>	loadClassFromBundle(java.lang.String type, org.osgi.framework.Bundle b) Loads a class from the passed bundle.
void	ungetFramework(org.osgi.framework.launch.Framework framework) Stops/ungets the OSGi framework, depending on the environment.

Method Detail

getFramework

org.osgi.framework.launch.Framework getFramework(java.lang.String felixCacheDir,
                                                 boolean clean)

Provides an OSGI framework. When running inside an OSGi container, the container framework is returned. When running standalone a new Apache Felix container is created.

ungetFramework

void ungetFramework(org.osgi.framework.launch.Framework framework)

Stops/ungets the OSGi framework, depending on the environment.

isSystemBundle

boolean isSystemBundle(org.osgi.framework.Bundle bundle)

Whether the bundle is exporting classes from the application class path.

loadClassFromBundle

<T> java.lang.Class<T> loadClassFromBundle(java.lang.String type,
                                           org.osgi.framework.Bundle b)
                                    throws java.lang.ClassNotFoundException

Loads a class from the passed bundle. The embedded environment has some special requirements for loading classes so the implementation will abstract those.

Throws:

java.lang.ClassNotFoundException

getResourceFromBundle

<T> java.net.URL getResourceFromBundle(java.lang.String type,
                                       org.osgi.framework.Bundle b)

Loads a resource from the passed bundle. The embedded environment has some special requirements for loading resources so the implementation will abstract those.

getResourcesFromBundle

<T> java.util.Enumeration<java.net.URL> getResourcesFromBundle(java.lang.String type,
                                                               org.osgi.framework.Bundle b)
                                                        throws java.io.IOException

Loads resources from the passed bundle. The embedded environment has some special requirements for loading resources so the implementation will abstract those. As a single bundle is passed the result will contain at most one element, or be null if none is found.

Throws:

java.io.IOException