org.opengis.cite.iso19142.simple

Class StoredQueryTests

java.lang.Object

org.opengis.cite.iso19142.BaseFixture

org.opengis.cite.iso19142.simple.StoredQueryTests

public class StoredQueryTests
extends BaseFixture

Tests the service response to a GetFeature request that invokes a stored query. A WFS implementation is required to support stored queries at this conformance level.

Sources

• ISO 19142:2010, cl. A.1.1: Simple WFS
• ISO 19142:2010, cl. 11: GetFeature operation
• ISO 19142:2010, cl. 7.9.3: Stored query expression

Field Summary

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
StoredQueryTests()

Method Summary

Modifier and Type	Method and Description
void	buildGetFeatureRequestEntity() Builds a DOM Document representing a GetFeature request entity that contains no query expressions.
(package private) NodeList	executeGetFeatureByType(QName featureType, ProtocolBinding binding) Submits a request to execute the GetFeatureByType stored query.
(package private) String	findFeatureIdentifier(Document wfsMetadata) Attempts to find a feature identifier by (a) querying the SUT if it implements the "Basic WFS" conformance class, or (b) invoking the stored query GetFeatureByType.
void	initClassFixture(String fid, ITestContext testContext) Initializes the test class fixture.
void	invokeGetFeatureById(ProtocolBinding binding) [Test] Invoking the GetFeatureById query with a known feature identifier shall produce the matching feature representation (@gml:id) as the response entity.
void	invokeGetFeatureByIdWithUnknownID(ProtocolBinding binding) [Test] Invoking the GetFeatureById query with an id parameter value that does not match any feature should produce an error response with status code 404 (Not Found).
void	unknownStoredQuery(ProtocolBinding binding) [Test] If no stored query matches the given identifier then an exception report with exception code "InvalidParameterValue" is expected.

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

StoredQueryTests

public StoredQueryTests()

Method Detail

initClassFixture

public void initClassFixture(String fid,
                             ITestContext testContext)

Initializes the test class fixture. The (pre-compiled) WFS schema and the 'fid' parameter are retrieved from the test run context.

Parameters:

fid - A String that identifies an available feature instance (gml:id attribute).

testContext - The test run context.

buildGetFeatureRequestEntity

public void buildGetFeatureRequestEntity()

Builds a DOM Document representing a GetFeature request entity that contains no query expressions.

unknownStoredQuery

public void unknownStoredQuery(ProtocolBinding binding)

[Test] If no stored query matches the given identifier then an exception report with exception code "InvalidParameterValue" is expected.

Parameters:

binding - The ProtocolBinding to use.

See Also:

"ISO 19142:2010, cl. 7.9.3.4: Stored query identifier"

invokeGetFeatureByIdWithUnknownID

public void invokeGetFeatureByIdWithUnknownID(ProtocolBinding binding)

[Test] Invoking the GetFeatureById query with an id parameter value that does not match any feature should produce an error response with status code 404 (Not Found). The corresponding OGC exception code in the response entity, if present, must be "NotFound". In the WFS 2.0.0 specification, clause 11.4 stipulates that "In the event that a web feature service encounters an error processing a GetFeature request, it shall raise an OperationProcessingFailed exception as described in 7.5." In Table D.2 this exception code is mapped to status code 403 for some reason.

Parameters:

binding - The ProtocolBinding to use.

See Also:

"OGC 09-026r2, cl. 11.3.5: GetFeatureById response", "OGC 09-026r1, cl. 7.9.3.6: GetFeatureById stored query"

invokeGetFeatureById

public void invokeGetFeatureById(ProtocolBinding binding)

[Test] Invoking the GetFeatureById query with a known feature identifier shall produce the matching feature representation (@gml:id) as the response entity. If there is no matching feature, an error response with a status code 404 (Not Found) is expected.

Parameters:

binding - The ProtocolBinding to use.

See Also:

"ISO 19142:2010, cl. 7.9.3.6: GetFeatureById stored query"

findFeatureIdentifier

String findFeatureIdentifier(Document wfsMetadata)

Attempts to find a feature identifier by (a) querying the SUT if it implements the "Basic WFS" conformance class, or (b) invoking the stored query GetFeatureByType.

Parameters:

wfsMetadata - A WFS capabilities document (wfs:WFS_Capabilities).

Returns:

A String representing a feature identifier.

executeGetFeatureByType

NodeList executeGetFeatureByType(QName featureType,
                                 ProtocolBinding binding)

Submits a request to execute the GetFeatureByType stored query.

Parameters:

featureType - A QName specifying the feature type name.

binding - The ProtocolBinding to use (if null any supported request message binding will be used).

Returns:

A NodeList containing feature instances of the specified type (it may be empty).