BFE的回调机制
BFE的转发过程和回调点
BFE转发过程中的回调点如下图所示。
回调点列表
在BFE中,设置了以下9个回调点:
- HandleAccept: 位于和客户端的TCP连接建立后
- HandleHandshake:位于和客户端的SSL或TLS握手完成后
- HandleBeforeLocation:位于查找产品线之前
- HandleFoundProduct:位于完成查找产品线之后
- HandleAfterLocation:位于完成查找集群之后
- HandleForward:位于完成查找子集群和后端实例之后,位于转发请求之前
- HandleReadResponse:位于读取到后端响应之后
- HandleRequestFinish:位于后端响应处理完毕后
- HandleFinish:位于和客户端的TCP连接关闭后
回调点的定义,可以查看/bfe_module/bfe_callback.go
回调函数的返回值
在回调点执行由模块注册的回调函数,回调函数会返回特定的返回值。BFE根据回调函数的返回值,执行后续的操作。
回调函数的返回值,定义如下:
- BfeHandlerFinish:在发送响应后,关闭连接
- BfeHandlerGoOn:继续执行下一个回调函数
- BfeHandlerRedirect:执行重定向(Redirect)
- BfeHandlerResponse:发送响应
- BfeHandlerClose:直接关闭连接,不发送任何数据
回调函数返回值的定义,可以查看/bfe_module/bfe_handler_list.go
回调函数的形式
在不同的回调点,回调函数的形式也是不同的。在BFE中,定义了以下5种类型的回调函数
- HandlersAccept:用于处理连接建立的相关场景
- HandlersRequest:用于处理和请求有关的场景
- HandlersForward:用于处理和转发有关的场景
- HandlersResponse:用于处理和响应有关的场景
- HandlersFinish:用于处理连接关闭的相关场景
回调函数类型的定义,可以查看/bfe_module/bfe_handler_list.go
下面对这几种回调函数做详细的说明。
注:下面回调函数中int类型的返回值,参见上述“回调函数的返回值”中的说明。
HandlersAccept
- 适用回调点:
- HandleAccept
- HandleHandshake
- 回调函数形式:
- handler(session *bfe_basic.Session) int
HandlersRequest
- 适用回调点:
- HandleBeforeLocation
- HandleFoundProduct
- HandleAfterLocation
- 回调函数形式:
- handler(req bfe_basic.Request) (int, bfe_http.Response)
HandlersForward
- 适用回调点:
- HandleForward
- 回调函数形式:
- handler(req *bfe_basic.Request) int
HandlersResponse
- 适用回调点:
- HandleReadResponse
- HandleRequestFinish
- 回调函数形式:
- handler(req bfe_basic.Request, res bfe_http.Response) int
HandlersFinish
- 适用回调点:
- HandleFinish
- 回调函数形式:
- handler(session *bfe_basic.Session) int