Package org.somda.sdc.dpws.http

Interface HttpHandler

All Known Implementing Classes:

ByteResourceHandler, RequestResponseServerHttpHandler

public interface HttpHandler

Simple HTTP handler for HttpServerRegistry callbacks.

This HTTP handler is designed to be used for SOAP bindings only. Hence, any modification to HTTP headers is handled by the underlying HttpServerRegistry implementation according to the SOAP HTTP binding specification.

See Also:

SOAP HTTP Binding

Method Summary

Modifier and Type	Method	Description
void	handle(InputStream inStream, OutputStream outStream, CommunicationContext communicationContext)	Callback that is invoked by HttpServerRegistry whenever a respective context path is matched.

Method Detail

handle

void handle(InputStream inStream,
            OutputStream outStream,
            CommunicationContext communicationContext)
     throws HttpException

Callback that is invoked by HttpServerRegistry whenever a respective context path is matched.

Parameters:

inStream - stream of the incoming SOAP request. The caller is responsible for closing the stream.

outStream - stream of the outgoing SOAP response. The caller is responsible for closing the stream.

communicationContext - information from the transport and application layer, e.g., local address, local port, certificate data etc.

Throws:

HttpException - if there is a SOAP fault thrown that is supposed to cause the HTTP layer to attach a status code other than 200. If the exception includes a message, then the caller is supposed to put the text to the HTTP response. If the exception does not include a message (length is 0), then the caller is supposed to put the outStream content to the HTTP response.