aQute.bnd.junit

Class JUnitFramework

java.lang.Object

aQute.bnd.junit.JUnitFramework

All Implemented Interfaces:

AutoCloseable

public class JUnitFramework
extends Object
implements AutoCloseable

This class provides an OSGi framework that is configured with the current bnd workspace. A project directory is used to find the workspace. This makes all repositories in the workspace available to the framework. To be able to test JUnit code against/in this framework it is necessary that all packages on the buildpath and testpath are actually exported in the framework. This class will ensure that. Once the framework is up and running it will be possible to add bundles to it. There are a number of ways that this can be achieved:

• Build a bundle – A bnd Builder is provided to create a bundle and install it. This makes it possible to add classes from the src or test directories or resources. See bundle().
• Add a bundle using a bnd spec – Using the bnd specs (e.g. 'org.apache.felix.configadmin;version=3'). See addBundle(String) et. al.
• Add a bndrun file – A file bndrun file can be added. All properties in this file that can be applied after a framework is started will be applied. See addBundles(File) et. al.

Convenience methods are added to get services, see getService(Class) et. al. Notice that this framework starts in the same process as that the JUnit code runs. This is normally a separately started VM.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	JUnitFramework.BundleBuilder

Field Summary

Fields

Modifier and Type	Field and Description
Jar	bin_test
org.osgi.framework.BundleContext	context
org.osgi.framework.launch.Framework	framework
Project	project
File	projectDir
List<org.osgi.util.tracker.ServiceTracker<?,?>>	trackers
Workspace	workspace

Constructor Summary

Constructors

Constructor and Description
JUnitFramework() Start a framework assuming the current working directory is the project directory.
JUnitFramework(File projectDir) Start a framework while providing a project directory.

Method Summary

Modifier and Type	Method and Description
List<org.osgi.framework.Bundle>	addBundle(String spec)
void	addBundles(File bndrun)
void	addBundles(String bndrun)
JUnitFramework.BundleBuilder	bundle()
void	close() Close this framework
org.osgi.framework.BundleContext	getBundleContext()
Project	getProject()
<T> T	getService(Class<T> class1)
<T> List<T>	getServices(Class<T> class1)
Workspace	getWorkspace()
void	startAll(List<org.osgi.framework.Bundle> bundles)
<T> org.osgi.util.promise.Promise<T>	waitForService(Class<T> class1, long timeoutInMs)

Methods inherited from class java.lang.Object

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

Field Detail

trackers

public final List<org.osgi.util.tracker.ServiceTracker<?,?>> trackers

bin_test

public final Jar bin_test

framework

public final org.osgi.framework.launch.Framework framework

context

public final org.osgi.framework.BundleContext context

projectDir

public final File projectDir

workspace

public Workspace workspace

project

public Project project

Constructor Detail

JUnitFramework

public JUnitFramework()

Start a framework assuming the current working directory is the project directory.

JUnitFramework

public JUnitFramework(File projectDir)

Start a framework while providing a project directory.

Parameters:

projectDir -

Method Detail

close

public void close()
           throws Exception

Close this framework

Specified by:

close in interface AutoCloseable

Throws:

Exception

getBundleContext

public org.osgi.framework.BundleContext getBundleContext()

getServices

public <T> List<T> getServices(Class<T> class1)
                        throws org.osgi.framework.InvalidSyntaxException

Throws:

org.osgi.framework.InvalidSyntaxException

getService

public <T> T getService(Class<T> class1)
                 throws Exception

Throws:

Exception

waitForService

public <T> org.osgi.util.promise.Promise<T> waitForService(Class<T> class1,
                                                           long timeoutInMs)
                                                    throws Exception

Throws:

Exception

bundle

public JUnitFramework.BundleBuilder bundle()
                                    throws IOException

Throws:

IOException

addBundles

public void addBundles(String bndrun)
                throws Exception

Throws:

Exception

addBundles

public void addBundles(File bndrun)
                throws Exception

Throws:

Exception

getWorkspace

public Workspace getWorkspace()
                       throws Exception

Throws:

Exception

getProject

public Project getProject()
                   throws Exception

Throws:

Exception

startAll

public void startAll(List<org.osgi.framework.Bundle> bundles)
              throws org.osgi.framework.BundleException

Throws:

org.osgi.framework.BundleException

addBundle

public List<org.osgi.framework.Bundle> addBundle(String spec)
                                          throws Exception

Throws:

Exception