Modifier and Type	Class and Description
private static class	AbstractReflectionConverter.ArraysList
public static class	AbstractReflectionConverter.DuplicateFieldException Deprecated as a consequence of `ConversionException` being deprecated.
private static class	AbstractReflectionConverter.FieldInfo
private static class	AbstractReflectionConverter.FieldLocation
private static interface	AbstractReflectionConverter.FieldMarshaller
private class	AbstractReflectionConverter.MappingList
public static class	AbstractReflectionConverter.UnknownFieldException Deprecated as a consequence of `ConversionException` being deprecated.

Modifier and Type	Field and Description
protected final Mapper	mapper
private transient ReflectionProvider	pureJavaReflectionProvider
protected final ReflectionProvider	reflectionProvider
protected transient SerializationMembers	serializationMembers
protected transient SerializationMethodInvoker	serializationMethodInvoker Deprecated As of 1.4.8, use `serializationMembers`.

Access	Constructor and Description
public	AbstractReflectionConverter(Mapper mapper, ReflectionProvider reflectionProvider)

Method Summary

Modifier and Type	Method and Description
protected boolean	canAccess(Class<T> type)
protected void	doMarshal(final Object source, final HierarchicalStreamWriter writer, final MarshallingContext context)
public Object	doUnmarshal(final Object result, final HierarchicalStreamReader reader, final UnmarshallingContext context)
public void	flushCache() Implements com.thoughtworks.xstream.core.Caching.flushCache.
private void	handleUnknownField(Class<T> classDefiningField, String fieldName, Class<T> resultType, String originalNodeName)
protected Object	instantiateNewInstance(HierarchicalStreamReader reader, UnmarshallingContext context)
public void	marshal(Object The object to be marshalled. original, final HierarchicalStreamWriter A stream to write to. writer, final MarshallingContext A context that allows nested objects to be processed by XStream. context) Implements com.thoughtworks.xstream.converters.Converter.marshal. Convert an object to textual data.
protected void	marshallField(final MarshallingContext context, Object newObj, Field field)
private Class<T>	readDeclaringClass(HierarchicalStreamReader reader)
protected Object	readResolve()
protected boolean	shouldUnmarshalField(Field field)
protected boolean	shouldUnmarshalTransientFields()
public Object	unmarshal(final HierarchicalStreamReader The stream to read the text from. reader, final UnmarshallingContext context) Implements com.thoughtworks.xstream.converters.Converter.unmarshal. Convert textual data back into an object.
protected Object	unmarshallField(final UnmarshallingContext context, final Object result, Class<T> type, Field field)
private void	writeValueToImplicitCollection(Object value, Map<K, V> implicitCollections, Object result, final AbstractReflectionConverter.FieldLocation fieldLocation)

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

mapper	back to summary
protected final Mapper mapper

pureJavaReflectionProvider	back to summary
private transient ReflectionProvider pureJavaReflectionProvider

reflectionProvider	back to summary
protected final ReflectionProvider reflectionProvider

serializationMembers	back to summary
protected transient SerializationMembers serializationMembers

serializationMethodInvoker	back to summary
protected transient SerializationMethodInvoker serializationMethodInvoker Deprecated As of 1.4.8, use `serializationMembers`.

AbstractReflectionConverter	back to summary
public AbstractReflectionConverter(Mapper mapper, ReflectionProvider reflectionProvider)

Method Detail

canAccess	back to summary
protected boolean canAccess(Class<T> type)

doMarshal	back to summary
protected void doMarshal(final Object source, final HierarchicalStreamWriter writer, final MarshallingContext context)

doUnmarshal	back to summary
public Object doUnmarshal(final Object result, final HierarchicalStreamReader reader, final UnmarshallingContext context)

flushCache	back to summary
public void flushCache() Implements com.thoughtworks.xstream.core.Caching.flushCache.

handleUnknownField	back to summary
private void handleUnknownField(Class<T> classDefiningField, String fieldName, Class<T> resultType, String originalNodeName)

instantiateNewInstance	back to summary
protected Object instantiateNewInstance(HierarchicalStreamReader reader, UnmarshallingContext context)

marshal	back to summary
public void marshal(Object original, final HierarchicalStreamWriter writer, final MarshallingContext context) Implements com.thoughtworks.xstream.converters.Converter.marshal. Doc from com.thoughtworks.xstream.converters.Converter.marshal. Convert an object to textual data. Parameters original:Object The object to be marshalled. writer:HierarchicalStreamWriter A stream to write to. context:MarshallingContext A context that allows nested objects to be processed by XStream.

marshal

back to summary

public void marshal(Object original, final HierarchicalStreamWriter writer, final MarshallingContext context)

