com.thoughtworks.xstream.converters.reflection

Interface ReflectionProvider

All Known Implementing Classes:

PureJavaReflectionProvider, ReflectionProviderWrapper, Sun14ReflectionProvider, SunLimitedUnsafeReflectionProvider, SunUnsafeReflectionProvider

public interface ReflectionProvider

Provides core reflection services.

Author:

Joe Walnes

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static interface	ReflectionProvider.Visitor A visitor interface for serializable fields defined in a class.

Method Summary

Modifier and Type	Method and Description
boolean	fieldDefinedInClass(String fieldName, Class type) Deprecated. As of 1.4.5, use getFieldOrNull(Class, String) instead
Field	getField(Class definedIn, String fieldName) Returns a field defined in some class.
Field	getFieldOrNull(Class definedIn, String fieldName) Returns a field defined in some class.
Class	getFieldType(Object object, String fieldName, Class definedIn)
Object	newInstance(Class type) Creates a new instance of the specified type.
void	visitSerializableFields(Object object, ReflectionProvider.Visitor visitor)
void	writeField(Object object, String fieldName, Object value, Class definedIn)

Method Detail

newInstance

Object newInstance(Class type)

Creates a new instance of the specified type. It is in the responsibility of the implementation how such an instance is created.

Parameters:

type - the type to instantiate

Returns:

a new instance of this type

visitSerializableFields

void visitSerializableFields(Object object,
                             ReflectionProvider.Visitor visitor)

writeField

void writeField(Object object,
                String fieldName,
                Object value,
                Class definedIn)

getFieldType

Class getFieldType(Object object,
                   String fieldName,
                   Class definedIn)

fieldDefinedInClass

boolean fieldDefinedInClass(String fieldName,
                            Class type)

Deprecated. As of 1.4.5, use getFieldOrNull(Class, String) instead

getField

Field getField(Class definedIn,
               String fieldName)

Returns a field defined in some class.

Parameters:

definedIn - class where the field was defined

fieldName - field name

Returns:

the field itself

Throws:

ObjectAccessException - if field does not exist

getFieldOrNull

Field getFieldOrNull(Class definedIn,
                     String fieldName)

Returns a field defined in some class.

Parameters:

definedIn - class where the field was defined

fieldName - field name

Returns:

the field itself or null

Since:

1.4.5