io.muserver

Interface AsyncHandle

public interface AsyncHandle

A class to handle the request and response handling when using asynchronous request handling.

To asynchronously read the request body, see setReadListener(RequestBodyListener). To write data, this interface provides asynchronous write operations, or alternatively you can use the blocking write operations on the original MuResponse.

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static interface	AsyncHandle.ResponseCompletedListener

Method Summary

Modifier and Type	Method and Description
void	complete() Call this to indicate that the response is complete.
void	complete(Throwable throwable) Calling this will mark the request as complete and log the error message.
void	setReadListener(RequestBodyListener readListener) Sets a listener that will be notified when chunks of request data become available.
void	setResponseCompletedHandler(AsyncHandle.ResponseCompletedListener responseCompletedListener) Add a listener for when request processing is complete.
Future<Void>	write(ByteBuffer data) Writes data to the response asynchronously.
void	write(ByteBuffer data, WriteCallback callback) Writes data to the response asynchronously.

Method Detail

setReadListener

void setReadListener(RequestBodyListener readListener)

Sets a listener that will be notified when chunks of request data become available.

If this is not set, then the usual (blocking) request reading methods on the request object can be used.

Parameters:

readListener - The listener.

complete

void complete()

Call this to indicate that the response is complete.

complete

void complete(Throwable throwable)

Calling this will mark the request as complete and log the error message. If possible, a 500 Internal Server Error message will be sent to the client.

Parameters:

throwable - an exception to log

write

void write(ByteBuffer data,
           WriteCallback callback)

Writes data to the response asynchronously.

Note that even in async mode it is possible to use the blocking write methods on the MuResponse

See write(ByteBuffer) for an alternative that returns a future.

Parameters:

data - The data to write

callback - The callback when the write succeeds or fails

write

Future<Void> write(ByteBuffer data)

Writes data to the response asynchronously.

Note that even in async mode it is possible to use the blocking write methods on the MuResponse

See write(ByteBuffer, WriteCallback) for an alternative that uses a callback.

Parameters:

data - The data to write

Returns:

A future that is resolved when the write succeeds or fails.

setResponseCompletedHandler

void setResponseCompletedHandler(AsyncHandle.ResponseCompletedListener responseCompletedListener)

Add a listener for when request processing is complete. One use of this is to detect early client disconnects so that expensive operations can be cancelled.

Parameters:

responseCompletedListener - The handler to invoke when the request is complete.