deegree-core-3.0-pre-nightly (2010/03/05 00:01) - official

org.deegree.feature.persistence.simplesql
Class SimpleSQLDatastore

java.lang.Object
  extended by org.deegree.feature.persistence.simplesql.SimpleSQLDatastore
All Implemented Interfaces:
FeatureStore

public class SimpleSQLDatastore
extends Object
implements FeatureStore

SimpleSQLDatastore

Version:
$Revision: 22496 $, $Date: 2010-02-10 17:24:45 +0100 (Mi, 10 Feb 2010) $
Author:
Andreas Schmitz, last edited by: $Author: aschmitz $

Field Summary
(package private)  boolean available
           
(package private)  Connection conn
           
(package private)  CRS crs
           
(package private)  GeometryFactory fac
           
(package private)  GenericFeatureType featureType
           
(package private)  TreeMap<Integer,String> lods
           
(package private) static org.slf4j.Logger LOG
           
(package private)  GeometryTransformer transformer
           
 
Constructor Summary
SimpleSQLDatastore(String connId, String crs, String sql, String featureName, String namespace, String bbox, List<Pair<Integer,String>> lods)
           
 
Method Summary
 FeatureStoreTransaction acquireTransaction()
          Acquires transactional access to the feature store.
 void destroy()
          Called by the container to indicate that this FeatureStore instance is being taken out of service.
 Envelope getEnvelope(QName ftName)
          Returns the envelope for all stored features of the given type.
 LockManager getLockManager()
          Returns the associated LockManager.
 GMLObject getObjectById(String id)
          Retrieves the stored object with a certain id.
 ApplicationSchema getSchema()
          Returns the application schema that this FeatureStore serves.
 CRS getStorageSRS()
          Returns the native CRS used for storing geometries.
 void init()
          Called by the container to indicate that this FeatureStore instance is being placed into service.
 boolean isAvailable()
          Returns whether the store is currently able to perform operations.
 FeatureResultSet query(Query query)
          Performs the given query and returns the matching features as a FeatureResultSet.
 FeatureResultSet query(Query[] queries)
          Performs the given queries and returns the matching features as a FeatureResultSet.
 int queryHits(Query query)
          Returns the number of features that are matched by the given query.
 int queryHits(Query[] queries)
          Returns the number of features that are matched by the given queries.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

LOG

static final org.slf4j.Logger LOG

available

boolean available

conn

Connection conn

crs

CRS crs

fac

GeometryFactory fac

featureType

GenericFeatureType featureType

transformer

GeometryTransformer transformer

lods

TreeMap<Integer,String> lods
Constructor Detail

SimpleSQLDatastore

public SimpleSQLDatastore(String connId,
                          String crs,
                          String sql,
                          String featureName,
                          String namespace,
                          String bbox,
                          List<Pair<Integer,String>> lods)
Parameters:
connId -
crs -
sql -
featureName -
namespace -
bbox -
lods -
Method Detail

acquireTransaction

public FeatureStoreTransaction acquireTransaction()
                                           throws FeatureStoreException
Description copied from interface: FeatureStore
Acquires transactional access to the feature store.

Specified by:
acquireTransaction in interface FeatureStore
Returns:
transaction object that allows to perform transactions operations on the datastore, never null
Throws:
FeatureStoreException - if the transactional access could not be acquired or is not implemented for this FeatureStore

destroy

public void destroy()
Description copied from interface: FeatureStore
Called by the container to indicate that this FeatureStore instance is being taken out of service.

Specified by:
destroy in interface FeatureStore

getEnvelope

public Envelope getEnvelope(QName ftName)
Description copied from interface: FeatureStore
Returns the envelope for all stored features of the given type.

Specified by:
getEnvelope in interface FeatureStore
Parameters:
ftName - name of the feature type, must not be null and must be served by this store
Returns:
the envelope (using the native CRS), or null if the feature type is not known

getLockManager

public LockManager getLockManager()
                           throws FeatureStoreException
Description copied from interface: FeatureStore
Returns the associated LockManager.

Specified by:
getLockManager in interface FeatureStore
Returns:
the associated LockManager instance, never null
Throws:
FeatureStoreException - if the FeatureStore does not implement locking

getObjectById

public GMLObject getObjectById(String id)
                        throws FeatureStoreException
Description copied from interface: FeatureStore
Retrieves the stored object with a certain id. TODO check if a common interface for returned objects should be used here (instead of Object)

Specified by:
getObjectById in interface FeatureStore
Parameters:
id - identifier of the object to be retrieved
Returns:
the stored object (either a Feature or a Geometry) or null if no object with the given id is known
Throws:
FeatureStoreException - if the query could not be performed

getSchema

public ApplicationSchema getSchema()
Description copied from interface: FeatureStore
Returns the application schema that this FeatureStore serves.

Specified by:
getSchema in interface FeatureStore
Returns:
the served application schema, never null

init

public void init()
          throws FeatureStoreException
Description copied from interface: FeatureStore
Called by the container to indicate that this FeatureStore instance is being placed into service.

Specified by:
init in interface FeatureStore
Throws:
FeatureStoreException - if the initialization fails

isAvailable

public boolean isAvailable()
Description copied from interface: FeatureStore
Returns whether the store is currently able to perform operations.

Specified by:
isAvailable in interface FeatureStore
Returns:
true, if the store is functional, false otherwise

query

public FeatureResultSet query(Query query)
                       throws FeatureStoreException,
                              FilterEvaluationException
Description copied from interface: FeatureStore
Performs the given query and returns the matching features as a FeatureResultSet.

Specified by:
query in interface FeatureStore
Parameters:
query - query to be performed, must not be null
Returns:
matching features, never null
Throws:
FeatureStoreException - if the query could not be performed
FilterEvaluationException - if the filter contained in the query could not be evaluated

query

public FeatureResultSet query(Query[] queries)
                       throws FeatureStoreException,
                              FilterEvaluationException
Description copied from interface: FeatureStore
Performs the given queries and returns the matching features as a FeatureResultSet.

Specified by:
query in interface FeatureStore
Parameters:
queries - queries to be performed, must not be null and contain at least one entry
Returns:
matching features, never null
Throws:
FeatureStoreException - if the query could not be performed
FilterEvaluationException - if the filter contained in the query could not be evaluated

queryHits

public int queryHits(Query query)
              throws FeatureStoreException,
                     FilterEvaluationException
Description copied from interface: FeatureStore
Returns the number of features that are matched by the given query.

Specified by:
queryHits in interface FeatureStore
Parameters:
query - query to be performed, must not be null
Returns:
number of matching featuress
Throws:
FeatureStoreException - if the query could not be performed
FilterEvaluationException - if the filter contained in the query could not be evaluated

queryHits

public int queryHits(Query[] queries)
              throws FeatureStoreException,
                     FilterEvaluationException
Description copied from interface: FeatureStore
Returns the number of features that are matched by the given queries.

Specified by:
queryHits in interface FeatureStore
Parameters:
queries - queries to be performed, must not be null and contain at least one entry
Returns:
number of matching features
Throws:
FeatureStoreException - if the query could not be performed
FilterEvaluationException - if the filter contained in the query could not be evaluated

getStorageSRS

public CRS getStorageSRS()
Description copied from interface: FeatureStore
Returns the native CRS used for storing geometries.

Specified by:
getStorageSRS in interface FeatureStore
Returns:
the native CRS used for storing geometries, can be null

deegree-core-3.0-pre-nightly (2010/03/05 00:01) - official

an open source project founded by lat/lon, Bonn, Germany.
For more information visit: http://www.deegree.org

]]>