Package org.rribbit.dispatching

Class HttpRequestDispatcher

java.lang.Object

org.rribbit.dispatching.HttpRequestDispatcher

All Implemented Interfaces:

RequestDispatcher

public class HttpRequestDispatcher
extends Object
implements RequestDispatcher

This RequestDispatcher dispatches a Request to an HttpRequestProcessorServlet via HTTP. Failover and loadbalancing are not supported in this class, as opposed to the RmiRequestDispatcher. The reason for this is that failover and loadbalancing are typically done in another layer of the HTTP stack, which does not apply to RMI.

This class uses Apache HTTPClient to make the connection to the HttpRequestProcessorServlet. It uses the default functionality of Apache HTTPClient to do its work. If you want to use more advanced functionality of Apache HTTPClient to make the connection, then it should be fairly straightforward to extend this class or implement your own RequestDispatcher implementation with this class as an example.

Author:

G.J. Schouten

Field Summary

Fields

Modifier and Type	Field	Description
protected String	url

Constructor Summary

Constructors

Constructor	Description
HttpRequestDispatcher()	Whenever you use this constructor, be sure to set the url with the setter provided by this class.
HttpRequestDispatcher(String url)	Creates an HttpRequestDispatcher that will send the Requests to the specified URL.

Method Summary

Modifier and Type	Method	Description
<T> Response<T>	dispatchRequest(Request request)	Dispatches a Request to a RequestProcessor and returns the Response.
String	getUrl()
void	setUrl(String url)

Methods inherited from class java.lang.Object

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

Field Details

url

protected String url

Constructor Details

HttpRequestDispatcher

public HttpRequestDispatcher()

Whenever you use this constructor, be sure to set the url with the setter provided by this class. If you don't, runtime exceptions will occur.

HttpRequestDispatcher

public HttpRequestDispatcher(String url)

Creates an HttpRequestDispatcher that will send the Requests to the specified URL. An HttpRequestProcessorServlet is expected to be listening at this URL. The URL is a standard HTTP URL, such as "http://host:port/path". It can also be an HTTPS URL, beginning with 'https:'. This constructor is recommended, since it forces you to specify the url. Passing a null value for this will result in runtime exceptions whenever the HttpRequestDispatcher is used.

Parameters:

url -

Method Details

dispatchRequest

public <T> Response<T> dispatchRequest(Request request)

Description copied from interface: RequestDispatcher

Dispatches a Request to a RequestProcessor and returns the Response.

Specified by:

dispatchRequest in interface RequestDispatcher

Parameters:

request - The Request to be dispatched to a RequestProcessor

Returns:

The Response to be returned from the RequestProcessor

getUrl

public String getUrl()

setUrl

public void setUrl(String url)