io.grpc.stub

Class AbstractStub<S extends AbstractStub<S>>

java.lang.Object

io.grpc.stub.AbstractStub<S>

Type Parameters:

S - the concrete type of this stub.

public abstract class AbstractStub<S extends AbstractStub<S>>
extends Object

Common base type for stub implementations.

This is the base class of the stub classes from the generated code. It allows for reconfiguration, e.g., attaching interceptors to the stub.

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	AbstractStub(io.grpc.Channel channel) Constructor for use by subclasses, with the default CallOptions.
protected	AbstractStub(io.grpc.Channel channel, io.grpc.CallOptions callOptions) Constructor for use by subclasses, with the default CallOptions.

Method Summary

Modifier and Type	Method and Description
protected abstract S	build(io.grpc.Channel channel, io.grpc.CallOptions callOptions) Returns a new stub with the given channel for the provided method configurations.
io.grpc.CallOptions	getCallOptions() The CallOptions of the stub.
io.grpc.Channel	getChannel() The underlying channel of the stub.
S	withChannel(io.grpc.Channel newChannel) Returns a new stub that uses the given channel.
S	withDeadlineAfter(long duration, TimeUnit unit) Returns a new stub with a deadline that is after the given duration from now.
S	withDeadlineNanoTime(Long deadlineNanoTime) Returns a new stub with an absolute deadline in nanoseconds in the clock as per System.nanoTime().
S	withInterceptors(io.grpc.ClientInterceptor... interceptors) Returns a new stub that has the given interceptors attached to the underlying channel.

Methods inherited from class java.lang.Object

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

Constructor Detail

AbstractStub

protected AbstractStub(io.grpc.Channel channel)

Constructor for use by subclasses, with the default CallOptions.

Parameters:

channel - the channel that this stub will use to do communications

AbstractStub

protected AbstractStub(io.grpc.Channel channel,
                       io.grpc.CallOptions callOptions)

Constructor for use by subclasses, with the default CallOptions.

Parameters:

channel - the channel that this stub will use to do communications

callOptions - the runtime call options to be applied to every call on this stub

Method Detail

getChannel

public final io.grpc.Channel getChannel()

The underlying channel of the stub.

getCallOptions

public final io.grpc.CallOptions getCallOptions()

The CallOptions of the stub.

build

protected abstract S build(io.grpc.Channel channel,
                           io.grpc.CallOptions callOptions)

Returns a new stub with the given channel for the provided method configurations.

Parameters:

channel - the channel that this stub will use to do communications

callOptions - the runtime call options to be applied to every call on this stub

withDeadlineNanoTime

public final S withDeadlineNanoTime(@Nullable
                                    Long deadlineNanoTime)

Returns a new stub with an absolute deadline in nanoseconds in the clock as per System.nanoTime().

This is mostly used for propagating an existing deadline. withDeadlineAfter(long, java.util.concurrent.TimeUnit) is the recommended way of setting a new deadline,

Parameters:

deadlineNanoTime - nanoseconds in the clock as per System.nanoTime()

withDeadlineAfter

public final S withDeadlineAfter(long duration,
                                 TimeUnit unit)

Returns a new stub with a deadline that is after the given duration from now.

See Also:

CallOptions.withDeadlineAfter(long, java.util.concurrent.TimeUnit)

withChannel

public final S withChannel(io.grpc.Channel newChannel)

Returns a new stub that uses the given channel.

withInterceptors

public final S withInterceptors(io.grpc.ClientInterceptor... interceptors)

Returns a new stub that has the given interceptors attached to the underlying channel.