com.thoughtworks.xstream.converters

Class ConversionException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

com.thoughtworks.xstream.core.BaseException

com.thoughtworks.xstream.XStreamException

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

Constructors

Constructor and Description
ConversionException(java.lang.String msg)
ConversionException(java.lang.String msg, java.lang.Throwable cause)
ConversionException(java.lang.Throwable cause)

Method Summary

Methods

Modifier and Type	Method and Description
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

addSuppressed, fillInStackTrace, getLocalizedMessage, getStackTrace, getSuppressed, 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()