Package io.servicetalk.grpc.api

Interface GrpcLifecycleObserver.GrpcExchangeObserver

All Superinterfaces:

HttpLifecycleObserver.HttpExchangeObserver

Enclosing interface:

GrpcLifecycleObserver

public static interface GrpcLifecycleObserver.GrpcExchangeObserver
extends HttpLifecycleObserver.HttpExchangeObserver

An observer interface that provides visibility into events associated with a single gRPC exchange.

An exchange is represented by a request and a response. Both can be observed independently and may publish their events concurrently because connections are full-duplex. The terminal event for the exchange is signaled only when nested observers signal terminal events. Cancellation is the best effort, more events may be signaled after cancel.

Method Summary

Modifier and Type	Method	Description
GrpcLifecycleObserver.GrpcRequestObserver	onRequest(HttpRequestMetaData requestMetaData)	Callback when a request starts.
GrpcLifecycleObserver.GrpcResponseObserver	onResponse(HttpResponseMetaData responseMetaData)	Callback when a response meta-data was observed.

Methods inherited from interface io.servicetalk.http.api.HttpLifecycleObserver.HttpExchangeObserver

onConnectionSelected, onExchangeFinally, onResponseCancel, onResponseError

Method Details

onRequest

GrpcLifecycleObserver.GrpcRequestObserver onRequest(HttpRequestMetaData requestMetaData)

Description copied from interface: HttpLifecycleObserver.HttpExchangeObserver

Callback when a request starts.

Specified by:

onRequest in interface HttpLifecycleObserver.HttpExchangeObserver

Parameters:

requestMetaData - The corresponding HttpRequestMetaData

Returns:

an HttpLifecycleObserver.HttpRequestObserver that provides visibility into request events

onResponse

GrpcLifecycleObserver.GrpcResponseObserver onResponse(HttpResponseMetaData responseMetaData)

Description copied from interface: HttpLifecycleObserver.HttpExchangeObserver

Callback when a response meta-data was observed.

Specified by:

onResponse in interface HttpLifecycleObserver.HttpExchangeObserver

Parameters:

responseMetaData - the corresponding HttpResponseMetaData

Returns:

an HttpLifecycleObserver.HttpResponseObserver that provides visibility into response events