001: /*BEGIN_COPYRIGHT_BLOCK
002: *
003: * Copyright (c) 2001-2007, JavaPLT group at Rice University (javaplt@rice.edu)
004: * All rights reserved.
005: *
006: * Redistribution and use in source and binary forms, with or without
007: * modification, are permitted provided that the following conditions are met:
008: * * Redistributions of source code must retain the above copyright
009: * notice, this list of conditions and the following disclaimer.
010: * * Redistributions in binary form must reproduce the above copyright
011: * notice, this list of conditions and the following disclaimer in the
012: * documentation and/or other materials provided with the distribution.
013: * * Neither the names of DrJava, the JavaPLT group, Rice University, nor the
014: * names of its contributors may be used to endorse or promote products
015: * derived from this software without specific prior written permission.
016: *
017: * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
018: * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
019: * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
020: * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
021: * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
022: * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
023: * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
024: * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
025: * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
026: * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
027: * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
028: *
029: * This software is Open Source Initiative approved Open Source Software.
030: * Open Source Initative Approved is a trademark of the Open Source Initiative.
031: *
032: * This file is part of DrJava. Download the current version of this project
033: * from http://www.drjava.org/ or http://sourceforge.net/projects/drjava/
034: *
035: * END_COPYRIGHT_BLOCK*/
036:
037: package edu.rice.cs.drjava.model.junit;
038:
039: import java.util.List;
040: import edu.rice.cs.drjava.model.EventNotifier;
041: import edu.rice.cs.drjava.model.OpenDefinitionsDocument;
042: import edu.rice.cs.drjava.model.compiler.CompilerListener;
043: import edu.rice.cs.util.classloader.ClassFileError;
044: import edu.rice.cs.util.swing.Utilities;
045:
046: /**
047: * Keeps track of all listeners to a JUnitModel, and has the ability
048: * to notify them of some event.
049: * <p>
050: *
051: * This class has a specific role of managing JUnitListeners. Other
052: * classes with similar names use similar code to perform the same function for
053: * other interfaces, e.g. InteractionsEventNotifier and GlobalEventNotifier.
054: * These classes implement the appropriate interface definition so that they
055: * can be used transparently as composite packaging for a particular listener
056: * interface.
057: * <p>
058: *
059: * Components which might otherwise manage their own list of listeners use
060: * EventNotifiers instead to simplify their internal implementation. Notifiers
061: * should therefore be considered a private implementation detail of the
062: * components, and should not be used directly outside of the "host" component.
063: * <p>
064: *
065: * All methods in this class must use the synchronization methods
066: * provided by ReaderWriterLock. This ensures that multiple notifications
067: * (reads) can occur simultaneously, but only one thread can be adding
068: * or removing listeners (writing) at a time, and no reads can occur
069: * during a write.
070: * <p>
071: *
072: * <i>No</i> methods on this class should be synchronized using traditional
073: * Java synchronization!
074: * <p>
075: *
076: * @version $Id: JUnitEventNotifier.java 4255 2007-08-28 19:17:37Z mgricken $
077: */
078: class JUnitEventNotifier extends EventNotifier<JUnitListener> implements
079: JUnitListener {
080:
081: public void addListener(JUnitListener jul) {
082: super .addListener(jul);
083: // Utilities.show("Adding listener " + jul + " to listener list in " + this);
084: }
085:
086: /** Called when trying to test a non-TestCase class.
087: * @param isTestAll whether or not it was a use of the test all button
088: */
089: public void nonTestCase(boolean isTestAll) {
090: _lock.startRead();
091: try {
092: for (JUnitListener jul : _listeners) {
093: jul.nonTestCase(isTestAll);
094: }
095: } finally {
096: _lock.endRead();
097: }
098: }
099:
100: public void classFileError(ClassFileError e) {
101: _lock.startRead();
102: try {
103: for (JUnitListener jul : _listeners) {
104: jul.classFileError(e);
105: }
106: } finally {
107: _lock.endRead();
108: }
109: }
110:
111: /** Called before JUnit is started by the DefaultJUnitModel. */
112: public void compileBeforeJUnit(final CompilerListener cl) {
113: _lock.startRead();
114: try {
115: for (JUnitListener jul : _listeners) {
116: jul.compileBeforeJUnit(cl);
117: }
118: } finally {
119: _lock.endRead();
120: }
121: }
122:
123: /** Called after junit/junitAll is started by the GlobalModel. */
124: public void junitStarted() {
125: _lock.startRead();
126: try {
127: for (JUnitListener jul : _listeners) {
128: jul.junitStarted();
129: }
130: } finally {
131: _lock.endRead();
132: }
133: }
134:
135: /** Called after junitClasses is started by the GlobalModel. */
136: public void junitClassesStarted() {
137: _lock.startRead();
138: try {
139: for (JUnitListener jul : _listeners) {
140: jul.junitClassesStarted();
141: }
142: } finally {
143: _lock.endRead();
144: }
145: }
146:
147: /** Called to indicate that a suite of tests has started running.
148: * @param numTests The number of tests in the suite to be run.
149: */
150: public void junitSuiteStarted(int numTests) {
151: _lock.startRead();
152: try {
153: for (JUnitListener jul : _listeners) {
154: jul.junitSuiteStarted(numTests);
155: }
156: } finally {
157: _lock.endRead();
158: }
159: }
160:
161: /** Called when a particular test is started.
162: * @param name The name of the test being started.
163: */
164: public void junitTestStarted(String name) {
165: _lock.startRead();
166: try {
167: for (JUnitListener jul : _listeners) {
168: jul.junitTestStarted(name);
169: }
170: } finally {
171: _lock.endRead();
172: }
173: }
174:
175: /** Called when a particular test has ended.
176: * @param name The name of the test that has ended.
177: * @param wasSuccessful Whether the test passed or not.
178: * @param causedError If not successful, whether the test caused an error or simply failed.
179: */
180: public void junitTestEnded(String name, boolean wasSuccessful,
181: boolean causedError) {
182: _lock.startRead();
183: try {
184: for (JUnitListener jul : _listeners) {
185: jul.junitTestEnded(name, wasSuccessful, causedError);
186: }
187: } finally {
188: _lock.endRead();
189: }
190: }
191:
192: /** Called after JUnit is finished running tests. */
193: public void junitEnded() {
194: // new ScrollableDialog(null, "Ready to grab acquireReadLock for junitListener queue in junitEnded" + _listeners, "", "").show();
195: _lock.startRead();
196: // new ScrollableDialog(null, "Grabbed acquireReadLock for junitListener queue in junitEnded" + _listeners, "", "").show();
197: try {
198: for (JUnitListener jul : _listeners) {
199: jul.junitEnded();
200: }
201: } finally {
202: _lock.endRead();
203: }
204: }
205: }
|