org.opengis.cite.iso19142.SuitePreconditions Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of ets-wfs20 Show documentation
Checks WFS 2.0 implementations for conformance to ISO 19142:2010.
There is a newer version: 2.0-r18
package org.opengis.cite.iso19142;

import java.util.ArrayList;
import java.util.Map;
import java.util.logging.Logger;

import javax.xml.namespace.QName;

import org.opengis.cite.iso19142.util.DataSampler;
import org.opengis.cite.iso19142.util.WFSClient;
import org.testng.Assert;
import org.testng.ITestContext;
import org.testng.ITestResult;
import org.testng.Reporter;
import org.testng.annotations.AfterMethod;
import org.testng.annotations.Test;
import org.w3c.dom.Document;
import org.w3c.dom.Element;

/**
 * Includes tests to confirm the readiness of the SUT to undergo testing. If any
 * of these test methods fail then its name is added to the suite attribute
 * {@link org.opengis.cite.iso19142.SuiteAttribute#FAILED_PRECONDITIONS}. The
 * presence of the attribute can be checked in a @BeforeTest method
 * to determine whether or not a set of tests should be skipped if one or more
 * preconditions were not satisfied.
 * 
 */
public class SuitePreconditions {

	private static final Logger LOGR = Logger
			.getLogger(SuitePreconditions.class.getName());

	@AfterMethod
	@SuppressWarnings("unchecked")
	public void preconditionNotSatisfied(ITestResult result) {
		if (!result.isSuccess()) {
			Object failedPreconditions = result
					.getTestContext()
					.getSuite()
					.getAttribute(SuiteAttribute.FAILED_PRECONDITIONS.getName());
			if (null == failedPreconditions) {
				failedPreconditions = new ArrayList();
				result.getTestContext()
						.getSuite()
						.setAttribute(
								SuiteAttribute.FAILED_PRECONDITIONS.getName(),
								failedPreconditions);
			}
			ArrayList.class.cast(failedPreconditions).add(result.getName());
		}
	}

	/**
	 * [{@literal @Test}] Verifies that the service capabilities description
	 * contains all required elements in accord with the "Simple WFS"
	 * conformance class.
	 * 
	 * @param testContext
	 *            The test run context (ITestContext).
	 */
	@Test(description = "Capabilities doc indicates at least 'Simple WFS' conformance")
	public void verifyServiceDescription(ITestContext testContext) {
		Document wfsMetadata = (Document) testContext.getSuite().getAttribute(
				SuiteAttribute.TEST_SUBJECT.getName());
		ETSAssert.assertSimpleWFSCapabilities(wfsMetadata);
	}

	/**
	 * [{@literal @Test}] Confirms that the SUT is available and produces a
	 * service description in response to a basic GetCapabilities request. The
	 * document element is expected to have the following infoset properties:
	 * 
	 * [local name] = "WFS_Capabilities"
	 * [namespace name] = "http://www.opengis.net/wfs/2.0"
	 * 
	 * 
	 * @param testContext
	 *            Supplies details about the test run.
	 */
	@Test(description = "SUT produces GetCapabilities response", dependsOnMethods = { "verifyServiceDescription" })
	public void serviceIsAvailable(ITestContext testContext) {
		Document wfsMetadata = (Document) testContext.getSuite().getAttribute(
				SuiteAttribute.TEST_SUBJECT.getName());
		WFSClient wfsClient = new WFSClient(wfsMetadata);
		Document capabilities = wfsClient.getCapabilities();
		Assert.assertNotNull(capabilities,
				"No GetCapabilities response from SUT.");
		Element docElement = capabilities.getDocumentElement();
		Assert.assertEquals(docElement.getLocalName(), WFS2.WFS_CAPABILITIES,
				"Capabilities document element has unexpected [local name].");
		Assert.assertEquals(docElement.getNamespaceURI(), Namespaces.WFS,
				"Capabilities document element has unexpected [namespace name].");
	}

	/**
	 * [{@literal @Test}] Confirms that the SUT can supply data for at least one
	 * advertised feature type.
	 * 
	 * @param testContext
	 *            Supplies details about the test run.
	 */
	@Test(description = "SUT has data for at least one advertised feature type", dependsOnMethods = { "verifyServiceDescription" })
	public void dataAreAvailable(ITestContext testContext) {
		Document wfsMetadata = (Document) testContext.getSuite().getAttribute(
				SuiteAttribute.TEST_SUBJECT.getName());
		DataSampler sampler = new DataSampler(wfsMetadata);
		sampler.acquireFeatureData();
		Map featureTypeInfo = sampler
				.getFeatureTypeInfo();
		boolean sutHasData = false;
		for (FeatureTypeInfo typeInfo : featureTypeInfo.values()) {
			if (typeInfo.isInstantiated()) {
				sutHasData = true;
				break;
			}
		}
		if (!sutHasData) {
			String msg = ErrorMessage.get(ErrorMessageKeys.DATA_UNAVAILABLE);
			LOGR.warning(msg + featureTypeInfo.toString());
			Reporter.getOutput().add(msg);
			throw new AssertionError(msg);
		}
	}
}