|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectjava.lang.Throwable
java.lang.Exception
javax.xml.stream.XMLStreamException
org.codehaus.stax2.typed.TypedXMLStreamException
public class TypedXMLStreamException
This class represents an exception throw by an
TypedXMLStreamReader
or an TypedXMLStreamWriter
. It is
used to indicate a problems occuring when trying convert
data for access using typed read or write methods.
Note that the lexical value is a mandatory thing to pass -- since
this exception subtype need not be used solely for wrapping
purposes (XMLStreamException
s are to be passed as is,
other underlying root cause types should be unchecked), we
can mandate a lexical value (which may be null, however) to
be passed.
Similarly, aside from generic stream exception, it is mandated
that root causes to wrap need to be of type
IllegalArgumentException
, since that is the supertype
of regular parsing/conversion types for primitive types.
Field Summary | |
---|---|
protected String |
mLexical
Lexical representation of the content that could not be converted to the requested type. |
Fields inherited from class javax.xml.stream.XMLStreamException |
---|
location, nested |
Constructor Summary | |
---|---|
TypedXMLStreamException(String lexical,
IllegalArgumentException rootCause)
Constructor used to wrap an underlying data conversion error message. |
|
TypedXMLStreamException(String lexical,
String msg)
Construct an exception with the associated message. |
|
TypedXMLStreamException(String lexical,
String msg,
IllegalArgumentException rootCause)
Construct an exception with the associated message and exception |
|
TypedXMLStreamException(String lexical,
String msg,
Location location)
Construct an exception with the associated message, exception and location. |
|
TypedXMLStreamException(String lexical,
String msg,
Location location,
IllegalArgumentException rootCause)
Construct an exception with the associated message, exception and location. |
Method Summary | |
---|---|
String |
getLexical()
Return the lexical representation of the attribute or element content that could not be converted as requested. |
Methods inherited from class javax.xml.stream.XMLStreamException |
---|
getLocation, getNestedException |
Methods inherited from class java.lang.Throwable |
---|
fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
Field Detail |
---|
protected String mLexical
null
if a processor is unable to provide it. Lexical representation
should preferably be as close to the original input String
as possible (as opposed to being normalized which often
is done before actual parsing).
Constructor Detail |
---|
public TypedXMLStreamException(String lexical, String msg)
msg
- The message to report.public TypedXMLStreamException(String lexical, IllegalArgumentException rootCause)
rootCause
- Underlying conversion problempublic TypedXMLStreamException(String lexical, String msg, IllegalArgumentException rootCause)
msg
- The message to report.rootCause
- Underlying conversion problempublic TypedXMLStreamException(String lexical, String msg, Location location, IllegalArgumentException rootCause)
msg
- The message to report.location
- The location of the error.rootCause
- Underlying conversion problempublic TypedXMLStreamException(String lexical, String msg, Location location)
msg
- The message to report.location
- The location of the error.Method Detail |
---|
public String getLexical()
null
if unavailable.
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |