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>

Field Summary

Fields

Modifier and Type	Field	Description
static final io.grpc.CallOptions.Key<ApiTracer>	TRACER_KEY

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.
void	validateUniverseDomain()	Validate the Universe Domain to ensure that the user configured Universe Domain and the Credentials' Universe Domain match.
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	withEndpointContext(EndpointContext endpointContext)
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

Field Details

TRACER_KEY

public static final io.grpc.CallOptions.Key<ApiTracer> TRACER_KEY

Method Details

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

withEndpointContext

public GrpcCallContext withEndpointContext(EndpointContext endpointContext)

Specified by:

withEndpointContext 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

validateUniverseDomain

@InternalApi
public void validateUniverseDomain()

Validate the Universe Domain to ensure that the user configured Universe Domain and the Credentials' Universe Domain match. An exception will be raised if there are any issues when trying to validate (i.e. unable to access the universe domain).

Throws:

UnauthenticatedException - Thrown if the universe domain that the user configured does not match the Credential's universe domain.

UnavailableException - If client library is unable to retrieve the universe domain from the Credentials and the RPC is configured to retry Unavailable exceptions, the client library will attempt to retry with the RPC's defined retry bounds. If the retry bounds have been exceeded and the library is still unable to retrieve the universe domain, the exception will be thrown back to the user.

hashCode

public int hashCode()

Overrides:

hashCode in class Object

equals

public boolean equals(Object o)

Overrides:

equals in class Object