01: /*BEGIN_COPYRIGHT_BLOCK
02: *
03: * Copyright (c) 2001-2007, JavaPLT group at Rice University (javaplt@rice.edu)
04: * All rights reserved.
05: *
06: * Redistribution and use in source and binary forms, with or without
07: * modification, are permitted provided that the following conditions are met:
08: * * Redistributions of source code must retain the above copyright
09: * notice, this list of conditions and the following disclaimer.
10: * * Redistributions in binary form must reproduce the above copyright
11: * notice, this list of conditions and the following disclaimer in the
12: * documentation and/or other materials provided with the distribution.
13: * * Neither the names of DrJava, the JavaPLT group, Rice University, nor the
14: * names of its contributors may be used to endorse or promote products
15: * derived from this software without specific prior written permission.
16: *
17: * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
18: * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
19: * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
20: * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
21: * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
22: * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
23: * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
24: * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
25: * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
26: * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
27: * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
28: *
29: * This software is Open Source Initiative approved Open Source Software.
30: * Open Source Initative Approved is a trademark of the Open Source Initiative.
31: *
32: * This file is part of DrJava. Download the current version of this project
33: * from http://www.drjava.org/ or http://sourceforge.net/projects/drjava/
34: *
35: * END_COPYRIGHT_BLOCK*/
36:
37: package edu.rice.cs.drjava.model.junit;
38:
39: import java.util.List;
40:
41: import edu.rice.cs.drjava.model.OpenDefinitionsDocument;
42: import edu.rice.cs.drjava.model.compiler.CompilerListener;
43:
44: import edu.rice.cs.util.classloader.ClassFileError;
45:
46: /**
47: * An interface for responding to events generated by the JUnitModel.
48: *
49: * @version $Id: JUnitListener.java 4255 2007-08-28 19:17:37Z mgricken $
50: */
51: public interface JUnitListener {
52:
53: /** Called when trying to test a non-TestCase class.
54: * @param isTestAll whether or not it was a use of the test all button
55: */
56: public void nonTestCase(boolean isTestAll);
57:
58: /** Called when JUnit encounters an illegal class file.
59: * @param e the error or exception thrown by loading and resolving f.
60: */
61: public void classFileError(ClassFileError e);
62:
63: /** Called after JUnit is started by the GlobalModel. */
64: public void junitStarted();
65:
66: /** Called when testing a specific list of classes given their source files. */
67: public void junitClassesStarted();
68:
69: /** Called to indicate that a suite of tests has started running.
70: * @param numTests The number of tests in the suite to be run.
71: */
72: public void junitSuiteStarted(int numTests);
73:
74: /** Called when a particular test is started.
75: * @param name The name of the test being started.
76: */
77: public void junitTestStarted(String name);
78:
79: /** Called when a particular test has ended.
80: * @param name The name of the test that has ended.
81: * @param wasSuccessful Whether the test passed or not.
82: * @param causedError If not successful, whether the test caused an error or simply failed.
83: */
84: public void junitTestEnded(String name, boolean wasSuccessful,
85: boolean causedError);
86:
87: /** Called after JUnit is finished running tests. */
88: public void junitEnded();
89:
90: /** Called to demand that all source files be in sync before running JUnit tests.
91: * It is up to the caller of this method to check if the documents are in sync
92: * using OpenDefinitionsDocument.checkIfClassFileInSync().
93: */
94: public void compileBeforeJUnit(final CompilerListener l);
95: }
|