Package org.apache.uima.cas

Interface FeatureStructure

All Known Subinterfaces:

AnnotationBaseFS, AnnotationFS, ArrayFS, BooleanArrayFS, ByteArrayFS, CommonArrayFS, DoubleArrayFS, FloatArrayFS, IntArrayFS, LongArrayFS, ShortArrayFS, SofaFS, StringArrayFS

All Known Implementing Classes:

Annotation, AnnotationBase, AnnotationBaseImpl, AnnotationImpl, ArrayFSImpl, BooleanArray, BooleanArrayFSImpl, ByteArray, ByteArrayFSImpl, CommonArrayFSImpl, CommonAuxArrayFSImpl, DocumentAnnotation, DoubleArray, DoubleArrayFSImpl, EmptyFloatList, EmptyFSList, EmptyIntegerList, EmptyStringList, FeatureStructureImpl, FeatureStructureImplC, FloatArray, FloatArrayFSImpl, FloatList, FSArray, FSList, IntArrayFSImpl, IntegerArray, IntegerList, LongArray, LongArrayFSImpl, NonEmptyFloatList, NonEmptyFSList, NonEmptyIntegerList, NonEmptyStringList, ShortArray, ShortArrayFSImpl, Sofa, SofaFSImpl, SourceDocumentInformation, StringArray, StringArrayFSImpl, StringList, TOP

public interface FeatureStructure

Interface for feature structures.

Note that object identity is not meaningful for feature structures. You may ask the CAS for the same feature structure two times in a row, and get different object references. Use equals() instead.

Method Summary

Modifier and Type	Method	Description
java.lang.Object	clone()	Creates a copy of this feature structure.
boolean	equals(java.lang.Object o)	A feature structure is equal to another feature structure iff it is identical in the underlying representation.
boolean	getBooleanValue(Feature feat)	Get the boolean value of a feature.
byte	getByteValue(Feature feat)	Get the byte value of a feature.
CAS	getCAS()	Return the CAS that this FS belongs to.
double	getDoubleValue(Feature feat)	Get the double value of a feature.
FeatureStructure	getFeatureValue(Feature feat)	Get a feature value.
java.lang.String	getFeatureValueAsString(Feature feat)	Get the value of the feature as a string if the type of the feature is one of the primitive type.
float	getFloatValue(Feature feat)	Get the float value of a feature.
int	getIntValue(Feature feat)	Get the int value of a feature.
long	getLongValue(Feature feat)	Get the long value of a feature.
short	getShortValue(Feature feat)	Get the short value of a feature.
java.lang.String	getStringValue(Feature f)	Get the string value under a feature.
Type	getType()	Get the type of this FS.
int	hashCode()	Will return a hash code that's consistent with equality, i.e., if two FSs are equal, they will also return the same hash code.
void	setBooleanValue(Feature feat, boolean i)	Set the boolean value of a feature.
void	setByteValue(Feature feat, byte i)	Set the byte (8 bit) value of a feature.
void	setDoubleValue(Feature feat, double i)	Set the double value of a feature.
void	setFeatureValue(Feature feat, FeatureStructure fs)	Set a feature value to another FS.
void	setFeatureValueFromString(Feature feat, java.lang.String s)	Sets the value of a feature from a string input if the feature type is one of the primitive types.
void	setFloatValue(Feature feat, float f)	Set the float value of a feature.
void	setIntValue(Feature feat, int i)	Set the int value of a feature.
void	setLongValue(Feature feat, long i)	Set the long (64 bit) value of a feature.
void	setShortValue(Feature feat, short i)	Set the short (16 bit) value of a feature.
void	setStringValue(Feature feat, java.lang.String s)	Set the string value of a feature.

Method Detail

getType

Type getType()

Get the type of this FS.

Returns:

The type.

setFeatureValue

void setFeatureValue(Feature feat,
                     FeatureStructure fs)
              throws CASRuntimeException

Set a feature value to another FS.

Parameters:

feat - The feature whose value should be set.

fs - The value FS.

Throws:

CASRuntimeException - If there is a typing violation, i.e., if feat is not defined for the type of this FS, or the range type of feat is not a supertype of fs.getType().

getFeatureValue

FeatureStructure getFeatureValue(Feature feat)
                          throws CASRuntimeException

Get a feature value.

Parameters:

feat - The feature whose value we want to get.

Returns:

The value; may be null if the value has not been set.

Throws:

CASRuntimeException - If there is a typing violation, i.e., if feat is not defined for the type of this FS, or the range type of feat is Float, Integer or String.

setStringValue

void setStringValue(Feature feat,
                    java.lang.String s)
             throws CASRuntimeException

Set the string value of a feature.

Parameters:

feat - The feature whose value we want to set.

s - The string we're setting the feature to.

Throws:

CASRuntimeException - If there is a typing violation, i.e., if feat is not defined for this.getType() or feat.getRange() is not CAS.STRING_TYPE.

getStringValue

java.lang.String getStringValue(Feature f)
                         throws CASRuntimeException

Get the string value under a feature.

Parameters:

f - The feature for which we want the value.

Returns:

The value of this feature; may be null if the value has not been set.

Throws:

CASRuntimeException - If there is a typing violation, i.e., if f is not defined for the type of this feature structure, or if the range type of f is not String.

getFloatValue

float getFloatValue(Feature feat)
             throws CASRuntimeException

Get the float value of a feature. This method will throw an exception if the feature is not float valued.

Parameters:

feat - The feature whose value we want to get.

Returns:

The value float; 0.0 if the value has not been set.

Throws:

CASRuntimeException - If feat is not defined for the type of this FS, or if it is not float valued.

setFloatValue

void setFloatValue(Feature feat,
                   float f)
            throws CASRuntimeException

