|
||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectorg.exolab.castor.mapping.loader.FieldHandlerFriend
org.exolab.castor.mapping.ExtendedFieldHandler
public abstract class ExtendedFieldHandler
An extended version of the FieldHandler interface which is used for adding additional functionality while preserving backward compatability.
FieldDescriptor
,
FieldHandler
Constructor Summary | |
---|---|
ExtendedFieldHandler()
|
Method Summary | |
---|---|
void |
checkValidity(java.lang.Object object)
Deprecated. No longer supported |
protected abstract FieldDescriptor |
getFieldDescriptor()
Returns the FieldDescriptor for the field that this handler is reponsibile for, or null if no FieldDescriptor has been set. |
abstract java.lang.Object |
getValue(java.lang.Object object)
Returns the value of the field from the object. |
abstract java.lang.Object |
newInstance(java.lang.Object parent)
Creates a new instance of the object described by this field. |
abstract java.lang.Object |
newInstance(java.lang.Object parent,
java.lang.Object[] args)
Creates a new instance of the object described by this field. |
abstract void |
resetValue(java.lang.Object object)
Sets the value of the field to a default value. |
abstract void |
setFieldDescriptor(FieldDescriptor fieldDesc)
Sets the FieldDescriptor that this FieldHander is responsibile for. |
abstract void |
setValue(java.lang.Object object,
java.lang.Object value)
Sets the value of the field on the object. |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
---|
public ExtendedFieldHandler()
Method Detail |
---|
protected abstract FieldDescriptor getFieldDescriptor()
getFieldDescriptor
in class FieldHandlerFriend
public abstract void setFieldDescriptor(FieldDescriptor fieldDesc)
setFieldDescriptor
in class FieldHandlerFriend
fieldDesc
- the FieldDescriptor to setpublic void checkValidity(java.lang.Object object) throws ValidityException, java.lang.IllegalStateException
checkValidity
in interface FieldHandler
checkValidity
in class FieldHandlerFriend
ValidityException
java.lang.IllegalStateException
public abstract java.lang.Object getValue(java.lang.Object object) throws java.lang.IllegalStateException
getValue
in interface FieldHandler
getValue
in class FieldHandlerFriend
object
- The object
java.lang.IllegalStateException
- The Java object has changed and
is no longer supported by this handler, or the handler is not
compatiable with the Java objectpublic abstract java.lang.Object newInstance(java.lang.Object parent) throws java.lang.IllegalStateException
newInstance
in interface FieldHandler
newInstance
in class FieldHandlerFriend
parent
- The object for which the field is created
java.lang.IllegalStateException
- This field is a simple type and
cannot be instantiatedpublic abstract java.lang.Object newInstance(java.lang.Object parent, java.lang.Object[] args) throws java.lang.IllegalStateException
parent
- The object for which the field is createdargs
- the set of constructor arguments
java.lang.IllegalStateException
- This field is a simple type and
cannot be instantiatedpublic abstract void resetValue(java.lang.Object object) throws java.lang.IllegalStateException, java.lang.IllegalArgumentException
Reference fields are set to null, primitive fields are set to their default value, collection fields are emptied of all elements.
resetValue
in interface FieldHandler
resetValue
in class FieldHandlerFriend
object
- The object
java.lang.IllegalStateException
- The Java object has changed and
is no longer supported by this handler, or the handler is not
compatiable with the Java object
java.lang.IllegalArgumentException
public abstract void setValue(java.lang.Object object, java.lang.Object value) throws java.lang.IllegalStateException, java.lang.IllegalArgumentException
setValue
in interface FieldHandler
setValue
in class FieldHandlerFriend
object
- The objectvalue
- The new value
java.lang.IllegalStateException
- The Java object has changed and
is no longer supported by this handler, or the handler is not
compatiable with the Java object
java.lang.IllegalArgumentException
|
||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |