com.netflix.loadbalancer

Class DynamicServerListLoadBalancer<T extends Server>

java.lang.Object

com.netflix.loadbalancer.AbstractLoadBalancer

com.netflix.loadbalancer.BaseLoadBalancer

com.netflix.loadbalancer.DynamicServerListLoadBalancer<T>

All Implemented Interfaces:

com.netflix.client.IClientConfigAware, PrimeConnections.PrimeConnectionListener, ILoadBalancer

Direct Known Subclasses:

ZoneAwareLoadBalancer

public class DynamicServerListLoadBalancer<T extends Server>
extends BaseLoadBalancer

A LoadBalancer that has the capabilities to obtain the candidate list of servers using a dynamic source. i.e. The list of servers can potentially be changed at Runtime. It also contains facilities wherein the list of servers can be passed through a Filter criteria to filter out servers that do not meet the desired criteria.

Nested Class Summary

Nested classes/interfaces inherited from class com.netflix.loadbalancer.AbstractLoadBalancer

AbstractLoadBalancer.ServerGroup

Nested classes/interfaces inherited from interface com.netflix.client.IClientConfigAware

com.netflix.client.IClientConfigAware.Factory

Field Summary

Fields

Modifier and Type	Field and Description
protected java.util.concurrent.atomic.AtomicBoolean	serverListUpdateInProgress
protected ServerListUpdater	serverListUpdater
protected ServerListUpdater.UpdateAction	updateAction

Fields inherited from class com.netflix.loadbalancer.BaseLoadBalancer

allServerList, allServerLock, lbStats, lbTimer, maxTotalPingTimeSeconds, name, ping, pingInProgress, pingIntervalSeconds, pingStrategy, rule, serverComparator, upServerList, upServerLock

Constructor Summary

Constructors

Constructor and Description
DynamicServerListLoadBalancer()
DynamicServerListLoadBalancer(com.netflix.client.config.IClientConfig clientConfig)
DynamicServerListLoadBalancer(com.netflix.client.config.IClientConfig clientConfig, IRule rule, IPing ping, ServerList<T> serverList, ServerListFilter<T> filter) Deprecated.
DynamicServerListLoadBalancer(com.netflix.client.config.IClientConfig clientConfig, IRule rule, IPing ping, ServerList<T> serverList, ServerListFilter<T> filter, ServerListUpdater serverListUpdater)

Method Summary

Modifier and Type	Method and Description
void	enableAndInitLearnNewServersFeature() Feature that lets us add new instances (from AMIs) to the list of existing servers that the LB will use Call this method if you want this feature enabled
void	forceQuickPing()
int	getCoreThreads()
long	getDurationSinceLastUpdateMs()
ServerListFilter<T>	getFilter()
java.lang.String	getLastUpdate()
int	getNumberMissedCycles()
ServerList<T>	getServerListImpl()
ServerListUpdater	getServerListUpdater()
void	initWithNiwsConfig(com.netflix.client.config.IClientConfig clientConfig)
void	initWithNiwsConfig(com.netflix.client.config.IClientConfig clientConfig, com.netflix.client.IClientConfigAware.Factory factory)
void	setFilter(ServerListFilter<T> filter)
protected void	setServerListForZones(java.util.Map<java.lang.String,java.util.List<Server>> zoneServersMap)
void	setServerListImpl(ServerList<T> niwsServerList)
void	setServerListUpdater(ServerListUpdater serverListUpdater)
void	setServersList(java.util.List lsrv) Set the list of servers used as the server pool.
void	shutdown()
void	stopServerListRefreshing()
java.lang.String	toString()
protected void	updateAllServerList(java.util.List<T> ls) Update the AllServer list in the LoadBalancer if necessary and enabled
void	updateListOfServers()

Methods inherited from class com.netflix.loadbalancer.BaseLoadBalancer

addServer, addServerListChangeListener, addServers, addServerStatusChangeListener, cancelPingTask, choose, chooseServer, getAllServers, getClientConfig, getLoadBalancerStats, getMaxTotalPingTime, getName, getPing, getPingInterval, getPrimeConnections, getReachableServers, getRule, getServerByIndex, getServerCount, getServerList, getServerList, init, isEnablePrimingConnections, isPingInProgress, lockAllServerList, lockUpServerList, markServerDown, markServerDown, primeCompleted, removeServerListChangeListener, removeServerStatusChangeListener, setEnablePrimingConnections, setLoadBalancerStats, setMaxTotalPingTime, setPing, setPingInterval, setPrimeConnections, setRule

