org.apache.commons.latka.http
Interface Session

All Known Implementing Classes:

SessionImpl

public interface Session

A Latka Session is a container that manages state information over 1+ HTTP request/response pairs over 1+ HTTP servers.

Version:

$Id: Session.java 155424 2005-02-26 13:09:29Z dirkv $

Author:

Doug Sale, Morgan Delagrange, dIon Gillard

Method Summary

void	addCookie(String domain, String path, String name, String value) Adds a cookie to all HTTP requests whose domain and path match (according to RFC2109).
Request	createRequest(String label, URL url, int httpMethod, String version, boolean followRedirects) Creates a labeled request object, with the specified URL, HTTP Method, version, and redirect handling behavior.
Request	createRequest(String label, URL url, int httpMethod, String version, boolean followRedirects, Proxy proxy) Create a labeled request with the specified URL, HTTP method, version, and redirect handling behavior, using the given proxy for communication.
Request	createRequest(URL url, int httpMethod, Proxy proxy, String version) Creates a request object with the specified URL, HTTP Method, and version to be accessed via the provided proxy.
Request	createRequest(URL url, int httpMethod, String version) Creates a request object with the specified URL, HTTP Method, and version.
String	getCookieValue(String name) Returns the value of cookie name.

Method Detail

createRequest

Request createRequest(URL url,
                      int httpMethod,
                      String version)

Creates a request object with the specified URL, HTTP Method, and version.

Parameters:

url - The URL to request of the HTTP server.

httpMethod - An integer representing the HTTP method (e.g. GET, PUT) used to communicate with server.

version - A String representing the version of the HTTP request, i.e. 1.0 or 1.1.

Returns:

a new Request object representing the url and httpMethod

See Also:

Request.HTTP_METHOD_GET, Request.HTTP_METHOD_POST

createRequest

Request createRequest(String label,
                      URL url,
                      int httpMethod,
                      String version,
                      boolean followRedirects)

Creates a labeled request object, with the specified URL, HTTP Method, version, and redirect handling behavior.

Parameters:

label - a name used to identify the request

url - The URL to request of the HTTP server.

httpMethod - An integer representing the HTTP method (e.g. GET, PUT) used to communicate with server.

version - A String representing the version of the HTTP request, i.e. 1.0 or 1.1.

followRedirects - whether to follow HTTP redirection responses

Returns:

a new Request object representing the url and httpMethod

See Also:

Request.HTTP_METHOD_GET, Request.HTTP_METHOD_POST

createRequest

Request createRequest(URL url,
                      int httpMethod,
                      Proxy proxy,
                      String version)

Creates a request object with the specified URL, HTTP Method, and version to be accessed via the provided proxy.

Parameters:

url - The URL to request of the HTTP server.

httpMethod - An integer representing the HTTP method (e.g. GET, PUT) used to communicate with server.

proxy - a proxy to use during the request

version - A String representing the version of the HTTP request, i.e. 1.0 or 1.1.

Returns:

a new Request object representing the url and httpMethod.

See Also:

Request.HTTP_METHOD_GET, Request.HTTP_METHOD_POST, Proxy

createRequest

Request createRequest(String label,
                      URL url,
                      int httpMethod,
                      String version,
                      boolean followRedirects,
                      Proxy proxy)

Create a labeled request with the specified URL, HTTP method, version, and redirect handling behavior, using the given proxy for communication.

Parameters:

label - a name used to identify the request

url - The URL to request of the HTTP server.

httpMethod - An integer representing the HTTP method (e.g. GET, PUT) used to communicate with server.

version - A String representing the version of the HTTP request, i.e. 1.0 or 1.1.

followRedirects - whether to follow HTTP redirection responses

proxy - a proxy to use during the request

Returns:

a new Request object representing the url and httpMethod

See Also:

Request.HTTP_METHOD_GET, Request.HTTP_METHOD_POST, Proxy

addCookie

void addCookie(String domain,
               String path,
               String name,
               String value)

Adds a cookie to all HTTP requests whose domain and path match (according to RFC2109).

Parameters:

domain - the domain to which the cookie should apply

path - the path to which the cookie should apply

name - the name of the cookie

value - the value of the cookie

getCookieValue

String getCookieValue(String name)

Returns the value of cookie name.

Parameters:

name - the name of the cookie

Returns:

the value of the cookie, or null if the cookie isn't set