com.google.appengine.api.urlfetch
Class HTTPRequest

java.lang.Object
  com.google.appengine.api.urlfetch.HTTPRequest

All Implemented Interfaces:

java.io.Serializable

public class HTTPRequest
extends java.lang.Object
implements java.io.Serializable

HTTPRequest encapsulates a single HTTP request that is made via the URLFetchService.

See Also:

Serialized Form

Constructor Summary

HTTPRequest(java.net.URL url)
Creates a HTTPRequest that represents a GET request to the specified URL.

HTTPRequest(java.net.URL url, HTTPMethod method)
Creates a HTTPRequest that represents an HTTP request to the speceified URL with the specified HTTP method (e.g.

HTTPRequest(java.net.URL url, HTTPMethod method, FetchOptions fetchOptions)
Creates a HTTPRequest that represents an HTTP request to the speceified URL with the specified HTTP method (e.g.

Method Summary

void	addHeader(HTTPHeader header) Adds header to this request.
FetchOptions	getFetchOptions() Get the fetch options for this request.
java.util.List<HTTPHeader>	getHeaders() Returns an immutable List of HTTPHeader objects that have been added to this request.
HTTPMethod	getMethod() Gets the HTTP method for this request (e.g.
byte[]	getPayload() Gets the payload (e.g.
java.net.URL	getURL() Gets the URL for this request.
void	setHeader(HTTPHeader header) Sets an HTTPHeader for this request.
void	setPayload(byte[] payload) Sets the payload for this request.

Methods inherited from class java.lang.Object

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

Constructor Detail

HTTPRequest

public HTTPRequest(java.net.URL url)

Creates a HTTPRequest that represents a GET request to the specified URL.

HTTPRequest

public HTTPRequest(java.net.URL url,
                   HTTPMethod method)

Creates a HTTPRequest that represents an HTTP request to the speceified URL with the specified HTTP method (e.g. GET, POST, etc.).

HTTPRequest

public HTTPRequest(java.net.URL url,
                   HTTPMethod method,
                   FetchOptions fetchOptions)

Creates a HTTPRequest that represents an HTTP request to the speceified URL with the specified HTTP method (e.g. GET, POST, etc.) and the specified FetchOptions.

Method Detail

getMethod

public HTTPMethod getMethod()

Gets the HTTP method for this request (e.g. GET, POST, etc.).

getURL

public java.net.URL getURL()

Gets the URL for this request.

getPayload

public byte[] getPayload()

Gets the payload (e.g. POST body) for this request. Certain HTTP methods (e.g. GET) will not have any payload, and this method will return null.

setPayload

public void setPayload(byte[] payload)

Sets the payload for this request. This method should not be called for certain HTTP methods (e.g. GET).

addHeader

public void addHeader(HTTPHeader header)

Adds header to this request. If an HTTPHeader with the same name already exists for this request, it's values are merged with header.

Parameters:

header - a not null HTTPHeader

setHeader

public void setHeader(HTTPHeader header)

Sets an HTTPHeader for this request. If an HTTPHeader with the same name already exists, its value is replaced.

getHeaders

public java.util.List<HTTPHeader> getHeaders()

Returns an immutable List of HTTPHeader objects that have been added to this request.

getFetchOptions

public FetchOptions getFetchOptions()

Get the fetch options for this request.