|
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object org.geotools.data.dir.DirectoryDataStore
This datastore represents methods of reading an enture directory. It propagates actual reading / writing of the data to the dataStore which reads / writes the requested format.
Constructor Summary | |
DirectoryDataStore(java.io.File f,
java.lang.String[] co)
Creates a new DirectoryDataStore object. |
Method Summary | |
void |
createSchema(FeatureType featureType)
Creates storage for a new featureType .
|
boolean |
exists(java.lang.String authID)
Check if any locks exist held by the authorization lockID .
|
FeatureReader |
getFeatureReader(Query query,
Transaction transaction)
Access a FeatureReader providing access to Feature information. |
FeatureSource |
getFeatureSource(java.lang.String typeName)
Access a FeatureSource for typeName providing a high-level API. |
FeatureWriter |
getFeatureWriter(java.lang.String typeName,
Filter filter,
Transaction transaction)
Access FeatureWriter for modification of existing DataStore contents. |
FeatureWriter |
getFeatureWriter(java.lang.String typeName,
Transaction transaction)
Access FeatureWriter for modification of the DataStore typeName. |
FeatureWriter |
getFeatureWriterAppend(java.lang.String typeName,
Transaction transaction)
Aquire a FeatureWriter for adding new content to a FeatureType. |
LockingManager |
getLockingManager()
Retrieve a per featureID based locking service from this DataStore. |
FeatureType |
getSchema(java.lang.String typeName)
Retrieve FeatureType metadata by typeName .
|
java.lang.String[] |
getTypeNames()
Retrieves a list of of the available FeatureTypes. |
FeatureSource |
getView(Query query)
Access a FeatureSource for Query providing a high-level API. |
void |
lockFeatureID(java.lang.String typeName,
java.lang.String authID,
Transaction transaction,
FeatureLock featureLock)
FeatureID based locking. |
boolean |
refresh(java.lang.String authID,
Transaction transaction)
Refresh locks held by the authorization lockID .
|
boolean |
release(java.lang.String authID,
Transaction transaction)
Release locks held by the authorization lockID .
|
void |
unLockFeatureID(java.lang.String typeName,
java.lang.String authID,
Transaction transaction,
FeatureLock featureLock)
FeatureID based unlocking. |
void |
updateSchema(java.lang.String typeName,
FeatureType featureType)
Used to force namespace and CS info into a persistent change. |
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
public DirectoryDataStore(java.io.File f, java.lang.String[] co) throws java.net.MalformedURLException, java.io.IOException
f
- File the directoryco
- list of file suffixes in order of preference for creating new
FTs
java.net.MalformedURLException
java.io.IOException
Method Detail |
public FeatureSource getView(Query query) throws java.io.IOException, SchemaException
DataStore
The provided Query does not need to completely cover the existing schema for Query.getTypeName(). The result will mostly likely only be a FeatureSource and probably wont' allow write access by the FeatureStore method.
By using Query we allow support for reprojection, in addition to overriding the CoordinateSystem used by the native FeatureType.
We may wish to limit this method to only support Queries using Filter.ALL.
Update - GeoServer has an elegatent implementation of this functionality that we could steal. GeoServerFeatureSource, GeoServerFeatureStore and GeoServerFeatureLocking serve as a working prototype.
getView
in interface DataStore
SchemaException
- If fetureType is not covered by existing schema
java.io.IOException
- If FeatureSource is not availablepublic java.lang.String[] getTypeNames() throws java.io.IOException
DataStore
This is simply a list of the FeatureType names as aquiring the actual FeatureType schemas may be expensive.
Warning: this list may not be unique - the types may be in separate namespaces.
If you need to worry about such things please consider the use of the Catalog and CatalogEntry interface - many DataStores support this. getTypeNames is really a convience method for a Catalog.iterator() where the name of each entry is returned.
getTypeNames
in interface DataStore
java.io.IOException
DataStore.getTypeNames()
public FeatureType getSchema(java.lang.String typeName) throws java.io.IOException
DataStore
typeName
.
Retrieves the Schema information as a FeatureType object.
getSchema
in interface DataStore
typeName
- typeName of requested FeatureType
java.io.IOException
- If typeName cannot be foundDataStore.getSchema(java.lang.String)
public void createSchema(FeatureType featureType) throws java.io.IOException
DataStore
featureType
.
The provided featureType
we be accessable by the typeName
provided by featureType.getTypeName().
createSchema
in interface DataStore
featureType
- FetureType to add to DataStore
java.io.IOException
- If featureType cannot be createdDataStore.createSchema(org.geotools.feature.FeatureType)
public void updateSchema(java.lang.String typeName, FeatureType featureType) throws java.io.IOException
DataStore
The provided featureType should completely cover the existing schema. All attributes should be accounted for and the typeName should match.
Suggestions:
updateSchema
in interface DataStore
typeName
-
java.io.IOException
DataStore.updateSchema(java.lang.String,
org.geotools.feature.FeatureType)
public FeatureSource getFeatureSource(java.lang.String typeName) throws java.io.IOException
DataStore
The resulting FeatureSource may implment more functionality:
FeatureSource fsource = dataStore.getFeatureSource( "roads" );
FeatureStore fstore = null;
if( fsource instanceof FeatureLocking ){
fstore = (FeatureStore) fs;
}
else {
System.out.println("We do not have write access to roads");
}
getFeatureSource
in interface DataStore
typeName
-
java.io.IOException
DataStore.getFeatureSource(java.lang.String)
public FeatureReader getFeatureReader(Query query, Transaction transaction) throws java.io.IOException
DataStore
Filter is used as a low-level indication of constraints. (Implementations may resort to using a FilteredFeatureReader, or provide their own optimizations)
FeatureType provides a template for the returned FeatureReader
Transaction to externalize DataStore state on a per Transaction basis. The most common example is a JDBC datastore saving a Connection for use across several FeatureReader requests. Similarly a Shapefile reader may wish to redirect FeatureReader requests to a alternate filename over the course of a Transaction.
Notes For Implementing DataStore
Subclasses may need to retrieve additional attributes, beyond those
requested by featureType.getAttributeTypes(), in order to correctly
apply the filter
.
These Additional attribtues should be not be returned by
FeatureReader. Subclasses may use ReTypeFeatureReader to aid in
acomplishing this.
Helper classes for implementing a FeatureReader (in order):
Sample use (not optimized):
if (filter == Filter.ALL) {
return new EmptyFeatureReader(featureType);
}
String typeName = featureType.getTypeName();
FeatureType schema = getSchema( typeName );
FeatureReader reader = new DefaultFeatureReader( getAttributeReaders(), schema );
if (filter != Filter.NONE) {
reader = new FilteringFeatureReader(reader, filter);
}
if (transaction != Transaction.AUTO_COMMIT) {
Map diff = state(transaction).diff(typeName);
reader = new DiffFeatureReader(reader, diff);
}
if (!featureType.equals(reader.getFeatureType())) {
reader = new ReTypeFeatureReader(reader, featureType);
}
return reader
Locking support does not need to be provided for FeatureReaders.
getFeatureReader
in interface DataStore
query
- Requested form of the returned Features and the filter used
to constraints the resultstransaction
- Transaction this query opperates against
java.io.IOException
DataStore.getFeatureReader(org.geotools.data.Query,
org.geotools.data.Transaction)
public FeatureWriter getFeatureWriter(java.lang.String typeName, Filter filter, Transaction transaction) throws java.io.IOException
DataStore
To limit FeatureWriter to the FeatureTypes defined by this DataStore, typeName is used to indicate FeatureType. The resulting feature writer will allow modifications against the same FeatureType provided by getSchema( typeName )
The FeatureWriter will provide access to the existing contents of the FeatureType referenced by typeName. The provided filter will be used to skip over Features as required.
Notes For Implementing DataStore
The returned FeatureWriter does not support the addition of new
Features to FeatureType (it would need to police your modifications to
agree with filer
). As such it will return
false
for getNext() when it reaches the end of the Query
and NoSuchElementException when next() is called.
Helper classes for implementing a FeatureWriter (in order):
getFeatureWriter
in interface DataStore
typeName
- Indicates featureType to be modifiedfilter
- constraints used to limit the modificationtransaction
- Transaction this query opperates against
java.io.IOException
DataStore.getFeatureWriter(java.lang.String,
org.geotools.filter.Filter, org.geotools.data.Transaction)
public FeatureWriter getFeatureWriter(java.lang.String typeName, Transaction transaction) throws java.io.IOException
DataStore
FeatureWriters will need to be limited to the FeatureTypes defined by the DataStore, the easiest way to express this limitation is to the FeatureType by a provided typeName.
The returned FeatureWriter will return false
for getNext()
when it reaches the end of the Query.
getFeatureWriter
in interface DataStore
typeName
- Indicates featureType to be modifiedtransaction
- Transaction to opperates against
java.io.IOException
DataStore.getFeatureWriter(java.lang.String,
org.geotools.data.Transaction)
public FeatureWriter getFeatureWriterAppend(java.lang.String typeName, Transaction transaction) throws java.io.IOException
DataStore
This FeatureWriter will return false
for hasNext(), however
next() may be used to aquire new Features that may be writen out to add
new content.
getFeatureWriterAppend
in interface DataStore
typeName
- Indicates featureType to be modifiedtransaction
- Transaction to opperates against
java.io.IOException
DataStore.getFeatureWriterAppend(java.lang.String,
org.geotools.data.Transaction)
public LockingManager getLockingManager()
DataStore
It is common to return an instanceof InProcessLockingManager for DataStores that do not provide native locking.
AbstractFeatureLocking makes use of this service to provide locking
support. You are not limitied by this implementation and may simply
return null
for this value.
getLockingManager
in interface DataStore
null
, if the handling locking
in another fashion.DataStore.getLockingManager()
public boolean exists(java.lang.String authID)
LockingManager
lockID
.
(remember that the lock may have expired)
exists
in interface LockingManager
authID
- Authorization for lock
true
if lock was foundLockingManager.exists(java.lang.String)
public boolean release(java.lang.String authID, Transaction transaction) throws java.io.IOException
LockingManager
lockID
.
(remember that the lock may have expired)
release
in interface LockingManager
authID
- Authorization for locktransaction
- Transaction with authorization for lockID
true
if lock was found and released
java.io.IOException
- DOCUMENT ME!LockingManager.release(java.lang.String,
org.geotools.data.Transaction)
public boolean refresh(java.lang.String authID, Transaction transaction) throws java.io.IOException
LockingManager
lockID
.
All features locked with the provied lockID
will be locked
for additional time (the origional duration requested).
(remember that the lock may have expired)
refresh
in interface LockingManager
authID
- Authorization for locktransaction
- Transaction with authorization for lockID
true
if lock was found and refreshed
java.io.IOException
- DOCUMENT ME!LockingManager.refresh(java.lang.String,
org.geotools.data.Transaction)
public void unLockFeatureID(java.lang.String typeName, java.lang.String authID, Transaction transaction, FeatureLock featureLock) throws java.io.IOException
LockingManager
unLockFeatureID
in interface LockingManager
typeName
- authID
- transaction
- featureLock
-
java.io.IOException
- DOCUMENT ME!LockingManager.unLockFeatureID(java.lang.String,
java.lang.String, org.geotools.data.Transaction,
org.geotools.data.FeatureLock)
public void lockFeatureID(java.lang.String typeName, java.lang.String authID, Transaction transaction, FeatureLock featureLock) throws java.io.IOException
LockingManager
lockFeatureID
in interface LockingManager
typeName
- authID
- transaction
- featureLock
-
java.io.IOException
- DOCUMENT ME!LockingManager.lockFeatureID(java.lang.String,
java.lang.String, org.geotools.data.Transaction,
org.geotools.data.FeatureLock)
|
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |