1 /********************************************************************************
2 * DDTUnit, a Datadriven Approach to Unit- and Moduletesting
3 * Copyright (c) 2004, Joerg and Kai Gellien
4 * All rights reserved.
5 *
6 * The Software is provided under the terms of the Common Public License 1.0
7 * as provided with the distribution of DDTUnit in the file cpl-v10.html.
8 * Redistribution and use in source and binary forms, with or without
9 * modification, are permitted provided that the following conditions
10 * are met:
11 *
12 * + Redistributions of source code must retain the above copyright
13 * notice, this list of conditions and the following disclaimer.
14 *
15 * + Redistributions in binary form must reproduce the above
16 * copyright notice, this list of conditions and the following
17 * disclaimer in the documentation and/or other materials provided
18 * with the distribution.
19 *
20 * + Neither the name of the authors or DDTUnit, nor the
21 * names of its contributors may be used to endorse or promote
22 * products derived from this software without specific prior
23 * written permission.
24 *
25 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
26 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
27 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
28 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR
29 * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
30 * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
31 * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
32 * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
33 * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
34 * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
35 * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
36 ********************************************************************************/
37 package junitx.ddtunit;
38
39 import junit.framework.AssertionFailedError;
40 import junit.framework.Test;
41 import junit.framework.TestListener;
42
43 /**
44 * DDTTestListener provides methods to notify test progress and results
45 * to others.
46 *
47 * @author jg
48 */
49 public interface DDTTestListener extends TestListener
50 {
51 /**
52 * An error occurred during execution of a method with test data
53 * @param test processed
54 * @param testName actually processed
55 * @param throwable caught during execution
56 */
57 public void addMethodTestError(Test test, String testName,
58 Throwable throwable);
59
60 /**
61 * A failure occurred during execution of a method with test data
62 * @param test processed
63 * @param testName actually processed
64 * @param assertFailed caught during execution
65 */
66 public void addMethodTestFailure(Test test, String testName,
67 AssertionFailedError assertFailed);
68
69 /**
70 * A test inside of a testmethod with a given dataset is started.
71 * @param test processed
72 * @param testName actually processed
73 */
74 public void endMethodTest(IDDTTestCase test, String testName);
75
76 /**
77 * A test inside of a testmethod with a given dataset is started.
78 * @param test processed
79 * @param testName actually processed
80 */
81 public void startMethodTest(IDDTTestCase test, String testName);
82 }