interceptor

Documentation

Overview

Package interceptor 针对带参数类型路由的拦截处理

在解析诸如 /authors/{id:\\d+} 带参数的路由项时， 用户可以通过拦截并自定义对参数部分 {id:\\d+} 的解析， 从而不需要走正则表达式的那一套解析流程，可以在一定程度上增强性能。

一旦正则表达式被拦截，则节点类型也将不再是正则表达式， 其处理优先级会比正则表达式类型高。 在某些情况下，可能会造成处理结果不相同。比如：

/authors/{id:\\d+}     // 1
/authors/{id:[0-9]+}   // 2

以上两条记录是相同的，但因为表达式不同，也能正常添加， 处理流程，会按添加顺序优先比对第一条，所以第二条是永远无法匹配的。 但是如果你此时添加了 Register(MatchDigit, "[0-9]+")， 将第二个记录的优先级作为提升，以后的匹配都是优先第二条， 造成第一条永远无法匹配到数据。

除非是改造旧有的项目，否则建议自定义一些约束符来处理。比如：

/authors/{id:digit}

用户只要注册一个 Register(MatchDigit, "digit") 即可拦截针对 digit 的项， 且不会影响正则表达式的处理。

interceptor 也是本着这样的原则，添加了以下拦截器：

• digit 数字；
• word 单词，即 [a-zA-Z0-9]+；
• any 任意非空内容；

Index

• func Deregister(val ...string)
• func MatchAny(path string) bool
• func MatchDigit(path string) bool
• func MatchWord(path string) bool
• func Register(f MatchFunc, val ...string) error
• type MatchFunc
  • func Get(v string) (MatchFunc, bool)

Functions

func Deregister

func Deregister(val ...string)

Deregister 注销拦截器

func MatchAny

func MatchAny(path string) bool

MatchAny 匹配任意非空内容

func MatchDigit

func MatchDigit(path string) bool

MatchDigit 匹配数值字符

正则表达式中的 [0-9]+ 是相同的。

func MatchWord

func MatchWord(path string) bool

MatchWord 匹配单词

正则表达式中的 [a-zA-Z0-9]+ 是相同的。

func Register

func Register(f MatchFunc, val ...string) error

Register 注册拦截器

val 表示需要处理的正则表达式，比如 {id:\\d+} 则为 \\d+。

Types

type MatchFunc

type MatchFunc func(string) bool

MatchFunc 每个拦截器的实际处理函数

func Get

func Get(v string) (MatchFunc, bool)

Get 查找指定的处理函数