com.thoughtworks.xstream.converters
Class ConversionException

java.lang.Object
  extended by java.lang.Throwable
      extended by java.lang.Exception
          extended by java.lang.RuntimeException
              extended by com.thoughtworks.xstream.core.BaseException
                  extended by com.thoughtworks.xstream.XStreamException
                      extended by com.thoughtworks.xstream.converters.ConversionException
All Implemented Interfaces:
ErrorWriter, java.io.Serializable
Direct Known Subclasses:
AbstractReflectionConverter.DuplicateFieldException, JavaBeanConverter.DuplicateFieldException

public class ConversionException
extends XStreamException
implements ErrorWriter

Thrown by Converter implementations when they cannot convert an object to/from textual data. When this exception is thrown it can be passed around to things that accept an ErrorWriter, allowing them to add diagnostics to the stack trace.

Author:
Joe Walnes, Jörg Schaible
See Also:
ErrorWriter, Serialized Form

Constructor Summary
ConversionException(java.lang.String msg)
           
ConversionException(java.lang.String msg, java.lang.Throwable cause)
           
ConversionException(java.lang.Throwable cause)
           
 
Method Summary
 void add(java.lang.String name, java.lang.String information)
          Add some information to the error message.
 java.lang.String get(java.lang.String errorKey)
          Retrieve information of the error message.
 java.lang.String getMessage()
           
 java.lang.String getShortMessage()
           
 java.util.Iterator keys()
          Retrieve an iterator over all keys of the error message.
 
Methods inherited from class com.thoughtworks.xstream.XStreamException
getCause
 
Methods inherited from class java.lang.Throwable
fillInStackTrace, getLocalizedMessage, getStackTrace, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Constructor Detail

ConversionException

public ConversionException(java.lang.String msg,
                           java.lang.Throwable cause)

ConversionException

public ConversionException(java.lang.String msg)

ConversionException

public ConversionException(java.lang.Throwable cause)
Method Detail

get

public java.lang.String get(java.lang.String errorKey)
Description copied from interface: ErrorWriter
Retrieve information of the error message.

Specified by:
get in interface ErrorWriter
Parameters:
errorKey - the key of the message
Returns:
the value

add

public void add(java.lang.String name,
                java.lang.String information)
Description copied from interface: ErrorWriter
Add some information to the error message.

Specified by:
add in interface ErrorWriter
Parameters:
name - something to identify the type of information (e.g. 'XPath').
information - detail of the message (e.g. '/blah/moo[3]'

keys

public java.util.Iterator keys()
Description copied from interface: ErrorWriter
Retrieve an iterator over all keys of the error message.

Specified by:
keys in interface ErrorWriter
Returns:
an Iterator

getMessage

public java.lang.String getMessage()
Overrides:
getMessage in class java.lang.Throwable

getShortMessage

public java.lang.String getShortMessage()


Joe Walnes, http://xstream.codehaus.org/