io.grpc.util

Class GracefulSwitchLoadBalancer

java.lang.Object

io.grpc.LoadBalancer

io.grpc.util.ForwardingLoadBalancer

io.grpc.util.GracefulSwitchLoadBalancer

@ExperimentalApi(value="https://github.com/grpc/grpc-java/issues/5999")
 @NotThreadSafe
public final class GracefulSwitchLoadBalancer
extends ForwardingLoadBalancer

A load balancer that gracefully swaps to a new lb policy. If the channel is currently in a state other than READY, the new policy will be swapped into place immediately. Otherwise, the channel will keep using the old policy until the new policy reports READY or the old policy exits READY.

Nested Class Summary

Nested classes/interfaces inherited from class io.grpc.LoadBalancer

io.grpc.LoadBalancer.CreateSubchannelArgs, io.grpc.LoadBalancer.Factory, io.grpc.LoadBalancer.Helper, io.grpc.LoadBalancer.PickResult, io.grpc.LoadBalancer.PickSubchannelArgs, io.grpc.LoadBalancer.ResolvedAddresses, io.grpc.LoadBalancer.Subchannel, io.grpc.LoadBalancer.SubchannelPicker, io.grpc.LoadBalancer.SubchannelStateListener

Field Summary

Fields inherited from class io.grpc.LoadBalancer

ATTR_LOAD_BALANCING_CONFIG

Constructor Summary

Constructors

Constructor and Description
GracefulSwitchLoadBalancer(io.grpc.LoadBalancer.Helper helper)

Method Summary

Modifier and Type	Method and Description
protected io.grpc.LoadBalancer	delegate() Returns the underlying balancer.
void	handleSubchannelState(io.grpc.LoadBalancer.Subchannel subchannel, io.grpc.ConnectivityStateInfo stateInfo) Deprecated.
void	shutdown()
void	switchTo(io.grpc.LoadBalancerProvider newLbProvider) Gracefully switch to a new load balancing policy.

Methods inherited from class io.grpc.util.ForwardingLoadBalancer

canHandleEmptyAddressListFromNameResolution, handleNameResolutionError, handleResolvedAddresses, handleResolvedAddressGroups, requestConnection, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

GracefulSwitchLoadBalancer

public GracefulSwitchLoadBalancer(io.grpc.LoadBalancer.Helper helper)

Method Detail

switchTo

public void switchTo(io.grpc.LoadBalancerProvider newLbProvider)

Gracefully switch to a new load balancing policy.

delegate

protected io.grpc.LoadBalancer delegate()

Description copied from class: ForwardingLoadBalancer

Returns the underlying balancer.

Specified by:

delegate in class ForwardingLoadBalancer

handleSubchannelState

@Deprecated
public void handleSubchannelState(io.grpc.LoadBalancer.Subchannel subchannel,
                                              io.grpc.ConnectivityStateInfo stateInfo)

Deprecated.

Overrides:

handleSubchannelState in class ForwardingLoadBalancer

shutdown

public void shutdown()

Overrides:

shutdown in class ForwardingLoadBalancer