io.grpc.internal

Interface ManagedClientTransport

All Superinterfaces:

ClientTransport, io.grpc.InternalInstrumented<io.grpc.InternalChannelz.SocketStats>, io.grpc.InternalWithLogId

All Known Subinterfaces:

ConnectionClientTransport

@ThreadSafe
public interface ManagedClientTransport
extends ClientTransport

A ClientTransport that has life-cycle management.

start(io.grpc.internal.ManagedClientTransport.Listener) must be the first method call to this interface and return before calling other methods.

Typically the transport owns the streams it creates through ClientTransport.newStream(io.grpc.MethodDescriptor<?, ?>, io.grpc.Metadata, io.grpc.CallOptions), while some implementations may transfer the streams to somewhere else. Either way they must conform to the contract defined by shutdown(io.grpc.Status), ManagedClientTransport.Listener.transportShutdown(io.grpc.Status) and ManagedClientTransport.Listener.transportTerminated().

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static interface	ManagedClientTransport.Listener Receives notifications for the transport life-cycle events.

Nested classes/interfaces inherited from interface io.grpc.internal.ClientTransport

ClientTransport.PingCallback

Method Summary

Modifier and Type	Method and Description
void	shutdown(io.grpc.Status reason) Initiates an orderly shutdown of the transport.
void	shutdownNow(io.grpc.Status reason) Initiates a forceful shutdown in which preexisting and new calls are closed.
Runnable	start(ManagedClientTransport.Listener listener) Starts transport.

Methods inherited from interface io.grpc.internal.ClientTransport

newStream, ping

Methods inherited from interface io.grpc.InternalInstrumented

getStats

Methods inherited from interface io.grpc.InternalWithLogId

getLogId

Method Detail

start

@CheckReturnValue
 @Nullable
Runnable start(ManagedClientTransport.Listener listener)

Starts transport. This method may only be called once.

Implementations must not call listener from within start(io.grpc.internal.ManagedClientTransport.Listener); implementations are expected to notify listener on a separate thread or when the returned Runnable is run. This method and the returned Runnable should not throw any exceptions.

Parameters:

listener - non-null listener of transport events

Returns:

a Runnable that is executed after-the-fact by the original caller, typically after locks are released

shutdown

void shutdown(io.grpc.Status reason)

Initiates an orderly shutdown of the transport. Existing streams continue, but the transport will not own any new streams. New streams will either fail (once ManagedClientTransport.Listener.transportShutdown(io.grpc.Status) callback called), or be transferred off this transport (in which case they may succeed). This method may only be called once.

shutdownNow

void shutdownNow(io.grpc.Status reason)

Initiates a forceful shutdown in which preexisting and new calls are closed. Existing calls should be closed with the provided reason.