All Packages Class Hierarchy This Package Previous Next Index
Class org.xml.sax.SAXParseException
java.lang.Object
|
+----java.lang.Throwable
|
+----java.lang.Exception
|
+----org.xml.sax.SAXException
|
+----org.xml.sax.SAXParseException
- public class SAXParseException
- extends SAXException
Encapsulate an XML parse error or warning.
This exception will include information for locating the error
in the original XML document. Note that although the application
will receive a SAXParseException as the argument to the handlers
in the ErrorHandler interface, the application is not actually
required to throw the exception; instead, it can simply read the
information in it and take a different action.
Since this exception is a subclass of SAXException, it
inherits the ability to wrap another exception.
- See Also:
- SAXException, Locator, ErrorHandler
-
SAXParseException(String, Locator)
- Create a new SAXParseException from a message and a Locator.
-
SAXParseException(String, Locator, Exception)
- Wrap an existing exception in a SAXParseException.
-
SAXParseException(String, String, String, int, int)
- Create a new SAXParseException.
-
SAXParseException(String, String, String, int, int, Exception)
- Create a new SAXParseException with an embedded exception.
-
getColumnNumber()
- The column number of the end of the text where the exception occurred.
-
getLineNumber()
- The line number of the end of the text where the exception occurred.
-
getPublicId()
- Get the public identifier of the entity where the exception occurred.
-
getSystemId()
- Get the system identifier of the entity where the exception occurred.
SAXParseException
public SAXParseException(String message,
Locator locator)
- Create a new SAXParseException from a message and a Locator.
This constructor is especially useful when an application is
creating its own exception from within a DocumentHandler
callback.
- Parameters:
- message - The error or warning message.
- locator - The locator object for the error or warning.
- See Also:
- Locator, setLocale
SAXParseException
public SAXParseException(String message,
Locator locator,
Exception e)
- Wrap an existing exception in a SAXParseException.
This constructor is especially useful when an application is
creating its own exception from within a DocumentHandler
callback, and needs to wrap an existing exception that is not a
subclass of SAXException.
- Parameters:
- message - The error or warning message, or null to
use the message from the embedded exception.
- locator - The locator object for the error or warning.
- e - Any exception
- See Also:
- Locator, setLocale
SAXParseException
public SAXParseException(String message,
String publicId,
String systemId,
int lineNumber,
int columnNumber)
- Create a new SAXParseException.
This constructor is most useful for parser writers.
If the system identifier is a URL, the parser must resolve it
fully before creating the exception.
- Parameters:
- message - The error or warning message.
- publicId - The public identifer of the entity that generated
the error or warning.
- systemId - The system identifer of the entity that generated
the error or warning.
- lineNumber - The line number of the end of the text that
caused the error or warning.
- columnNumber - The column number of the end of the text that
cause the error or warning.
- See Also:
- setLocale
SAXParseException
public SAXParseException(String message,
String publicId,
String systemId,
int lineNumber,
int columnNumber,
Exception e)
- Create a new SAXParseException with an embedded exception.
This constructor is most useful for parser writers who
need to wrap an exception that is not a subclass of
SAXException.
If the system identifier is a URL, the parser must resolve it
fully before creating the exception.
- Parameters:
- message - The error or warning message, or null to use
the message from the embedded exception.
- publicId - The public identifer of the entity that generated
the error or warning.
- systemId - The system identifer of the entity that generated
the error or warning.
- lineNumber - The line number of the end of the text that
caused the error or warning.
- columnNumber - The column number of the end of the text that
cause the error or warning.
- e - Another exception to embed in this one.
- See Also:
- setLocale
getPublicId
public String getPublicId()
- Get the public identifier of the entity where the exception occurred.
- Returns:
- A string containing the public identifier, or null
if none is available.
- See Also:
- getPublicId
getSystemId
public String getSystemId()
- Get the system identifier of the entity where the exception occurred.
If the system identifier is a URL, it will be resolved
fully.
- Returns:
- A string containing the system identifier, or null
if none is available.
- See Also:
- getSystemId
getLineNumber
public int getLineNumber()
- The line number of the end of the text where the exception occurred.
- Returns:
- An integer representing the line number, or -1
if none is available.
- See Also:
- getLineNumber
getColumnNumber
public int getColumnNumber()
- The column number of the end of the text where the exception occurred.
The first column in a line is position 1.
- Returns:
- An integer representing the column number, or -1
if none is available.
- See Also:
- getColumnNumber
All Packages Class Hierarchy This Package Previous Next Index