001: /*
002:
003: ============================================================================
004: The Apache Software License, Version 1.1
005: ============================================================================
006:
007: Copyright (C) 1999-2003 The Apache Software Foundation. All rights reserved.
008:
009: Redistribution and use in source and binary forms, with or without modifica-
010: tion, are permitted provided that the following conditions are met:
011:
012: 1. Redistributions of source code must retain the above copyright notice,
013: this list of conditions and the following disclaimer.
014:
015: 2. Redistributions in binary form must reproduce the above copyright notice,
016: this list of conditions and the following disclaimer in the documentation
017: and/or other materials provided with the distribution.
018:
019: 3. The end-user documentation included with the redistribution, if any, must
020: include the following acknowledgment: "This product includes software
021: developed by the Apache Software Foundation (http://www.apache.org/)."
022: Alternately, this acknowledgment may appear in the software itself, if
023: and wherever such third-party acknowledgments normally appear.
024:
025: 4. The names "Batik" and "Apache Software Foundation" must not be
026: used to endorse or promote products derived from this software without
027: prior written permission. For written permission, please contact
028: apache@apache.org.
029:
030: 5. Products derived from this software may not be called "Apache", nor may
031: "Apache" appear in their name, without prior written permission of the
032: Apache Software Foundation.
033:
034: THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES,
035: INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
036: FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
037: APACHE SOFTWARE FOUNDATION OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT,
038: INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLU-
039: DING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS
040: OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
041: ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
042: (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
043: THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
044:
045: This software consists of voluntary contributions made by many individuals
046: on behalf of the Apache Software Foundation. For more information on the
047: Apache Software Foundation, please see <http://www.apache.org/>.
048:
049: */
050:
051: package org.apache.batik.css.parser;
052:
053: /**
054: * This class encapsulates a general parse error or warning.
055: *
056: * <p>This class can contain basic error or warning information from
057: * either the parser or the application.
058: *
059: * <p>If the application needs to pass through other types of
060: * exceptions, it must wrap those exceptions in a ParseException.
061: *
062: * @author <a href="mailto:stephane@hillion.org">Stephane Hillion</a>
063: * @version $Id$
064: */
065: public class ParseException extends RuntimeException {
066:
067: /**
068: * @serial The embedded exception if tunnelling, or null.
069: */
070: protected Exception exception;
071:
072: /**
073: * @serial The line number.
074: */
075: protected int lineNumber;
076:
077: /**
078: * @serial The column number.
079: */
080: protected int columnNumber;
081:
082: /**
083: * Creates a new ParseException.
084: * @param message The error or warning message.
085: * @param line The line of the last parsed character.
086: * @param column The column of the last parsed character.
087: */
088: public ParseException(String message, int line, int column) {
089: super (message);
090: exception = null;
091: lineNumber = line;
092: columnNumber = column;
093: }
094:
095: /**
096: * Creates a new ParseException wrapping an existing exception.
097: *
098: * <p>The existing exception will be embedded in the new
099: * one, and its message will become the default message for
100: * the ParseException.
101: * @param e The exception to be wrapped in a ParseException.
102: */
103: public ParseException(Exception e) {
104: exception = e;
105: lineNumber = -1;
106: columnNumber = -1;
107: }
108:
109: /**
110: * Creates a new ParseException from an existing exception.
111: *
112: * <p>The existing exception will be embedded in the new
113: * one, but the new exception will have its own message.
114: * @param message The detail message.
115: * @param e The exception to be wrapped in a SAXException.
116: */
117: public ParseException(String message, Exception e) {
118: super (message);
119: this .exception = e;
120: }
121:
122: /**
123: * Return a detail message for this exception.
124: *
125: * <p>If there is a embedded exception, and if the ParseException
126: * has no detail message of its own, this method will return
127: * the detail message from the embedded exception.
128: * @return The error or warning message.
129: */
130: public String getMessage() {
131: String message = super .getMessage();
132:
133: if (message == null && exception != null) {
134: return exception.getMessage();
135: } else {
136: return message;
137: }
138: }
139:
140: /**
141: * Return the embedded exception, if any.
142: * @return The embedded exception, or null if there is none.
143: */
144: public Exception getException() {
145: return exception;
146: }
147:
148: /**
149: * Returns the line of the last parsed character.
150: */
151: public int getLineNumber() {
152: return lineNumber;
153: }
154:
155: /**
156: * Returns the column of the last parsed character.
157: */
158: public int getColumnNumber() {
159: return columnNumber;
160: }
161: }
|