net.jini.jeri

Interface RequestDispatcher

All Known Implementing Classes:

DgcRequestDispatcher

public interface RequestDispatcher

A callback object for processing inbound requests.

Requests received on a ListenEndpoint will be dispatched to the instance of this interface that was passed to the endpoint's listen method.

Since:

2.0

Author:

Sun Microsystems, Inc.

Method Summary

Modifier and Type	Method and Description
void	dispatch(InboundRequest request) Processes an inbound request.

Method Detail

dispatch

void dispatch(InboundRequest request)

Processes an inbound request.

The supplied InboundRequest is used to read the request data and to write the response. The request is processed in the current thread; this method does not return until it is done processing the request.

After the invocation of this method completes (either by returning normally or by throwing an exception), the supplied InboundRequest will be automatically terminated (see InboundRequest.abort()). If this method completes before the close method has been invoked on the stream returned by the request's getResponseOutputStream method, there is no guarantee that any or none of the data written to the stream will be delivered; the implication is that the implementation of this method is no longer interested in the successful delivery of the response.

Parameters:

request - the InboundRequest to use to read the request data and write the response

Throws:

NullPointerException - if request is null