router

type BaseContext struct {
	Segs  []string //路由段信息
	Level int      //当前路由级别
}

type BaseRouter struct {
	UnlimitedRouter
	// contains filtered or unexported fields
}

type BaseRouterExecutor struct {
	End     Router
	Context RouterContext
}

type Error string

type PostFilter interface {
	// Filter 过滤该请求
	// return:返回true表示继续处理,否则终止路由过程,后续的过滤器也不会执行
	Filter(context RouterContext, result interface{}) bool
}

type PreFilter interface {
	// Filter 过滤该请求
	// return:返回true表示继续处理,否则终止路由过程,后续的过滤器也不会执行
	Filter(context RouterContext) bool
}

type RegSegment struct {
	Exp    string         //正则表达式
	Regexp *regexp.Regexp //编译后的正则表达式
	Keys   []string       //可提取keys
}

type Router interface {
	// Name 返回当前路由名称
	Name() string
	// MatchString 返回当前路由用于进行匹配的字符串
	MatchString() string
	// Parent 返回当前父路由,每个Router只能有一个Parent
	Parent() Router
	// SetParent 设置当前路由父路由,当前路由必须是父路由的子路由
	SetParent(router Router) error
	// Normal 返回当前路由是否为通常路由,通常路由可以使用MatchString()返回的字符串进行直接匹配
	Normal() bool
	// AddChild 添加子路由,Name相同的路由自动合并
	AddChild(router Router)
	// AddChildren 批量添加子路由,Name相同的路由自动合并
	AddChildren(routers []Router)
	// Child 返回指定名称的子路由
	Child(name string) (Router, bool)
	// Children 返回所有子路由
	Children() []Router
	// RemoveChild 移除指定名称的路由,并返回该路由
	RemoveChild(name string) (Router, bool)
	// AddPreFilter 添加前置过滤器
	AddPreFilter(filter PreFilter) Router
	// RemovePreFilter 移除前置过滤器
	RemovePreFilter(filter PreFilter) bool
	// ExecPreFilter 执行前置过滤器
	ExecPreFilter(context RouterContext) bool
	// AddPostFilter 添加后置过滤器
	AddPostFilter(filter PostFilter) Router
	// RemovePostFilter 移除后置过滤器
	RemovePostFilter(filter PostFilter) bool
	// ExecPostFilter 执行后置过滤器
	ExecPostFilter(context RouterContext, result interface{}) bool
	// SetRouterExcutorGenerator 设置路由执行器生成方法
	SetRouterExcutorGenerator(RouterExcutorGenerator)
	// RouterExcutor 获得路由执行器
	RouterExcutor() (RouterExcutor, bool)
	// Find 查找路由,该路由不一定能够生成RouterExcutor
	Find(context RouterContext) (Router, bool)
	// Match 匹配指定路由上下文,匹配成功则返回RouterExcutor
	Match(context RouterContext) (RouterExcutor, bool)
}

type RouterContext interface {
	// Segments 返回可匹配路由段(不包含已匹配的路由段)
	Segments() []string
	// AllSegments 返回所有路由段
	AllSegments() []string
	// Match 匹配路由段数量
	Match(count int)
	// Unmatch 失配路由段数量
	Unmatch(count int)
	// Matched 返回当前已匹配的路由段数量
	Matched() int
	// Value 返回路由值
	Value(name string) (string, bool)
	// SetValue 设置路由值
	SetValue(name string, value string)
}

type RouterCreator func(name string, match interface{}) (Router, error)

type RouterExcutor interface {
	// Router 返回生成RouterExcutor的路由
	Router() Router
	// SetRouter 设置生成RouterExcutor的路由
	SetRouter(router Router)
	// RouterContext 返回路由上下文
	RouterContext() RouterContext
	// SetRouterContext 设置路由上下文
	SetRouterContext(context RouterContext)
	// Execute 执行,并返回相应结果
	Execute() (interface{}, error)
}

type RouterExcutorGenerator func() RouterExcutor

type UnlimitedRouter struct {
	// contains filtered or unexported fields
}