io.servicetalk.http.api

Interface HttpLifecycleObserver.HttpResponseObserver

Enclosing interface:

HttpLifecycleObserver

public static interface HttpLifecycleObserver.HttpResponseObserver

An observer interface that provides visibility into events associated with a single HTTP response.

The response is considered complete when one of the terminal events is invoked. It's guaranteed only one terminal event will be invoked per response.

Method Summary

Modifier and Type	Method and Description
void	onResponseCancel() Callback when the response is cancelled.
void	onResponseComplete() Callback when the response completes successfully.
void	onResponseData(Buffer data) Callback when the response payload body data chunk was observed.
void	onResponseError(Throwable cause) Callback when the response fails with an error.
void	onResponseTrailers(HttpHeaders trailers) Callback when response trailers were observed.

Method Detail

onResponseData

void onResponseData(Buffer data)

Callback when the response payload body data chunk was observed.

May be invoked multiple times if the payload body is split into multiple chunks.

Parameters:

data - the response payload body data chunk

onResponseTrailers

void onResponseTrailers(HttpHeaders trailers)

Callback when response trailers were observed.

Parameters:

trailers - trailers of the response

onResponseComplete

void onResponseComplete()

Callback when the response completes successfully.

This is one of the possible terminal events.

onResponseError

void onResponseError(Throwable cause)

Callback when the response fails with an error.

This is one of the possible terminal events.

Parameters:

cause - Throwable that terminated this response

onResponseCancel

void onResponseCancel()

Callback when the response is cancelled.

This is one of the possible terminal events. Cancellation is the best effort, more events may be signaled after cancel.