Eclipse JDT
Release 3.7

org.eclipse.jdt.junit
Class JUnitCore

java.lang.Object
  extended by 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
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.
 
Constructor Summary
JUnitCore()
           
 
Method Summary
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, 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
Constructor Detail

JUnitCore

public JUnitCore()
Method Detail

addTestRunListener

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

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

Eclipse JDT
Release 3.7

Guidelines for using Eclipse APIs.

Copyright (c) 2000, 2011 IBM Corporation and others. All rights reserved.