org.deegree.io.datastore
Interface DatastoreTransaction

All Known Implementing Classes:

GenericSQLTransaction, SDETransaction, SQLTransaction

public interface DatastoreTransaction

Handler for TransactionOperations (Insert, Update, Delete, Native). One instance is bound to exactly one Datastore instance (and one Datastore has no more than one active DatastoreTransaction at a time.

Version:

$Revision: 9342 $, $Date: 2007-12-27 13:32:57 +0100 (Do, 27 Dez 2007) $

Author:

Anup Deshmukh, Markus Schneider, last edited by: $Author: apoth $

Method Summary

void	commit() Makes the changes persistent that have been performed in this transaction.
Datastore	getDatastore() Returns the associated Datastore instance.
int	performDelete(MappedFeatureType mappedFeatureType, Filter filter, String lockId) Deletes the features from the datastore that are matched by the given filter and type.
List<FeatureId>	performInsert(List<Feature> features) Inserts the given feature instances into the datastore.
int	performNative(Native operation) Performs a native operation against the datastore.
int	performUpdate(MappedFeatureType mappedFeatureType, Feature replacementFeature, Filter filter, String lockId) Performs an update operation against the datastore.
int	performUpdate(MappedFeatureType mappedFeatureType, Map<PropertyPath,FeatureProperty> replacementProps, Filter filter, String lockId) Performs an update operation against the datastore.
void	release() Releases the transaction instance so other clients may acquire a transaction (and underlying resources, such as JDBCConnections can be cleaned up).
void	rollback() Aborts the changes that have been performed in this transaction.

Method Detail

getDatastore

Datastore getDatastore()

Returns the associated Datastore instance.

Returns:

the associated Datastore instance

commit

void commit()
            throws DatastoreException

Makes the changes persistent that have been performed in this transaction.

Throws:

DatastoreException

rollback

void rollback()
              throws DatastoreException

Aborts the changes that have been performed in this transaction.

Throws:

DatastoreException

release

void release()
             throws DatastoreException

Releases the transaction instance so other clients may acquire a transaction (and underlying resources, such as JDBCConnections can be cleaned up).

Throws:

DatastoreException

performInsert

List<FeatureId> performInsert(List<Feature> features)
                              throws DatastoreException

Inserts the given feature instances into the datastore.

Please note that the features to be inserted must have suitable feature ids at this point.

Parameters:

features -

Returns:

feature ids of the inserted (root) features

Throws:

DatastoreException

See Also:

FeatureIdAssigner

performUpdate

int performUpdate(MappedFeatureType mappedFeatureType,
                  Map<PropertyPath,FeatureProperty> replacementProps,
                  Filter filter,
                  String lockId)
                  throws DatastoreException

Performs an update operation against the datastore.

Parameters:

mappedFeatureType - feature type that is to be updated

replacementProps - properties and their replacement values

filter - selects the feature instances that are to be updated

lockId - optional id of associated lock (may be null)

Returns:

number of updated feature instances

Throws:

DatastoreException

performUpdate

int performUpdate(MappedFeatureType mappedFeatureType,
                  Feature replacementFeature,
                  Filter filter,
                  String lockId)
                  throws DatastoreException

Performs an update operation against the datastore.

The filter is expected to match exactly one feature which will be replaced by the specified replacement feature.

Parameters:

mappedFeatureType - feature type that is to be updated

replacementFeature - feature instance that will replace the selected feature

filter - selects the single feature instances that is to be replaced

lockId - optional id of associated lock (may be null)

Returns:

number of updated feature instances (must be 0 or 1)

Throws:

DatastoreException

performDelete

int performDelete(MappedFeatureType mappedFeatureType,
                  Filter filter,
                  String lockId)
                  throws DatastoreException

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

Parameters:

mappedFeatureType -

filter -

lockId - optional id of associated lock (may be null)

Returns:

number of deleted feature instances

Throws:

DatastoreException

performNative

int performNative(Native operation)
                  throws DatastoreException

Performs a native operation against the datastore.

Parameters:

operation - operation to perform

Returns:

int

Throws:

DatastoreException