SOS-Test-Suite

How to use the test suite

Include the following artifacts in your pom.xml:

<dependency>
    <groupId>org.n52.sensorweb.sos</groupId>
    <artifactId>test-suite-common</artifactId>
    <version>1.0.0-SNAPSHOT</version>
    <scope>test</scope>
</dependency>
<dependency>
    <groupId>org.n52.sensorweb.sos</groupId>
    <artifactId>test-suite-sos-20</artifactId>
    <version>1.0.0-SNAPSHOT</version>
    <scope>test</scope>
</dependency>

The tests can be faciliated by implementing the class ComplianceSuite. The method #getTests() defines the tests that sould be run with the RequestExecutor provided by the method #getExecutor().

The RequestExecutor provides methods to build and issue request to a service instance. The instance can be external deployed, embedded with Jetty or even a HTTPServlet instance that is feeded with mocked requests and responses.

Additional dependencies and requirements should be included by using JUnit rules. The following example uses a H2 database as a ExternalResource (which also bootstraps the service) and issues requests using the provided MockHttpExecutor. The tested service uses different endpoints for bindings which are defined in the implemented methods of MockHttpExecutor.

import org.junit.Rule;
import org.junit.runner.RunWith;
import org.n52.sos.service.SosService;
import org.n52.sos.service.it.*;
import org.n52.sos.service.it.v2.kvp.*;

@RunWith(ComplianceSuiteRunner.class)
public class KvpSuiteTest implements ComplianceSuite {
    private final H2Database datasource = new H2Database();
    private final RequestExecutor executor = new RequestExecutorImpl();

    @Rule public H2Database getDatasource() { return this.datasource; }
    @Override public RequestExecutor getExecutor() { return this.executor; }

    @Override
    public Class<?>[] getTests() {
        return new Class<?>[] {
            DeleteObservationTest.class,
            DeleteSensorTest.class,
            DescribeSensorTest.class,
            GetCapabilitiesTest.class,
            GetDataAvailabilityTest.class,
            GetFeatureOfInterestTest.class,
            GetObservationByIdTest.class,
            GetObservationTest.class,
            GetResultTemplateTest.class,
            GetResultTest.class
        };
    }

    private class RequestExecutorImpl extends MockHttpExecutor {
        RequestExecutorImpl() { super(SosService.class); }
        @Override public Client kvp() { return get("/kvp"); }
        @Override public Client pox() { return post("/pox"); }
        @Override public Client soap() { return post("/soap"); }
    }
}

How to provide tests

Tests are instances of AbstractComplianceSuiteTest. The class provides methods to obtain an RequestExecutor/Client to issue requests:

import static org.hamcrest.Matchers.*;
import static org.junit.Assert.assertThat;
import static org.n52.sos.service.it.v2.ExceptionMatchers.*;
import org.junit.Test;
import org.n52.sos.service.it.*;
import org.w3c.dom.Node;

public class GetObservationTest extends AbstractComplianceSuiteTest {

    @Test public void missingServiceParameter() {
        Node node = getExecutor().kvp()
                .query("request", "GetObservation")
                .query("version", "2.0.0")
                .response().asNode();
        assertThat(node, is(missingServiceParameterValueException()));
    }
}