org.eclipse.jdt.junit

Class JUnitCore

java.lang.Object

org.eclipse.jdt.junit.JUnitCore

public class JUnitCore
extends Object

Class for accessing JUnit support; all functionality is provided by static methods.

This class is not intended to be subclassed or instantiated by clients.

Since:

2.1

Restriction:

This class is not intended to be subclassed by clients.

Restriction:

This class is not intended to be instantiated by clients.

Field Summary

Fields

Modifier and Type	Field and Description
static String	JUNIT_CONTAINER_ID ID of the JUnit classpath container.
static IPath	JUNIT3_CONTAINER_PATH Path of the JUnit 3 classpath container.
static IPath	JUNIT4_CONTAINER_PATH Path of the JUnit 4 classpath container.
static IPath	JUNIT5_CONTAINER_PATH Path of the JUnit 5 classpath container.

Constructor Summary

Constructors

Constructor and Description
JUnitCore()

Method Summary

Modifier and Type	Method and Description
static void	addTestRunListener(ITestRunListener listener) Deprecated. As of 3.3, replaced by addTestRunListener(TestRunListener)
static void	addTestRunListener(TestRunListener listener) Adds a listener for test runs.
static void	exportTestRunSession(ITestRunSession testRunSession, File file) Exports the given test run session into an XML report file.
static void	exportTestRunSession(ITestRunSession testRunSession, OutputStream output) Exports the given test run session to an output stream.
static IType[]	findTestTypes(IJavaElement container, IProgressMonitor monitor) Finds types that contain JUnit tests in the given container.
static ITestRunSession	importTestRunSession(File file) Imports a test run session from the given file.
static ITestRunSession	importTestRunSession(String url, IProgressMonitor monitor) Imports a test run session from the given URL.
static void	removeTestRunListener(ITestRunListener listener) Deprecated. As of 3.3, replaced by removeTestRunListener(TestRunListener)
static void	removeTestRunListener(TestRunListener listener) Removes a listener for test runs.

Methods inherited from class java.lang.Object

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

Field Detail

JUNIT_CONTAINER_ID

public static final String JUNIT_CONTAINER_ID

ID of the JUnit classpath container. The general format of classpath entries using this container is unspecified.

Since:

3.6

See Also:

JUNIT3_CONTAINER_PATH, JUNIT4_CONTAINER_PATH, JUNIT5_CONTAINER_PATH, Constant Field Values

JUNIT3_CONTAINER_PATH

public static final IPath JUNIT3_CONTAINER_PATH

Path of the JUnit 3 classpath container.

Since:

3.6

JUNIT4_CONTAINER_PATH

public static final IPath JUNIT4_CONTAINER_PATH

Path of the JUnit 4 classpath container.

Since:

3.6

JUNIT5_CONTAINER_PATH

public static final IPath JUNIT5_CONTAINER_PATH

Path of the JUnit 5 classpath container.

Since:

3.10

Constructor Detail

JUnitCore

public JUnitCore()

Method Detail

addTestRunListener

@Deprecated
public static void addTestRunListener(ITestRunListener listener)

Deprecated. As of 3.3, replaced by addTestRunListener(TestRunListener)

Adds a listener for test runs.

Parameters:

listener - listener to be added

removeTestRunListener

@Deprecated
public static void removeTestRunListener(ITestRunListener listener)

Deprecated. As of 3.3, replaced by removeTestRunListener(TestRunListener)

Removes a listener for test runs.

Parameters:

listener - listener to be removed

addTestRunListener

public static void addTestRunListener(TestRunListener listener)

Adds a listener for test runs.

Note: If your plug-in should be loaded when a test run starts, please contribute to the org.eclipse.jdt.junit.testRunListeners extension point instead.

Parameters:

listener - the listener to be added

Since:

3.3

removeTestRunListener

public static void removeTestRunListener(TestRunListener listener)

Removes a listener for test runs.

Parameters:

listener - the listener to be removed

Since:

3.3

findTestTypes

public static IType[] findTestTypes(IJavaElement container,
                                    IProgressMonitor monitor)
                             throws CoreException,
                                    OperationCanceledException

Finds types that contain JUnit tests in the given container.

Parameters:

container - the container

monitor - the progress monitor used to report progress and request cancelation, or null if none

Returns:

test types inside the given container

Throws:

CoreException - when a problem occurs while accessing container or its children

OperationCanceledException - if the operation has been canceled

Since:

3.5

exportTestRunSession

public static void exportTestRunSession(ITestRunSession testRunSession,
                                        File file)
                                 throws CoreException

Exports the given test run session into an XML report file.

Parameters:

testRunSession - the test run session

file - the destination

Throws:

CoreException - if an error occurred

Since:

3.7

exportTestRunSession

public static void exportTestRunSession(ITestRunSession testRunSession,
                                        OutputStream output)
                                 throws CoreException

Exports the given test run session to an output stream.

Parameters:

testRunSession - the test run session

output - the output stream

Throws:

CoreException - if an error occurred

Since:

3.7

importTestRunSession

public static ITestRunSession importTestRunSession(File file)
                                            throws CoreException

Imports a test run session from the given file.

Parameters:

file - a file containing a test run session transcript

Returns:

the imported test run session

Throws:

CoreException - if the import failed

Since:

3.7

importTestRunSession

public static ITestRunSession importTestRunSession(String url,
                                                   IProgressMonitor monitor)
                                            throws CoreException

Imports a test run session from the given URL.

Parameters:

url - an URL to a test run session transcript

monitor - a progress monitor for cancellation

Returns:

the imported test run session, or null if the import has been cancelled

Throws:

CoreException - if the import failed

Since:

3.7