Implements com.thoughtworks.xstream.converters.Converter.marshal.

Doc from com.thoughtworks.xstream.converters.Converter.marshal.

Convert an object to textual data.

Parameters

original:Object: The object to be marshalled.
writer:HierarchicalStreamWriter: A stream to write to.
context:MarshallingContext: A context that allows nested objects to be processed by XStream.

marshallField	back to summary
protected void marshallField(final MarshallingContext context, Object newObj, Field field)

readDeclaringClass	back to summary
private Class<T> readDeclaringClass(HierarchicalStreamReader reader)

readResolve	back to summary
protected Object readResolve()

shouldUnmarshalField	back to summary
protected boolean shouldUnmarshalField(Field field)

shouldUnmarshalTransientFields	back to summary
protected boolean shouldUnmarshalTransientFields()

unmarshal	back to summary
public Object unmarshal(final HierarchicalStreamReader reader, final UnmarshallingContext context) Implements com.thoughtworks.xstream.converters.Converter.unmarshal. Doc from com.thoughtworks.xstream.converters.Converter.unmarshal. Convert textual data back into an object. Parameters reader:HierarchicalStreamReader The stream to read the text from. Returns:Object The resulting object.

unmarshal

back to summary

public Object unmarshal(final HierarchicalStreamReader reader, final UnmarshallingContext context)

Implements com.thoughtworks.xstream.converters.Converter.unmarshal.

Doc from com.thoughtworks.xstream.converters.Converter.unmarshal.

Convert textual data back into an object.

Parameters

reader:HierarchicalStreamReader: The stream to read the text from.

Returns:Object

The resulting object.

unmarshallField	back to summary
protected Object unmarshallField(final UnmarshallingContext context, final Object result, Class<T> type, Field field)

writeValueToImplicitCollection	back to summary
private void writeValueToImplicitCollection(Object value, Map<K, V> implicitCollections, Object result, final AbstractReflectionConverter.FieldLocation fieldLocation)

com.thoughtworks.xstream.converters.reflection back to summary

private Class AbstractReflectionConverter.ArraysList

Class Inheritance

extends ArrayList

java.lang.Object
java.util.AbstractCollection
java.util.AbstractList
java.util.ArrayList
com.thoughtworks.xstream.converters.reflection.AbstractReflectionConverter.ArraysList

Field Summary

Modifier and Type	Field and Description
pack-priv final Class<T>	physicalFieldType

Constructor Summary

Access	Constructor and Description
pack-priv	ArraysList(Class<T> physicalFieldType)

Method Summary

Modifier and Type	Method and Description
pack-priv Object	toPhysicalArray()

Field Detail

physicalFieldType	back to summary
pack-priv final Class<T> physicalFieldType

Constructor Detail

ArraysList	back to summary
pack-priv ArraysList(Class<T> physicalFieldType)

Method Detail

toPhysicalArray	back to summary
pack-priv Object toPhysicalArray()

com.thoughtworks.xstream.converters.reflection back to summary

public Class AbstractReflectionConverter.DuplicateFieldException

Class Inheritance

extends 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.ErrorWritingException
com.thoughtworks.xstream.converters.ConversionException
com.thoughtworks.xstream.converters.reflection.AbstractReflectionConverter.DuplicateFieldException

Deprecated

as a consequence of ConversionException being deprecated. See corresponding docs for further information.

Constructor Summary

Access	Constructor and Description
public	DuplicateFieldException(String msg)

Constructor Detail

DuplicateFieldException	back to summary
public DuplicateFieldException(String msg)

com.thoughtworks.xstream.converters.reflection back to summary

private Class AbstractReflectionConverter.FieldInfo

Class Inheritance

extends FieldLocation

java.lang.Object
com.thoughtworks.xstream.converters.reflection.AbstractReflectionConverter.FieldLocation
com.thoughtworks.xstream.converters.reflection.AbstractReflectionConverter.FieldInfo

Field Summary

Modifier and Type	Field and Description
pack-priv final Class<T>	type
pack-priv final Object	value

Inherited from com.thoughtworks.xstream.converters.reflection.AbstractReflectionConverter.FieldLocation:: definedIn fieldName

Constructor Summary

Access	Constructor and Description
pack-priv	FieldInfo(final String fieldName, final Class<T> type, final Class<T> definedIn, final Object value)

Method Summary

Inherited from com.thoughtworks.xstream.converters.reflection.AbstractReflectionConverter.FieldLocation:: equals hashCode

Field Detail

type	back to summary
pack-priv final Class<T> type

value	back to summary
pack-priv final Object value

Constructor Detail

FieldInfo	back to summary
pack-priv FieldInfo(final String fieldName, final Class<T> type, final Class<T> definedIn, final Object value)

