org.ops4j.pax.exam.spi

Class PaxExamRuntime

java.lang.Object

org.ops4j.pax.exam.spi.PaxExamRuntime

public class PaxExamRuntime
extends Object

Pax Exam runtime.

Since:

0.3.0, December 09, 2008

Author:

Alin Dreghiciu (adreghiciu@gmail.com), Toni Menzel (toni@okidokiteam.com)

Method Summary

Modifier and Type	Method and Description
static org.ops4j.pax.exam.TestContainer	createContainer(org.ops4j.pax.exam.ExamSystem system) Convenience factory when just dealing with one container (intentionally).
static org.ops4j.pax.exam.TestContainer	createContainer(String configurationClassName) Creates and starts a test container using options from a configuration class.
static org.ops4j.pax.exam.ExamSystem	createServerSystem(org.ops4j.pax.exam.Option... options)
static org.ops4j.pax.exam.ExamSystem	createTestSystem(org.ops4j.pax.exam.Option... options)
static org.ops4j.pax.exam.TestContainerFactory	getTestContainerFactory() Discovers the regression container.
static org.ops4j.pax.exam.TestContainerFactory	getTestContainerFactory(Class<? extends org.ops4j.pax.exam.TestContainerFactory> select) Select yourself
static void	main(String[] args) Runs a standalone container in server mode which can be terminated gracefully by sending text commands over a socket.

Methods inherited from class java.lang.Object

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

Method Detail

getTestContainerFactory

public static org.ops4j.pax.exam.TestContainerFactory getTestContainerFactory()

Discovers the regression container. Discovery is performed via ServiceLoader discovery mechanism.

Returns:

discovered test container

createContainer

public static org.ops4j.pax.exam.TestContainer createContainer(org.ops4j.pax.exam.ExamSystem system)

Convenience factory when just dealing with one container (intentionally). Note, this will break if there is not exaclty one container available and parsed from options. If there are more containers, just the first (whatever comes first) will be picked.

Parameters:

system - to be used.

Returns:

exactly one Test Container.

createContainer

public static org.ops4j.pax.exam.TestContainer createContainer(String configurationClassName)
                                                        throws Exception

Creates and starts a test container using options from a configuration class.

Parameters:

configurationClassName - fully qualified class name of a configuration class.

Returns:

started test container

Throws:

Exception - when options cannot be parsed

createTestSystem

public static org.ops4j.pax.exam.ExamSystem createTestSystem(org.ops4j.pax.exam.Option... options)
                                                      throws IOException

Throws:

IOException

createServerSystem

public static org.ops4j.pax.exam.ExamSystem createServerSystem(org.ops4j.pax.exam.Option... options)
                                                        throws IOException

Throws:

IOException

getTestContainerFactory

public static org.ops4j.pax.exam.TestContainerFactory getTestContainerFactory(Class<? extends org.ops4j.pax.exam.TestContainerFactory> select)

Select yourself

Parameters:

select - the exact implementation if you dont want to rely on commons util discovery or change different containers in a single project.

Returns:

discovered regression container

main

public static void main(String[] args)
                 throws Exception

Runs a standalone container in server mode which can be terminated gracefully by sending text commands over a socket.

This class must be invoked with two arguments:

• The fully qualified name of a @Configuration class
• A port number.

After starting the container, this process will listen on the given port for a "stop" command, sending a reply of "stopped". When finally receiving a "quit" command, the process will exit.

Parameters:

args - command line argument

Throws:

Exception - when options cannot be parsed