Interface LauncherConfig


  • @API(status=EXPERIMENTAL,
         since="1.3")
    public interface LauncherConfig
    LauncherConfig defines the configuration API for creating Launcher instances via the LauncherFactory.

    Example

     LauncherConfig launcherConfig = LauncherConfig.builder()
       .enableTestEngineAutoRegistration(false)
       .enableTestExecutionListenerAutoRegistration(false)
       .addTestEngines(new CustomTestEngine())
       .addTestExecutionListeners(new CustomTestExecutionListener())
       .build();
    
     Launcher launcher = LauncherFactory.create(launcherConfig);
     LauncherDiscoveryRequest discoveryRequest = ...
     launcher.execute(discoveryRequest);
     
    Since:
    1.3
    See Also:
    builder(), Launcher, LauncherFactory
    • Method Detail

      • isTestEngineAutoRegistrationEnabled

        boolean isTestEngineAutoRegistrationEnabled()
        Determine if test engines should be discovered at runtime using the ServiceLoader mechanism and automatically registered.
        Returns:
        true if test engines should be automatically registered
      • isTestExecutionListenerAutoRegistrationEnabled

        boolean isTestExecutionListenerAutoRegistrationEnabled()
        Determine if test execution listeners should be discovered at runtime using the ServiceLoader mechanism and automatically registered.
        Returns:
        true if test execution listeners should be automatically registered
      • getAdditionalTestEngines

        Collection<TestEngine> getAdditionalTestEngines()
        Get the collection of additional test engines that should be added to the Launcher.
        Returns:
        the collection of additional test engines; never null but potentially empty
      • getAdditionalTestExecutionListeners

        Collection<TestExecutionListener> getAdditionalTestExecutionListeners()
        Get the collection of additional test execution listeners that should be added to the Launcher.
        Returns:
        the collection of additional test execution listeners; never null but potentially empty