| gvSIG desktop 1

package org.gvsig.fmap.dal.feature;

import java.util.Date;

import java.util.List;

import org.gvsig.fmap.geom.Geometry;

import org.gvsig.fmap.geom.primitive.Envelope;

/**

 * <p>Represents the basic unit of the tabular

 * data element (could be equivalent to data base register).

 * </p>

 * <br>

 * <p>The Feature:

 *   <ul>

 *     <li>Can create a unike identifier <code>FeatureID</code>

 *     to recognize our Feature from each other of the same

 *     data source</li>

 *     <li>Have a <code>FeatureType</code> that shows the

 *     charasteristics of the <code>Feature</code> (fields,

 *     fileds data type, default geometry, validation rules).</li>

 *   </ul>

 * </p>

 * <p><code>Feature</code> has all necesary methoths to access and

 * modify fileds values.</p>

 *

 * @author

 *

 */

public interface Feature {

        public FeatureReference getReference();

        public FeatureType getType();

        public Feature getCopy();

        static final int ALL = 0;

        static final int UPDATE = 1;

        static final int FINISH_EDITING = 2;

        public void validate(int mode);

        public EditableFeature getEditable();

        public Object   get(String name);

        public Object   get(int index);

        public int      getInt(String name);

        public int      getInt(int index);

        public boolean  getBoolean(String name);

        public boolean  getBoolean(int index);

        public long     getLong(String name);

        public long     getLong(int index);

        public float   getFloat(String name);

        public float    getFloat(int index);

        public double  getDouble(String name);

        public double   getDouble(int index);

        public Date    getDate(String name);

        public Date     getDate(int index);

        public String  getString(String name);

        public String   getString(int index);

        public byte    getByte(String name);

        public byte     getByte(int index);

        public Geometry getGeometry(String name);

        public Geometry getGeometry(int index);

        public Object[] getArray(String name);

        public Object[] getArray(int index);

        public Feature  getFeature(String name);

        public Feature  getFeature(int index);

        /**

         * Rectangle of DefaultGeometry.

         *

         * @return Envelope

         */

        public Envelope getDefaultEnvelope();

        public Geometry getDefaultGeometry();

        public List getGeometries();

        public String getDefaultSRS();

        public List getSRSs();

}