com.thoughtworks.xstream.converters.reflection back to summary

private Class AbstractReflectionConverter.FieldLocation

Class Inheritance

extends Object

java.lang.Object
com.thoughtworks.xstream.converters.reflection.AbstractReflectionConverter.FieldLocation

Known Direct Subclasses

com.thoughtworks.xstream.converters.reflection.AbstractReflectionConverter.FieldInfo

Field Summary

Modifier and Type	Field and Description
pack-priv final Class<T>	definedIn
pack-priv final String	fieldName

Constructor Summary

Access	Constructor and Description
pack-priv	FieldLocation(final String fieldName, final Class<T> definedIn)

Method Summary

Modifier and Type	Method and Description
public boolean	equals(final Object the reference object with which to compare. obj) Overrides java.lang.Object.equals. Indicates whether some other object is "equal to" this one.
public int	hashCode() Overrides java.lang.Object.hashCode. Returns a hash code value for the object.

Inherited from java.lang.Object:: clone finalize getClass notify notifyAll toString wait wait wait

Field Detail

definedIn	back to summary
pack-priv final Class<T> definedIn

fieldName	back to summary
pack-priv final String fieldName

Constructor Detail

FieldLocation	back to summary
pack-priv FieldLocation(final String fieldName, final Class<T> definedIn)

Method Detail

equals back to summary

equals	back to summary
public boolean equals(final Object obj) Overrides java.lang.Object.equals. Doc from java.lang.Object.equals. Indicates whether some other object is "equal to" this one. The `equals` method implements an equivalence relation on non-null object references: It is reflexive: for any non-null reference value `x`, `x.equals(x)` should return `true`. It is symmetric: for any non-null reference values `x` and `y`, `x.equals(y)` should return `true` if and only if `y.equals(x)` returns `true`. It is transitive: for any non-null reference values `x`, `y`, and `z`, if `x.equals(y)` returns `true` and `y.equals(z)` returns `true`, then `x.equals(z)` should return `true`. It is consistent: for any non-null reference values `x` and `y`, multiple invocations of `x.equals(y)` consistently return `true` or consistently return `false`, provided no information used in `equals` comparisons on the objects is modified. For any non-null reference value `x`, `x.equals(null)` should return `false`. An equivalence relation partitions the elements it operates on into equivalence classes; all the members of an equivalence class are equal to each other. Members of an equivalence class are substitutable for each other, at least for some purposes. Parameters obj:Object the reference object with which to compare. Returns:boolean `true` if this object is the same as the obj argument; `false` otherwise.

public boolean equals(final Object obj)

Overrides java.lang.Object.equals.

Doc from java.lang.Object.equals.

Indicates whether some other object is "equal to" this one.

The equals method implements an equivalence relation on non-null object references:

It is reflexive: for any non-null reference value x, x.equals(x) should return true.
It is symmetric: for any non-null reference values x and y, x.equals(y) should return true if and only if y.equals(x) returns true.
It is transitive: for any non-null reference values x, y, and z, if x.equals(y) returns true and y.equals(z) returns true, then x.equals(z) should return true.
It is consistent: for any non-null reference values x and y, multiple invocations of x.equals(y) consistently return true or consistently return false, provided no information used in equals comparisons on the objects is modified.
For any non-null reference value x, x.equals(null) should return false.

An equivalence relation partitions the elements it operates on into equivalence classes; all the members of an equivalence class are equal to each other. Members of an equivalence class are substitutable for each other, at least for some purposes.

Parameters

obj:Object: the reference object with which to compare.

Returns:boolean

true if this object is the same as the obj argument; false otherwise.

hashCode back to summary

hashCode	back to summary
public int hashCode() Overrides java.lang.Object.hashCode. Doc from java.lang.Object.hashCode. Returns a hash code value for the object. This method is supported for the benefit of hash tables such as those provided by `java.util.HashMap`. The general contract of `hashCode` is: Whenever it is invoked on the same object more than once during an execution of a Java application, the `hashCode` method must consistently return the same integer, provided no information used in `equals` comparisons on the object is modified. This integer need not remain consistent from one execution of an application to another execution of the same application. If two objects are equal according to the `equals` method, then calling the `hashCode` method on each of the two objects must produce the same integer result. It is not required that if two objects are unequal according to the `equals` method, then calling the `hashCode` method on each of the two objects must produce distinct integer results. However, the programmer should be aware that producing distinct integer results for unequal objects may improve the performance of hash tables. Returns:int a hash code value for this object.

public int hashCode()

Overrides java.lang.Object.hashCode.

Doc from java.lang.Object.hashCode.

Returns a hash code value for the object. This method is supported for the benefit of hash tables such as those provided by java.util.HashMap.

The general contract of hashCode is:

Whenever it is invoked on the same object more than once during an execution of a Java application, the hashCode method must consistently return the same integer, provided no information used in equals comparisons on the object is modified. This integer need not remain consistent from one execution of an application to another execution of the same application.
If two objects are equal according to the equals method, then calling the hashCode method on each of the two objects must produce the same integer result.
It is not required that if two objects are unequal according to the equals method, then calling the hashCode method on each of the two objects must produce distinct integer results. However, the programmer should be aware that producing distinct integer results for unequal objects may improve the performance of hash tables.

Returns:int: a hash code value for this object.

com.thoughtworks.xstream.converters.reflection back to summary

private Interface AbstractReflectionConverter.FieldMarshaller

Method Summary

Modifier and Type	Method and Description
public void	writeField(final String fieldName, final String aliasName, final Class<T> fieldType, final Class<T> definedIn, final Object newObj)
public void	writeItem(final Object item)

Method Detail

writeField	back to summary
public void writeField(final String fieldName, final String aliasName, final Class<T> fieldType, final Class<T> definedIn, final Object newObj)

writeItem	back to summary
public void writeItem(final Object item)

com.thoughtworks.xstream.converters.reflection back to summary

private Class AbstractReflectionConverter.MappingList

Class Inheritance

extends AbstractList

java.lang.Object
java.util.AbstractCollection
java.util.AbstractList
com.thoughtworks.xstream.converters.reflection.AbstractReflectionConverter.MappingList

Field Summary

Modifier and Type	Field and Description
private final Map<K, V>	fieldCache
private final String	keyFieldName
private final Map<K, V>	map

Inherited from java.util.AbstractList:: modCount

Constructor Summary

Access	Constructor and Description
public	MappingList(Map<K, V> map, String keyFieldName)

Method Summary

Modifier and Type	Method and Description
public boolean	add(Object element to be appended to this list object) Overrides java.util.AbstractList.add. Implements java.util.List.add, java.util.Collection.add. Appends the specified element to the end of this list (optional operation).
public Object	get(int index of the element to return index) Implements abstract java.util.AbstractList.get. Implements java.util.List.get. Returns the element at the specified position in this list.
public int	size() Implements abstract java.util.AbstractCollection.size. Implements java.util.List.size, java.util.Collection.size. Returns the number of elements in this list.

Inherited from java.util.AbstractList:: add addAll clear equals hashCode indexOf iterator lastIndexOf listIterator listIterator remove removeRange set subList

Field Detail

fieldCache	back to summary
private final Map<K, V> fieldCache

keyFieldName	back to summary
private final String keyFieldName

map	back to summary
private final Map<K, V> map

Constructor Detail

MappingList	back to summary
public MappingList(Map<K, V> map, String keyFieldName)

Method Detail

add back to summary

public boolean add(Object object)

Overrides java.util.AbstractList.add.

Implements java.util.List.add, java.util.Collection.add.

Doc from java.util.AbstractList.add.

Appends the specified element to the end of this list (optional operation).

Lists that support this operation may place limitations on what elements may be added to this list. In particular, some lists will refuse to add null elements, and others will impose restrictions on the type of elements that may be added. List classes should clearly specify in their documentation any restrictions on what elements may be added.

Parameters

object:Object: element to be appended to this list

Returns:boolean

true (as specified by Collection#add)

get

back to summary

public Object get(int index)

Implements abstract java.util.AbstractList.get.

Implements java.util.List.get.

Doc from java.util.AbstractList.get.

Returns the element at the specified position in this list.

Parameters

index:int

Doc from java.util.List.get.

index of the element to return

Returns:Object

Doc from java.util.List.get.

the element at the specified position in this list

size back to summary

public int size()

Implements abstract java.util.AbstractCollection.size.

Implements java.util.List.size, java.util.Collection.size.

Doc from java.util.List.size.

Returns the number of elements in this list. If this list contains more than Integer.MAX_VALUE elements, returns Integer.MAX_VALUE.

Returns:int: the number of elements in this list

public abstract Class AbstractReflectionConverter

Nested and Inner Type Summary

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

private Class AbstractReflectionConverter.ArraysList

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

public Class AbstractReflectionConverter.DuplicateFieldException

Constructor Summary

Constructor Detail

private Class AbstractReflectionConverter.FieldInfo

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

private Class AbstractReflectionConverter.FieldLocation

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

private Interface AbstractReflectionConverter.FieldMarshaller

Method Summary

Method Detail

private Class AbstractReflectionConverter.MappingList

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

public Class AbstractReflectionConverter.UnknownFieldException

Constructor Summary

Constructor Detail