Feature

All Known Subinterfaces:

EditableFeature, EditableFeature, Feature

All Known Implementing Classes:

DefaultEditableFeature, DefaultFeature
```
public interface Feature
```
Represents the basic data unit of a tabular structure, equivalent to a record in a data base table. In SIG domain, a Feature is a compound data structure that may contain a geographic component. The conventional term Feature comes from the term cartographic feature and both represent the same concept.

A Feature may contain more than one geometry attribute. In the case there is not any geometry data, the getDefaultGeometry() will return null.

Features are not editable as such. To edit a Feature you have to obtain an editable instance EditableFeature using the method getEditable(). Modify that editable instance and then apply the changes to the Feature. This mechanism is to avoid ambiguity and loosing track on the Feature internal state.

The Feature:
- Has an unique identifier FeatureReference to recognize our Feature from each other from the same data store
- Has a FeatureType that describes the Feature characteristics (attributes, data types, default geometry, validation rules).
- Can obtain a copy of itself.
- Can obtain its default geometry attribute and also a list with all the geometry attributes.
- Can obtain its default Spatial Reference System and also a list with all the SRSs used in the geometry attributes.
- Can obtain the envelope (extent) of the default geometry attribute.
- Can obtain the editable instance of the Feature.
- Has a set of utility methods to read attributes when their type is known, by both index and name.

Field Summary

Fields
Modifier and Type	Field and Description
`static int`	`ALL` Mode that indicates the validation of all FeatureRules
`static int`	`FINISH_EDITING` Mode that indicates the validation of the finish editing FeatureRules
`static int`	`UPDATE` Mode that indicates the validation of the update FeatureRules

Method Summary

All Methods Instance Methods Abstract Methods
Modifier and Type	Method and Description
`Object`	`get(int index)` Returns the value of an attribute given its position.
`Object`	`get(String name)` Returns the value of an attribute given its name.
`Object[]`	`getArray(int index)` Returns the array value of an attribute given its position.
`Object[]`	`getArray(String name)` Returns the array value of an attribute given its name.
`DynObject`	`getAsDynObject()`
`boolean`	`getBoolean(int index)` Returns the Boolean value of an attribute given its position.
`boolean`	`getBoolean(String name)` Returns the Boolean value of an attribute given its name.
`byte`	`getByte(int index)` Returns the byte value of an attribute given its position.
`byte`	`getByte(String name)` Returns the byte value of an attribute given its name.
`Feature`	`getCopy()` Creates and returns a copy of this
`Date`	`getDate(int index)` Returns the Date value of an attribute given its position.
`Date`	`getDate(String name)` Returns the Date value of an attribute given its name.
`Envelope`	`getDefaultEnvelope()` Envelope (AKA extent or bounding box) of the default geometry attribute.
`Geometry`	`getDefaultGeometry()` Returns the value of the default geometry attribute, which is a `Geometry`.
`IProjection`	`getDefaultSRS()` Returns the Spatial Reference System in which is expressed the default geometry attribute.
`double`	`getDouble(int index)` Returns the double value of an attribute given its position.
`double`	`getDouble(String name)` Returns the double value of an attribute given its name.
`EditableFeature`	`getEditable()` Returns the editable instance of this Feature.
`EvaluatorData`	`getEvaluatorData()` This lets Feature be used eaily with `Evaluator`
`Feature`	`getFeature(int index)` Returns the Feature value of an attribute given its position.
`Feature`	`getFeature(String name)` Returns the Feature value of an attribute given its name.
`float`	`getFloat(int index)` Returns the float value of an attribute given its position.
`float`	`getFloat(String name)` Returns the float value of an attribute given its name.
`List`	`getGeometries()` Returns a list with the values of this Feature's geometry attributes.
`Geometry`	`getGeometry(int index)` Returns the Geometry value of an attribute given its position.
`Geometry`	`getGeometry(String name)` Returns the Geometry value of an attribute given its name.
`Instant`	`getInstant(int index)` Returns the instant value of an attribute given its position.
`Instant`	`getInstant(String name)` Returns the instant value of an attribute given its name.
`int`	`getInt(int index)` Returns the int value of an attribute given its position.
`int`	`getInt(String name)` Returns the int value of an attribute given its name.
`Interval`	`getInterval(int index)` Returns the interval value of an attribute given its position.
`Interval`	`getInterval(String name)` Returns the interval value of an attribute given its name.
`long`	`getLong(int index)` Returns the long value of an attribute given its position.
`long`	`getLong(String name)` Returns the long value of an attribute given its name.
`FeatureReference`	`getReference()` Returns a unique identifier for this Feature in the associated store.
`List`	`getSRSs()` Returns a list with the Spatial Reference Systems in which are expressed this Feature's geometry attributes.
`FeatureStore`	`getStore()` Return the store associated to this feature.
`String`	`getString(int index)` Returns the String value of an attribute given its position.
`String`	`getString(String name)` Returns the String value of an attribute given its name.
`FeatureType`	`getType()` Returns the FeatureType that describes the structure of this Feature.
`void`	`validate(int mode)` Validates this Feature by applying the `FeatureRules` corresponding to the given mode.

- Field Detail
  - ALL
```
static final int ALL
```
    Mode that indicates the validation of all FeatureRules
    
    See Also:
    
    Constant Field Values
  - UPDATE
```
static final int UPDATE
```
    Mode that indicates the validation of the update FeatureRules
    
    See Also:
    
    Constant Field Values
  - FINISH_EDITING
```
static final int FINISH_EDITING
```
    Mode that indicates the validation of the finish editing FeatureRules
    
    See Also:
    
    Constant Field Values
- Method Detail
  - getReference
```
FeatureReference getReference()
```
    Returns a unique identifier for this Feature in the associated store.
    
    Returns:
    
    a unique FeatureReference in the associated store
  - getType
```
FeatureType getType()
```
    Returns the FeatureType that describes the structure of this Feature.
    
    Returns:
    
    a FeatureType describing this Feature structure.
  - getCopy
```
Feature getCopy()
```
    Creates and returns a copy of this
    
    Returns:
    
    a new instance of Feature which is equal to this
  - validate
```
void validate(int mode)
       throws DataException
```
    Validates this Feature by applying the FeatureRules corresponding to the given mode.
    
    Parameters:
    
    mode - one of the constants {ALL, UPDATE, FINISH_EDITING}
    
    Throws:
    
    DataException - on validation errors
  - getEditable
```
EditableFeature getEditable()
```
    Returns the editable instance of this Feature. EditableFeature offers methods for Feature editing.
    
    Returns:
    
    EditableFeature of this
  - get
```
Object get(String name)
```
    Returns the value of an attribute given its name.
    
    Parameters:
    
    name - a string containing the name of the attribute
    
    Returns:
    
    value of the specified attribute
  - get
```
Object get(int index)
```
    Returns the value of an attribute given its position.
    
    Parameters:
    
    index - position of the attribute
    
    Returns:
    
    value of the specified attribute
  - getInt
```
int getInt(String name)
```
    Returns the int value of an attribute given its name.
    
    Parameters:
    
    name - a string containing the name of the attribute
    
    Returns:
    
    value of the specified attribute
  - getInt
```
int getInt(int index)
```
    Returns the int value of an attribute given its position.
    
    Parameters:
    
    index - position of the attribute
    
    Returns:
    
    value of the specified attribute
  - getBoolean
```
boolean getBoolean(String name)
```
    Returns the Boolean value of an attribute given its name.
    
    Parameters:
    
    name - name of the attribute
    
    Returns:
    
    value of the specified attribute
  - getBoolean
```
boolean getBoolean(int index)
```
    Returns the Boolean value of an attribute given its position.
    
    Parameters:
    
    index - position of the attribute
    
    Returns:
    
    value of the specified attribute
  - getLong
```
long getLong(String name)
```
    Returns the long value of an attribute given its name.
    
    Parameters:
    
    name - name of the attribute
    
    Returns:
    
    value of the specified attribute
  - getLong
```
long getLong(int index)
```
    Returns the long value of an attribute given its position.
    
    Parameters:
    
    index - position of the attribute
    
    Returns:
    
    value of the specified attribute
  - getFloat
```
float getFloat(String name)
```
    Returns the float value of an attribute given its name.
    
    Parameters:
    
    name - name of the attribute
    
    Returns:
    
    value of the specified attribute
  - getFloat
```
float getFloat(int index)
```
    Returns the float value of an attribute given its position.
    
    Parameters:
    
    index - position of the attribute
    
    Returns:
    
    value of the specified attribute
  - getDouble
```
double getDouble(String name)
```
    Returns the double value of an attribute given its name.
    
    Parameters:
    
    name - name of the attribute
    
    Returns:
    
    value of the specified attribute
  - getDouble
```
double getDouble(int index)
```
    Returns the double value of an attribute given its position.
    
    Parameters:
    
    index - position of the attribute
    
    Returns:
    
    value of the specified attribute
  - getDate
```
Date getDate(String name)
```
    Returns the Date value of an attribute given its name.
    
    Parameters:
    
    name - name of the attribute
    
    Returns:
    
    value of the specified attribute
  - getDate
```
Date getDate(int index)
```
    Returns the Date value of an attribute given its position.
    
    Parameters:
    
    index - position of the attribute
    
    Returns:
    
    value of the specified attribute
  - getString
```
String getString(String name)
```
    Returns the String value of an attribute given its name.
    
    Parameters:
    
    name - name of the attribute
    
    Returns:
    
    value of the specified attribute
  - getString
```
String getString(int index)
```
    Returns the String value of an attribute given its position.
    
    Parameters:
    
    index - position of the attribute
    
    Returns:
    
    value of the specified attribute
  - getByte
```
byte getByte(String name)
```
    Returns the byte value of an attribute given its name.
    
    Parameters:
    
    name - name of the attribute
    
    Returns:
    
    value of the specified attribute
  - getByte
```
byte getByte(int index)
```
    Returns the byte value of an attribute given its position.
    
    Parameters:
    
    index - position of the attribute
    
    Returns:
    
    value of the specified attribute
  - getGeometry
```
Geometry getGeometry(String name)
```
    Returns the Geometry value of an attribute given its name.
    
    Parameters:
    
    name - name of the attribute
    
    Returns:
    
    value of the specified attribute
  - getGeometry
```
Geometry getGeometry(int index)
```
    Returns the Geometry value of an attribute given its position.
    
    Parameters:
    
    index - position of the attribute
    
    Returns:
    
    value of the specified attribute
  - getArray
```
Object[] getArray(String name)
```
    Returns the array value of an attribute given its name.
    
    Parameters:
    
    name - name of the attribute
    
    Returns:
    
    value of the specified attribute
  - getArray
```
Object[] getArray(int index)
```
    Returns the array value of an attribute given its position.
    
    Parameters:
    
    index - position of the attribute
    
    Returns:
    
    value of the specified attribute
  - getFeature
```
Feature getFeature(String name)
```
    Returns the Feature value of an attribute given its name.
    
    Parameters:
    
    name - name of the attribute
    
    Returns:
    
    value of the specified attribute
  - getFeature
```
Feature getFeature(int index)
```
    Returns the Feature value of an attribute given its position.
    
    Parameters:
    
    index - position of the attribute
    
    Returns:
    
    value of the specified attribute
  - getDefaultEnvelope
```
Envelope getDefaultEnvelope()
```
    Envelope (AKA extent or bounding box) of the default geometry attribute.
    
    Returns:
    
    Envelope of the default geometry attribute
  - getDefaultGeometry
```
Geometry getDefaultGeometry()
```
    Returns the value of the default geometry attribute, which is a Geometry.
    
    Returns:
    
    value of the default geometry attribute
  - getGeometries
```
List getGeometries()
```
    Returns a list with the values of this Feature's geometry attributes.
    
    Returns:
    
    a list with the values of this Feature's geometry attributes
  - getDefaultSRS
```
IProjection getDefaultSRS()
```
    Returns the Spatial Reference System in which is expressed the default geometry attribute.
    
    Returns:
    
    A string containing the default geometry attribute SRS.
  - getSRSs
```
List getSRSs()
```
    Returns a list with the Spatial Reference Systems in which are expressed this Feature's geometry attributes.
    
    Returns:
    
    a list with the Spatial Reference Systems.
  - getInstant
```
Instant getInstant(int index)
```
    Returns the instant value of an attribute given its position.
    
    Parameters:
    
    index - position of the attribute
    
    Returns:
    
    value of the specified attribute
  - getInstant
```
Instant getInstant(String name)
```
    Returns the instant value of an attribute given its name.
    
    Parameters:
    
    name - a string containing the name of the attribute
    
    Returns:
    
    value of the specified attribute
  - getInterval
```
Interval getInterval(int index)
```
    Returns the interval value of an attribute given its position.
    
    Parameters:
    
    index - position of the attribute
    
    Returns:
    
    value of the specified attribute
  - getInterval
```
Interval getInterval(String name)
```
    Returns the interval value of an attribute given its name.
    
    Parameters:
    
    name - a string containing the name of the attribute
    
    Returns:
    
    value of the specified attribute
  - getAsDynObject
```
DynObject getAsDynObject()
```
  - getEvaluatorData
```
EvaluatorData getEvaluatorData()
```
    This lets Feature be used eaily with Evaluator
    
    Returns:
    
    An instance of EvaluatorData which returns the data of this feature
  - getStore
```
FeatureStore getStore()
```
    Return the store associated to this feature.
    
    Returns:
    
    the FeatureStore of the feature.

Interface Feature

Field Summary

Method Summary

Field Detail

ALL

UPDATE

FINISH_EDITING

Method Detail

getReference

getType

getCopy

validate

getEditable

get

get

getInt

getInt

getBoolean

getBoolean

getLong

getLong

getFloat

getFloat

getDouble

getDouble

getDate

getDate

getString

getString

getByte

getByte

getGeometry

getGeometry

getArray

getArray

getFeature

getFeature

getDefaultEnvelope

getDefaultGeometry

getGeometries

getDefaultSRS

getSRSs

getInstant

getInstant

getInterval

getInterval

getAsDynObject

getEvaluatorData

getStore