org.opengis.cite.iso19142.util

Class WFSRequest

java.lang.Object

org.opengis.cite.iso19142.util.WFSRequest

public class WFSRequest
extends Object

Provides various utility methods for constructing and manipulating the content of WFS request messages.

Constructor Summary

Constructors

Constructor and Description
WFSRequest()

Method Summary

Methods

Modifier and Type	Method and Description
static void	addInsertStatement(Document request, Node feature) Appends a wfs:Insert element to the document element in the given request entity.
static void	addNamespaceBinding(Document doc, QName qName) Adds a namespace binding to the document element.
static void	addReplaceStatements(Document trxRequest, List<Element> replacements) Adds a sequence of wfs:Replace statements to the given transaction request entity.
static void	addResourceIdPredicate(Document request, Set<String> idSet) Adds a ResourceId predicate to a GetFeature (or GetFeatureWithLock) request entity that contains a simple query expression without a filter.
static void	appendSimpleQuery(Document doc, QName... qNames) Adds a simple wfs:Query element (without a filter) to the given request entity.
static void	appendStoredQuery(Document doc, String queryId, Map<String,Object> params) Adds a wfs:StoredQuery element to the given request entity.
static Document	createGMLEnvelope() Creates a GML envelope covering the area of use for the "WGS 84" CRS (srsName="urn:ogc:def:crs:EPSG::4326").
static Document	createRequestEntity(String requestType) Creates an XML request entity of the specified request type.
static Element	createValueReference(org.apache.xerces.xs.XSElementDeclaration propertyElem) Creates an Element node (fes:ValueReference) containing an XPath expression derived from a property element declaration.
static void	insertGMLProperty(Element feature, Element gmlProperty) Inserts a standard GML property into a given feature instance.
static Element	newResourceIdFilter(String id) Builds a filter predicate containing a fes:ResourceId element that identifies the feature instance to be modified.
static void	setTypeName(Element elem, QName qName) Sets the value of the typeName attribute on an action element (wfs:Update, wfs:Delete) contained in a Transaction request entity.
static String	transformEntityToKVP(Source xmlSource) Transforms the XML representation of a WFS request entity to its corresponding KVP serialization format.
static Document	wrapEntityInSOAPEnvelope(Source xmlSource, String version) Wraps the given XML request entity in the body of a SOAP envelope.

Methods inherited from class java.lang.Object

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

Constructor Detail

WFSRequest

public WFSRequest()

Method Detail

transformEntityToKVP

public static String transformEntityToKVP(Source xmlSource)

Transforms the XML representation of a WFS request entity to its corresponding KVP serialization format.

Parameters:

xmlSource - A Source representing the XML request entity.

Returns:

A String containing the resulting query component.

wrapEntityInSOAPEnvelope

public static Document wrapEntityInSOAPEnvelope(Source xmlSource,
                                String version)

Wraps the given XML request entity in the body of a SOAP envelope.

Parameters:

xmlSource - The Source providing the XML request entity.

version - The version of the SOAP protocol (either "1.1" or "1.2"); if not specified the latest version is assumed.

Returns:

A DOM Document node representing a SOAP request message.

appendSimpleQuery

public static void appendSimpleQuery(Document doc,
                     QName... qNames)

Adds a simple wfs:Query element (without a filter) to the given request entity. The typeNames attribute value is set using the supplied QName objects. Namespace bindings are added if necessary.

Parameters:

doc - A Document representing a WFS request entity that accepts wfs:Query elements as children of the document element (GetFeature, GetPropertyValue, GetFeatureWithLock, LockFeature).

qNames - A sequence of QName objects representing (qualified) feature type names recognized by the IUT.

appendStoredQuery

public static void appendStoredQuery(Document doc,
                     String queryId,
                     Map<String,Object> params)

Adds a wfs:StoredQuery element to the given request entity.

Parameters:

doc - A Document representing a WFS request entity that accepts wfs:StoredQuery elements as children of the document element (GetFeature, GetPropertyValue, GetFeatureWithLock, LockFeature).

queryId - A URI that identifies the stored query to invoke.

params - A Map containing query parameters (may be empty, e.g. Collections. emptyMap()). A parameter name is associated with an Object (String or QName) representing its value.

createRequestEntity

public static Document createRequestEntity(String requestType)

Creates an XML request entity of the specified request type.

Parameters:

requestType - The local name of the document element.

Returns:

A Document representing a WFS request entity.

setTypeName

public static void setTypeName(Element elem,
               QName qName)

Sets the value of the typeName attribute on an action element (wfs:Update, wfs:Delete) contained in a Transaction request entity.

Parameters:

elem - An action element in a transaction request.

qName - The qualified name of a feature type.

newResourceIdFilter

public static Element newResourceIdFilter(String id)

Builds a filter predicate containing a fes:ResourceId element that identifies the feature instance to be modified.

Parameters:

id - A String denoting a GML object identifier (gml:id).

Returns:

An Element node (fes:Filter).

insertGMLProperty

public static void insertGMLProperty(Element feature,
                     Element gmlProperty)

Inserts a standard GML property into a given feature instance. If the property node already exists it is replaced.

Parameters:

feature - An Element node representing a GML feature

gmlProperty - An Element node representing a standard (non-deprecated) GML feature property.

createValueReference

public static Element createValueReference(org.apache.xerces.xs.XSElementDeclaration propertyElem)

Creates an Element node (fes:ValueReference) containing an XPath expression derived from a property element declaration.

Parameters:

propertyElem - An element declaration that defines some feature property.

Returns:

An Element containing an XPath expression and an appropriate namespace binding.

createGMLEnvelope

public static Document createGMLEnvelope()

Creates a GML envelope covering the area of use for the "WGS 84" CRS (srsName="urn:ogc:def:crs:EPSG::4326").

Returns:

A Document containing gml:Envelope as the document element.

addNamespaceBinding

public static void addNamespaceBinding(Document doc,
                       QName qName)

Adds a namespace binding to the document element.

Parameters:

doc - A Document representing a request entity.

qName - A QName containing a namespace URI and prefix; the local part is ignored.

addReplaceStatements

public static void addReplaceStatements(Document trxRequest,
                        List<Element> replacements)

Adds a sequence of wfs:Replace statements to the given transaction request entity.

Parameters:

trxRequest - A Document node representing a wfs:Transaction request entity.

replacements - A List containing replacement feature representations (as GML).

addInsertStatement

public static void addInsertStatement(Document request,
                      Node feature)

Appends a wfs:Insert element to the document element in the given request entity. The wfs:Insert element contains the supplied feature instance.

Parameters:

request - A Document node representing a wfs:Transaction request entity.

feature - A Node representing a GML feature instance.

addResourceIdPredicate

public static void addResourceIdPredicate(Document request,
                          Set<String> idSet)

Adds a ResourceId predicate to a GetFeature (or GetFeatureWithLock) request entity that contains a simple query expression without a filter. The identifiers should match features of the indicated type.

Parameters:

request - The request entity (/wfs:GetFeature/[wfs:Query]).

idSet - A Set<String> of feature identifiers that conform to the xsd:ID datatype.