Package com.google.api.gax.grpc

Class GrpcCallContext

java.lang.Object

com.google.api.gax.grpc.GrpcCallContext

All Implemented Interfaces:

RetryingContext, ApiCallContext

@BetaApi("Reference ApiCallContext instead - this class is likely to experience breaking changes")
public final class GrpcCallContext
extends Object
implements ApiCallContext

GrpcCallContext encapsulates context data used to make a grpc call.

GrpcCallContext is immutable in the sense that none of its methods modifies the GrpcCallContext itself or the underlying data. Methods of the form withX, such as withTransportChannel(com.google.api.gax.rpc.TransportChannel), return copies of the object, but with one field changed. The immutability and thread safety of the arguments solely depends on the arguments themselves.

Nested Class Summary

Nested classes/interfaces inherited from interface com.google.api.gax.rpc.ApiCallContext

ApiCallContext.Key<T extends Object>

Method Summary

Modifier and Type	Method	Description
static GrpcCallContext	createDefault()	Returns an empty instance with a null channel and default CallOptions.
boolean	equals(Object o)
io.grpc.CallOptions	getCallOptions()	The CallOptions set on this context.
io.grpc.Channel	getChannel()	The Channel set on this context.
Integer	getChannelAffinity()	The channel affinity for this context.
Map<String,List<String>>	getExtraHeaders()	The extra header for this context.
<T> T	getOption(ApiCallContext.Key<T> key)
Set<StatusCode.Code>	getRetryableCodes()
RetrySettings	getRetrySettings()
org.threeten.bp.Duration	getStreamIdleTimeout()	The stream idle timeout set for this context.
org.threeten.bp.Duration	getStreamWaitTimeout()	The stream wait timeout set for this context.
org.threeten.bp.Duration	getTimeout()
ApiTracer	getTracer()
int	hashCode()
ApiCallContext	merge(ApiCallContext inputCallContext)
GrpcCallContext	nullToSelf(ApiCallContext inputContext)	Returns inputContext cast to GrpcCallContext, or an empty GrpcCallContext if inputContext is null.
static GrpcCallContext	of(io.grpc.Channel channel, io.grpc.CallOptions callOptions)	Returns an instance with the given channel and CallOptions.
GrpcCallContext	withCallOptions(io.grpc.CallOptions newCallOptions)	Returns a new instance with the call options set to the given call options.
GrpcCallContext	withChannel(io.grpc.Channel newChannel)	Returns a new instance with the channel set to the given channel.
GrpcCallContext	withChannelAffinity(Integer affinity)
GrpcCallContext	withCredentials(com.google.auth.Credentials newCredentials)
GrpcCallContext	withExtraHeaders(Map<String,List<String>> extraHeaders)
<T> GrpcCallContext	withOption(ApiCallContext.Key<T> key, T value)
GrpcCallContext	withRequestParamsDynamicHeaderOption(String requestParams)
GrpcCallContext	withRetryableCodes(Set<StatusCode.Code> retryableCodes)
GrpcCallContext	withRetrySettings(RetrySettings retrySettings)
GrpcCallContext	withStreamIdleTimeout(org.threeten.bp.Duration streamIdleTimeout)
GrpcCallContext	withStreamWaitTimeout(org.threeten.bp.Duration streamWaitTimeout)
GrpcCallContext	withTimeout(org.threeten.bp.Duration timeout)
GrpcCallContext	withTracer(ApiTracer tracer)
GrpcCallContext	withTransportChannel(TransportChannel inputChannel)

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Method Detail

createDefault

public static GrpcCallContext createDefault()

Returns an empty instance with a null channel and default CallOptions.

of

public static GrpcCallContext of(io.grpc.Channel channel,
                                 io.grpc.CallOptions callOptions)

Returns an instance with the given channel and CallOptions.

nullToSelf

public GrpcCallContext nullToSelf(ApiCallContext inputContext)

Returns inputContext cast to GrpcCallContext, or an empty GrpcCallContext if inputContext is null.

Specified by:

nullToSelf in interface ApiCallContext

Parameters:

inputContext - the ApiCallContext to cast if it is not null

withCredentials

public GrpcCallContext withCredentials(com.google.auth.Credentials newCredentials)

Specified by:

withCredentials in interface ApiCallContext

withTransportChannel

