org.opengis.cite.iso19142.locking

Class LockFeatureTests

java.lang.Object

org.opengis.cite.iso19142.BaseFixture

org.opengis.cite.iso19142.locking.LockingFixture

org.opengis.cite.iso19142.locking.LockFeatureTests

public class LockFeatureTests
extends LockingFixture

Tests the response to a LockFeature request that attempts to lock feature instances identified using one or more query expressions. A lock is active until it either expires (default duration is 300 s) or it is released by a subsequent transaction.

Sources

• ISO 19142:2010, cl. 12: LockFeature operation
• ISO 19142:2010, cl. 12.4: Exceptions
• ISO 19142:2010, cl. 15.2.3.1.1: Declaring support for locking

Field Summary

Fields inherited from class org.opengis.cite.iso19142.locking.LockingFixture

dataSampler, locks, storedQueryId

Fields inherited from class org.opengis.cite.iso19142.BaseFixture

docBuilder, ETS_PKG, featureInfo, featureTypes, reqEntity, rspEntity, supportedBindings, TNS_PREFIX, wfsClient, wfsMetadata, wfsVersion

Constructor Summary

Constructors

Constructor and Description
LockFeatureTests()

Method Summary

Modifier and Type	Method and Description
void	buildSimpleLockFeatureRequest() Builds a DOM Document representing a LockFeature request entity.
(package private) Map<String,QName>	fetchRandomFeatureIdentifier(Map<QName,FeatureTypeInfo> featureInfo) Obtains the system-assigned identifier of an instance of some randomly selected feature type.
void	lockAllFeaturesByType(ProtocolBinding binding, QName featureType) [Test] Locks all feature instances of a given type using default values for all locking options.
void	lockFeatureAlreadyLocked() [Test] A feature instance may be locked by only one lock.
void	lockFeatureAndAttemptDelete() [Test] Submits a request to lock a feature instance; within this interval an attempt to delete the instance without the correct lock identifier should fail with exception code MissingParameterValue.
void	resetNonexistentLock() [Test] An attempt to reset a non-existent lock should produce a service exception with error code "LockHasExpired" and HTTP status code 403 (Forbidden).
(package private) static QName	selectRandomFeatureType(Map<QName,FeatureTypeInfo> featureTypes) Randomly selects a feature type name for which instances are available in the SUT.

Methods inherited from class org.opengis.cite.iso19142.locking.LockingFixture

initLockingFixture, releaseAllLocks

Methods inherited from class org.opengis.cite.iso19142.BaseFixture

addAttributesOnTestFailure, allProtocolsAndFeatureTypes, bindingAndAvailFeatureTypeProductSet, extractBodyAsDocument, getFeatureTypes, getInstantiatedFeatureTypes, getProtocolBindings, initBaseFixture, initParser, setWfsClient

Methods inherited from class java.lang.Object

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

Constructor Detail

LockFeatureTests

public LockFeatureTests()

Method Detail

buildSimpleLockFeatureRequest

public void buildSimpleLockFeatureRequest()

Builds a DOM Document representing a LockFeature request entity.

resetNonexistentLock

public void resetNonexistentLock()

[Test] An attempt to reset a non-existent lock should produce a service exception with error code "LockHasExpired" and HTTP status code 403 (Forbidden).

Note: The WFS2 specification makes no distinction between a non-existent and an expired lock in this context. The error code InvalidLockId would seem more appropriate here but that may only appear in a Transaction response according to Table 3.

Sources

• ISO 19142:2010, cl. 12.2.4.2: lockId parameter
• ISO 19142:2010, Table D.2

lockFeatureAndAttemptDelete

public void lockFeatureAndAttemptDelete()

[Test] Submits a request to lock a feature instance; within this interval an attempt to delete the instance without the correct lock identifier should fail with exception code MissingParameterValue.

Sources

• ISO 19142:2010, cl. 12.2.4.3: Lock expiry parameter
• ISO 19142:2010, cl. 15.2.3.1.2: lockId parameter

lockFeatureAlreadyLocked

public void lockFeatureAlreadyLocked()

[Test] A feature instance may be locked by only one lock. An attempt to establish another lock should fail with exception code CannotLockAllFeatures if lockAction = "ALL" (the default value).

Sources

• ISO 19142:2010, Table 18: Keywords for LockFeature KVP encoding
• ISO 19142:2010, cl. 12.2.5: State machine for WFS locking

lockAllFeaturesByType

public void lockAllFeaturesByType(ProtocolBinding binding,
                                  QName featureType)

[Test] Locks all feature instances of a given type using default values for all locking options. If no data exist for a given feature type it is skipped. The response entity must include a lockId attribute and the wfs:FeaturesLocked element. The wfs:FeatureNotLocked element must not be present.

Sources

• ISO 19142:2010, cl. 12.3.2: XML-encoding

Parameters:

binding - The ProtocolBinding to use for the request.

featureType - A QName object denoting the feature type name.

fetchRandomFeatureIdentifier

Map<String,QName> fetchRandomFeatureIdentifier(Map<QName,FeatureTypeInfo> featureInfo)

Obtains the system-assigned identifier of an instance of some randomly selected feature type.

Parameters:

featureInfo - A Map containing information about supported feature types, keyed by type name (QName).

Returns:

A Map containing at most a single entry that associates the (String) value of the gml:id attribute with the feature type name (QName); the map is empty if no data exist in the SUT.

selectRandomFeatureType

static QName selectRandomFeatureType(Map<QName,FeatureTypeInfo> featureTypes)

Randomly selects a feature type name for which instances are available in the SUT.

Parameters:

featureTypes - A Map containing information about supported feature types, keyed by type name (QName).

Returns:

A QName object denoting the name of a feature type, or null if no data exist in the SUT.