跳转至

BFE的回调机制

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