Class DirectoryDataStore
- Object
-
- DirectoryDataStore
-
- All Implemented Interfaces:
DataAccess<SimpleFeatureType,SimpleFeature>
,DataStore
public class DirectoryDataStore extends Object implements DataStore
-
-
Constructor Summary
Constructors Constructor Description DirectoryDataStore(File directory, FileStoreFactory dialect)
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description void
createSchema(SimpleFeatureType featureType)
Creates storage for a newfeatureType
.void
dispose()
Disposes of this data store and releases any resource that it is using.DataStore
getDataStore(String typeName)
Returns the native store for a specified type nameFeatureReader<SimpleFeatureType,SimpleFeature>
getFeatureReader(Query query, Transaction transaction)
Gets aFeatureReader
for features selected by the givenQuery
.SimpleFeatureSource
getFeatureSource(String typeName)
Gets aSimpleFeatureSource
for features of the specified type.SimpleFeatureSource
getFeatureSource(Name typeName)
Gets aSimpleFeatureSource
for features of the type specified by a qualified name (namespace plus type name).FeatureWriter<SimpleFeatureType,SimpleFeature>
getFeatureWriter(String typeName, Transaction transaction)
Gets aFeatureWriter
to modify features in thisDataStore
.FeatureWriter<SimpleFeatureType,SimpleFeature>
getFeatureWriter(String typeName, Filter filter, Transaction transaction)
Gets aFeatureWriter
to modify features in thisDataStore
.FeatureWriter<SimpleFeatureType,SimpleFeature>
getFeatureWriterAppend(String typeName, Transaction transaction)
Gets aFeatureWriter
that can add new features to theDataStore
.ServiceInfo
getInfo()
Information about this service.LockingManager
getLockingManager()
Retrieve a per featureID based locking service from thisDataStore
.List<Name>
getNames()
Names of the available Resources.SimpleFeatureType
getSchema(String typeName)
Gets the type information (schema) for the specified feature type.SimpleFeatureType
getSchema(Name name)
Description of the named resource.String[]
getTypeNames()
Gets the names of feature types available in thisDataStore
.void
removeSchema(String name)
Used to permanently remove a schema from the underlying storagevoid
removeSchema(Name name)
Used to permanently remove a schema from the underlying storagevoid
updateSchema(String typeName, SimpleFeatureType featureType)
Applies a new schema to the given feature type.void
updateSchema(Name typeName, SimpleFeatureType featureType)
Used to update a schema in place.
-
-
-
Constructor Detail
-
DirectoryDataStore
public DirectoryDataStore(File directory, FileStoreFactory dialect) throws IOException
- Throws:
IOException
-
-
Method Detail
-
getFeatureReader
public FeatureReader<SimpleFeatureType,SimpleFeature> getFeatureReader(Query query, Transaction transaction) throws IOException
Description copied from interface:DataStore
Gets aFeatureReader
for features selected by the givenQuery
.FeatureReader
provies an iterator-style API to feature data.The
Query
provides the schema for the form of the returned features as well as aFilter
to constrain the features available via the reader.The
Transaction
can be used to externalize the state of theDataStore
. Examples of this include aJDBCDataStore
sharing a connection for use across severalFeatureReader
requests; and aShapefileDataStore
redirecting requests to an alternate file during the course of aTransaction
.- Specified by:
getFeatureReader
in interfaceDataStore
- Parameters:
query
- a query providing the schema and constraints for features that the reader will returntransaction
- a transaction that this reader will operate against- Returns:
- an instance of
FeatureReader
- Throws:
IOException
- if data access errors occur
-
getFeatureSource
public SimpleFeatureSource getFeatureSource(String typeName) throws IOException
Description copied from interface:DataStore
Gets aSimpleFeatureSource
for features of the specified type.SimpleFeatureSource
provides a high-level API for feature operations.The resulting
SimpleFeatureSource
may implment more functionality as in this example:SimpleFeatureSource fsource = dataStore.getFeatureSource("roads"); if (fsource instanceof SimpleFeatureStore) { // we have write access to the feature data SimpleFeatureStore fstore = (SimpleFeatureStore) fs; } else { // System.out.println("We do not have write access to roads"); }
- Specified by:
getFeatureSource
in interfaceDataStore
- Parameters:
typeName
- the feature type- Returns:
- a
SimpleFeatureSource
(or possibly a subclass) providing operations for features of the specified type - Throws:
IOException
- if data access errors occur- See Also:
SimpleFeatureSource
,SimpleFeatureStore
-
getFeatureWriter
public FeatureWriter<SimpleFeatureType,SimpleFeature> getFeatureWriter(String typeName, Filter filter, Transaction transaction) throws IOException
Description copied from interface:DataStore
Gets aFeatureWriter
to modify features in thisDataStore
.FeatureWriter
provides an iterator style API to features.The returned writer does not allow features to be added.
- Specified by:
getFeatureWriter
in interfaceDataStore
- Parameters:
typeName
- the type name for features that will be accessiblefilter
- defines additional constraints on the features that will be accessibletransaction
- the transaction that the returned writer operates against- Returns:
- an instance of
FeatureWriter
- Throws:
IOException
- if data access errors occur- See Also:
DataStore.getFeatureWriterAppend(String, Transaction)
-
getFeatureWriter
public FeatureWriter<SimpleFeatureType,SimpleFeature> getFeatureWriter(String typeName, Transaction transaction) throws IOException
Description copied from interface:DataStore
Gets aFeatureWriter
to modify features in thisDataStore
.FeatureWriter
provides an iterator style API to features.The returned writer does not allow features to be added.
- Specified by:
getFeatureWriter
in interfaceDataStore
- Parameters:
typeName
- the type name for features that will be accessibletransaction
- the transaction that the returned writer operates against- Returns:
- an instance of
FeatureWriter
- Throws:
IOException
- if data access errors occur- See Also:
DataStore.getFeatureWriterAppend(String, Transaction)
-
getFeatureWriterAppend
public FeatureWriter<SimpleFeatureType,SimpleFeature> getFeatureWriterAppend(String typeName, Transaction transaction) throws IOException
Description copied from interface:DataStore
Gets aFeatureWriter
that can add new features to theDataStore
.The
FeatureWriter
will returnfalse
when itshasNext()
method is called, butnext()
can be used to acquire new features.- Specified by:
getFeatureWriterAppend
in interfaceDataStore
- Parameters:
typeName
- name of the feature type for which features will be addedtransaction
- the transaction to operate against- Returns:
- an instance of
FeatureWriter
that can only be used to append new features - Throws:
IOException
- if data access errors occur
-
getLockingManager
public LockingManager getLockingManager()
Description copied from interface:DataStore
Retrieve a per featureID based locking service from thisDataStore
.- Specified by:
getLockingManager
in interfaceDataStore
- Returns:
- an instance of
LockingManager
; ornull
if locking is handled by theDataStore
in a different fashion
-
getSchema
public SimpleFeatureType getSchema(String typeName) throws IOException
Description copied from interface:DataStore
Gets the type information (schema) for the specified feature type.- Specified by:
getSchema
in interfaceDataStore
- Parameters:
typeName
- the feature type name- Returns:
- the requested feature type
- Throws:
IOException
- iftypeName
is not available
-
getTypeNames
public String[] getTypeNames() throws IOException
Description copied from interface:DataStore
Gets the names of feature types available in thisDataStore
. Please note that this is not guaranteed to return a list of unique names since the same unqualified name may be present in separate namespaces within theDataStore
.- Specified by:
getTypeNames
in interfaceDataStore
- Returns:
- names of feature types available in this
DataStore
- Throws:
IOException
- if data access errors occur
-
updateSchema
public void updateSchema(String typeName, SimpleFeatureType featureType) throws IOException
Description copied from interface:DataStore
Applies a new schema to the given feature type. This can be used to add or remove properties. The resulting update will be persistent.- Specified by:
updateSchema
in interfaceDataStore
- Parameters:
typeName
- name of the feature type to updatefeatureType
- the new schema to apply- Throws:
IOException
- on error
-
createSchema
public void createSchema(SimpleFeatureType featureType) throws IOException
Description copied from interface:DataAccess
Creates storage for a newfeatureType
.The provided
featureType
we be accessable by the typeName provided by featureType.getTypeName().- Specified by:
createSchema
in interfaceDataAccess<SimpleFeatureType,SimpleFeature>
- Parameters:
featureType
- FetureType to add to DataStore- Throws:
IOException
- If featureType cannot be created
-
dispose
public void dispose()
Description copied from interface:DataAccess
Disposes of this data store and releases any resource that it is using.A
DataStore
cannot be used afterdispose
has been called, neither can any data access object it helped create, such asFeatureReader
,FeatureSource
orFeatureCollection
.This operation can be called more than once without side effects.
There is no thread safety assurance associated with this method. For example, client code will have to make sure this method is not called while retrieving/saving data from/to the storage, or be prepared for the consequences.
- Specified by:
dispose
in interfaceDataAccess<SimpleFeatureType,SimpleFeature>
-
getFeatureSource
public SimpleFeatureSource getFeatureSource(Name typeName) throws IOException
Description copied from interface:DataStore
Gets aSimpleFeatureSource
for features of the type specified by a qualified name (namespace plus type name).- Specified by:
getFeatureSource
in interfaceDataAccess<SimpleFeatureType,SimpleFeature>
- Specified by:
getFeatureSource
in interfaceDataStore
- Parameters:
typeName
- the qualified name of the feature type- Returns:
- a
SimpleFeatureSource
(or possibly a subclass) providing operations for features of the specified type - Throws:
IOException
- if data access errors occur- See Also:
DataStore.getFeatureSource(String)
,SimpleFeatureSource
,SimpleFeatureStore
-
getInfo
public ServiceInfo getInfo()
Description copied from interface:DataAccess
Information about this service.This method offers access to a summary of header or metadata information describing the service. Subclasses may return a specific ServiceInfo instance that has additional information (such as FilterCapabilities).
- Specified by:
getInfo
in interfaceDataAccess<SimpleFeatureType,SimpleFeature>
- Returns:
- SeviceInfo
-
getNames
public List<Name> getNames() throws IOException
Description copied from interface:DataAccess
Names of the available Resources.For additional information please see getInfo( Name ) and getSchema( Name ).
- Specified by:
getNames
in interfaceDataAccess<SimpleFeatureType,SimpleFeature>
- Returns:
- Names of the available contents.
- Throws:
IOException
-
getSchema
public SimpleFeatureType getSchema(Name name) throws IOException
Description copied from interface:DataAccess
Description of the named resource.The FeatureType returned describes the contents being published. For additional metadata please review getInfo( Name ).
- Specified by:
getSchema
in interfaceDataAccess<SimpleFeatureType,SimpleFeature>
- Parameters:
name
- Type name a the resource from getNames()- Returns:
- Description of the FeatureType being made avaialble
- Throws:
IOException
-
updateSchema
public void updateSchema(Name typeName, SimpleFeatureType featureType) throws IOException
Description copied from interface:DataAccess
Used to update a schema in place.This functionality is similar to an "alter table" statement in SQL. Implementation is optional; it may not be supported by all servers or files.
- Specified by:
updateSchema
in interfaceDataAccess<SimpleFeatureType,SimpleFeature>
- Throws:
IOException
- if the operation failed
-
getDataStore
public DataStore getDataStore(String typeName) throws IOException
Returns the native store for a specified type name- Throws:
IOException
-
removeSchema
public void removeSchema(Name name) throws IOException
Description copied from interface:DataAccess
Used to permanently remove a schema from the underlying storageThis functionality is similar to an "drop table" statement in SQL. Implementation is optional; it may not be supported by all servers or files.
- Specified by:
removeSchema
in interfaceDataAccess<SimpleFeatureType,SimpleFeature>
- Throws:
IOException
- if the operation failed
-
removeSchema
public void removeSchema(String name) throws IOException
Description copied from interface:DataStore
Used to permanently remove a schema from the underlying storageThis functionality is similar to an "drop table" statement in SQL. Implementation is optional; it may not be supported by all servers or files.
- Specified by:
removeSchema
in interfaceDataStore
- Throws:
IOException
- if the operation failed
-
-