cn.xnatural.xchain

类 Chain<T extends Context>

java.lang.Object

cn.xnatural.xchain.Chain<T>

public class Chain<T extends Context>
extends Object

MVC 树结构的执行链

 {
        "": {
                Filter[(0)/a], Route[/a/b/d], Route[/a/b/{c}], Route[/map], Route[/arr], Route[/optional], Route[(GET)/getmethod],
  }
        "test": {
                Route[/proto],
   }
 }
 

线程安全

嵌套类概要

嵌套类

限定符和类型	类和说明
protected class	Chain.IntMap<E> ...-2,-1,0,1,2..
protected class	Chain.Node 执行链路节点

字段概要

字段

限定符和类型	字段和说明
protected cn.xnatural.xchain.Lazier<cn.xnatural.xchain.Counter>	_counter 时间段统计器
protected static org.slf4j.Logger	log
protected Map<String,Chain.Node>	protocolMap 协议处理器节点链
protected IMvc<T>	server

构造器概要

构造器

构造器和说明
Chain(IMvc<T> server)

方法概要

限定符和类型	方法和说明
Chain<T>	filter(String protocol, String prefix, int order, Handler<T> handler) 添加Filter
protected boolean	handle(PathHandler<T> h, T ctx) 执行某个RouteHandler
protected boolean	handle(T ctx) 执行此Chain
protected void	handleNoMatch(T ctx) 处理未有匹配的处理器
String	logStr(String protocol, String id, String method, String path)
Map<String,Object>	openApi()
protected void	preMatch(Chain.Node first) 计算节点的可跳跃节点 节点匹配结果代码 RouteHandler.match(Context) Chain.Node.matchJump 匹配结果代码 -> 跳跃的目的节点
Chain<T>	register(PathHandler<T> handler) 注册 PathHandler 按优先级PathHandler.compareTo(PathHandler)}的比较结果添加
Chain<T>	resolve(Collection ctrls) 从对象中解析 Route Filter
Chain<T>	resolve(Object... ctrls) 从对象中解析 Route Filter
Chain<T>	resolve(Object ctrl) 从对象中解析 Route Filter
protected void	resolve(Object ctrl, Method method) 解析路由,可扩展自定义注释 子类重写添加其他解析
protected void	resolveFilter(Object ctrl, Method method) 解析 Filter
protected void	resolveRoute_preProcess(Object ctrl, Method method, Set<String> paths, Set<String> protocols, Set<String> methods, Set<String> consumes, Set<String> produces)
protected void	resolveRoute(Object ctrl, Method method) 解析 Route
Chain<T>	route(String path, Consumer<T> handler) 指定路径处理器
Chain<T>	route(String path, Handler<T> handler) 指定路径处理器
Chain<T>	route(String protocol, String path, Consumer<T> handler) 指定路径和协议处理器
Chain<T>	route(String protocol, String path, Matchable<T> matcher, Handler<T> handler) 指定路径和协议处理器
protected RouteHandler<T>	routeHandler(String protocol, String path, Set<String> method, Set<String> consume, Set<String> produce, Handler<T> handler) 创建一个 RouteHandler 用于子类重写
String	toString()

从类继承的方法 java.lang.Object

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

字段详细资料

log

protected static final org.slf4j.Logger log

protocolMap

protected final Map<String,Chain.Node> protocolMap

协议处理器节点链

server

protected final IMvc<T extends Context> server

_counter

protected final cn.xnatural.xchain.Lazier<cn.xnatural.xchain.Counter> _counter

时间段统计器

构造器详细资料

Chain

public Chain(IMvc<T> server)

方法详细资料

handle

protected boolean handle(T ctx)

执行此Chain

参数:

ctx - Context

返回:

true: 已处理(匹配路由处理:非Filter处理)，false: 未处理

handle

protected boolean handle(PathHandler<T> h,
                         T ctx)
                  throws Throwable

执行某个RouteHandler

抛出:

Throwable

handleNoMatch

protected void handleNoMatch(T ctx)

处理未有匹配的处理器

register

public Chain<T> register(PathHandler<T> handler)

注册 PathHandler 按优先级PathHandler.compareTo(PathHandler)}的比较结果添加

参数:

handler - Handler

返回:

Chain

preMatch

protected void preMatch(Chain.Node first)

 计算节点的可跳跃节点
 节点匹配结果代码 RouteHandler.match(Context)
 Chain.Node.matchJump 匹配结果代码 -> 跳跃的目的节点
 

route

public Chain<T> route(String protocol,
                      String path,
                      Matchable<T> matcher,
                      Handler<T> handler)

指定路径和协议处理器

参数:

protocol - Route.protocol()

path - Route.path()

matcher - 匹配函数, 可由运行时逻辑动态决定是否匹配

handler - 处理器

返回:

Chain

route

public Chain<T> route(String path,
                      Handler<T> handler)

指定路径处理器

参数:

path - Route.path()

handler - 处理器

返回:

Chain

route

public Chain<T> route(String protocol,
                      String path,
                      Consumer<T> handler)

指定路径和协议处理器

参数:

protocol - Route.protocol()

path - Route.path()

handler - 处理器

返回:

Chain

route

public Chain<T> route(String path,
                      Consumer<T> handler)

指定路径处理器

参数:

path - Route.path()

handler - 处理器

返回:

Chain

filter

public Chain<T> filter(String protocol,
                       String prefix,
                       int order,
                       Handler<T> handler)

添加Filter

参数:

protocol - Filter.protocol()

prefix - Filter.prefix()

handler - Handler

返回:

Chain

resolve

public Chain<T> resolve(Collection ctrls)

从对象中解析 Route Filter

resolve

public Chain<T> resolve(Object... ctrls)

从对象中解析 Route Filter

resolve

public Chain<T> resolve(Object ctrl)

从对象中解析 Route Filter

resolve

protected void resolve(Object ctrl,
                       Method method)

解析路由,可扩展自定义注释 子类重写添加其他解析

resolveFilter

protected void resolveFilter(Object ctrl,
                             Method method)

解析 Filter

参数:

ctrl - 控制层对象

method - 方法

resolveRoute

protected void resolveRoute(Object ctrl,
                            Method method)

解析 Route

参数:

ctrl - 控制层对象

method - 方法

resolveRoute_preProcess

protected void resolveRoute_preProcess(Object ctrl,
                                       Method method,
                                       Set<String> paths,
                                       Set<String> protocols,
                                       Set<String> methods,
                                       Set<String> consumes,
                                       Set<String> produces)

routeHandler

protected RouteHandler<T> routeHandler(String protocol,
                                       String path,
                                       Set<String> method,
                                       Set<String> consume,
                                       Set<String> produce,
                                       Handler<T> handler)

创建一个 RouteHandler 用于子类重写

logStr

public String logStr(String protocol,
                     String id,
                     String method,
                     String path)

openApi

public Map<String,Object> openApi()

toString

public String toString()

覆盖:

toString 在类中 Object