NSG Profile¶

Installing the extension¶

1. Download the NSG Profile extension from the nightly GeoServer community module builds.

2. Place the JARs into the WEB-INF/lib directory of the GeoServer installation.

Configure the extension¶

The root directory inside the GeoServer data directory for the nsg-profile community module is named nsg-profile and all the configurations properties are stored in a file named configuration.properties.

All configuration properties are changeable at runtime, which means that if a property is updated the module take it into account.

When the application starts if no configuration file exists one with the default values is created.

The GetFeature requests representations associated with an index result type is serialized and stored in the file system in a location that is configurable.

The default location, relative to the GeoServer data directory, is nsg-profie/resultSets.

The GetFeature request to resultSetID mapping is stored by default in an H2 DB in nsg-profie/resultSets folder; for details on database configuration see GeoTools JDBCDataStore syntax.

The configuration properties are the follows:

Index Result Type¶

The index result type extends the WFS hits result type by adding an extra attribute named resultSetID to the response. The resultSetID attribute can then be used by the PageResults operation to navigate randomly through the results.

A GetFeature request that uses the index result type should look like this:

http://<host>/geoserver/ows?service=WFS&version=2.0.0&request=GetFeature&typeNames=topp%3Atasmania_roads&resultType=index

The response of a GetFeature operation when the index result type is used should look like this:

<?xml version="1.0" encoding="UTF-8"?>
<wfs:FeatureCollection
 numberMatched="14"
 numberReturned="0"
 resultSetID="ef35292477a011e7b5a5be2e44b06b34"
 xmlns:fes="http://www.opengis.net/fes/2.0"
 xmlns:gml="http://www.opengis.net/gml/3.2"
 xmlns:ows="http://www.opengis.net/ows/1.1"
 xmlns:wfs="http://www.opengis.net/wfs/2.0"
 xmlns:xlink="http://www.w3.org/1999/xlink"
 xmlns:xs="http://www.w3.org/2001/XMLSchema"
 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 xsi:schemaLocation="http://www.opengis.net/wfs/2.0
 http://schemas.opengis.net/wfs/2.0/wfs.xsd"/>

The resultSetID is an unique identifier that identifies the original request.

Clients will use the resultSetID with the PageResults operation to reference the original request.

If pagination is used, the previous and next attributes should appear as in hits result type request.

PageResults Operation¶

The PageResults operation allows clients to query random positions of an existing result set (stored GetFeature request) that was previously created using the index result type request.

The available parameters are this ones:

The two parameters that are not already supported by the GetFeature operation are the resultSetID parameter and the timeout parameter.

1. The resultSetID parameter should reference an existing result set (stored GetFeature request).

   A typical PageResults request will look like this:

   http://<host>/geoserver/ows?service=WFS&version=2.0.2&request=PageResults&resultSetID=ef35292477a011e7b5a5be2e44b06b34&startIndex=5&count=10&outputFormat=application/gml+xml; version=3.2&resultType=results
   

   This looks like a GetFeature request where the query expression was substituted by the resultSetID parameter.

2. The timeout parameter is not implemented yet.

The following parameters of index request are override using the ones provided with the PageResults operation or the default values:

1. startIndex

2. count

3. outputFormat

4. resultType

and finally the GetFeature response is returned.