Package org.exolab.castor.mapping
Interface FieldHandler
- All Known Subinterfaces:
ClonableFieldHandler,ConfigurableFieldHandler
- All Known Implementing Classes:
AbstractFieldHandler,CenturyDescriptor.CenturyFieldHandler,CollectionFieldHandler,ContainerFieldHandler,DateDescriptor.DateFieldHandler,DateFieldHandler,DateTimeDescriptor.DateTimeFieldHandler,DurationDescriptor.DurationFieldHandler,EnumFieldHandler,EnumFieldHandler,ExtendedFieldHandler,ExtendedFieldHandler,FieldHandlerFriend,FieldHandlerImpl,GDayDescriptor.GDayFieldHandler,GeneralizedFieldHandler,GMonthDayDescriptor.GMonthDayFieldHandler,GMonthDescriptor.GMonthFieldHandler,GYearDescriptor.GYearFieldHandler,GYearMonthDescriptor.GYearMonthFieldHandler,MonthDescriptor.MonthFieldHandler,RecurringDurationDescriptor.RecurringDurationFieldHandler,SQLTimeFieldHandler,SQLTimestampFieldHandler,TimeDescriptor.TimeFieldHandler,TimeDurationDescriptor.TimeDurationFieldHandler,TimePeriodDescriptor.TimePeriodFieldHandler,ToStringFieldHandler,TransientFieldHandler,ValueOfFieldHandler,XMLFieldHandler,YearDescriptor.YearFieldHandler
public interface FieldHandler
A field handler knows how to perform various operations on the
field that require access to the field value.
- Version:
- $Revision: 6671 $ $Date: 2003-03-03 00:05:44 -0700 (Mon, 03 Mar 2003) $
- Author:
- Assaf Arkin
- See Also:
-
Method Summary
Modifier and TypeMethodDescriptionvoidcheckValidity(Object object) Deprecated.No longer supportedReturns the value of the field from the object.newInstance(Object parent) Creates a new instance of the object described by this field.voidresetValue(Object object) Sets the value of the field to a default value.voidSets the value of the field on the object.
-
Method Details
-
getValue
Returns the value of the field from the object.- Parameters:
object- The object- Returns:
- The value of the field
- Throws:
IllegalStateException- The Java object has changed and is no longer supported by this handler, or the handler is not compatible with the Java object
-
setValue
Sets the value of the field on the object.- Parameters:
object- The object.value- The new value.- Throws:
IllegalStateException- The Java object has changed and is no longer supported by this handler, or the handler is not compatible with the Java object.IllegalArgumentException- The value passed is not of a supported type.
-
resetValue
Sets the value of the field to a default value.Reference fields are set to null, primitive fields are set to their default value, collection fields are emptied of all elements.
- Parameters:
object- The object.- Throws:
IllegalStateException- The Java object has changed and is no longer supported by this handler, or the handler is not compatible with the Java object.IllegalArgumentException
-
checkValidity
Deprecated.No longer supported -
newInstance
Creates a new instance of the object described by this field.- Parameters:
parent- The object for which the field is created- Returns:
- A new instance of the field's value
- Throws:
IllegalStateException- This field is a simple type and cannot be instantiated
-