Clover icon

jalviewX

  1. Project Clover database Wed Oct 31 2018 15:13:58 GMT
  2. Package org.xml.sax

File SAXException.java

 

Coverage histogram

../../../img/srcFileCovDistChart0.png
56% of files have more coverage

Code metrics

4
16
7
1
155
46
10
0.62
2.29
7
1.43

Classes

Class Line # Actions
SAXException 37 16 10 27
0.00%
 

Contributing tests

No tests hitting this source file were found.

Source view

1    // SAX exception class.
2    // http://www.saxproject.org
3    // No warranty; no copyright -- use this as you will.
4    // $Id: SAXException.java,v 1.7 2002/01/30 21:13:48 dbrownell Exp $
5   
6    package org.xml.sax;
7   
8    /**
9    * Encapsulate a general SAX error or warning.
10    *
11    * <blockquote>
12    * <em>This module, both source code and documentation, is in the
13    * Public Domain, and comes with <strong>NO WARRANTY</strong>.</em>
14    * See <a href='http://www.saxproject.org'>http://www.saxproject.org</a>
15    * for further information.
16    * </blockquote>
17    *
18    * <p>This class can contain basic error or warning information from
19    * either the XML parser or the application: a parser writer or
20    * application writer can subclass it to provide additional
21    * functionality. SAX handlers may throw this exception or
22    * any exception subclassed from it.</p>
23    *
24    * <p>If the application needs to pass through other types of
25    * exceptions, it must wrap those exceptions in a SAXException
26    * or an exception derived from a SAXException.</p>
27    *
28    * <p>If the parser or application needs to include information about a
29    * specific location in an XML document, it should use the
30    * {@link org.xml.sax.SAXParseException SAXParseException} subclass.</p>
31    *
32    * @since SAX 1.0
33    * @author David Megginson
34    * @version 2.0.1 (sax2r2)
35    * @see org.xml.sax.SAXParseException
36    */
 
37    public class SAXException extends Exception {
38   
39   
40    /**
41    * Create a new SAXException.
42    */
 
43  0 toggle public SAXException ()
44    {
45  0 super();
46  0 this.exception = null;
47    }
48   
49   
50    /**
51    * Create a new SAXException.
52    *
53    * @param message The error or warning message.
54    */
 
55  0 toggle public SAXException (String message) {
56  0 super(message);
57  0 this.exception = null;
58    }
59   
60   
61    /**
62    * Create a new SAXException wrapping an existing exception.
63    *
64    * <p>The existing exception will be embedded in the new
65    * one, and its message will become the default message for
66    * the SAXException.</p>
67    *
68    * @param e The exception to be wrapped in a SAXException.
69    */
 
70  0 toggle public SAXException (Exception e)
71    {
72  0 super();
73  0 this.exception = e;
74    }
75   
76   
77    /**
78    * Create a new SAXException from an existing exception.
79    *
80    * <p>The existing exception will be embedded in the new
81    * one, but the new exception will have its own message.</p>
82    *
83    * @param message The detail message.
84    * @param e The exception to be wrapped in a SAXException.
85    */
 
86  0 toggle public SAXException (String message, Exception e)
87    {
88  0 super(message);
89  0 this.exception = e;
90    }
91   
92   
93    /**
94    * Return a detail message for this exception.
95    *
96    * <p>If there is an embedded exception, and if the SAXException
97    * has no detail message of its own, this method will return
98    * the detail message from the embedded exception.</p>
99    *
100    * @return The error or warning message.
101    */
 
102  0 toggle @Override
103    public String getMessage ()
104    {
105  0 String message = super.getMessage();
106   
107  0 if (message == null && exception != null) {
108  0 return exception.getMessage();
109    } else {
110  0 return message;
111    }
112    }
113   
114   
115    /**
116    * Return the embedded exception, if any.
117    *
118    * @return The embedded exception, or null if there is none.
119    */
 
120  0 toggle public Exception getException ()
121    {
122  0 return exception;
123    }
124   
125   
126    /**
127    * Override toString to pick up any embedded exception.
128    *
129    * @return A string representation of this exception.
130    */
 
131  0 toggle @Override
132    public String toString ()
133    {
134  0 if (exception != null) {
135  0 return exception.toString();
136    } else {
137  0 return super.toString();
138    }
139    }
140   
141   
142   
143    //////////////////////////////////////////////////////////////////////
144    // Internal state.
145    //////////////////////////////////////////////////////////////////////
146   
147   
148    /**
149    * @serial The embedded exception if tunnelling, or null.
150    */
151    private Exception exception;
152   
153    }
154   
155    // end of SAXException.java