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

Class ConditionRouter

java.lang.Object

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

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

All Implemented Interfaces:

Comparable<Router>, Router

public class ConditionRouter
extends AbstractRouter

ConditionRouter It supports the conditional routing configured by "override://", in 2.6.x, refer to https://dubbo.apache.org/en/docs/v2.7/user/examples/routing-rule/ . For 2.7.x and later, please refer to ServiceRouter and AppRouter refer to https://dubbo.apache.org/zh/docs/v2.7/user/examples/routing-rule/ .

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
ConditionRouter(String rule, boolean force, boolean enabled)
ConditionRouter(org.apache.dubbo.common.URL url)

Method Summary

Modifier and Type	Method and Description
org.apache.dubbo.common.URL	getUrl() Get the router url.
void	init(String rule)
boolean	isRuntime() To decide whether this router need to execute every time an RPC comes or should only execute when addresses or rule change.
boolean	matchArguments(Map.Entry<String,org.apache.dubbo.rpc.cluster.router.condition.ConditionRouter.MatchPair> matchPair, Invocation invocation) analysis the arguments in the rule.
<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

getPriority, isForce, 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

ConditionRouter

public ConditionRouter(String rule,
                       boolean force,
                       boolean enabled)

ConditionRouter

public ConditionRouter(org.apache.dubbo.common.URL url)

Method Detail

init

public void init(String rule)

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.

Parameters:

invokers - invoker list

url - refer url

invocation - invocation

Returns:

routed invokers

Throws:

RpcException

isRuntime

public boolean isRuntime()

Description copied from interface: Router

To decide whether this router need to execute every time an RPC comes or should only execute when addresses or rule change.

Specified by:

isRuntime in interface Router

Overrides:

isRuntime in class AbstractRouter

Returns:

true if the router need to execute every time.

getUrl

public org.apache.dubbo.common.URL getUrl()

Description copied from interface: Router

Get the router url.

Specified by:

getUrl in interface Router

Overrides:

getUrl in class AbstractRouter

Returns:

url

matchArguments

public boolean matchArguments(Map.Entry<String,org.apache.dubbo.rpc.cluster.router.condition.ConditionRouter.MatchPair> matchPair,
                              Invocation invocation)

analysis the arguments in the rule. Examples would be like this: "arguments[0]=1", whenCondition is that the first argument is equal to '1'. "arguments[1]=a", whenCondition is that the second argument is equal to 'a'.

Parameters:

matchPair -

invocation -

Returns: