org.opengis.cite.iso19142.util

Class WFSClient

java.lang.Object

org.opengis.cite.iso19142.util.WFSClient

public class WFSClient
extends Object

A WFS 2.0 client component.

Field Summary

Fields

Modifier and Type	Field and Description
protected Client	client
protected List<QName>	featureTypes The list of feature types recognized by the SUT.
protected Set<ProtocolBinding>	globalBindings The set of message bindings broadly implemented by the SUT.
protected Document	wfsMetadata A Document that describes the service under test.

Constructor Summary

Constructors

Constructor and Description
WFSClient() Default client constructor.
WFSClient(Document wfsMetadata) Constructs a client that is aware of the capabilities of some WFS.

Method Summary

Methods

Modifier and Type	Method and Description
Document	delete(Map<String,QName> features, ProtocolBinding binding) Submits a request to delete a collection of features specified by identifier and type name.
(package private) Document	executeTransaction(Document request, ProtocolBinding binding) Executes a WFS transaction.
ProtocolBinding	getAnyTransactionBinding() Returns a protocol binding suitable for transaction requests.
Document	getCapabilities() Retrieves a complete representation of the capabilities document from the WFS implementation described by the service metadata.
Document	getFeatureByType(QName typeName, int count, ProtocolBinding binding) Retrieves feature representations by type name.
Document	getServiceDescription()
Document	insert(List<Element> features, ProtocolBinding binding) Submits a request to insert a collection of GML feature instances.
Document	invokeStoredQuery(String queryId, Map<String,Object> params) Invokes a stored query using any supported protocol binding (request encoding).
(package private) Document	retrieveXMLResponseEntity(Document request, ProtocolBinding binding) Submits the given request entity and returns the response entity as a DOM Document.
void	setServiceDescription(InputStream srvMetadata) Sets the service description obtained using the given InputStream.
ClientResponse	submitRequest(Document reqEntity, ProtocolBinding binding) Submits a request using the specified message binding and the content of the given XML request entity.
ClientResponse	submitRequest(Source entity, ProtocolBinding binding, URI endpoint) Submits an HTTP request message.
Document	updateFeature(Document req, String id, QName featureType, Map<String,Object> properties, ProtocolBinding binding) Submits a request to update a feature.
Document	updateFeature(String id, QName featureType, Map<String,Object> properties) Submits a request to update a feature using the POST protocol binding.

Methods inherited from class java.lang.Object

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

Field Detail

client

protected Client client

wfsMetadata

protected Document wfsMetadata

A Document that describes the service under test.

globalBindings

protected Set<ProtocolBinding> globalBindings

The set of message bindings broadly implemented by the SUT.

featureTypes

protected List<QName> featureTypes

The list of feature types recognized by the SUT.

Constructor Detail

WFSClient

public WFSClient()

Default client constructor. The client is configured to consume SOAP message entities. The request and response may be logged to a default JDK logger (in the namespace "com.sun.jersey.api.client").

WFSClient

public WFSClient(Document wfsMetadata)

Constructs a client that is aware of the capabilities of some WFS.

Parameters:

wfsMetadata - A service description (e.g. WFS capabilities document).

Method Detail

getServiceDescription

public Document getServiceDescription()

setServiceDescription

public void setServiceDescription(InputStream srvMetadata)
                           throws SAXException,
                                  IOException

Sets the service description obtained using the given InputStream. The standard description is an XML representation of a WFS capabilities document.

Parameters:

srvMetadata - An InputStream supplying the service metadata.

Throws:

SAXException - If any I/O errors occur.

IOException - If any parsing errors occur.

invokeStoredQuery

public Document invokeStoredQuery(String queryId,
                         Map<String,Object> params)

Invokes a stored query using any supported protocol binding (request encoding).

Parameters:

queryId - The stored query identifier.

params - A collection of query parameters distinguished by name (may be empty, e.g. Collections. emptyMap()).

Returns:

A Document representing the XML response entity, or null if the response doesn't contain one.

getFeatureByType

public Document getFeatureByType(QName typeName,
                        int count,
                        ProtocolBinding binding)

