org.opengis.cite.cat20.dgiwg10.util

Class ClientUtils

java.lang.Object

org.opengis.cite.cat20.dgiwg10.util.ClientUtils

public class ClientUtils
extends Object

Provides various utility methods for creating and configuring HTTP client components.

Constructor Summary

Constructors

Constructor and Description
ClientUtils()

Method Summary

Modifier and Type	Method and Description
static com.sun.jersey.api.client.ClientRequest	buildGetRequest(URI endpoint, Map<String,String> qryParams, javax.ws.rs.core.MediaType... mediaTypes) Builds an HTTP request message that uses the GET method.
static Document	getResponseEntityAsDocument(com.sun.jersey.api.client.ClientResponse response, String targetURI) Obtains the (XML) response entity as a DOM Document and resets the entity input stream for subsequent reads.
static Source	getResponseEntityAsSource(com.sun.jersey.api.client.ClientResponse response, String targetURI) Obtains the (XML) response entity as a JAXP Source object and resets the entity input stream for subsequent reads.

Methods inherited from class java.lang.Object

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

Constructor Detail

ClientUtils

public ClientUtils()

Method Detail

buildGetRequest

public static com.sun.jersey.api.client.ClientRequest buildGetRequest(URI endpoint,
                                                                      Map<String,String> qryParams,
                                                                      javax.ws.rs.core.MediaType... mediaTypes)

Builds an HTTP request message that uses the GET method.

Parameters:

endpoint - A URI indicating the target resource.

qryParams - A Map containing query parameters (may be null);

mediaTypes - A list of acceptable media types; if not specified, generic XML ("application/xml") is preferred.

Returns:

A ClientRequest object.

getResponseEntityAsSource

public static Source getResponseEntityAsSource(com.sun.jersey.api.client.ClientResponse response,
                                               String targetURI)

Obtains the (XML) response entity as a JAXP Source object and resets the entity input stream for subsequent reads.

Parameters:

response - A representation of an HTTP response message.

targetURI - The target URI from which the entity was retrieved (may be null).

Returns:

A Source to read the entity from; its system identifier is set using the given targetURI value (this may be used to resolve any relative URIs found in the source).

getResponseEntityAsDocument

public static Document getResponseEntityAsDocument(com.sun.jersey.api.client.ClientResponse response,
                                                   String targetURI)

Obtains the (XML) response entity as a DOM Document and resets the entity input stream for subsequent reads.

Parameters:

response - A representation of an HTTP response message.

targetURI - The target URI from which the entity was retrieved (may be null).

Returns:

A Document representing the entity; its base URI is set using the given targetURI value (this may be used to resolve any relative URIs found in the document).