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.xprogramming.com/software.htm. + * + *
This ant task runs a single TestCase. By default it spans a new
+ * Java VM to prevent interferences between different testcases,
+ * unless This TestRunner expects a name of a TestCase class as its
+ * argument. If this class provides a static suite() method it will be
+ * called and the resulting Test will be run.
+ *
+ * Otherwise all public methods starting with "test" and taking no
+ * argument will be run.
+ *
+ * Summary output is generated at the end.
+ *
+ * @author Stefan Bodewig
+ */
+
+public class JUnitTestRunner implements TestListener {
+
+ /**
+ * Holds the registered formatters.
+ */
+ private Vector formatters = new Vector();
+
+ /**
+ * Collects TestResults.
+ */
+ private TestResult res;
+
+ /**
+ * Flag for endTest.
+ */
+ private boolean failed = true;
+
+ /**
+ * The test I'm going to run.
+ */
+ private JUnitTest junitTest;
+
+ /**
+ * The corresponding testsuite.
+ */
+ private Test suite = null;
+
+ /**
+ * Returncode
+ */
+ private int retCode = 0;
+
+ public JUnitTestRunner(JUnitTest test) {
+ junitTest = test;
+ try {
+ if (junitTest.getPrintxml()) {
+ if (test.getOutfile() != null
+ && test.getOutfile().length() > 0) {
+
+ addFormatter(new XMLJUnitResultFormatter(
+ new PrintWriter(
+ new FileWriter(test.getOutfile(), false)
+ )
+ )
+ );
+ } else {
+ addFormatter(new XMLJUnitResultFormatter(
+ new PrintWriter(
+ new OutputStreamWriter(System.out), true)
+ )
+ );
+ }
+ }
+
+ if (junitTest.getPrintsummary()) {
+ addFormatter(new SummaryJUnitResultFormatter());
+ }
+
+ Class testClass = Class.forName(junitTest.getName());
+
+ try {
+ Method suiteMethod= testClass.getMethod("suite", new Class[0]);
+ suite = (Test)suiteMethod.invoke(null, new Class[0]);
+ } catch(NoSuchMethodException e) {
+ } catch(InvocationTargetException e) {
+ } catch(IllegalAccessException e) {
+ }
+
+ if (suite == null) {
+ // try to extract a test suite automatically
+ // this will generate warnings if the class is no suitable Test
+ suite= new TestSuite(testClass);
+ }
+
+ res = new TestResult();
+ res.addListener(this);
+ for (int i=0; i < formatters.size(); i++) {
+ res.addListener((TestListener)formatters.elementAt(i));
+ }
+
+ } catch(Exception e) {
+ retCode = 2;
+
+ fireStartTestSuite();
+ for (int i=0; i < formatters.size(); i++) {
+ ((TestListener)formatters.elementAt(i)).addError(null, e);
+ }
+ junitTest.setCounts(1, 0, 1);
+ junitTest.setRunTime(0);
+ fireEndTestSuite();
+ }
+ }
+
+ public void run() {
+ long start = System.currentTimeMillis();
+
+ if (retCode != 0) { // had an exception in the constructor
+ return;
+ }
+
+ fireStartTestSuite();
+ suite.run(res);
+ junitTest.setRunTime(System.currentTimeMillis()-start);
+ junitTest.setCounts(res.runCount(), res.failureCount(),
+ res.errorCount());
+ fireEndTestSuite();
+
+ if (res.errorCount() != 0) {
+ retCode = 2;
+ } else if (res.failureCount() != 0) {
+ retCode = 1;
+ }
+ }
+
+ /**
+ * Returns what System.exit() would return in the standalone version.
+ *
+ * @return 2 if errors occurred, 1 if tests failed else 0.
+ */
+ public int getRetCode() {
+ return retCode;
+ }
+
+ /**
+ * Interface TestListener.
+ *
+ * A new Test is started.
+ */
+ public void startTest(Test t) {
+ failed = false;
+ }
+
+ /**
+ * Interface TestListener.
+ *
+ * A Test is finished.
+ */
+ public void endTest(Test test) {
+ }
+
+ /**
+ * Interface TestListener.
+ *
+ * A Test failed.
+ */
+ public void addFailure(Test test, Throwable t) {
+ failed = true;
+
+ if (junitTest.getHaltonfailure()) {
+ res.stop();
+ }
+ }
+
+ /**
+ * Interface TestListener.
+ *
+ * An error occured while running the test.
+ */
+ public void addError(Test test, Throwable t) {
+ failed = true;
+
+ if (junitTest.getHaltonerror()) {
+ res.stop();
+ }
+ }
+
+ private void fireStartTestSuite() {
+ for (int i=0; i A new Test is started.
+ */
+ public void startTest(Test t) {
+ }
+
+ /**
+ * Interface TestListener.
+ *
+ * A Test is finished.
+ */
+ public void endTest(Test test) {
+ }
+
+ /**
+ * Interface TestListener.
+ *
+ * A Test failed.
+ */
+ public void addFailure(Test test, Throwable t) {
+ }
+
+ /**
+ * Interface TestListener.
+ *
+ * An error occured while running the test.
+ */
+ public void addError(Test test, Throwable t) {
+ }
+
+ /**
+ * The whole testsuite ended.
+ */
+ public void endTestSuite(JUnitTest suite) {
+ System.out.print("Tests run: ");
+ System.out.print(suite.runCount());
+ System.out.print(", Failures: ");
+ System.out.print(suite.failureCount());
+ System.out.print(", Errors: ");
+ System.out.print(suite.errorCount());
+ System.out.print(", Time ellapsed: ");
+ System.out.print(nf.format(suite.getRunTime()/1000.0));
+ System.out.println(" sec");
+ }
+}
diff --git a/src/main/org/apache/tools/ant/taskdefs/optional/junit/XMLJUnitResultFormatter.java b/src/main/org/apache/tools/ant/taskdefs/optional/junit/XMLJUnitResultFormatter.java
new file mode 100644
index 000000000..8d2f0ce62
--- /dev/null
+++ b/src/main/org/apache/tools/ant/taskdefs/optional/junit/XMLJUnitResultFormatter.java
@@ -0,0 +1,235 @@
+/*
+ * The Apache Software License, Version 1.1
+ *
+ * Copyright (c) 2000 The Apache Software Foundation. All rights
+ * reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ * 1. Redistributions of source code must retain the above copyright
+ * notice, this list of conditions and the following disclaimer.
+ *
+ * 2. Redistributions in binary form must reproduce the above copyright
+ * notice, this list of conditions and the following disclaimer in
+ * the documentation and/or other materials provided with the
+ * distribution.
+ *
+ * 3. The end-user documentation included with the redistribution, if
+ * any, must include the following acknowlegement:
+ * "This product includes software developed by the
+ * Apache Software Foundation (http://www.apache.org/)."
+ * Alternately, this acknowlegement may appear in the software itself,
+ * if and wherever such third-party acknowlegements normally appear.
+ *
+ * 4. The names "The Jakarta Project", "Tomcat", and "Apache Software
+ * Foundation" must not be used to endorse or promote products derived
+ * from this software without prior written permission. For written
+ * permission, please contact apache@apache.org.
+ *
+ * 5. Products derived from this software may not be called "Apache"
+ * nor may "Apache" appear in their names without prior written
+ * permission of the Apache Group.
+ *
+ * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
+ * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
+ * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+ * DISCLAIMED. IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR
+ * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+ * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+ * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
+ * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+ * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+ * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
+ * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+ * SUCH DAMAGE.
+ * ====================================================================
+ *
+ * This software consists of voluntary contributions made by many
+ * individuals on behalf of the Apache Software Foundation. For more
+ * information on the Apache Software Foundation, please see
+ * A new Test is started.
+ */
+ public void startTest(Test t) {
+ lastTestStart = System.currentTimeMillis();
+ }
+
+ /**
+ * Interface TestListener.
+ *
+ * A Test is finished.
+ */
+ public void endTest(Test test) {
+ formatTestCaseOpenTag(test);
+ results.append(" ");
+ results.append(newLine);
+ }
+
+ /**
+ * Interface TestListener.
+ *
+ * A Test failed.
+ */
+ public void addFailure(Test test, Throwable t) {
+ formatError("failure", test, t);
+ }
+
+ /**
+ * Interface TestListener.
+ *
+ * An error occured while running the test.
+ */
+ public void addError(Test test, Throwable t) {
+ formatError("error", test, t);
+ }
+
+ /**
+ * Translates <, & and > to corresponding entities.
+ */
+ private String xmlEscape(String orig) {
+ if (orig == null) return "";
+ StringBuffer temp = new StringBuffer();
+ StringCharacterIterator sci = new StringCharacterIterator(orig);
+ for (char c = sci.first(); c != CharacterIterator.DONE;
+ c = sci.next()) {
+
+ switch (c) {
+ case '<':
+ temp.append("<");
+ break;
+ case '>':
+ temp.append(">");
+ break;
+ case '&':
+ temp.append("&");
+ break;
+ default:
+ temp.append(c);
+ break;
+ }
+ }
+ return temp.toString();
+ }
+
+ private void formatTestCaseOpenTag(Test test) {
+ results.append(" fork has been disabled.
+ *
+ * @author Thomas Haas
+ */
+public class JUnitTask extends Task {
+
+ // key description default value exit exit with System.exit after testcase is
+ * complete? true haltOnError halt test on
+ * errors? false haltOnFailure halt test on
+ * failures? false printSummary print summary to System.out?
+ * true printXML generate XML report?
+ * false outfile where to print the XML report - a
+ * filename System.out