com.codestreet.messageforge
Class RFldString

java.lang.Object
  extended bycom.codestreet.messageforge.RFld
      extended bycom.codestreet.messageforge.RFldString
All Implemented Interfaces:
RFldInterface, java.io.Serializable

public class RFldString
extends RFld

Class to represent a String field.

Author:
Jawaid Hakim.
See Also:
Serialized Form

Field Summary
protected  java.lang.String dataObj_
          Data.
static java.lang.String NA_VALUE
          Not Available - if a field has this marker value, then it implies that the value of the field is not available.
protected static java.lang.String XML_TAG
          XML tag for this element type.
 
Fields inherited from class com.codestreet.messageforge.RFld
desc_, fieldId_, locked_, name_, optional_, propertyName_, tags_, transient_, valSet_
 
Constructor Summary
RFldString()
          Default constructor.
RFldString(java.lang.String name, int fieldId)
          Constructor.
RFldString(java.lang.String name, int fieldId, java.lang.String desc)
          Constructor.
 
Method Summary
 void addConstraint(RFldConstraintString cons)
          Add a constraint.
 boolean equals(java.lang.Object anObject)
          Check if another field is equal to this field.
 java.lang.String getTag()
          Get the XML tag for this field type.
 RFldType getType()
          Get field type.
 java.lang.String getValue()
          Get data.
 java.util.Hashtable getValueAsHashtable()
          Get the field value as a java.util.Hashtable.
 java.lang.Object getValueAsObject()
          Get the field value as an object.
 java.lang.String getValueAsString()
          Get the field value as a string.
 int hashCode()
          Returns a hash code value for the field.
 void reset()
          Reset the field value.
 RFld set(org.jdom.Element elem)
          Set the field value from a JDOM element.
 RFld set(java.lang.Object newData)
          Set data.
 RFld set(java.lang.String newData)
          Set data.
static void setTag(java.lang.String tag)
          Set the XML tag for this field type.
 void validate()
          Validate against constraints.
 void validate(java.lang.String newData)
          Check if a new value will satifsy constraints.
 
Methods inherited from class com.codestreet.messageforge.RFld
addConstraint, buildMinMaxConstraintKey, getConstraint, getConstraintCount, getDesc, getId, getName, getOptional, getPropertyName, getTags, getTransient, isConstrained, isLocked, isProperty, isValSet, marshal, marshal, setId, setLocked, setName, setOptional, setPropertyName, setTags, setTransient, setXmlAttrNames, setXmlTags
 
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

XML_TAG

protected static transient java.lang.String XML_TAG
XML tag for this element type.


NA_VALUE

public static final transient java.lang.String NA_VALUE
Not Available - if a field has this marker value, then it implies that the value of the field is not available.

See Also:
Constant Field Values

dataObj_

protected java.lang.String dataObj_
Data.

Constructor Detail

RFldString

public RFldString()
Default constructor.


RFldString

public RFldString(java.lang.String name,
                  int fieldId)
Constructor.

Parameters:
name - Field name.
fieldId - Field id. Field ids must be either 0 to indicate that there is no id on the field, or greater. In addition, field ids must be unique within a messages - no two fields are allowed to have the same field id.

RFldString

public RFldString(java.lang.String name,
                  int fieldId,
                  java.lang.String desc)
Constructor.

Parameters:
name - Field name.
fieldId - Field id. Field ids must be either 0 to indicate that there is no id on the field, or greater. In addition, field ids must be unique within a messages - no two fields are allowed to have the same field id.
desc - Field description.
Method Detail

getType

public final RFldType getType()
Get field type.

Specified by:
getType in interface RFldInterface
Specified by:
getType in class RFld
Returns:
Field type STRING.
See Also:
RFldType

equals

public boolean equals(java.lang.Object anObject)
Check if another field is equal to this field. Equality is defined as the fields having the same value - the comparison is case-sensitive.

Specified by:
equals in class RFld
Parameters:
anObject - Another field.
Returns:
true if another message is equal to this message. Otherwise, returns false.

hashCode

public int hashCode()
Returns a hash code value for the field.

Specified by:
hashCode in class RFld
Returns:
a hash code value for the field, uses the java.lang.String hashCode method to compute the value.

addConstraint

public void addConstraint(RFldConstraintString cons)
                   throws FieldValidationException
Add a constraint.

Parameters:
cons - Constraint.
Throws:
FieldValidationException

reset

public void reset()
           throws FieldValidationException
Reset the field value.

Specified by:
reset in class RFld
Throws:
FieldValidationException
See Also:
RFld.isValSet()

set

public RFld set(java.lang.Object newData)
         throws FieldValidationException
Set data.

Specified by:
set in interface RFldInterface
Specified by:
set in class RFld
Parameters:
newData - New data.
Returns:
Reference to self so method chaining can be used.
Throws:
FieldValidationException

set

public final RFld set(org.jdom.Element elem)
               throws FieldValidationException
Set the field value from a JDOM element.

Specified by:
set in interface RFldInterface
Specified by:
set in class RFld
Parameters:
elem - Field value as a JDOM element.
Returns:
Reference to self so method chaining can be used.
Throws:
FieldValidationException

set

public RFld set(java.lang.String newData)
         throws FieldValidationException
Set data.

Parameters:
newData - New data.
Throws:
FieldValidationException

validate

public void validate()
              throws FieldValidationException
Validate against constraints. A field is valid if either it's value is set and satisfies all constraints, or the the field is optional.

Specified by:
validate in class RFld
Throws:
FieldValidationException

validate

public void validate(java.lang.String newData)
              throws FieldValidationException
Check if a new value will satifsy constraints.

Parameters:
newData - New value.
Throws:
FieldValidationException

getValue

public java.lang.String getValue()
Get data.

Returns:
data Data. Returns null if the field value is not set.

getValueAsObject

public java.lang.Object getValueAsObject()
Get the field value as an object.

Returns:
Field value as an object. Returns null if the field value is not set.

getValueAsString

public java.lang.String getValueAsString()
Get the field value as a string.

Specified by:
getValueAsString in class RFld
Returns:
Field value as a string. Returns null if the field value is not set.

getValueAsHashtable

public java.util.Hashtable getValueAsHashtable()
                                        throws FieldValidationException
Get the field value as a java.util.Hashtable. Not supported - throws an exception.

Returns:
Field value as java.util.Hashtable. Returns null if the field value is not set.
Throws:
FieldValidationException

getTag

public final java.lang.String getTag()
Get the XML tag for this field type.

Specified by:
getTag in class RFld
Returns:
XML tag for this field type.

setTag

public static void setTag(java.lang.String tag)
Set the XML tag for this field type.

Parameters:
tag - New XML tag for this field type.


Copyright © 2003-2006 CodeStreet. All Rights Reserved.