| gvSIG desktop 1

package org.gvsig.data.datastores.vectorial.file.shp_util;

import org.gvsig.exceptions.DriverException;

/**

 * This interface comes from the old data access model, and is used only by the JNI and memory SHP datastores

 * 

 * @author jldominguez

 *

 */

public interface DBFDataSource {

        /**

         * 

         * @return number of firlds in the DBF file

         * @throws BaseReadException

         */

        int getFieldCount() throws BaseReadException;

        /**

         * Gets the type of the i-th field

         * @param i the index of the field of interest

         * @return the type of the i-th field

         * @throws BaseReadException

         */

        int getFieldType(int i) throws BaseReadException;

        /**

         * Gets the name of the i-th field

         * @param i the index of the field of interest

         * @return the name of the i-th field

         * @throws BaseReadException

         */

        String getFieldName(int i) throws BaseReadException;

        /**

         * Gets the width of the i-th field

         * @param i the index of the field of interest

         * @return the width of the i-th field

         * @throws BaseReadException

         */

        int getFieldWidth(int i) throws BaseReadException;

        /**

         *

         * @return the name of this data source

         */

        String getName();

        /**

         * Gets the index of a field from its name

         * @param desc_fname the name of the field of interest

         * @return the index of the field 

         * @throws BaseReadException

         */

        int getFieldIndexByName(String desc_fname) throws BaseReadException;

        /**

         * gets the value of a field

         * @param i row index

         * @param ind field index

         * @return an object with the value. The returned class depends on the field type (Integer, Double, Date, etc.)

         * @throws BaseReadException

         */

        Object getFieldValue(long i, int ind) throws BaseReadException;

}