01: /*
02: ******************************************************************
03: Copyright (c) 2001-2007, Jeff Martin, Tim Bacon
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
08: are met:
09:
10: * Redistributions of source code must retain the above copyright
11: notice, this list of conditions and the following disclaimer.
12: * Redistributions in binary form must reproduce the above
13: copyright notice, this list of conditions and the following
14: disclaimer in the documentation and/or other materials provided
15: with the distribution.
16: * Neither the name of the xmlunit.sourceforge.net nor the names
17: of its contributors may be used to endorse or promote products
18: derived from this software without specific prior written
19: permission.
20:
21: THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
22: "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
23: LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
24: FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
25: COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
26: INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
27: BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
28: LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
29: CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
30: LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
31: ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
32: POSSIBILITY OF SUCH DAMAGE.
33:
34: ******************************************************************
35: */
36:
37: package org.custommonkey.xmlunit;
38:
39: import org.w3c.dom.Node;
40:
41: /**
42: * Thrown by a NodeTest that fails.
43: * <br />Examples and more at <a href="http://xmlunit.sourceforge.net"/>xmlunit.sourceforge.net</a>
44: * @see NodeTest
45: */
46: public class NodeTestException extends Exception {
47: private transient final Node node;
48:
49: /**
50: * Constructor for specific node and message
51: * @param message
52: * @param node
53: */
54: public NodeTestException(String message, Node node) {
55: super (message);
56: this .node = node;
57: }
58:
59: /**
60: * Constructor for message only
61: * @param message
62: */
63: public NodeTestException(String message) {
64: this (message, null);
65: }
66:
67: /**
68: * @return true if a node was passed to constructor
69: */
70: public boolean hasNode() {
71: return node != null;
72: }
73:
74: /**
75: * @return the node passed to constructor, or null if no node was passed
76: */
77: public Node getNode() {
78: return node;
79: }
80:
81: /**
82: * @return the exception message and node information if available
83: */
84: public String getMessage() {
85: StringBuffer stringBuffer = new StringBuffer(super .getMessage());
86: if (hasNode()) {
87: stringBuffer.append(' ').append(getNode().toString());
88: }
89: return stringBuffer.toString();
90: }
91: }
|