Methods inherited from class com.netflix.loadbalancer.AbstractLoadBalancer

chooseServer

Methods inherited from class java.lang.Object

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

Field Detail

serverListUpdateInProgress

protected java.util.concurrent.atomic.AtomicBoolean serverListUpdateInProgress

updateAction

protected final ServerListUpdater.UpdateAction updateAction

serverListUpdater

protected volatile ServerListUpdater serverListUpdater

Constructor Detail

DynamicServerListLoadBalancer

public DynamicServerListLoadBalancer()

DynamicServerListLoadBalancer

@Deprecated
public DynamicServerListLoadBalancer(com.netflix.client.config.IClientConfig clientConfig,
                                                 IRule rule,
                                                 IPing ping,
                                                 ServerList<T> serverList,
                                                 ServerListFilter<T> filter)

Deprecated.

DynamicServerListLoadBalancer

public DynamicServerListLoadBalancer(com.netflix.client.config.IClientConfig clientConfig,
                                     IRule rule,
                                     IPing ping,
                                     ServerList<T> serverList,
                                     ServerListFilter<T> filter,
                                     ServerListUpdater serverListUpdater)

DynamicServerListLoadBalancer

public DynamicServerListLoadBalancer(com.netflix.client.config.IClientConfig clientConfig)

Method Detail

initWithNiwsConfig

public void initWithNiwsConfig(com.netflix.client.config.IClientConfig clientConfig)

Specified by:

initWithNiwsConfig in interface com.netflix.client.IClientConfigAware

Overrides:

initWithNiwsConfig in class BaseLoadBalancer

initWithNiwsConfig

public void initWithNiwsConfig(com.netflix.client.config.IClientConfig clientConfig,
                               com.netflix.client.IClientConfigAware.Factory factory)

Specified by:

initWithNiwsConfig in interface com.netflix.client.IClientConfigAware

Overrides:

initWithNiwsConfig in class BaseLoadBalancer

setServersList

public void setServersList(java.util.List lsrv)

Description copied from class: BaseLoadBalancer

Set the list of servers used as the server pool. This overrides existing server list.

Overrides:

setServersList in class BaseLoadBalancer

setServerListForZones

protected void setServerListForZones(java.util.Map<java.lang.String,java.util.List<Server>> zoneServersMap)

getServerListImpl

public ServerList<T> getServerListImpl()

setServerListImpl

public void setServerListImpl(ServerList<T> niwsServerList)

getFilter

public ServerListFilter<T> getFilter()

setFilter

public void setFilter(ServerListFilter<T> filter)

getServerListUpdater

public ServerListUpdater getServerListUpdater()

setServerListUpdater

public void setServerListUpdater(ServerListUpdater serverListUpdater)

forceQuickPing

public void forceQuickPing()

Overrides:

forceQuickPing in class BaseLoadBalancer

enableAndInitLearnNewServersFeature

public void enableAndInitLearnNewServersFeature()

Feature that lets us add new instances (from AMIs) to the list of existing servers that the LB will use Call this method if you want this feature enabled

stopServerListRefreshing

public void stopServerListRefreshing()

updateListOfServers

public void updateListOfServers()

updateAllServerList

protected void updateAllServerList(java.util.List<T> ls)

Update the AllServer list in the LoadBalancer if necessary and enabled

Parameters:

ls -

toString

public java.lang.String toString()

Overrides:

toString in class BaseLoadBalancer

shutdown

public void shutdown()

Overrides:

shutdown in class BaseLoadBalancer

getLastUpdate

@Monitor(name="LastUpdated",
         type=INFORMATIONAL)
public java.lang.String getLastUpdate()

getDurationSinceLastUpdateMs

@Monitor(name="DurationSinceLastUpdateMs",
         type=GAUGE)
public long getDurationSinceLastUpdateMs()

getNumberMissedCycles

@Monitor(name="NumUpdateCyclesMissed",
         type=GAUGE)
public int getNumberMissedCycles()

getCoreThreads

@Monitor(name="NumThreads",
         type=GAUGE)
public int getCoreThreads()