org.ops4j.pax.exam
Class Customizer

java.lang.Object
  extended by org.ops4j.pax.exam.Customizer
All Implemented Interfaces:
Option
Direct Known Subclasses:
CompositeCustomizer

public abstract class Customizer
extends java.lang.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(java.io.File workingFolder)
          Callback method that can contain steps to finally change/set up the working environment.
 java.io.InputStream customizeTestProbe(java.io.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(java.io.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 java.io.InputStream customizeTestProbe(java.io.InputStream testProbe)
                                       throws java.lang.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:
java.lang.Exception - delegate exception handling to container as it would just clutter implementations.


Copyright © 2006-2012 OPS4J - Open Participation Software for Java. All Rights Reserved.