zone.gryphon.screech

Interface Client.ClientCallback

All Known Implementing Classes:

ClientCallbackImpl

Enclosing interface:

Client

public static interface Client.ClientCallback

Callback clients can use to return data about the request

Method Summary

Modifier and Type	Method and Description
void	abort(Throwable t) Callback method invoked when the request fails for any reason.
void	complete() Called when the request completes successfully.
Client.ContentCallback	headers(ResponseHeaders responseHeaders) Callback method invoked when the HTTP response code and headers are available.

Method Detail

headers

Client.ContentCallback headers(ResponseHeaders responseHeaders)

Callback method invoked when the HTTP response code and headers are available.

This method can only be invoked once per request.

This method will return a callback which can be used to stream the response content, if any. Once the response content has been exhausted, complete() should be called to indicate as such.

Note that should should be invoked before complete(), but need not be invoked before abort(Throwable)

Parameters:

responseHeaders - The response headers

Returns:

A callback which can be used to stream the response content

abort

void abort(Throwable t)

Callback method invoked when the request fails for any reason. This will ultimately result in an exception being bubbled up to consumer code.

No other methods should be invoked on the callback after this is called (i.e. this is a terminal operation)

Parameters:

t - The exception which caused the request to fail

complete

void complete()

Called when the request completes successfully. Note that "successful" does not mean a 2xx response code, only that the client was able to successfully receive all data from the upstream server.

No other methods should be invoked on the callback after this is called (i.e. this is a terminal operation)