org.ops4j.pax.exam
Class Customizer

java.lang.Object
  org.ops4j.pax.exam.Customizer

All Implemented Interfaces:

Option

Direct Known Subclasses:

CompositeCustomizer

public abstract class Customizer
extends Object
implements Option

Hooks to inject certain activities into pax exam execution phases. All phases can contain code to customize things at different phases.

Constructor Summary

Customizer()

Method Summary

void	customizeEnvironment(File workingFolder) Callback method that can contain steps to finally change/set up the working environment.
InputStream	customizeTestProbe(InputStream testProbe) Callback that allow to customize the ready built test probe.

Methods inherited from class java.lang.Object

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

Constructor Detail

Customizer

public Customizer()

Method Detail

customizeEnvironment

public void customizeEnvironment(File workingFolder)

Callback method that can contain steps to finally change/set up the working environment. It is being called just before the OSGi platform of choice boots. An exception at this point will make exam stop and not running the test. (actually, the test will fail)

Parameters:

workingFolder - final workingfolder (new File(".")) of your osgi setup. Be careful there, the platform may not start if you (for example) delete things in there.

customizeTestProbe

public InputStream customizeTestProbe(InputStream testProbe)
                               throws Exception

Callback that allow to customize the ready built test probe. Examples are: - need to obfuscate bytecode - need to add checksums - want to share/copy the probe somewhere You can use the Tinybundles library to easily change bits of your bundle on the fly.

Parameters:

testProbe - stream of the probe

Returns:

probe to be installed instead of probe.

Throws:

Exception - delegate exception handling to container as it would just clutter implementations.