org.apache.dubbo.rpc.cluster.router.condition.config

Class ListenableStateRouter<T>

java.lang.Object

org.apache.dubbo.rpc.cluster.router.state.AbstractStateRouter<T>

org.apache.dubbo.rpc.cluster.router.condition.config.ListenableStateRouter<T>

All Implemented Interfaces:

Comparable<StateRouter<T>>, EventListener, org.apache.dubbo.common.config.configcenter.ConfigurationListener, StateRouter<T>

Direct Known Subclasses:

AppStateRouter, ServiceRouter

public abstract class ListenableStateRouter<T>
extends AbstractStateRouter<T>
implements org.apache.dubbo.common.config.configcenter.ConfigurationListener

Abstract router which listens to dynamic configuration

Field Summary

Fields

Modifier and Type	Field and Description
static String	NAME

Fields inherited from interface org.apache.dubbo.rpc.cluster.router.state.StateRouter

DEFAULT_PRIORITY

Constructor Summary

Constructors

Constructor and Description
ListenableStateRouter(org.apache.dubbo.common.URL url, String ruleKey)

Method Summary

Modifier and Type	Method and Description
boolean	isForce() To decide whether this router should take effect when none of the invoker can match the router rule, which means the StateRouter.route(BitList, URL, Invocation, boolean) would be empty.
void	process(org.apache.dubbo.common.config.configcenter.ConfigChangedEvent event)
StateRouterResult<Invoker<T>>	route(BitList<Invoker<T>> invokers, org.apache.dubbo.common.URL url, Invocation invocation, boolean needToPrintMessage) ** This method can return the state of whether routerChain needed to continue route.
void	stop()

Methods inherited from class org.apache.dubbo.rpc.cluster.router.state.AbstractStateRouter

getPriority, getRuleRepository, getUrl, isRuntime, notify, setForce, setPriority, setUrl

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.apache.dubbo.rpc.cluster.router.state.StateRouter

compareTo

Field Detail

NAME

public static final String NAME

See Also:

Constant Field Values

Constructor Detail

ListenableStateRouter

public ListenableStateRouter(org.apache.dubbo.common.URL url,
                             String ruleKey)

Method Detail

process

public void process(org.apache.dubbo.common.config.configcenter.ConfigChangedEvent event)

Specified by:

process in interface org.apache.dubbo.common.config.configcenter.ConfigurationListener

route

public StateRouterResult<Invoker<T>> route(BitList<Invoker<T>> invokers,
                                           org.apache.dubbo.common.URL url,
                                           Invocation invocation,
                                           boolean needToPrintMessage)
                                    throws RpcException

Description copied from interface: StateRouter

** This method can return the state of whether routerChain needed to continue route. ** Filter invokers with current routing rule and only return the invokers that comply with the rule. Caching address lists in BitMap mode improves routing performance.

Specified by:

route in interface StateRouter<T>

Parameters:

invokers - invoker bit list

url - refer url

invocation - invocation

needToPrintMessage - whether to print router state. Such as `use router branch a`.

Returns:

state with route result

Throws:

RpcException

isForce

public boolean isForce()

Description copied from interface: StateRouter

To decide whether this router should take effect when none of the invoker can match the router rule, which means the StateRouter.route(BitList, URL, Invocation, boolean) would be empty. Most of time, most router implementation would default this value to false.

Specified by:

isForce in interface StateRouter<T>

Overrides:

isForce in class AbstractStateRouter<T>

Returns:

true to execute if none of invokers matches the current router

stop

public void stop()

Specified by:

stop in interface StateRouter<T>