public class SAXParseException extends SAXException
This module, both source code and documentation, is in the Public Domain, and comes with NO WARRANTY.
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.
SAXException
,
Locator
,
ErrorHandler
,
Serialized FormModifier and Type | Field and Description |
---|---|
private int |
columnNumber |
private int |
lineNumber |
private String |
publicId |
private String |
systemId |
Constructor and Description |
---|
SAXParseException(String message,
Locator locator)
Create a new SAXParseException from a message and a Locator.
|
SAXParseException(String message,
Locator locator,
Exception e)
Wrap an existing exception in a SAXParseException.
|
SAXParseException(String message,
String publicId,
String systemId,
int lineNumber,
int columnNumber)
Create a new SAXParseException.
|
SAXParseException(String message,
String publicId,
String systemId,
int lineNumber,
int columnNumber,
Exception e)
Create a new SAXParseException with an embedded exception.
|
Modifier and Type | Method and Description |
---|---|
int |
getColumnNumber()
The column number of the end of the text where the exception occurred.
|
int |
getLineNumber()
The line number of the end of the text where the exception occurred.
|
String |
getPublicId()
Get the public identifier of the entity where the exception occurred.
|
String |
getSystemId()
Get the system identifier of the entity where the exception occurred.
|
private void |
init(String publicId,
String systemId,
int lineNumber,
int columnNumber)
Internal initialization method.
|
getException, getMessage, toString
addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace
private String publicId
getPublicId()
private String systemId
getSystemId()
private int lineNumber
getLineNumber()
private int columnNumber
getColumnNumber()
public SAXParseException(String message, Locator locator)
This constructor is especially useful when an application is
creating its own exception from within a ContentHandler
callback.
message
- The error or warning message.locator
- The locator object for the error or warning (may be
null).Locator
,
Parser.setLocale(java.util.Locale)
public SAXParseException(String message, Locator locator, Exception e)
This constructor is especially useful when an application is
creating its own exception from within a ContentHandler
callback, and needs to wrap an existing exception that is not a
subclass of SAXException
.
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 (may be
null).e
- Any exception.Locator
,
Parser.setLocale(java.util.Locale)
public SAXParseException(String message, String publicId, String systemId, int lineNumber, int columnNumber)
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.
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.Parser.setLocale(java.util.Locale)
public SAXParseException(String message, String publicId, String systemId, int lineNumber, int columnNumber, Exception e)
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.
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.Parser.setLocale(java.util.Locale)
private void init(String publicId, String systemId, int lineNumber, int columnNumber)
publicId
- The public identifier of the entity which generated the exception,
or null.systemId
- The system identifier of the entity which generated the exception,
or null.lineNumber
- The line number of the error, or -1.columnNumber
- The column number of the error, or -1.public String getPublicId()
Locator.getPublicId()
public String getSystemId()
If the system identifier is a URL, it will be resolved fully.
Locator.getSystemId()
public int getLineNumber()
Locator.getLineNumber()
public int getColumnNumber()
The first column in a line is position 1.
Locator.getColumnNumber()
WebARTS Library Licensed Under the GNU - General Public License. Other Libraries licensed under their respective Open Source Licenses