123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175 |
- /*--
-
- $Id: JDOMParseException.java,v 1.8 2007/11/10 05:29:00 jhunter Exp $
-
- Copyright (C) 2000-2007 Jason Hunter & Brett McLaughlin.
- All rights reserved.
-
- Redistribution and use in source and binary forms, with or without
- modification, are permitted provided that the following conditions
- are met:
-
- 1. Redistributions of source code must retain the above copyright
- notice, this list of conditions, and the following disclaimer.
-
- 2. Redistributions in binary form must reproduce the above copyright
- notice, this list of conditions, and the disclaimer that follows
- these conditions in the documentation and/or other materials
- provided with the distribution.
-
- 3. The name "JDOM" must not be used to endorse or promote products
- derived from this software without prior written permission. For
- written permission, please contact <request_AT_jdom_DOT_org>.
-
- 4. Products derived from this software may not be called "JDOM", nor
- may "JDOM" appear in their name, without prior written permission
- from the JDOM Project Management <request_AT_jdom_DOT_org>.
-
- In addition, we request (but do not require) that you include in the
- end-user documentation provided with the redistribution and/or in the
- software itself an acknowledgement equivalent to the following:
- "This product includes software developed by the
- JDOM Project (http://www.jdom.org/)."
- Alternatively, the acknowledgment may be graphical using the logos
- available at http://www.jdom.org/images/logos.
-
- THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
- WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
- OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
- DISCLAIMED. IN NO EVENT SHALL THE JDOM AUTHORS OR THE PROJECT
- CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
- SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
- LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
- USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
- ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
- OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
- OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
- SUCH DAMAGE.
-
- This software consists of voluntary contributions made by many
- individuals on behalf of the JDOM Project and was originally
- created by Jason Hunter <jhunter_AT_jdom_DOT_org> and
- Brett McLaughlin <brett_AT_jdom_DOT_org>. For more information
- on the JDOM Project, please see <http://www.jdom.org/>.
-
- */
-
- package org.jdom.input;
-
- import org.jdom.*;
- import org.xml.sax.*;
-
- /**
- * Thrown during parse errors, with information about where the parse error
- * occurred as well as access to the partially built document.
- *
- * @version $Revision: 1.8 $, $Date: 2007/11/10 05:29:00 $
- * @author Laurent Bihanic
- */
- public class JDOMParseException extends JDOMException {
-
- private static final String CVS_ID =
- "@(#) $RCSfile: JDOMParseException.java,v $ $Revision: 1.8 $ $Date: 2007/11/10 05:29:00 $ $Name: jdom_1_1 $";
-
- /**
- * The portion of the document that was successfully built before
- * the parse error occurred.
- */
- private final Document partialDocument;
-
- /**
- * This will create a parse <code>Exception</code> with the given
- * message and wrap the <code>Exception</code> that cause a document
- * parse to fail.
- *
- * @param message <code>String</code> message indicating
- * the problem that occurred.
- * @param cause <code>Throwable</code> that caused this
- * to be thrown.
- */
- public JDOMParseException(String message, Throwable cause) {
- this(message, cause, null);
- }
-
- /**
- * This will create a parse <code>Exception</code> with the given
- * message and the partial document and wrap the
- * <code>Exception</code> that cause a document parse to fail.
- *
- * @param message <code>String</code> message indicating
- * the problem that occurred.
- * @param cause <code>Throwable</code> that caused this
- * to be thrown.
- * @param partialDocument <code>Document</code> the portion of
- * the input XML document that was
- * successfully built.
- */
- public JDOMParseException(String message, Throwable cause,
- Document partialDocument) {
- super(message, cause);
- this.partialDocument = partialDocument;
- }
-
- /**
- * Returns the partial document that was successfully built before
- * the error occurred.
- *
- * @return the partial document or null if none.
- */
- public Document getPartialDocument() {
- return partialDocument;
- }
-
- /**
- * Returns the public identifier of the entity where the
- * parse error occurred.
- *
- * @return a string containing the public identifier, or
- * <code>null</code> if the information is not available.
- */
- public String getPublicId() {
- return (getCause() instanceof SAXParseException)?
- ((SAXParseException)getCause()).getPublicId(): null;
- }
-
- /**
- * Returns the system identifier of the entity where the
- * parse error occurred.
- *
- * @return a string containing the system identifier, or
- * <code>null</code> if the information is not available.
- */
- public String getSystemId() {
- return (getCause() instanceof SAXParseException)?
- ((SAXParseException)getCause()).getSystemId(): null;
- }
-
- /**
- * Returns the line number of the end of the text where the
- * parse error occurred.
- * <p>
- * The first line in the document is line 1.</p>
- *
- * @return an integer representing the line number, or -1
- * if the information is not available.
- */
- public int getLineNumber() {
- return (getCause() instanceof SAXParseException)?
- ((SAXParseException)getCause()).getLineNumber(): -1;
- }
-
- /**
- * Returns the column number of the end of the text where the
- * parse error occurred.
- * <p>
- * The first column in a line is position 1.</p>
- *
- * @return an integer representing the column number, or -1
- * if the information is not available.
- */
- public int getColumnNumber() {
- return (getCause() instanceof SAXParseException)?
- ((SAXParseException)getCause()).getColumnNumber(): -1;
- }
- }
|