Class ExtendedFieldHandler<T>

java.lang.Object

org.exolab.castor.mapping.loader.FieldHandlerFriend<T>

org.exolab.castor.mapping.ExtendedFieldHandler<T>

All Implemented Interfaces:

FieldHandler<T>

Direct Known Subclasses:

AbstractFieldHandler

public abstract class ExtendedFieldHandler<T>
extends FieldHandlerFriend<T>

An extended version of the FieldHandler interface which is used for adding additional functionality while preserving backward compatibility.

Version:

$Revision: 9062 $ $Date: 2005-08-03 15:11:51 -0600 (Wed, 03 Aug 2005) $

Author:

Keith Visco

See Also:

• FieldDescriptor
• FieldHandler

Constructor Summary

Constructors

Constructor	Description
ExtendedFieldHandler()

Method Summary

Modifier and Type	Method	Description
void	checkValidity(Object object)	Deprecated. No longer supported
abstract Object	newInstance(Object parent, Object[] args)	Creates a new instance of the object described by this field.

Methods inherited from class FieldHandlerFriend

getFieldDescriptor, setFieldDescriptor

Modifier and Type	Method	Description
protected abstract FieldDescriptor	getFieldDescriptor()	Returns the FieldDescriptor for the field that this handler is responsible for, or null if no FieldDescriptor has been set.
abstract void	setFieldDescriptor(FieldDescriptor fieldDesc)	Sets the FieldDescriptor that this FieldHander is responsibile for.

Methods inherited from class Object

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

Methods inherited from interface FieldHandler

getValue, newInstance, resetValue, setValue

Modifier and Type	Method	Description
T	getValue(Object object)	Returns the value of the field from the object.
T	newInstance(Object parent)	Creates a new instance of the object described by this field.
void	resetValue(Object object)	Sets the value of the field to a default value.
void	setValue(Object object, T value)	Sets the value of the field on the object.

Constructor Details

ExtendedFieldHandler

public ExtendedFieldHandler()

Method Details

checkValidity

public void checkValidity(Object object)
                   throws ValidityException,
IllegalStateException

Deprecated.

No longer supported

Specified by:

checkValidity in interface FieldHandler<T>

Specified by:

checkValidity in class FieldHandlerFriend<T>

Throws:

ValidityException

IllegalStateException

newInstance

public abstract Object newInstance(Object parent,
 Object[] args)
                            throws IllegalStateException

Creates a new instance of the object described by this field.

Parameters:

parent - The object for which the field is created

args - the set of constructor arguments

Returns:

A new instance of the field's value

Throws:

IllegalStateException - This field is a simple type and cannot be instantiated