io.grpc.internal

Class AutoConfiguredLoadBalancerFactory.AutoConfiguredLoadBalancer

java.lang.Object

io.grpc.LoadBalancer

io.grpc.internal.AutoConfiguredLoadBalancerFactory.AutoConfiguredLoadBalancer

Enclosing class:

AutoConfiguredLoadBalancerFactory

public final class AutoConfiguredLoadBalancerFactory.AutoConfiguredLoadBalancer
extends LoadBalancer

Nested Class Summary

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

LoadBalancer.Factory, LoadBalancer.Helper, LoadBalancer.PickResult, LoadBalancer.PickSubchannelArgs, LoadBalancer.ResolvedAddresses, LoadBalancer.Subchannel, LoadBalancer.SubchannelPicker

Field Summary

Fields inherited from class io.grpc.LoadBalancer

ATTR_LOAD_BALANCING_CONFIG

Method Summary

Modifier and Type	Method and Description
boolean	canHandleEmptyAddressListFromNameResolution() Whether this LoadBalancer can handle empty address group list to be passed to LoadBalancer.handleResolvedAddresses(ResolvedAddresses).
LoadBalancer	getDelegate()
void	handleNameResolutionError(Status error) Handles an error from the name resolution system.
void	handleResolvedAddresses(LoadBalancer.ResolvedAddresses resolvedAddresses) Handles newly resolved server groups and metadata attributes from name resolution system.
void	handleSubchannelState(LoadBalancer.Subchannel subchannel, ConnectivityStateInfo stateInfo) Handles a state change on a Subchannel.
void	shutdown() The channel asks the load-balancer to shutdown.

Methods inherited from class io.grpc.LoadBalancer

handleResolvedAddressGroups

Methods inherited from class java.lang.Object

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

Method Detail

handleResolvedAddresses

public void handleResolvedAddresses(LoadBalancer.ResolvedAddresses resolvedAddresses)

Description copied from class: LoadBalancer

Handles newly resolved server groups and metadata attributes from name resolution system. servers contained in EquivalentAddressGroup should be considered equivalent but may be flattened into a single list if needed.

Implementations should not modify the given servers.

Overrides:

handleResolvedAddresses in class LoadBalancer

Parameters:

resolvedAddresses - the resolved server addresses, attributes, and config.

handleNameResolutionError

public void handleNameResolutionError(Status error)

Description copied from class: LoadBalancer

Handles an error from the name resolution system.

Specified by:

handleNameResolutionError in class LoadBalancer

Parameters:

error - a non-OK status

handleSubchannelState

public void handleSubchannelState(LoadBalancer.Subchannel subchannel,
                                  ConnectivityStateInfo stateInfo)

Description copied from class: LoadBalancer

Handles a state change on a Subchannel.

The initial state of a Subchannel is IDLE. You won't get a notification for the initial IDLE state.

If the new state is not SHUTDOWN, this method should create a new picker and call Helper.updateBalancingState(). Failing to do so may result in unnecessary delays of RPCs. Please refer to PickResult.withSubchannel()'s javadoc for more information.

SHUTDOWN can only happen in two cases. One is that LoadBalancer called LoadBalancer.Subchannel.shutdown() earlier, thus it should have already discarded this Subchannel. The other is that Channel is doing a forced shutdown or has already terminated, thus there won't be further requests to LoadBalancer. Therefore, SHUTDOWN can be safely ignored.

Specified by:

handleSubchannelState in class LoadBalancer

Parameters:

subchannel - the involved Subchannel

stateInfo - the new state

canHandleEmptyAddressListFromNameResolution

public boolean canHandleEmptyAddressListFromNameResolution()

Description copied from class: LoadBalancer

Whether this LoadBalancer can handle empty address group list to be passed to LoadBalancer.handleResolvedAddresses(ResolvedAddresses). The default implementation returns false, meaning that if the NameResolver returns an empty list, the Channel will turn that into an error and call LoadBalancer.handleNameResolutionError(io.grpc.Status). LoadBalancers that want to accept empty lists should override this method and return true.

This method should always return a constant value. It's not specified when this will be called.

Overrides:

canHandleEmptyAddressListFromNameResolution in class LoadBalancer

shutdown

public void shutdown()

Description copied from class: LoadBalancer

The channel asks the load-balancer to shutdown. No more callbacks will be called after this method. The implementation should shutdown all Subchannels and OOB channels, and do any other cleanup as necessary.

Specified by:

shutdown in class LoadBalancer

getDelegate

public LoadBalancer getDelegate()