|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object | +--org.apache.tools.ant.Task | +--org.apache.tools.ant.taskdefs.optional.junit.JUnitTask
Ant task to run JUnit tests.
JUnit is a framework to create unit test. It has been initially created by Erich Gamma and Kent Beck. JUnit can be found at http://www.junit.org.
To spawn a new Java VM to prevent interferences between
different testcases, you need to enable fork
.
Fields inherited from class org.apache.tools.ant.Task |
description, location, project, target, taskName, taskType, wrapper |
Constructor Summary | |
JUnitTask()
Creates a new JUnitRunner and enables fork of a new Java VM. |
Method Summary | |
void |
addFormatter(FormatterElement fe)
Add a new formatter to all tests of this task. |
void |
addSysproperty(Environment.Variable sysp)
Add a nested sysproperty element. |
void |
addTest(JUnitTest test)
Add a new single testcase. |
protected java.util.Enumeration |
allTests()
|
BatchTest |
createBatchTest()
Create a new set of testcases (also called ..batchtest) and add it to the list. |
Path |
createClasspath()
|
Commandline.Argument |
createJvmarg()
Create a new JVM argument. |
protected ExecuteWatchdog |
createWatchdog()
|
void |
execute()
Runs the testcase. |
protected void |
execute(JUnitTest test)
|
protected java.io.OutputStream |
getDefaultOutput()
get the default output for a formatter. |
protected java.util.Enumeration |
getIndividualTests()
Merge all individual tests from the batchtest with all individual tests and return an enumeration over all JUnitTest. |
protected java.io.File |
getOutput(FormatterElement fe,
JUnitTest test)
return the file or null if does not use a file |
void |
setDir(java.io.File dir)
The directory to invoke the VM in. |
void |
setFork(boolean value)
Tells whether a JVM should be forked for each testcase. |
void |
setHaltonerror(boolean value)
Tells this task to halt when there is an error in a test. |
void |
setHaltonfailure(boolean value)
Tells this task to halt when there is a failure in a test. |
void |
setJvm(java.lang.String value)
Set a new VM to execute the testcase. |
void |
setMaxmemory(java.lang.String max)
Set the maximum memory to be used by all forked JVMs. |
void |
setPrintsummary(boolean value)
Tells whether the task should print a short summary of the task. |
void |
setTimeout(java.lang.Integer value)
Set the timeout value (in milliseconds). |
Methods inherited from class org.apache.tools.ant.Task |
getDescription, getLocation, getOwningTarget, getProject, getRuntimeConfigurableWrapper, getTaskName, init, log, log, maybeConfigure, setDescription, setLocation, setOwningTarget, setRuntimeConfigurableWrapper, setTaskName |
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
public JUnitTask() throws java.lang.Exception
Method Detail |
public void setHaltonerror(boolean value)
value
- true if it should halt, otherwise falsepublic void setHaltonfailure(boolean value)
value
- true if it should halt, otherwise falsepublic void setFork(boolean value)
value
- true if a JVM should be forked, otherwise falsesetTimeout(Integer)
,
#haltOntimeout(boolean)
public void setPrintsummary(boolean value)
value
- true to print a summary, false otherwise.SummaryJUnitResultFormatter
public void setTimeout(java.lang.Integer value)
value
- the maximum time (in milliseconds) allowed before declaring the test
as 'timed-out'setFork(boolean)
,
#haltOnTimeout(boolean)
public void setMaxmemory(java.lang.String max)
max
- the value as defined by -mx or -Xmx
in the java command line options.public void setJvm(java.lang.String value)
value
- the new VM to use instead of javasetFork(boolean)
public Commandline.Argument createJvmarg()
setFork(boolean)
public void setDir(java.io.File dir)
dir
- the directory to invoke the JVM from.setFork(boolean)
public void addSysproperty(Environment.Variable sysp)
public Path createClasspath()
public void addTest(JUnitTest test)
test
- a new single testcaseJUnitTest
public BatchTest createBatchTest()
BatchTest
public void addFormatter(FormatterElement fe)
public void execute() throws BuildException
execute
in class Task
org.apache.tools.ant.Task
BuildException
- if someting goes wrong with the buildprotected void execute(JUnitTest test) throws BuildException
protected ExecuteWatchdog createWatchdog() throws BuildException
protected java.io.OutputStream getDefaultOutput()
protected java.util.Enumeration getIndividualTests()
protected java.util.Enumeration allTests()
protected java.io.File getOutput(FormatterElement fe, JUnitTest test)
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |