FieldInfo (Castor 1.3.2 API)

java.lang.Object
- org.exolab.castor.builder.info.FieldInfo

All Implemented Interfaces:

NatureExtendable, PropertyHolder, XMLInfo

Direct Known Subclasses:

CollectionInfo, IdentityInfo
```
public class FieldInfo
extends Object
implements XMLInfo, PropertyHolder
```
A class for representing field members of a class. FieldInfo objects hold all the information required about a member in order to be able to produce XML data binding (marshal/unmarshal) and validation code.

Version:

$Revision: 7996 $ $Date: 2006-04-25 15:08:23 -0600 (Tue, 25 Apr 2006) $

Author:

Keith Visco

Field Summary

Fields
Modifier and Type	Field and Description
`protected static String`	`METHOD_PREFIX_ADD` Method prefixes for "Add" methods.
`protected static String`	`METHOD_PREFIX_DELETE` Method prefixes for "Delete" methods.
`protected static String`	`METHOD_PREFIX_GET` Method prefixes for "Get" methods.
`protected static String`	`METHOD_PREFIX_HAS` Method prefixes for "Has" methods.
`protected static String`	`METHOD_PREFIX_IS` Method prefixes for "Is" methods.
`protected static String`	`METHOD_PREFIX_SET` Method prefixes for "Set" methods.
`static int`	`READ_METHOD` The Read / Getter method flag.
`static int`	`READ_WRITE_METHODS` The Read and Write methods flags.
`static int`	`WRITE_METHOD` The Write / Setter method flag.

Fields inherited from interface org.exolab.castor.builder.info.XMLInfo
CHOICE_NODE_NAME_ERROR_INDICATION

Constructor Summary

Constructors
Constructor and Description
`FieldInfo(XSType type, String name, FieldMemberAndAccessorFactory memberAndAccessorFactory)` Creates a new FieldInfo with the given XML Schema type and the given member name.

Method Summary

Methods
Modifier and Type	Method and Description
`void`	`addNature(String nature)` Adds a specified nature.
`String`	`getComment()` Returns the comment associated with this Member.
`ClassInfo`	`getDeclaringClassInfo()` Returns the ClassInfo to which this Member was declared, for inheritance reasons.
`String`	`getDefaultValue()` Returns the default value for this FieldInfo.
`String`	`getDeleteMethodName()` Returns the name of the delete method for this FieldInfo.
`FieldInfo`	`getFieldInfoReference()` Returns the reference to the `FieldInfo` instance within the same class.
`String`	`getFixedValue()` Returns the fixed production for this FieldInfo, or null if no fixed value has been specified.
`String`	`getHasMethodName()` Returns the name of the has method for this FieldInfo.
`String`	`getIsMethodName()` Get the 'is' method for this FieldInfo.
`FieldMemberAndAccessorFactory`	`getMemberAndAccessorFactory()` Returns the FieldMemberAndAccessorFactory instance to use to create a JField out of this FieldInfo.
`int`	`getMethods()` Returns the methods flag that indicates which.
`String`	`getMethodSuffix()` Returns the method suffix for creating method names.
`String`	`getName()` Returns the name of this FieldInfo.
`Object`	`getProperty(String name)` Get a property by its name.
`String`	`getReadMethodName()` Returns the name of the read method for this FieldInfo.
`List<String>`	`getSubstitutionGroupMembers()` Returns the possible substitution groups for this class.
`String`	`getValidator()` Returns the fully qualified name of the Validator to use.
`Object`	`getVisibility()` Returns this field's 'visibility'.
`String`	`getWriteMethodName()` Returns the name of the write method for this FieldInfo.
`String`	`getXMLFieldHandler()` Returns the fully qualified name of the XMLFieldHandler to use.
`boolean`	`hasNature(String nature)` Checks if a specified nature has been added.
`boolean`	`isBound()` Returns true if this FieldInfo represents a bound property.
`boolean`	`isContainer()` Returns true if this FieldInfo describes a container class.
`boolean`	`isFinal()` Indicates whether this field is final.
`boolean`	`isNillable()` Returns true if this field represents a nillable field.
`boolean`	`isStatic()` Indicates whether this field is static.
`boolean`	`isTransient()` Returns true if this FieldInfo is a transient member.
`boolean`	`requiresHasAndDeleteMethods()` Returns true if the "has" and "delete" methods are needed for the field associated with this FieldInfo.
`void`	`setBound(boolean bound)` Sets whether or not this FieldInfo represents a bound property.
`void`	`setComment(String comment)` Sets the comment for this Member.
`void`	`setContainer(boolean isContainer)` Sets whether or not this FieldInfo describes a container field.
`void`	`setDeclaringClassInfo(ClassInfo declaringClassInfo)` Sets the `ClassInfo` of the class that declares this field.
`void`	`setDefaultValue(String defaultValue)` Sets the default value for this FieldInfo.
`void`	`setFieldInfoReference(FieldInfo fieldInfo)` Sets the name of the field within the same class that is a reference to this field.
`void`	`setFinal(boolean isFinal)` Sets the "final" status of this FieldInfo.
`void`	`setFixedValue(String fixedValue)` Sets the fixed value in which instances of this field type must lexically match.
`void`	`setMethods(int methods)` Sets which methods to create: READ_METHOD, WRITE_METHOD, READ_WRITE_METHODS.
`void`	`setNillable(boolean nillable)` Sets whether or not this field can be nillable.
`void`	`setProperty(String name, Object value)` Set a property specified by the name to the passed value.
`void`	`setStatic(boolean isStatic)` Sets the "static" status of this FieldInfo.
`void`	`setSubstitutionGroupMembers(List<String> substitutionGroupMembers)` Sets the possible substitution groups for this class.
`void`	`setTransient(boolean isTransient)` Sets the transient status of this FieldInfo.
`void`	`setValidator(String validator)` Sets the name of the Validator to use.
`void`	`setVisibility(String visibility)` Sets the visibility of this FieldInfo.
`void`	`setXMLFieldHandler(String handler)` Sets the name of the XMLfieldHandler to use.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - READ_METHOD
```
public static final int READ_METHOD
```
    The Read / Getter method flag.
    
    See Also:
    Constant Field Values
  - WRITE_METHOD
```
public static final int WRITE_METHOD
```
    The Write / Setter method flag.
    
    See Also:
    Constant Field Values
  - READ_WRITE_METHODS
```
public static final int READ_WRITE_METHODS
```
    The Read and Write methods flags.
    
    See Also:
    Constant Field Values
  - METHOD_PREFIX_ADD
```
protected static final String METHOD_PREFIX_ADD
```
    Method prefixes for "Add" methods.
    
    See Also:
    Constant Field Values
  - METHOD_PREFIX_DELETE
```
protected static final String METHOD_PREFIX_DELETE
```
    Method prefixes for "Delete" methods.
    
    See Also:
    Constant Field Values
  - METHOD_PREFIX_GET
```
protected static final String METHOD_PREFIX_GET
```
    Method prefixes for "Get" methods.
    
    See Also:
    Constant Field Values
  - METHOD_PREFIX_HAS
```
protected static final String METHOD_PREFIX_HAS
```
    Method prefixes for "Has" methods.
    
    See Also:
    Constant Field Values
  - METHOD_PREFIX_SET
```
protected static final String METHOD_PREFIX_SET
```
    Method prefixes for "Set" methods.
    
    See Also:
    Constant Field Values
  - METHOD_PREFIX_IS
```
protected static final String METHOD_PREFIX_IS
```
    Method prefixes for "Is" methods.
    
    See Also:
    Constant Field Values
- Constructor Detail
  - FieldInfo
```
public FieldInfo(XSType type,
         String name,
         FieldMemberAndAccessorFactory memberAndAccessorFactory)
```
    Creates a new FieldInfo with the given XML Schema type and the given member name. Adds the XMLInfoNature for legacy compliance.
    
    Parameters:
    type - the XML Schema type of this member
    name - the name of the member
    memberAndAccessorFactory - the FieldMemberAndAccessorFactory to be used
- Method Detail
  - getMemberAndAccessorFactory
```
public FieldMemberAndAccessorFactory getMemberAndAccessorFactory()
```
    Returns the FieldMemberAndAccessorFactory instance to use to create a JField out of this FieldInfo.
    
    Returns:
    the suitable FieldMemberAndAccessorFactory
  - getDefaultValue
```
public final String getDefaultValue()
```
    Returns the default value for this FieldInfo.
    
    Returns:
    the default value for this FieldInfo, or null if no default value was set;
  - getFixedValue
```
public final String getFixedValue()
```
    Returns the fixed production for this FieldInfo, or null if no fixed value has been specified.
    NOTE: Fixed values are NOT the same as default values
    
    Returns:
    the fixed value for this FieldInfo
  - getDeleteMethodName
```
public final String getDeleteMethodName()
```
    Returns the name of the delete method for this FieldInfo.
    
    Returns:
    the name of the delete method for this FieldInfo.
  - getHasMethodName
```
public final String getHasMethodName()
```
    Returns the name of the has method for this FieldInfo.
    
    Returns:
    the name of the has method for this FieldInfo.
  - getReadMethodName
```
public final String getReadMethodName()
```
    Returns the name of the read method for this FieldInfo.
    
    Returns:
    the name of the read method for this FieldInfo.
  - getValidator
```
public final String getValidator()
```
    Returns the fully qualified name of the Validator to use.
    
    Returns:
    the fully qualified name of the Validator to use.
  - getWriteMethodName
```
public final String getWriteMethodName()
```
    Returns the name of the write method for this FieldInfo.
    
    Returns:
    the name of the write method for this FieldInfo.
  - getIsMethodName
```
public final String getIsMethodName()
```
    Get the 'is' method for this FieldInfo.
    
    Returns:
    the name of the 'is' method for this FieldInfo
  - getXMLFieldHandler
```
public final String getXMLFieldHandler()
```
    Returns the fully qualified name of the XMLFieldHandler to use.
    
    Returns:
    the fully qualified name of the XMLFieldHandler to use.
  - getComment
```
public final String getComment()
```
    Returns the comment associated with this Member.
    
    Returns:
    the comment associated with this Member, or null. if one has not been set.
  - getMethods
```
public final int getMethods()
```
    Returns the methods flag that indicates which. methods will be created.
    
    Returns:
    the methods flag
  - getName
```
public final String getName()
```
    Returns the name of this FieldInfo.
    
    Returns:
    the name of this FieldInfo.
  - isBound
```
public final boolean isBound()
```
    Returns true if this FieldInfo represents a bound property.
    
    Returns:
    true if this FieldInfo represents a bound property.
  - isContainer
```
public final boolean isContainer()
```
    Returns true if this FieldInfo describes a container class. A container class is a class which should not be marshalled as XML, but whose members should be.
    
    Returns:
    true if this ClassInfo describes a container class.
  - requiresHasAndDeleteMethods
```
public final boolean requiresHasAndDeleteMethods()
```
    Returns true if the "has" and "delete" methods are needed for the field associated with this FieldInfo.
    
    Returns:
    true if the has and delete methods are needed.
  - isNillable
```
public final boolean isNillable()
```
    Returns true if this field represents a nillable field. A nillable field is a field that can have null content (see XML Schema 1.0 definition of nillable).
    
    Returns:
    true if nillable, otherwise false.
    See Also:
    setNillable(boolean)
  - isTransient
```
public final boolean isTransient()
```
    Returns true if this FieldInfo is a transient member. Transient members are members which should be ignored by the Marshalling framework.
    
    Returns:
    true if this FieldInfo is transient.
  - setComment
```
public final void setComment(String comment)
```
    Sets the comment for this Member.
    
    Parameters:
    comment - the comment or description for this Member
  - getDeclaringClassInfo
```
public final ClassInfo getDeclaringClassInfo()
```
    Returns the ClassInfo to which this Member was declared, for inheritance reasons.
    
    Returns:
    the ClassInfo to which this Member was declared.
  - setBound
```
public final void setBound(boolean bound)
```
    Sets whether or not this FieldInfo represents a bound property.
    
    Parameters:
    bound - the flag when true indicates that this FieldInfo represents a bound property.
  - setContainer
```
public final void setContainer(boolean isContainer)
```
    Sets whether or not this FieldInfo describes a container field. A container field is a field which should not be marshalled directly as XML, but whose members should be. By default this is false.
    
    Parameters:
    isContainer - the boolean value when true indicates this class should be a container class.
  - setDeclaringClassInfo
```
public final void setDeclaringClassInfo(ClassInfo declaringClassInfo)
```
    Sets the ClassInfo of the class that declares this field.
    
    Parameters:
    declaringClassInfo - The ClassInfo of the declaring class.
  - setDefaultValue
```
public final void setDefaultValue(String defaultValue)
```
    Sets the default value for this FieldInfo.
    
    Parameters:
    defaultValue - the default value
  - setFinal
```
public final void setFinal(boolean isFinal)
```
    Sets the "final" status of this FieldInfo. Final members are also transient.
    
    Parameters:
    isFinal - the boolean indicating the final status, if true this FieldInfo will be treated as final.
  - setFixedValue
```
public final void setFixedValue(String fixedValue)
```
    Sets the fixed value in which instances of this field type must lexically match. NOTE: This is not the same as default value!
    
    Parameters:
    fixedValue - the fixed production for this FieldInfo
  - setMethods
```
public final void setMethods(int methods)
```
    Sets which methods to create: READ_METHOD, WRITE_METHOD, READ_WRITE_METHODS.
    
    Parameters:
    methods - a flag describing which methods to create.
  - setNillable
```
public final void setNillable(boolean nillable)
```
    Sets whether or not this field can be nillable.
    
    Parameters:
    nillable - a boolean that when true means the field may be nil.
    See Also:
    isNillable()
  - setFieldInfoReference
```
public final void setFieldInfoReference(FieldInfo fieldInfo)
```
    Sets the name of the field within the same class that is a reference to this field.
    
    Parameters:
    fieldInfo - FieldInfo for the referencing field (within the same class).
  - setStatic
```
public final void setStatic(boolean isStatic)
```
    Sets the "static" status of this FieldInfo. Static members are also transient.
    
    Parameters:
    isStatic - the boolean indicating the static status, if true this FieldInfo will be treated as static
  - setTransient
```
public final void setTransient(boolean isTransient)
```
    Sets the transient status of this FieldInfo.
    
    Parameters:
    isTransient - the boolean indicating the transient status, if true this FieldInfo will be treated as transient
  - setValidator
```
public final void setValidator(String validator)
```
    Sets the name of the Validator to use.
    
    Parameters:
    validator - the fully qualified name of the validator to use.
  - setXMLFieldHandler
```
public final void setXMLFieldHandler(String handler)
```
    Sets the name of the XMLfieldHandler to use.
    
    Parameters:
    handler - the fully qualified name of the handler to use.
  - getMethodSuffix
```
public String getMethodSuffix()
```
    Returns the method suffix for creating method names.
    
    Returns:
    the method suffix used when creating method names.
  - setVisibility
```
public final void setVisibility(String visibility)
```
    Sets the visibility of this FieldInfo.
    
    Parameters:
    visibility - the visibility of this FieldInfo.
  - setSubstitutionGroupMembers
```
public void setSubstitutionGroupMembers(List<String> substitutionGroupMembers)
```
    Sets the possible substitution groups for this class.
    
    Parameters:
    substitutionGroupMembers - Possible substitution groups for this class.
  - getSubstitutionGroupMembers
```
public List<String> getSubstitutionGroupMembers()
```
    Returns the possible substitution groups for this class.
    
    Returns:
    the possible substitution groups for this class.
  - isStatic
```
public boolean isStatic()
```
    Indicates whether this field is static.
    
    Returns:
    True if this field is static.
  - isFinal
```
public boolean isFinal()
```
    Indicates whether this field is final.
    
    Returns:
    True if this field is final.
  - getVisibility
```
public Object getVisibility()
```
    Returns this field's 'visibility'.
    
    Returns:
    This field's visibility.
  - getFieldInfoReference
```
public FieldInfo getFieldInfoReference()
```
    Returns the reference to the FieldInfo instance within the same class.
    
    Returns:
    the reference to the FieldInfo instance
  - getProperty
```
public final Object getProperty(String name)
```
    Description copied from interface: PropertyHolder
    
    Get a property by its name.
    
    Specified by:
    
    getProperty in interface PropertyHolder
    
    Parameters:
    name - of the property
    
    Returns:
    value of the property
    See Also:
    getProperty(java.lang.String)
  - setProperty
```
public final void setProperty(String name,
               Object value)
```
    Description copied from interface: PropertyHolder
    
    Set a property specified by the name to the passed value.
    
    Specified by:
    
    setProperty in interface PropertyHolder
    
    Parameters:
    name - of the property
    value - of the property
    See Also:
    setProperty(java.lang.String, java.lang.Object)
  - addNature
```
public final void addNature(String nature)
```
    Description copied from interface: NatureExtendable
    
    Adds a specified nature.
    
    Specified by:
    
    addNature in interface NatureExtendable
    
    Parameters:
    nature - ID of the Nature
    See Also:
    addNature(java.lang.String)
  - hasNature
```
public final boolean hasNature(String nature)
```
    Description copied from interface: NatureExtendable
    
    Checks if a specified nature has been added.
    
    Specified by:
    
    hasNature in interface NatureExtendable
    
    Parameters:
    nature - ID of the Nature
    
    Returns:
    true if the Nature ID was added.
    See Also:
    hasNature(java.lang.String)

Class FieldInfo

Field Summary

Fields inherited from interface org.exolab.castor.builder.info.XMLInfo

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

READ_METHOD

WRITE_METHOD

READ_WRITE_METHODS

METHOD_PREFIX_ADD

METHOD_PREFIX_DELETE

METHOD_PREFIX_GET

METHOD_PREFIX_HAS

METHOD_PREFIX_SET

METHOD_PREFIX_IS

Constructor Detail

FieldInfo

Method Detail

getMemberAndAccessorFactory

getDefaultValue

getFixedValue

getDeleteMethodName

getHasMethodName

getReadMethodName

getValidator

getWriteMethodName

getIsMethodName

getXMLFieldHandler

getComment

getMethods

getName

isBound

isContainer

requiresHasAndDeleteMethods

isNillable

isTransient

setComment

getDeclaringClassInfo

setBound

setContainer

setDeclaringClassInfo

setDefaultValue

setFinal

setFixedValue

setMethods

setNillable

setFieldInfoReference

setStatic

setTransient

setValidator

setXMLFieldHandler

getMethodSuffix

setVisibility

setSubstitutionGroupMembers

getSubstitutionGroupMembers

isStatic

isFinal

getVisibility

getFieldInfoReference

getProperty

setProperty

addNature

hasNature