org.deegree.feature.persistence.postgis
Class PostGISFeatureStoreTransaction

java.lang.Object
  org.deegree.feature.persistence.postgis.PostGISFeatureStoreTransaction

All Implemented Interfaces:

FeatureStoreTransaction

public class PostGISFeatureStoreTransaction
extends java.lang.Object
implements FeatureStoreTransaction

FeatureStoreTransaction implementation used by the PostGISFeatureStore.

Version:

$Revision: 27880 $, $Date: 2010-11-09 14:47:55 +0100 (Di, 09. Nov 2010) $

Author:

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

See Also:

PostGISFeatureStore

Nested Class Summary

Nested classes/interfaces inherited from interface org.deegree.feature.persistence.FeatureStoreTransaction

FeatureStoreTransaction.IDGenMode

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.
java.sql.Connection	getConnection() Returns the underlying JDBC connection.
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(javax.xml.namespace.QName ftName, OperatorFilter filter, Lock lock) Deletes the features from the FeatureStore that are matched by the given filter and type.
java.util.List<java.lang.String>	performInsert(FeatureCollection fc, FeatureStoreTransaction.IDGenMode mode) Inserts the given FeaureCollection into the FeatureStore (including subfeatures).
int	performUpdate(javax.xml.namespace.QName ftName, java.util.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.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

commit

public void commit()
            throws FeatureStoreException

Description copied from interface: FeatureStoreTransaction

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.

Specified by:

commit in interface FeatureStoreTransaction

Throws:

FeatureStoreException - if the committing fails

getStore

public FeatureStore getStore()

Description copied from interface: FeatureStoreTransaction

Returns the underlying FeatureStore instance.

Specified by:

getStore in interface FeatureStoreTransaction

Returns:

the underlying FeatureStore instance, never null

getConnection

public java.sql.Connection getConnection()

Returns the underlying JDBC connection. Can be used for performing other operations in the same transaction context.

Returns:

the underlying JDBC connection, never null

performDelete

public int performDelete(javax.xml.namespace.QName ftName,
                         OperatorFilter filter,
                         Lock lock)
                  throws FeatureStoreException

Description copied from interface: FeatureStoreTransaction

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

Specified by:

performDelete in interface FeatureStoreTransaction

Parameters:

ftName - feature type of the features to be deleted, must not be null

filter - filter that determines the features to be deleted, must not be null

lock - optional lock object, may be null

Returns:

number of deleted feature instances

Throws:

FeatureStoreException - if the deletion fails

performDelete

public int performDelete(IdFilter filter,
                         Lock lock)
                  throws FeatureStoreException

Description copied from interface: FeatureStoreTransaction

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

Specified by:

performDelete in interface FeatureStoreTransaction

Parameters:

filter - filter that determines the features to be deleted, must not be null

lock - optional lock object, may be null

Returns:

number of deleted feature instances

Throws:

FeatureStoreException - if the deletion fails (*not* if a specified id does not exist)

performInsert

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

Description copied from interface: FeatureStoreTransaction

Inserts the given FeaureCollection into the FeatureStore (including subfeatures).

Specified by:

performInsert in interface FeatureStoreTransaction

Parameters:

fc - features to be inserted, must not be null

mode - mode for deriving the ids of the inserted objects, must not be null

Returns:

effective ids of the inserted feature and subfeatures (in document order)

Throws:

FeatureStoreException - if the insertion fails

performUpdate

public int performUpdate(javax.xml.namespace.QName ftName,
                         java.util.List<Property> replacementProps,
                         Filter filter,
                         Lock lock)
                  throws FeatureStoreException

Description copied from interface: FeatureStoreTransaction

Performs an update operation against the FeatureStore.

Specified by:

performUpdate in interface FeatureStoreTransaction

Parameters:

ftName - feature type of the features to be updated, must not be null

replacementProps - properties and their replacement values, must not be null

filter - selects the feature instances that are to be updated, must not be null

lock - optional lock object, may be null

Returns:

number of updated feature instances

Throws:

FeatureStoreException - if the update fails

rollback

public void rollback()
              throws FeatureStoreException

Description copied from interface: FeatureStoreTransaction

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.

Specified by:

rollback in interface FeatureStoreTransaction

Throws:

FeatureStoreException - if the rollback fails