Package com.thoughtworks.xstream.converters.reflection

Class FieldDictionary

java.lang.Object

com.thoughtworks.xstream.converters.reflection.FieldDictionary

All Implemented Interfaces:

Caching

public class FieldDictionary
extends java.lang.Object
implements Caching

A field dictionary instance caches information about classes fields.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
private static class	FieldDictionary.DictionaryEntry
(package private) static interface	FieldDictionary.FieldUtil

Field Summary

Fields

Modifier and Type	Field	Description
private java.util.Map	dictionaryEntries
private FieldDictionary.FieldUtil	fieldUtil
private static FieldDictionary.DictionaryEntry	OBJECT_DICTIONARY_ENTRY
private FieldKeySorter	sorter

Constructor Summary

Constructors

Constructor	Description
FieldDictionary()
FieldDictionary(FieldKeySorter sorter)

Method Summary

Modifier and Type	Method	Description
private FieldDictionary.DictionaryEntry	buildDictionaryEntryForClass(java.lang.Class cls, FieldDictionary.DictionaryEntry lastDictionaryEntry)
private java.util.Map	buildMap(java.lang.Class type, boolean tupleKeyed)
java.lang.reflect.Field	field(java.lang.Class cls, java.lang.String name, java.lang.Class definedIn)	Returns an specific field of some class.
java.lang.reflect.Field	fieldOrNull(java.lang.Class cls, java.lang.String name, java.lang.Class definedIn)	Returns an specific field of some class.
java.util.Iterator	fieldsFor(java.lang.Class cls)	Returns an iterator for all fields for some class
void	flushCache()
private FieldDictionary.DictionaryEntry	getDictionaryEntry(java.lang.Class cls)
private void	init()
protected java.lang.Object	readResolve()
java.util.Iterator	serializableFieldsFor(java.lang.Class cls)	Deprecated. As of 1.3, use fieldsFor(Class) instead

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

OBJECT_DICTIONARY_ENTRY

private static final FieldDictionary.DictionaryEntry OBJECT_DICTIONARY_ENTRY

dictionaryEntries

private transient java.util.Map dictionaryEntries

fieldUtil

private transient FieldDictionary.FieldUtil fieldUtil

sorter

private final FieldKeySorter sorter

Constructor Detail

FieldDictionary

public FieldDictionary()

FieldDictionary

public FieldDictionary(FieldKeySorter sorter)

Method Detail

init

private void init()

serializableFieldsFor

public java.util.Iterator serializableFieldsFor(java.lang.Class cls)

Deprecated.

As of 1.3, use fieldsFor(Class) instead

Returns an iterator for all fields for some class

Parameters:

cls - the class you are interested on

Returns:

an iterator for its fields

fieldsFor

public java.util.Iterator fieldsFor(java.lang.Class cls)

Returns an iterator for all fields for some class

Parameters:

cls - the class you are interested on

Returns:

an iterator for its fields

field

public java.lang.reflect.Field field(java.lang.Class cls,
                                     java.lang.String name,
                                     java.lang.Class definedIn)

Returns an specific field of some class. If definedIn is null, it searches for the field named 'name' inside the class cls. If definedIn is different than null, tries to find the specified field name in the specified class cls which should be defined in class definedIn (either equals cls or a one of it's superclasses)

Parameters:

cls - the class where the field is to be searched

name - the field name

definedIn - the superclass (or the class itself) of cls where the field was defined

Returns:

the field itself

Throws:

ObjectAccessException - if no field can be found

fieldOrNull

public java.lang.reflect.Field fieldOrNull(java.lang.Class cls,
                                           java.lang.String name,
                                           java.lang.Class definedIn)

Returns an specific field of some class. If definedIn is null, it searches for the field named 'name' inside the class cls. If definedIn is different than null, tries to find the specified field name in the specified class cls which should be defined in class definedIn (either equals cls or a one of it's superclasses)

Parameters:

cls - the class where the field is to be searched

name - the field name

definedIn - the superclass (or the class itself) of cls where the field was defined

Returns:

the field itself or null

Since:

1.4

buildMap

private java.util.Map buildMap(java.lang.Class type,
                               boolean tupleKeyed)

buildDictionaryEntryForClass

private FieldDictionary.DictionaryEntry buildDictionaryEntryForClass(java.lang.Class cls,
                                                                     FieldDictionary.DictionaryEntry lastDictionaryEntry)

getDictionaryEntry

private FieldDictionary.DictionaryEntry getDictionaryEntry(java.lang.Class cls)

flushCache

public void flushCache()

Specified by:

flushCache in interface Caching

readResolve

protected java.lang.Object readResolve()