Set the float value of a feature.

Parameters:

feat - The feature whose value we want to set.

f - The float we're setting the feature to.

Throws:

CASRuntimeException - If feat is not defined for the type of this FS, or if it is not float valued.

getIntValue

int getIntValue(Feature feat)
         throws CASRuntimeException

Get the int value of a feature. This method will throw an exception if the feature is not int valued.

Parameters:

feat - The feature whose value we want to get.

Returns:

The value int; 0 if the value has not been set.

Throws:

CASRuntimeException - If feat is not defined for the type of this FS, or if it is not int valued.

setIntValue

void setIntValue(Feature feat,
                 int i)
          throws CASRuntimeException

Set the int value of a feature.

Parameters:

feat - The feature whose value we want to set.

i - The int we're setting the feature to.

Throws:

CASRuntimeException

getByteValue

byte getByteValue(Feature feat)
           throws CASRuntimeException

Get the byte value of a feature. This method will throw an exception if the feature is not byte valued.

Parameters:

feat - The feature whose value we want to set.

Returns:

The value byte; 0 if the value has not been set.

Throws:

CASRuntimeException - tbd

setByteValue

void setByteValue(Feature feat,
                  byte i)
           throws CASRuntimeException

Set the byte (8 bit) value of a feature.

Parameters:

feat - The feature whose value we want to set.

i - The 8bit value we're setting the feature to.

Throws:

CASRuntimeException - tbd

getBooleanValue

boolean getBooleanValue(Feature feat)
                 throws CASRuntimeException

Get the boolean value of a feature. This method will throw an exception if the feature is not boolean valued.

Parameters:

feat - The feature whose value we want to get.

Returns:

The value int; 0 if the value has not been set.

Throws:

CASRuntimeException - If feat is not defined for the type of this FS, or if it is not boolean valued.

setBooleanValue

void setBooleanValue(Feature feat,
                     boolean i)
              throws CASRuntimeException

Set the boolean value of a feature.

Parameters:

feat - The feature whose value we want to set.

i - The boolean value we're setting the feature to.

Throws:

CASRuntimeException

getShortValue

short getShortValue(Feature feat)
             throws CASRuntimeException

Get the short value of a feature. This method will throw an exception if the feature is not short valued.

Parameters:

feat - The feature whose value we want to get.

Returns:

The value int; 0 if the value has not been set.

Throws:

CASRuntimeException - If feat is not defined for the type of this FS, or if it is not short valued.

setShortValue

void setShortValue(Feature feat,
                   short i)
            throws CASRuntimeException

Set the short (16 bit) value of a feature.

Parameters:

feat - The feature whose value we want to set.

i - The short (16bit) value we're setting the feature to.

Throws:

CASRuntimeException

getLongValue

long getLongValue(Feature feat)
           throws CASRuntimeException

Get the long value of a feature. This method will throw an exception if the feature is not long valued.

Parameters:

feat - The feature whose value we want to get.

Returns:

The value int; 0 if the value has not been set.

Throws:

CASRuntimeException - If feat is not defined for the type of this FS, or if it is not long valued.

setLongValue

void setLongValue(Feature feat,
                  long i)
           throws CASRuntimeException

Set the long (64 bit) value of a feature.

Parameters:

feat - The feature whose value we want to set.

i - The long (64bit) value we're setting the feature to.

Throws:

CASRuntimeException

getDoubleValue

double getDoubleValue(Feature feat)
               throws CASRuntimeException

Get the double value of a feature. This method will throw an exception if the feature is not double valued.

Parameters:

feat - The feature whose value we want to get.

Returns:

The value int; 0 if the value has not been set.

Throws:

CASRuntimeException - If feat is not defined for the type of this FS, or if it is not double valued.

setDoubleValue

void setDoubleValue(Feature feat,
                    double i)
             throws CASRuntimeException

Set the double value of a feature.

Parameters:

feat - The feature whose value we want to set.

i - The double value we're setting the feature to.

Throws:

CASRuntimeException

getFeatureValueAsString

java.lang.String getFeatureValueAsString(Feature feat)
                                  throws CASRuntimeException

Get the value of the feature as a string if the type of the feature is one of the primitive type.

Parameters:

feat - The feature whose value we want to get and whose type is one of the primitve types.

Returns:

A string representation of the feature value.

Throws:

CASRuntimeException - If feat is not defined for the type of this FS, or if the type is not a primitive type.

setFeatureValueFromString

void setFeatureValueFromString(Feature feat,
                               java.lang.String s)
                        throws CASRuntimeException

Sets the value of a feature from a string input if the feature type is one of the primitive types.

Parameters:

feat - The feature whose value we want to set.

s - The string value that the feature will be set to.

Throws:

CASRuntimeException - If feat is not a primitive type or the value cannot be converted to this type.

equals

boolean equals(java.lang.Object o)
        throws java.lang.ClassCastException

A feature structure is equal to another feature structure iff it is identical in the underlying representation.

Overrides:

equals in class java.lang.Object

Throws:

java.lang.ClassCastException - If o is not a FS.

clone

java.lang.Object clone()
                throws CASRuntimeException

Creates a copy of this feature structure. The returned feature structure is a new and separate object but all features of the feature structure which are not of builtin types (integer, float, string) will be shared between the clone and it's source FS.

Returns:

a FeatureStructure that is the cloned copy of this FeatureStructure.

Throws:

CASRuntimeException - passthru

hashCode

int hashCode()

Will return a hash code that's consistent with equality, i.e., if two FSs are equal, they will also return the same hash code.

Overrides:

hashCode in class java.lang.Object

Returns:

The hash code.

getCAS

CAS getCAS()

Return the CAS that this FS belongs to.

Returns:

The CAS.