Retrieves feature representations by type name.

Parameters:

typeName - A QName denoting the feature type.

count - The maximum number of features to fetch (> 0). If count < 1, the default value (10) applies.

binding - The ProtocolBinding to use for this request; if null a global binding will be used.

Returns:

A Document representing the XML response entity, or null if the response doesn't contain one.

delete

public Document delete(Map<String,QName> features,
              ProtocolBinding binding)

Submits a request to delete a collection of features specified by identifier and type name.

Parameters:

features - A Map containing entries that specify a feature by identifier (gml:id attribute value) and type name (QName).

binding - The ProtocolBinding to use.

Returns:

A Document representing the XML response entity, or null if the response doesn't contain one.

insert

public Document insert(List<Element> features,
              ProtocolBinding binding)

Submits a request to insert a collection of GML feature instances.

Parameters:

features - A List containing one or more feature representations.

binding - The ProtocolBinding to use.

Returns:

A Document representing the XML response entity, or null if the response doesn't contain one.

updateFeature

public Document updateFeature(String id,
                     QName featureType,
                     Map<String,Object> properties)

Submits a request to update a feature using the POST protocol binding.

See Also:

updateFeature(Document, String, QName, Map, ProtocolBinding)

updateFeature

public Document updateFeature(Document req,
                     String id,
                     QName featureType,
                     Map<String,Object> properties,
                     ProtocolBinding binding)

Submits a request to update a feature.

Parameters:

req - An empty wfs:Transaction request entity.

id - The GML identifier of the feature to be updated (gml:id attribute).

featureType - The type of the feature instance.

properties - A Map containing the feature properties to be updated (replaced). Each entry consists of a value reference (an XPath expression) and a value object. The value may be a Node representing a complex property value; otherwise it is treated as a simple value by calling the object's toString() method.

binding - The ProtocolBinding to use.

Returns:

A Document representing the XML response entity, or null if the response doesn't contain one.

submitRequest

public ClientResponse submitRequest(Source entity,
                           ProtocolBinding binding,
                           URI endpoint)

Submits an HTTP request message. For GET requests the XML request entity is serialized to its corresponding KVP string format and added to the query component of the Request-URI. For SOAP requests that adhere to the "Request-Response" message exchange pattern, the outbound message entity is a SOAP envelope containing the standard XML request in the body.

Parameters:

entity - An XML representation of the request entity.

binding - The ProtocolBinding to use.

endpoint - The service endpoint.

Returns:

A ClientResponse object representing the response message.

submitRequest

public ClientResponse submitRequest(Document reqEntity,
                           ProtocolBinding binding)

Submits a request using the specified message binding and the content of the given XML request entity.

Parameters:

reqEntity - A DOM Document representing the content of the request message.

binding - The ProtocolBinding to use; may be ProtocolBinding.ANY if any supported binding can be used.

Returns:

A ClientResponse object representing the response message.

getCapabilities

public Document getCapabilities()

Retrieves a complete representation of the capabilities document from the WFS implementation described by the service metadata.

Returns:

A Document containing the response to a GetCapabilities request, or null if one could not be obtained.

getAnyTransactionBinding

public ProtocolBinding getAnyTransactionBinding()

Returns a protocol binding suitable for transaction requests. Any binding advertised in the service capabilities document is returned.

Returns:

A supported ProtocolBinding instance (POST or SOAP).

executeTransaction

Document executeTransaction(Document request,
                          ProtocolBinding binding)

Executes a WFS transaction.

Parameters:

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

binding - The ProtocolBinding to use

Returns:

A Document node representing the response entity.

retrieveXMLResponseEntity

Document retrieveXMLResponseEntity(Document request,
                                 ProtocolBinding binding)

Submits the given request entity and returns the response entity as a DOM Document.

Parameters:

request - An XML representation of the request entity; the actual request depends on the message binding in use.

binding - The ProtocolBinding to use (GET, POST, or SOAP).

Returns:

A DOM Document containing the response entity, or null if the request failed or the message body could not be parsed.