unused/xml/sax/SAXException.java

   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     public SAXException ()
  44     {
  45         super();
  46         this.exception = null;
  47     }
  48
  49
  50     /**
  51      * Create a new SAXException.
  52      *
  53      * @param message The error or warning message.
  54      */
  55     public SAXException (String message) {
  56         super(message);
  57         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     public SAXException (Exception e)
  71     {
  72         super();
  73         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     public SAXException (String message, Exception e)
  87     {
  88         super(message);
  89         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     @Override
 103                 public String getMessage ()
 104     {
 105         String message = super.getMessage();
 106
 107         if (message == null && exception != null) {
 108             return exception.getMessage();
 109         } else {
 110             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     public Exception getException ()
 121     {
 122         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     @Override
 132                 public String toString ()
 133     {
 134         if (exception != null) {
 135             return exception.toString();
 136         } else {
 137             return super.toString();
 138         }
 139     }
 140
 141
 142     \f
 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