com.codestreet.messageforge
Class RFldI64

java.lang.Object
  com.codestreet.messageforge.RFld
      com.codestreet.messageforge.RFldNumeric
          com.codestreet.messageforge.RFldI64

All Implemented Interfaces:

RFldInterface, java.io.Serializable

public class RFldI64

extends RFldNumeric

Class to represent a long field.

Author:

Jawaid Hakim.

See Also:

Serialized Form

Field Summary

protected java.lang.Long	dataObj_ Data.
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

RFldI64()
Default constructor.

RFldI64(java.lang.String name, int fieldId)
Constructor.

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

Method Summary

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.
long	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() Return the 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(long newData) Set data.
RFld	set(java.lang.Long newData) Set data.
RFld	set(java.lang.Object 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(RFld fld, long newData) Check if a new value will satifsy constraints.

Methods inherited from class com.codestreet.messageforge.RFldNumeric

addConstraint, validType

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.

dataObj_

protected java.lang.Long dataObj_

Data.

Constructor Detail

RFldI64

public RFldI64()

Default constructor.

RFldI64

public RFldI64(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.

RFldI64

public RFldI64(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 I64.

See Also:

RFldType

equals

public final 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.

Specified by:

equals in class RFld

Parameters:

anObject - Another field.

Returns:

true if another field is equal to this field. Otherwise, returns false.

hashCode

public final int hashCode()

Return the hash code value for the field. Uses the same technique as in java.lang.Long. The following javadoc comments taken from there. Computes a hashcode for this Long. The result is the exclusive OR of the two halves of the primitive long value represented by this Long object. That is, the hashcode is the value of the expression:

 (int)(getValue()^(getValue()>>32))
 

Specified by:

hashCode in class RFld

Returns:

a hash code value for the field

reset

public final void reset()
                 throws FieldValidationException

Reset the field value.

Specified by:

reset in class RFld

Throws:

FieldValidationException

See Also:

RFld.isValSet()

set

public final 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(long newData)
               throws FieldValidationException

Set data.

Parameters:

newData - New data.

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 final RFld set(java.lang.Long newData)
               throws FieldValidationException

Set data.

Parameters:

newData - New data.

Throws:

java.lang.NullPointerException - if the new data is null.

FieldValidationException

validate

public final 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 final void validate(RFld fld,
                           long newData)
                    throws FieldValidationException

Check if a new value will satifsy constraints.

Parameters:

newData - New value.

Throws:

FieldValidationException

getValue

public final long getValue()

Get data.

Returns:

data Data.

Throws:

java.lang.NullPointerException - if the field valuehas not been set.

getValueAsObject

public final java.lang.Object getValueAsObject()

Get the field value as an object.

Returns:

Field value as an object. Returns null if the field value has not been set.

getValueAsString

public final java.lang.String getValueAsString()

Get the field value as a string.

Specified by:

getValueAsString in class RFld

Returns:

Field value as a string.

Throws:

java.lang.NullPointerException - if the field valuehas not been set.

getValueAsHashtable

public final 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.