HTTPClient
Class Request

java.lang.Object
HTTPClient.Request

All Implemented Interfaces:

java.lang.Cloneable, RoRequest

public final class Request

extends java.lang.Object

implements RoRequest, java.lang.Cloneable

This class represents an http request. It's used by classes which implement the HTTPClientModule interface.

Constructor Summary

Request(HTTPConnection con, java.lang.String method, java.lang.String req_uri, NVPair[] headers, byte[] data, HttpOutputStream stream, boolean allow_ui)
Creates a new request structure.

Method Summary

boolean	allowUI()
java.lang.Object	clone()
void	copyFrom(Request other) Copy all the fields from other to this request.
HTTPConnection	getConnection()
byte[]	getData()
NVPair[]	getHeaders()
java.lang.String	getMethod()
java.lang.String	getRequestURI()
HttpOutputStream	getStream()
void	setAllowUI(boolean allow_ui)
void	setConnection(HTTPConnection con)
void	setData(byte[] data)
void	setHeaders(NVPair[] headers)
void	setMethod(java.lang.String method)
void	setRequestURI(java.lang.String req_uri)
void	setStream(HttpOutputStream stream)
java.lang.String	toString()

Methods inherited from class java.lang.Object

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

Constructor Detail

Request

public Request(HTTPConnection con,
               java.lang.String method,
               java.lang.String req_uri,
               NVPair[] headers,
               byte[] data,
               HttpOutputStream stream,
               boolean allow_ui)

Creates a new request structure.

Parameters:

con - the current HTTPConnection

method - the request method

req_uri - the request-uri

headers - the request headers

data - the entity as a byte[]

stream - the entity as a stream

allow_ui - allow user interaction

Method Detail

getConnection

public HTTPConnection getConnection()

Specified by:

getConnection in interface RoRequest

Returns:

the HTTPConnection this request is associated with

setConnection

public void setConnection(HTTPConnection con)

Parameters:

con - the HTTPConnection this request is associated with

getMethod

public java.lang.String getMethod()

Specified by:

getMethod in interface RoRequest

Returns:

the request method

setMethod

public void setMethod(java.lang.String method)

Parameters:

method - the request method (e.g. GET, POST, etc)

getRequestURI

public java.lang.String getRequestURI()

Specified by:

getRequestURI in interface RoRequest

Returns:

the request-uri

setRequestURI

public void setRequestURI(java.lang.String req_uri)

Parameters:

req_uri - the request-uri

getHeaders

public NVPair[] getHeaders()

Specified by:

getHeaders in interface RoRequest

Returns:

the headers making up this request

setHeaders

public void setHeaders(NVPair[] headers)

Parameters:

headers - the headers for this request

getData

public byte[] getData()

Specified by:

getData in interface RoRequest

Returns:

the body of this request

setData

public void setData(byte[] data)

Parameters:

data - the entity for this request

getStream

public HttpOutputStream getStream()

Specified by:

getStream in interface RoRequest

Returns:

the output stream on which the body is written

setStream

public void setStream(HttpOutputStream stream)

Parameters:

stream - an output stream on which the entity is written

allowUI

public boolean allowUI()

Specified by:

allowUI in interface RoRequest

Returns:

true if the modules or handlers for this request may popup windows or otherwise interact with the user

setAllowUI

public void setAllowUI(boolean allow_ui)

Parameters:

allow_ui - are modules and handlers allowed to popup windows or otherwise interact with the user?

clone

public java.lang.Object clone()

Returns:

a clone of this request object

copyFrom

public void copyFrom(Request other)

Copy all the fields from other to this request.

Parameters:

other - the Request to copy from

toString

public java.lang.String toString()

Returns:

a string containing the method and request-uri