Class JUnitTest
- java.lang.Object
- 
- org.apache.tools.ant.taskdefs.optional.junit.BaseTest
- 
- org.apache.tools.ant.taskdefs.optional.junit.JUnitTest
 
 
- 
- All Implemented Interfaces:
- java.lang.Cloneable
 
 public class JUnitTest extends BaseTest implements java.lang.Cloneable Run a single JUnit test.The JUnit test is actually run by JUnitTestRunner. So read the doc comments for that class :)- Since:
- Ant 1.2
- See Also:
- JUnitTask,- JUnitTestRunner
 
- 
- 
Field Summary- 
Fields inherited from class org.apache.tools.ant.taskdefs.optional.junit.BaseTestdestDir, errorProperty, failureProperty, filtertrace, fork, formatters, haltOnError, haltOnFail, ifProperty, unlessProperty
 
- 
 - 
Constructor SummaryConstructors Constructor Description JUnitTest()No arg constructor.JUnitTest(java.lang.String name)Constructor with name.JUnitTest(java.lang.String name, boolean haltOnError, boolean haltOnFailure, boolean filtertrace)Constructor with options.JUnitTest(java.lang.String name, boolean haltOnError, boolean haltOnFailure, boolean filtertrace, java.lang.String[] methods)Constructor with options.JUnitTest(java.lang.String name, boolean haltOnError, boolean haltOnFailure, boolean filtertrace, java.lang.String[] methods, int thread)Constructor with options.
 - 
Method SummaryModifier and Type Method Description java.lang.Objectclone()longerrorCount()Get the number of errors.longfailureCount()Get the number of failures.FormatterElement[]getFormatters()Get the formatters set for this test.java.lang.StringgetName()Get the name of the test class.java.lang.StringgetOutfile()Get the name of the output filejava.util.PropertiesgetProperties()Get the properties used in the test.longgetRunTime()Get the run time.intgetThread()Get the Ant id of the thread running the test.static java.lang.String[]parseTestMethodNamesList(java.lang.String methodNames)Parses a comma-separated list of method names and check their validity.longrunCount()Get the number of runs.voidsetCounts(long runs, long failures, long errors)Set the number of runs, failures, errors, and skipped tests.voidsetCounts(long runs, long failures, long errors, long skips)Set the number of runs, failures, errors, and skipped tests.voidsetMethods(java.lang.String value)Sets names of individual test methods to be executed.voidsetName(java.lang.String value)Set the name of the test class.voidsetOutfile(java.lang.String value)Set the name of the output file.voidsetProperties(java.util.Hashtable<?,?> p)Set the properties to be used in the test.voidsetRunTime(long runTime)Set the runtime.voidsetThread(int thread)Set the thread idbooleanshouldRun(Project p)Check if this test should run based on the if and unless attributes.longskipCount()Get the number of skipped tests.- 
Methods inherited from class org.apache.tools.ant.taskdefs.optional.junit.BaseTestaddFormatter, getErrorProperty, getFailureProperty, getFiltertrace, getFork, getHaltonerror, getHaltonfailure, getIfCondition, getTodir, getUnlessCondition, isSkipNonTests, setErrorProperty, setFailureProperty, setFiltertrace, setFork, setHaltonerror, setHaltonfailure, setIf, setIf, setSkipNonTests, setTodir, setUnless, setUnless
 
- 
 
- 
- 
- 
Constructor Detail- 
JUnitTestpublic JUnitTest() No arg constructor.
 - 
JUnitTestpublic JUnitTest(java.lang.String name) Constructor with name.- Parameters:
- name- the name of the test.
 
 - 
JUnitTestpublic JUnitTest(java.lang.String name, boolean haltOnError, boolean haltOnFailure, boolean filtertrace)Constructor with options.- Parameters:
- name- the name of the test.
- haltOnError- if true halt the tests if there is an error.
- haltOnFailure- if true halt the tests if there is a failure.
- filtertrace- if true filter stack traces.
 
 - 
JUnitTestpublic JUnitTest(java.lang.String name, boolean haltOnError, boolean haltOnFailure, boolean filtertrace, java.lang.String[] methods)Constructor with options.- Parameters:
- name- the name of the test.
- haltOnError- if true halt the tests if there is an error.
- haltOnFailure- if true halt the tests if there is a failure.
- filtertrace- if true filter stack traces.
- methods- if non-null run only these test methods
- Since:
- 1.8.2
 
 - 
