org.gvsig.fmap.dal.store.dbf

Class DBFStoreProvider

java.lang.Object

org.gvsig.tools.dispose.impl.AbstractDisposable

org.gvsig.fmap.dal.feature.spi.AbstractFeatureStoreProvider

org.gvsig.fmap.dal.store.dbf.DBFStoreProvider

All Implemented Interfaces:

DataStoreProvider, FeatureStoreProvider, ResourceConsumer, Disposable, DynObject

Direct Known Subclasses:

SHPStoreProvider

public class DBFStoreProvider
extends AbstractFeatureStoreProvider
implements ResourceConsumer

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	DBFStoreProvider.DuplicatedFieldNameException

Nested classes/interfaces inherited from class org.gvsig.fmap.dal.feature.spi.AbstractFeatureStoreProvider

AbstractFeatureStoreProvider.FeatureProviderNotFoundException

Nested classes/interfaces inherited from interface org.gvsig.fmap.dal.feature.spi.FeatureStoreProvider

FeatureStoreProvider.FeatureTypeChanged

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	DESCRIPTION
static int	MAX_FIELD_NAME_LENGTH
static java.lang.String	METADATA_DEFINITION_NAME
static java.lang.String	NAME

Constructor Summary

Constructors

Modifier	Constructor and Description
	DBFStoreProvider(DBFStoreParameters params, DataStoreProviderServices storeServices)
protected	DBFStoreProvider(DBFStoreParameters params, DataStoreProviderServices storeServices, DynObject metadata)

Method Summary

Methods

Modifier and Type	Method and Description
boolean	allowWrite() unsupported by default, override this otherwise
void	append(FeatureProvider featureProvider) unsupported by default, override this otherwise
void	beginAppend() unsupported by default, override this otherwise
boolean	canCreate()
boolean	canWriteGeometry(int geometryType, int geometrySubType) unsupported geometry write by default (return false), override this otherwise
protected void	checkNewFieldsNameSize(java.util.Iterator ft_upd)
void	close() do nothing by default, override this otherwise
protected void	closeFile()
boolean	closeResourceRequested(ResourceProvider resource)
FeatureProvider	createFeatureProvider(FeatureType type) Default Factory of FeatureProvider.
java.lang.Object	createNewOID() Return a new OID valid for a new feature.
FeatureSetProvider	createSet(FeatureQuery query, FeatureType featureType) Factory of FeatureSetProvider.
protected void	disposeResource()
protected void	doDispose() Internal implementation for the AbstractDisposable.dispose() method, to be implemented by child classes.
void	endAppend() unsupported by default, override this otherwise
protected DBFStoreParameters	getDBFParameters()
java.lang.Object	getDynValue(java.lang.String name)
DataServerExplorer	getExplorer() unsupported by default (return null), override this otherwise
long	getFeatureCount() Returns total feature count of this store.
protected FeatureProvider	getFeatureProviderByIndex(long index) * NOT supported in Alter Mode
protected FeatureProvider	getFeatureProviderByIndex(long index, FeatureType featureType)
java.lang.String	getFullName()
java.lang.String	getName()
protected java.lang.String	getNewFieldsWithNameTooLong(java.util.Iterator ft_updated) Returns null or a string which is a comma-separated list
int	getOIDType() Return OID data type (from DataTypes) of this store.
java.lang.String	getProviderName()
ResourceProvider	getResource()
java.lang.Object	getSourceId()
protected EditableFeatureType	getTheFeatureType()
protected void	init(DBFStoreParameters params, DataStoreProviderServices storeServices)
protected void	initFeatureProviderByIndex(FeatureProvider featureProvider, long index, FeatureType featureType)
protected void	initFeatureType()
protected void	initResource(DBFStoreParameters params, DataStoreProviderServices storeServices)
protected void	initResource(ResourceProvider resource, DataStoreProviderServices storeServices)
protected FeatureProvider	internalGetFeatureProviderByReference(FeatureReferenceProviderServices reference, FeatureType featureType) Returns a FeatureProvider by reference, using the provided FeatureType.
protected void	loadFeatureProviderByIndex(FeatureProvider featureProvider)
protected void	loadValue(FeatureProvider featureProvider, int rowIndex, FeatureAttributeDescriptor descriptor)
void	open()
protected void	openFile()
void	performChanges(java.util.Iterator deleteds, java.util.Iterator inserteds, java.util.Iterator updateds, java.util.Iterator originalFeatureTypesUpdated) unsupported by default, override this otherwise
void	refresh() do nothing by default, override this otherwise
protected static void	registerMetadataDefinition()
void	resourceChanged(ResourceProvider resource)
protected void	resourceCloseRequest()
protected void	resourcesNotifyChanges()
protected void	resourcesNotifyClose()
protected void	resourcesOpen()
boolean	supportsAppendMode() unsupported by default, override this otherwise

Methods inherited from class org.gvsig.fmap.dal.feature.spi.AbstractFeatureStoreProvider

abortAppend, allowAutomaticValues, clear, createFeatureLocks, createFeatureSelection, createResource, delegate, getChilds, getDynClass, getEnvelope, getFeatureProviderByReference, getFeatureProviderByReference, getFeatureStore, getInterval, getParameters, getRetrievedFeaturesLimit, getStoreServices, getTimes, getTimes, hasDynValue, hasRetrievedFeaturesLimit, implement, internalGetFeatureProviderByReference, invokeDynMethod, invokeDynMethod, isKnownEnvelope, isLocksSupported, savePrjFile, setDynValue, setMetadata

Methods inherited from class org.gvsig.tools.dispose.impl.AbstractDisposable

dispose, dispose

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.gvsig.tools.dispose.Disposable

dispose

Field Detail

MAX_FIELD_NAME_LENGTH

public static final int MAX_FIELD_NAME_LENGTH

See Also:

Constant Field Values

NAME

public static java.lang.String NAME

DESCRIPTION

public static java.lang.String DESCRIPTION

METADATA_DEFINITION_NAME

public static final java.lang.String METADATA_DEFINITION_NAME

Constructor Detail

DBFStoreProvider

public DBFStoreProvider(DBFStoreParameters params,
                DataStoreProviderServices storeServices)
                 throws InitializeException

Throws:

InitializeException

DBFStoreProvider

protected DBFStoreProvider(DBFStoreParameters params,
                DataStoreProviderServices storeServices,
                DynObject metadata)
                    throws InitializeException

Throws:

InitializeException

Method Detail

registerMetadataDefinition

protected static void registerMetadataDefinition()
                                          throws MetadataException

Throws:

MetadataException

init

protected void init(DBFStoreParameters params,
        DataStoreProviderServices storeServices)
             throws InitializeException

Throws:

InitializeException

getDynValue

public java.lang.Object getDynValue(java.lang.String name)
                             throws DynFieldNotFoundException

Specified by:

getDynValue in interface DynObject

Overrides:

getDynValue in class AbstractFeatureStoreProvider

Throws:

DynFieldNotFoundException

initResource

protected void initResource(DBFStoreParameters params,
                DataStoreProviderServices storeServices)
                     throws InitializeException

Throws:

InitializeException

initResource

protected void initResource(ResourceProvider resource,
                DataStoreProviderServices storeServices)

getProviderName

public java.lang.String getProviderName()

getDBFParameters

protected DBFStoreParameters getDBFParameters()

getExplorer

public DataServerExplorer getExplorer()
                               throws ReadException

Description copied from class: AbstractFeatureStoreProvider

unsupported by default (return null), override this otherwise

Overrides:

getExplorer in class AbstractFeatureStoreProvider

Returns:

ServerExplorer

Throws:

ReadException

See Also:

DataStoreProvider.getExplorer()

internalGetFeatureProviderByReference

protected FeatureProvider internalGetFeatureProviderByReference(FeatureReferenceProviderServices reference,
                                                    FeatureType featureType)
                                                         throws DataException

Description copied from class: AbstractFeatureStoreProvider

Returns a FeatureProvider by reference, using the provided FeatureType. This is the child classes implementation of the AbstractFeatureStoreProvider.getFeatureProviderByReference(FeatureReferenceProviderServices) method.

Specified by:

internalGetFeatureProviderByReference in class AbstractFeatureStoreProvider

Parameters:

reference - the reference to the FeatureProvider

featureType - the type of feature to load

Returns:

the FeatureProvider being referenced

Throws:

DataException - if there is an error loading the FeatureProvider

performChanges

public void performChanges(java.util.Iterator deleteds,
                  java.util.Iterator inserteds,
                  java.util.Iterator updateds,
                  java.util.Iterator originalFeatureTypesUpdated)
                    throws PerformEditingException

Description copied from class: AbstractFeatureStoreProvider

unsupported by default, override this otherwise

Specified by:

performChanges in interface FeatureStoreProvider

Overrides:

performChanges in class AbstractFeatureStoreProvider

Parameters:

deleteds - iterator of FeatureReferenceProviderServices

inserteds - iterator of FeatureProvider

updateds - iterator of FeatureProvider

originalFeatureTypesUpdated - iterator of FeatureStoreProvider.FeatureTypeChanged

Throws:

PerformEditingException

See Also:

FeatureStoreProvider.performChanges(Iterator, Iterator, Iterator, Iterator)

checkNewFieldsNameSize

protected void checkNewFieldsNameSize(java.util.Iterator ft_upd)
                               throws PerformEditingException

Throws:

PerformEditingException

getNewFieldsWithNameTooLong

protected java.lang.String getNewFieldsWithNameTooLong(java.util.Iterator ft_updated)

Returns null or a string which is a comma-separated list

Parameters:

ft_updated -

Returns:

createFeatureProvider

public FeatureProvider createFeatureProvider(FeatureType type)
                                      throws DataException

Description copied from class: AbstractFeatureStoreProvider

Default Factory of FeatureProvider. Create a new default FeatureProvider instance.
Override this if you need an special implemtation of FeatureProvider.

Specified by:

createFeatureProvider in interface FeatureStoreProvider

Overrides:

createFeatureProvider in class AbstractFeatureStoreProvider

Returns:

Throws:

DataException

See Also:

org.gvsig.fmap.dal.feature.spi.FeatureStoreProvider#createFeatureProvider(FeatureType)}

initFeatureType

protected void initFeatureType()
                        throws InitializeException

Throws:

InitializeException

getTheFeatureType

protected EditableFeatureType getTheFeatureType()
                                         throws InitializeException,
                                                OpenException

Throws:

InitializeException

OpenException

loadValue

protected void loadValue(FeatureProvider featureProvider,
             int rowIndex,
             FeatureAttributeDescriptor descriptor)
                  throws ReadException

Throws:

ReadException

getFeatureProviderByIndex

protected FeatureProvider getFeatureProviderByIndex(long index)
                                             throws DataException

* NOT supported in Alter Mode

Parameters:

index -

Returns:

Throws:

ReadException

DataException

getFeatureCount

public long getFeatureCount()
                     throws ReadException,
                            OpenException,
                            ResourceNotifyChangesException

Description copied from interface: FeatureStoreProvider

Returns total feature count of this store.

Specified by:

getFeatureCount in interface FeatureStoreProvider

Returns:

Throws:

ReadException

OpenException

ResourceNotifyChangesException

createSet

public FeatureSetProvider createSet(FeatureQuery query,
                           FeatureType featureType)
                             throws DataException

Description copied from interface: FeatureStoreProvider

Factory of FeatureSetProvider. Create a new FeatureSetProvider that represents result of FeatureQuery .

Specified by:

createSet in interface FeatureStoreProvider

Parameters:

query - (never will be null)

featureType - (never will be null)

Returns:

Throws:

DataException

canCreate

public boolean canCreate()

canWriteGeometry

public boolean canWriteGeometry(int geometryType,
                       int geometrySubType)
                         throws DataException

Description copied from class: AbstractFeatureStoreProvider

unsupported geometry write by default (return false), override this otherwise

Specified by:

canWriteGeometry in interface FeatureStoreProvider

Overrides:

canWriteGeometry in class AbstractFeatureStoreProvider

Returns:

Throws:

DataException

See Also:

FeatureStoreProvider.canWriteGeometry(int, int)

open

public void open()
          throws OpenException

Throws:

OpenException

openFile

protected void openFile()
                 throws FileNotFoundException,
                        UnsupportedVersionException,
                        java.io.IOException,
                        DataException

Throws:

FileNotFoundException

UnsupportedVersionException

java.io.IOException

DataException

close

public void close()
           throws CloseException

Description copied from class: AbstractFeatureStoreProvider

do nothing by default, override this otherwise

Overrides:

close in class AbstractFeatureStoreProvider

Throws:

CloseException

See Also:

DataStoreProvider.close()

closeFile

protected void closeFile()
                  throws CloseException

Throws:

CloseException

doDispose

protected void doDispose()
                  throws BaseException

Description copied from class: AbstractDisposable

Internal implementation for the AbstractDisposable.dispose() method, to be implemented by child classes.

Overrides:

doDispose in class AbstractFeatureStoreProvider

Throws:

BaseException

See Also:

AbstractDisposable.dispose()

disposeResource

protected void disposeResource()

closeResourceRequested

public boolean closeResourceRequested(ResourceProvider resource)

Specified by:

closeResourceRequested in interface ResourceConsumer

allowWrite

public boolean allowWrite()

Description copied from class: AbstractFeatureStoreProvider

unsupported by default, override this otherwise

Specified by:

allowWrite in interface FeatureStoreProvider

Overrides:

allowWrite in class AbstractFeatureStoreProvider

Returns:

if write is supported

See Also:

FeatureStoreProvider.allowWrite()

refresh

public void refresh()
             throws OpenException

Description copied from class: AbstractFeatureStoreProvider

do nothing by default, override this otherwise

Overrides:

refresh in class AbstractFeatureStoreProvider

Throws:

OpenException

See Also:

DataStoreProvider.refresh()

getFeatureProviderByIndex

protected FeatureProvider getFeatureProviderByIndex(long index,
                                        FeatureType featureType)
                                             throws DataException

Parameters:

index -

featureType -

Returns:

Throws:

ReadException

DataException

initFeatureProviderByIndex

protected void initFeatureProviderByIndex(FeatureProvider featureProvider,
                              long index,
                              FeatureType featureType)
                                   throws DataException

Throws:

DataException

loadFeatureProviderByIndex

protected void loadFeatureProviderByIndex(FeatureProvider featureProvider)
                                   throws DataException

Parameters:

featureProvider -

Throws:

DataException

getOIDType

public int getOIDType()

Description copied from interface: FeatureStoreProvider

Return OID data type (from DataTypes) of this store.

Specified by:

getOIDType in interface FeatureStoreProvider

Returns:

OID data type

See Also:

FeatureStoreProvider#createNewOID()} {@link DataTypes}

createNewOID

public java.lang.Object createNewOID()

Description copied from interface: FeatureStoreProvider

Return a new OID valid for a new feature.

Specified by:

createNewOID in interface FeatureStoreProvider

Returns:

a new OID

See Also:

FeatureStoreProvider#getOIDType()}

supportsAppendMode

public boolean supportsAppendMode()

Description copied from class: AbstractFeatureStoreProvider

unsupported by default, override this otherwise

Specified by:

supportsAppendMode in interface FeatureStoreProvider

Overrides:

supportsAppendMode in class AbstractFeatureStoreProvider

See Also:

FeatureStoreProvider.supportsAppendMode()

append

public void append(FeatureProvider featureProvider)
            throws DataException

Description copied from class: AbstractFeatureStoreProvider

unsupported by default, override this otherwise

Specified by:

append in interface FeatureStoreProvider

Overrides:

append in class AbstractFeatureStoreProvider

Throws:

DataException

See Also:

org.gvsig.fmap.dal.feature.spi.FeatureStoreProvider#append(org.gvsig. fmap.dal.feature.spi.FeatureProvider)

beginAppend

public void beginAppend()
                 throws DataException

Description copied from class: AbstractFeatureStoreProvider

unsupported by default, override this otherwise

Specified by:

beginAppend in interface FeatureStoreProvider

Overrides:

beginAppend in class AbstractFeatureStoreProvider

Throws:

DataException

See Also:

FeatureStoreProvider.beginAppend()

endAppend

public void endAppend()
               throws DataException

Description copied from class: AbstractFeatureStoreProvider

unsupported by default, override this otherwise

Specified by:

endAppend in interface FeatureStoreProvider

Overrides:

endAppend in class AbstractFeatureStoreProvider

Throws:

DataException

See Also:

FeatureStoreProvider.endAppend()

resourceChanged

public void resourceChanged(ResourceProvider resource)

Specified by:

resourceChanged in interface ResourceConsumer

resourcesNotifyChanges

protected void resourcesNotifyChanges()
                               throws ResourceNotifyChangesException

Throws:

ResourceNotifyChangesException

resourcesNotifyClose

protected void resourcesNotifyClose()
                             throws ResourceNotifyCloseException

Throws:

ResourceNotifyCloseException

resourcesOpen

protected void resourcesOpen()
                      throws ResourceNotifyOpenException

Throws:

ResourceNotifyOpenException

getSourceId

public java.lang.Object getSourceId()

getName

public java.lang.String getName()

getFullName

public java.lang.String getFullName()

resourceCloseRequest

protected void resourceCloseRequest()
                             throws ResourceException

Throws:

ResourceException

getResource

public ResourceProvider getResource()