Class GrpcResponseMetadata (2.51.0)

public class GrpcResponseMetadata implements ResponseMetadataHandler

GrpcResponseMetadata provides a mechanism to access the headers and trailers returned by a gRPC client method.

NOTE: the GrpcResponseMetadata class is not thread-safe and should NOT be re-used for multiple calls. A new instance of GrpcResponseMetadata should be constructed for each call that requires metadata to be accessed.

Example usage:

 
 GrpcResponseMetadata grpcResponseMetadata = new GrpcResponseMetadata();
 Foo foo = client.getFooCallable().call(getFooRequest, grpcResponseMetadata.createContextWithHandlers());
 Metadata headers = grpcResponseMetadata.getMetadata();
 Metadata trailers = grpcResponseMetadata.getTrailingMetadata();

Inheritance

java.lang.Object > GrpcResponseMetadata

Implements

ResponseMetadataHandler

Inherited Members

Object.clone()

Object.equals(Object)

Object.finalize()

Object.getClass()

Object.hashCode()

Object.notify()

Object.notifyAll()

Object.toString()

Object.wait()

Object.wait(long)

Object.wait(long,int)

Constructors

GrpcResponseMetadata()

public GrpcResponseMetadata()

Methods

addHandlers(ApiCallContext apiCallContext)

public GrpcCallContext addHandlers(ApiCallContext apiCallContext)

Constructs a new call context from an existing ApiCallContext, and sets the CallOptions to add handlers to retrieve the headers and trailers, and make them available via the getMetadata and getTrailingMetadata methods.

Parameter
Name	Description
`apiCallContext`	`ApiCallContext`

Returns
Type	Description
`GrpcCallContext`

createContextWithHandlers()

public GrpcCallContext createContextWithHandlers()

Constructs a new call context and sets the CallOptions to add handlers to retrieve the headers and trailers, and make them available via the getMetadata and getTrailingMetadata methods.

Returns
Type	Description
`GrpcCallContext`

getMetadata()

public Metadata getMetadata()

Returns the headers from the gRPC method as Metadata. If the call has not completed, will return null.

Returns
Type	Description
`io.grpc.Metadata`

getTrailingMetadata()

public Metadata getTrailingMetadata()

Returns the trailers from the gRPC method as Metadata. If the call has not completed, will return null.

Returns
Type	Description
`io.grpc.Metadata`

onHeaders(Metadata metadata)

public void onHeaders(Metadata metadata)

Handle the headers returned by an RPC.

Parameter
Name	Description
`metadata`	`io.grpc.Metadata`

onTrailers(Metadata metadata)

public void onTrailers(Metadata metadata)

Handle the trailers returned by an RPC.

Parameter
Name	Description
`metadata`	`io.grpc.Metadata`