JUnitTestpublic JUnitTest(java.lang.String name, boolean haltOnError, boolean haltOnFailure, boolean filtertrace, java.lang.String[] methods, int thread)Constructor with options.- Parameters:
- name- the name of the test.
- haltOnError- if true halt the tests if there is an error.
- haltOnFailure- if true halt the tests if there is a failure.
- filtertrace- if true filter stack traces.
- methods- if non-null run only these test methods
- thread- Ant thread ID in which test is currently running
- Since:
- 1.9.4
 
 
- 
 - 
Method Detail- 
setMethodspublic void setMethods(java.lang.String value) Sets names of individual test methods to be executed.- Parameters:
- value- comma-separated list of names of individual test methods to be executed, or- nullif all test methods should be executed
- Since:
- 1.8.2
 
 - 
setNamepublic void setName(java.lang.String value) Set the name of the test class.- Parameters:
- value- the name to use.
 
 - 
setThreadpublic void setThread(int thread) Set the thread id- Parameters:
- thread- the Ant id of the thread running this test (this is not the system process or thread id) (this will be 0 in single-threaded mode).
- Since:
- Ant 1.9.4
 
 - 
setOutfilepublic void setOutfile(java.lang.String value) Set the name of the output file.- Parameters:
- value- the name of the output file to use.
 
 - 
parseTestMethodNamesListpublic static java.lang.String[] parseTestMethodNamesList(java.lang.String methodNames) throws java.lang.IllegalArgumentExceptionParses a comma-separated list of method names and check their validity.- Parameters:
- methodNames- comma-separated list of method names to be parsed
- Returns:
- array of individual test method names
- Throws:
- java.lang.IllegalArgumentException- if the given string is- nullor if it is not a comma-separated list of valid Java identifiers; an empty string is acceptable and is handled as an empty list
- Since:
- 1.8.2
 
 - 
getNamepublic java.lang.String getName() Get the name of the test class.- Returns:
- the name of the test.
 
 - 
getThreadpublic int getThread() Get the Ant id of the thread running the test.- Returns:
- the thread id
 
 - 
getOutfilepublic java.lang.String getOutfile() Get the name of the output file- Returns:
- the name of the output file.
 
 - 
setCountspublic void setCounts(long runs, long failures, long errors)Set the number of runs, failures, errors, and skipped tests.- Parameters:
- runs- the number of runs.
- failures- the number of failures.
- errors- the number of errors. Kept for backward compatibility with Ant 1.8.4
 
 - 
setCountspublic void setCounts(long runs, long failures, long errors, long skips)Set the number of runs, failures, errors, and skipped tests.- Parameters:
- runs- the number of runs.
- failures- the number of failures.
- errors- the number of errors.
- skips- the number of skipped tests.
- Since:
- Ant 1.9.0
 
 - 
setRunTimepublic void setRunTime(long runTime) Set the runtime.- Parameters:
- runTime- the time in milliseconds.
 
 - 
runCountpublic long runCount() Get the number of runs.- Returns:
- the number of runs.
 
 - 
failureCountpublic long failureCount() Get the number of failures.- Returns:
- the number of failures.
 
 - 
errorCountpublic long errorCount() Get the number of errors.- Returns:
- the number of errors.
 
 - 
skipCountpublic long skipCount() Get the number of skipped tests.- Returns:
- the number of skipped tests.
 
 - 
getRunTimepublic long getRunTime() Get the run time.- Returns:
- the run time in milliseconds.
 
 - 
getPropertiespublic java.util.Properties getProperties() Get the properties used in the test.- Returns:
- the properties.
 
 - 
setPropertiespublic void setProperties(java.util.Hashtable<?,?> p) Set the properties to be used in the test.- Parameters:
- p- the properties. This is a copy of the projects ant properties.
 
 - 
shouldRunpublic boolean shouldRun(Project p) Check if this test should run based on the if and unless attributes.- Parameters:
- p- the project to use to check if the if and unless properties exist in.
- Returns:
- true if this test or testsuite should be run.
 
 - 
getFormatterspublic FormatterElement[] getFormatters() Get the formatters set for this test.- Returns:
- the formatters as an array.
 
 - 
clonepublic java.lang.Object clone() - Overrides:
- clonein class- java.lang.Object
- Returns:
- a clone of this test.
- Since:
- Ant 1.5
 
 
- 
 
-