org.deegree.feature.persistence
Interface FeatureStoreTransaction

All Known Implementing Classes:

MemoryFeatureStoreTransaction, PostGISFeatureStoreTransaction

public interface FeatureStoreTransaction

Provides transactional access to a FeatureStore.

Please note that a transaction must always be ended by calling either commit() or rollback().

Version:

$Revision: 20612 $, $Date: 2009-11-05 18:53:29 +0100 (Do, 05 Nov 2009) $

Author:

Markus Schneider, last edited by: $Author: mschneider $

See Also:

FeatureStore.acquireTransaction()

Nested Class Summary

static class

FeatureStoreTransaction.IDGenMode Enum type for discriminating the different object id generation policies for inserts.

Method Summary

void	commit() Makes the changes persistent that have been performed in this transaction and releases the transaction instance so other clients may acquire a transaction on the FeatureStore.
FeatureStore	getStore() Returns the underlying FeatureStore instance.
int	performDelete(IdFilter filter, Lock lock) Deletes the features from the FeatureStore that are matched by the given filter.
int	performDelete(QName ftName, OperatorFilter filter, Lock lock) Deletes the features from the FeatureStore that are matched by the given filter and type.
List<String>	performInsert(FeatureCollection fc, FeatureStoreTransaction.IDGenMode mode) Inserts the member features of the given FeatureCollection into the FeatureStore.
int	performUpdate(QName ftName, List<Property<?>> replacementProps, Filter filter, Lock lock) Performs an update operation against the FeatureStore.
void	rollback() Aborts the changes that have been performed in this transaction and releases the transaction instance so other clients may acquire a transaction on the FeatureStore.

Method Detail

getStore

FeatureStore getStore()

Returns the underlying FeatureStore instance.

Returns:

the underlying FeatureStore instance

commit

void commit()
            throws FeatureStoreException

Makes the changes persistent that have been performed in this transaction and releases the transaction instance so other clients may acquire a transaction on the FeatureStore.

Throws:

FeatureStoreException - if the committing fails

rollback

void rollback()
              throws FeatureStoreException

Aborts the changes that have been performed in this transaction and releases the transaction instance so other clients may acquire a transaction on the FeatureStore.

Throws:

FeatureStoreException - if the rollback fails

performInsert

List<String> performInsert(FeatureCollection fc,
                           FeatureStoreTransaction.IDGenMode mode)
                           throws FeatureStoreException

Inserts the member features of the given FeatureCollection into the FeatureStore.

Parameters:

fc - contains the member features to be inserted, their types must be served by the feature store and must not be null

mode - mode for deriving the ids of the inserted objects

Returns:

feature ids of the inserted (root) features

Throws:

FeatureStoreException - if the insertion fails

performUpdate

int performUpdate(QName ftName,
                  List<Property<?>> replacementProps,
                  Filter filter,
                  Lock lock)
                  throws FeatureStoreException

Performs an update operation against the FeatureStore.

Parameters:

ftName - name of the feature type of the features to be updated, must not be null and served by the store

replacementProps - properties and their replacement values

filter - selects the feature instances that are to be updated

lock - optional lock object, may be null

Returns:

number of updated feature instances

Throws:

FeatureStoreException - if the update fails

performDelete

int performDelete(QName ftName,
                  OperatorFilter filter,
                  Lock lock)
                  throws FeatureStoreException

Deletes the features from the FeatureStore that are matched by the given filter and type.

Parameters:

ftName - feature type of the features to be deleted, must not be null and served by the store

filter - filter that determines the features to be deleted

lock - optional lock object, may be null

Returns:

number of deleted feature instances

Throws:

FeatureStoreException - if the deletion fails

performDelete

int performDelete(IdFilter filter,
                  Lock lock)
                  throws FeatureStoreException

Deletes the features from the FeatureStore that are matched by the given filter.

Parameters:

filter - filter that determines the features to be deleted

lock - optional lock object, may be null

Returns:

number of deleted feature instances

Throws:

FeatureStoreException - if the deletion fails