public GrpcCallContext withTransportChannel(TransportChannel inputChannel)

Specified by:

withTransportChannel in interface ApiCallContext

withTimeout

public GrpcCallContext withTimeout(@Nullable
                                   org.threeten.bp.Duration timeout)

Specified by:

withTimeout in interface ApiCallContext

getTimeout

@Nullable
public org.threeten.bp.Duration getTimeout()

Specified by:

getTimeout in interface ApiCallContext

withStreamWaitTimeout

public GrpcCallContext withStreamWaitTimeout(@Nullable
                                             org.threeten.bp.Duration streamWaitTimeout)

Specified by:

withStreamWaitTimeout in interface ApiCallContext

withStreamIdleTimeout

public GrpcCallContext withStreamIdleTimeout(@Nullable
                                             org.threeten.bp.Duration streamIdleTimeout)

Specified by:

withStreamIdleTimeout in interface ApiCallContext

withChannelAffinity

@BetaApi("The surface for channel affinity is not stable yet and may change in the future.")
public GrpcCallContext withChannelAffinity(@Nullable
                                           Integer affinity)

withExtraHeaders

@BetaApi("The surface for extra headers is not stable yet and may change in the future.")
public GrpcCallContext withExtraHeaders(Map<String,List<String>> extraHeaders)

Specified by:

withExtraHeaders in interface ApiCallContext

getRetrySettings

public RetrySettings getRetrySettings()

Specified by:

getRetrySettings in interface RetryingContext

withRetrySettings

public GrpcCallContext withRetrySettings(RetrySettings retrySettings)

Specified by:

withRetrySettings in interface ApiCallContext

getRetryableCodes

public Set<StatusCode.Code> getRetryableCodes()

Specified by:

getRetryableCodes in interface RetryingContext

withRetryableCodes

public GrpcCallContext withRetryableCodes(Set<StatusCode.Code> retryableCodes)

Specified by:

withRetryableCodes in interface ApiCallContext

merge

public ApiCallContext merge(ApiCallContext inputCallContext)

Specified by:

merge in interface ApiCallContext

getChannel

public io.grpc.Channel getChannel()

The Channel set on this context.

getCallOptions

public io.grpc.CallOptions getCallOptions()

The CallOptions set on this context.

getStreamWaitTimeout

@Nullable
public org.threeten.bp.Duration getStreamWaitTimeout()

The stream wait timeout set for this context.

Specified by:

getStreamWaitTimeout in interface ApiCallContext

See Also:

ApiCallContext.withStreamWaitTimeout(Duration)

getStreamIdleTimeout

@Nullable
public org.threeten.bp.Duration getStreamIdleTimeout()

The stream idle timeout set for this context.

Specified by:

getStreamIdleTimeout in interface ApiCallContext

See Also:

ApiCallContext.withStreamIdleTimeout(Duration)

getChannelAffinity

@Nullable
public Integer getChannelAffinity()

The channel affinity for this context.

getExtraHeaders

@BetaApi("The surface for extra headers is not stable yet and may change in the future.")
public Map<String,List<String>> getExtraHeaders()

The extra header for this context.

Specified by:

getExtraHeaders in interface ApiCallContext

withChannel

public GrpcCallContext withChannel(io.grpc.Channel newChannel)

Returns a new instance with the channel set to the given channel.

withCallOptions

public GrpcCallContext withCallOptions(io.grpc.CallOptions newCallOptions)

Returns a new instance with the call options set to the given call options.

withRequestParamsDynamicHeaderOption

public GrpcCallContext withRequestParamsDynamicHeaderOption(String requestParams)

getTracer

@Nonnull
public ApiTracer getTracer()

Specified by:

getTracer in interface ApiCallContext

Specified by:

getTracer in interface RetryingContext

withTracer

public GrpcCallContext withTracer(@Nonnull
                                  ApiTracer tracer)

Specified by:

withTracer in interface ApiCallContext

withOption

public <T> GrpcCallContext withOption(ApiCallContext.Key<T> key,
                                      T value)

Specified by:

withOption in interface ApiCallContext

getOption

public <T> T getOption(ApiCallContext.Key<T> key)

Specified by:

getOption in interface ApiCallContext

hashCode

public int hashCode()

Overrides:

hashCode in class Object

equals

public boolean equals(Object o)

Overrides:

equals in class Object