Module org.junit.platform.launcher

Package org.junit.platform.launcher

Class LauncherConstants

java.lang.Object

org.junit.platform.launcher.LauncherConstants

@API(status=EXPERIMENTAL,
     since="1.3")
public class LauncherConstants
extends Object

Collection of constants related to Launcher.

Since:

1.3

See Also:

ConfigurationParameters

Field Summary

Fields

Modifier and Type	Field	Description
static int	CAPTURE_MAX_BUFFER_DEFAULT	Default maximum number of bytes for buffering to use per thread and output type if output capturing is enabled.
static String	CAPTURE_MAX_BUFFER_PROPERTY_NAME	Property name used to configure the maximum number of bytes for buffering to use per thread and output type if output capturing is enabled: "junit.platform.output.capture.maxBuffer"
static String	CAPTURE_STDERR_PROPERTY_NAME	Property name used to enable capturing output to System.err: "junit.platform.output.capture.stderr"
static String	CAPTURE_STDOUT_PROPERTY_NAME	Property name used to enable capturing output to System.out: "junit.platform.output.capture.stdout"
static String	DEACTIVATE_ALL_LISTENERS_PATTERN	Wildcard pattern which signals that all listeners registered via the ServiceLoader mechanism should be deactivated: "*"
static String	DEACTIVATE_LISTENERS_PATTERN_PROPERTY_NAME	Property name used to provide patterns for deactivating listeners registered via the ServiceLoader mechanism: "junit.platform.execution.listeners.deactivate"
static String	STDERR_REPORT_ENTRY_KEY	Key used to publish captured output to System.err as part of a ReportEntry: "stderr"
static String	STDOUT_REPORT_ENTRY_KEY	Key used to publish captured output to System.out as part of a ReportEntry: "stdout"

Method Summary

Methods inherited from class java.lang.Object

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

Field Detail

CAPTURE_STDOUT_PROPERTY_NAME

public static final String CAPTURE_STDOUT_PROPERTY_NAME

Property name used to enable capturing output to System.out: "junit.platform.output.capture.stdout"

By default, output to System.out is not captured.

If enabled, the JUnit Platform captures the corresponding output and publishes it as a ReportEntry using the "stdout" key immediately before reporting the test identifier as finished.

See Also:

STDOUT_REPORT_ENTRY_KEY, ReportEntry, TestExecutionListener.reportingEntryPublished(TestIdentifier, ReportEntry), Constant Field Values

CAPTURE_STDERR_PROPERTY_NAME

public static final String CAPTURE_STDERR_PROPERTY_NAME

Property name used to enable capturing output to System.err: "junit.platform.output.capture.stderr"

By default, output to System.err is not captured.

If enabled, the JUnit Platform captures the corresponding output and publishes it as a ReportEntry using the "stderr" key immediately before reporting the test identifier as finished.

See Also:

STDERR_REPORT_ENTRY_KEY, ReportEntry, TestExecutionListener.reportingEntryPublished(TestIdentifier, ReportEntry), Constant Field Values

CAPTURE_MAX_BUFFER_PROPERTY_NAME

public static final String CAPTURE_MAX_BUFFER_PROPERTY_NAME

Property name used to configure the maximum number of bytes for buffering to use per thread and output type if output capturing is enabled: "junit.platform.output.capture.maxBuffer"

Value must be an integer; defaults to 4194304.

See Also:

CAPTURE_MAX_BUFFER_DEFAULT, Constant Field Values

CAPTURE_MAX_BUFFER_DEFAULT

public static final int CAPTURE_MAX_BUFFER_DEFAULT

Default maximum number of bytes for buffering to use per thread and output type if output capturing is enabled.

See Also:

CAPTURE_MAX_BUFFER_PROPERTY_NAME, Constant Field Values

STDOUT_REPORT_ENTRY_KEY

public static final String STDOUT_REPORT_ENTRY_KEY

Key used to publish captured output to System.out as part of a ReportEntry: "stdout"

See Also:

Constant Field Values

STDERR_REPORT_ENTRY_KEY

public static final String STDERR_REPORT_ENTRY_KEY

Key used to publish captured output to System.err as part of a ReportEntry: "stderr"

See Also:

Constant Field Values

DEACTIVATE_LISTENERS_PATTERN_PROPERTY_NAME

public static final String DEACTIVATE_LISTENERS_PATTERN_PROPERTY_NAME

Property name used to provide patterns for deactivating listeners registered via the ServiceLoader mechanism: "junit.platform.execution.listeners.deactivate"

Pattern Matching Syntax

If the property value consists solely of an asterisk (*), all listeners will be deactivated. Otherwise, the property value will be treated as a comma-separated list of patterns where each individual pattern will be matched against the fully qualified class name (FQCN) of each registered listener. Any dot (.) in a pattern will match against a dot (.) or a dollar sign ($) in a FQCN. Any asterisk (*) will match against one or more characters in a FQCN. All other characters in a pattern will be matched one-to-one against a FQCN.

Examples

• *: deactivates all listeners.
• org.junit.*: deactivates every listener under the org.junit base package and any of its subpackages.
• *.MyListener: deactivates every listener whose simple class name is exactly MyListener.
• *System*, *Dev*: deactivates every listener whose FQCN contains System or Dev.
• org.example.MyListener, org.example.TheirListener: deactivates listeners whose FQCN is exactly org.example.MyListener or org.example.TheirListener.

See Also:

DEACTIVATE_ALL_LISTENERS_PATTERN, TestExecutionListener, Constant Field Values

DEACTIVATE_ALL_LISTENERS_PATTERN

public static final String DEACTIVATE_ALL_LISTENERS_PATTERN

Wildcard pattern which signals that all listeners registered via the ServiceLoader mechanism should be deactivated: "*"

See Also:

DEACTIVATE_LISTENERS_PATTERN_PROPERTY_NAME, TestExecutionListener, Constant Field Values