1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
|
/*
Derby - Class org.apache.derbyTesting.unitTests.harness.T_Fail
Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements. See the NOTICE file distributed with
this work for additional information regarding copyright ownership.
The ASF licenses this file to You under the Apache License, Version 2.0
(the "License"); you may not use this file except in compliance with
the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
*/
package org.apache.derbyTesting.unitTests.harness;
/**
Exception used to throw for errors in a unit test.
*/
public class T_Fail extends Exception {
private Throwable nested;
/**
Create a T_Fail exception which carries a message.
@param message An Id for an error message for this exception.
*/
private T_Fail(String message) {
super(message);
}
/**
return a T_Fail exception to indicate the configuration does
not specify the module to test.
@return The exception.
*/
public static T_Fail moduleToTestIdNotFound()
{
return new T_Fail("Test failed because the configuration does not include the MODULE_TO_TEST_IDENT attribute.");
}
/**
return a T_Fail exception to indicate the configuration does
not contain the module to test.
@return The exception.
*/
public static T_Fail moduleToTestNotFound(String moduleToTest)
{
return new T_Fail("Test failed due to failure loading " + moduleToTest);
}
/**
return a T_Fail exception to indicate the test failed due
to an exception.
<P>Note: Since the Test Service catches all exceptions this
seems to be of limited value.
@return The exception.
*/
public static T_Fail exceptionFail(Throwable e)
{
T_Fail tf = new T_Fail("The test failed with an exception: " + e.toString());
tf.nested = e;
return tf;
}
/**
return a T_Fail exception to indicate the test failed.
@return the exception.
*/
public static T_Fail testFail()
{
return new T_Fail("The test failed");
}
/**
return a T_Fail exception which includes a user message indicating
why a test failed.
@return The exception.
*/
public static T_Fail testFailMsg(String message)
{
return new T_Fail("Test failed - " + message);
}
/**
Check a test condition. If it is false, throw a T_Fail exception.
@param mustBeTrue The condition.
@exception T_Fail A test failure exception
*/
public static final void T_ASSERT(boolean mustBeTrue)
throws T_Fail
{
if (!mustBeTrue)
throw testFail();
}
/**
Check a test condition. If it is false, throw a T_Fail exception which
includes a message.
@param mustBeTrue The condition.
@param msg A message describing the failue.
@exception T_Fail A test failure exception
*/
public static final void T_ASSERT(boolean mustBeTrue,String msg)
throws T_Fail
{
if (!mustBeTrue)
throw testFailMsg(msg);
}
}
|
