Interface Launcher


  • @API(status=STABLE,
         since="1.0")
    public interface Launcher
    The Launcher API is the main entry point for client code that wishes to discover and execute tests using one or more test engines.

    Implementations of this interface are responsible for determining the set of test engines to delegate to at runtime and for ensuring that each test engine has an ID that is unique among the registered test engines. For example, the default implementation returned by LauncherFactory.create() dynamically discovers test engines via Java's ServiceLoader mechanism.

    Test discovery and execution require a LauncherDiscoveryRequest that is passed to all registered engines. Each engine decides which tests it can discover and execute according to the supplied request.

    Prior to executing tests, clients of this interface should register one or more TestExecutionListener instances in order to get feedback about the progress and results of test execution. Listeners will be notified of events in the order in which they were registered. The default implementation returned by LauncherFactory.create() dynamically discovers test execution listeners via Java's ServiceLoader mechanism.

    Since:
    1.0
    See Also:
    LauncherDiscoveryRequest, TestPlan, TestExecutionListener, LauncherFactory, TestEngine