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

Class ListenableRouter

java.lang.Object

org.apache.dubbo.rpc.cluster.router.AbstractRouter

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

All Implemented Interfaces:

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

Direct Known Subclasses:

AppRouter, ServiceRouter

public abstract class ListenableRouter
extends AbstractRouter
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

DEFAULT_PRIORITY

Constructor Summary

Constructors

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

Method Summary

Modifier and Type	Method and Description
int	getPriority() Router's priority, used to sort routers.
boolean	isForce() To decide whether this router should take effect when none of the invoker can match the router rule, which means the Router.route(List, URL, Invocation) would be empty.
void	process(org.apache.dubbo.common.config.configcenter.ConfigChangedEvent event)
<T> List<Invoker<T>>	route(List<Invoker<T>> invokers, org.apache.dubbo.common.URL url, Invocation invocation) Filter invokers with current routing rule and only return the invokers that comply with the rule.

Methods inherited from class org.apache.dubbo.rpc.cluster.router.AbstractRouter

getUrl, isRuntime, 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

compareTo, notify

Field Detail

NAME

public static final String NAME

See Also:

Constant Field Values

Constructor Detail

ListenableRouter

public ListenableRouter(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 <T> List<Invoker<T>> route(List<Invoker<T>> invokers,
                                  org.apache.dubbo.common.URL url,
                                  Invocation invocation)
                           throws RpcException

Description copied from interface: Router

Filter invokers with current routing rule and only return the invokers that comply with the rule.

Specified by:

route in interface Router

Parameters:

invokers - invoker list

url - refer url

invocation - invocation

Returns:

routed invokers

Throws:

RpcException

getPriority

public int getPriority()

Description copied from interface: Router

Router's priority, used to sort routers.

Specified by:

getPriority in interface Router

Overrides:

getPriority in class AbstractRouter

Returns:

router's priority

isForce

public boolean isForce()

Description copied from interface: Router

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

Specified by:

isForce in interface Router

Overrides:

isForce in class AbstractRouter

Returns:

true to execute if none of invokers matches the current router