org.opengis.cite.cat30.basic

Class OGCWebServiceTests

java.lang.Object

org.opengis.cite.cat30.CommonFixture

org.opengis.cite.cat30.basic.OGCWebServiceTests

public class OGCWebServiceTests
extends CommonFixture

Provides tests that apply to the OGCWebService interface defined in the common service model (OGC 06-121r9, Figure C.2) as adapted for Catalogue 3.0 implementations. The following service requests are covered:

• GetCapabilities: KVP syntax
• GetRecordById: KVP syntax

Field Summary

Fields inherited from class org.opengis.cite.cat30.CommonFixture

client, ROOT_PKG_PATH

Constructor Summary

Constructors

Constructor and Description
OGCWebServiceTests()

Method Summary

Methods

Modifier and Type	Method and Description
void	getCapabilitiesIsMissingServiceParam() [Test] If the required "service" parameter is missing, an exception report with status code 400 must be produced.
void	getCapabilitiesWithInvalidParamValue() [Test] Query parameter values must be handled in a case-sensitive manner.
void	getCapabilitiesWithMixedCaseParamNames() [Test] Query parameter names must be handled in a case-insensitive manner.
void	getCapabilitiesWithUnsupportedVersion() [Test] Verifies that a request for an unsupported version of a capabilities document produces an exception report containing the exception code "VersionNegotiationFailed".
void	getFullCapabilities_v3() [Test] Verifies that the content of a complete service capabilities document is schema-valid.
void	getRecordById_noMatchingRecord() [Test] Verifies that a request for a record by identifier produces a response with status code 404 (Not Found) if no matching resource is found.
void	initOGCWebServiceTests(ITestContext testContext) Initializes the test fixture with the following items: CSW message schema (obtained from the suite attribute SuiteAttribute.CSW_SCHEMA, which should evaluate to a thread-safe Schema object). service capabilities document (obtained from the suite attribute SuiteAttribute.TEST_SUBJECT, which should evaluate to a DOM Document node).
void	setServiceCapabilities(Document cswCapabilities) Sets the service capabilities document.
void	verifyTestSubject(ITestContext testContext) Verifies that a service capabilities document was obtained and that the implementation under test is available.

Methods inherited from class org.opengis.cite.cat30.CommonFixture

initCommonFixture

Methods inherited from class java.lang.Object

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

Constructor Detail

OGCWebServiceTests

public OGCWebServiceTests()

Method Detail

verifyTestSubject

public void verifyTestSubject(ITestContext testContext)

Verifies that a service capabilities document was obtained and that the implementation under test is available. If either condition is false all tests will be marked as skipped.

Parameters:

testContext - Information about the pending test run.

initOGCWebServiceTests

public void initOGCWebServiceTests(ITestContext testContext)

Initializes the test fixture with the following items:

• CSW message schema (obtained from the suite attribute SuiteAttribute.CSW_SCHEMA, which should evaluate to a thread-safe Schema object).
• service capabilities document (obtained from the suite attribute SuiteAttribute.TEST_SUBJECT, which should evaluate to a DOM Document node).

Parameters:

testContext - The test context containing various suite attributes.

setServiceCapabilities

public void setServiceCapabilities(Document cswCapabilities)

Sets the service capabilities document. This method is intended to facilitate unit testing.

Parameters:

cswCapabilities - A Document node representing a service description (csw:Capabilities).

getFullCapabilities_v3

public void getFullCapabilities_v3()

[Test] Verifies that the content of a complete service capabilities document is schema-valid. All implementations must support the GET method for a GetCapabilities request.

The Accept request header expresses a preference for a representation of type "application/xml".

See Also:

"OGC 06-121r9, 7.2.1: GetCapabilities request parameters"

getCapabilitiesWithMixedCaseParamNames

public void getCapabilitiesWithMixedCaseParamNames()

[Test] Query parameter names must be handled in a case-insensitive manner. The parameter names are all presented in mixed case; a complete capabilities document is expected in response.

See Also:

"OGC 12-176r5, 6.5.4: KVP encoding rules"

getCapabilitiesWithInvalidParamValue

public void getCapabilitiesWithInvalidParamValue()

[Test] Query parameter values must be handled in a case-sensitive manner. The request specifies request=getCapabilities; an exception report is expected in response with OGC exception code "InvalidParameterValue" and status code 400.

See Also:

"OGC 12-176r5, 6.5.4: KVP encoding rules", "OGC 06-121r9, Table 28: Standard exception codes and meanings"

getCapabilitiesIsMissingServiceParam

public void getCapabilitiesIsMissingServiceParam()

[Test] If the required "service" parameter is missing, an exception report with status code 400 must be produced. The expected OGC exception code is "MissingParameterValue".

See Also:

"OGC 12-176r5, Table 5: KVP encoding of common operation request parameters"

getCapabilitiesWithUnsupportedVersion

public void getCapabilitiesWithUnsupportedVersion()

[Test] Verifies that a request for an unsupported version of a capabilities document produces an exception report containing the exception code "VersionNegotiationFailed". The status code must be 400 (Bad Request) and the response entity must be an XML document having {http://www.opengis.net/ows/2.0}ExceptionReport as the document element.

See Also:

"OGC 06-121r9, 7.3.2: Version negotiation"

getRecordById_noMatchingRecord

public void getRecordById_noMatchingRecord()

[Test] Verifies that a request for a record by identifier produces a response with status code 404 (Not Found) if no matching resource is found. A response entity (an exception report) is optional; if present, the exception code shall be "InvalidParameterValue".

See Also:

"OGC 06-121r9, 9.3.3.2"