org.apache.dubbo.rpc.cluster.router.state

Interface StateRouter<T>

All Superinterfaces:

Comparable<StateRouter<T>>

All Known Implementing Classes:

AbstractStateRouter, AppStateRouter, ConditionStateRouter, ListenableStateRouter, MockInvokersSelector, ScriptStateRouter, ServiceRouter, TagStateRouter

public interface StateRouter<T>
extends Comparable<StateRouter<T>>

State Router. (SPI, Prototype, ThreadSafe)

Routing

Since:

3.0

See Also:

Cluster.join(Directory, boolean), Directory.list(Invocation)

Field Summary

Fields

Modifier and Type	Field and Description
static int	DEFAULT_PRIORITY

Method Summary

Modifier and Type	Method and Description
default int	compareTo(StateRouter o)
int	getPriority() Router's priority, used to sort routers.
org.apache.dubbo.common.URL	getUrl() Get the router url.
boolean	isForce() To decide whether this router should take effect when none of the invoker can match the router rule, which means the route(BitList, URL, Invocation, boolean) would be empty.
boolean	isRuntime() To decide whether this router need to execute every time an RPC comes or should only execute when addresses or rule change.
void	notify(BitList<Invoker<T>> invokers) Notify the router the invoker list.
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.
default void	stop()

Field Detail

DEFAULT_PRIORITY

static final int DEFAULT_PRIORITY

See Also:

Constant Field Values

Method Detail

getUrl

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

Get the router url.

Returns:

url

route

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

** 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.

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

Since:

3.0

isRuntime

boolean isRuntime()

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

Returns:

true if the router need to execute every time.

isForce

boolean isForce()

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

Returns:

true to execute if none of invokers matches the current router

getPriority

int getPriority()

Router's priority, used to sort routers.

Returns:

router's priority

notify

void notify(BitList<Invoker<T>> invokers)

Notify the router the invoker list. Invoker list may change from time to time. This method gives the router a chance to prepare before route(BitList, URL, Invocation, boolean) gets called.

Parameters:

invokers - invoker list

compareTo

default int compareTo(StateRouter o)

Specified by:

compareTo in interface Comparable<StateRouter<T>>

stop

default void stop()