HTTP & WebSocket 支持

更新时间:

1. HTTP 支持概况

FPNN 框架Server部分支持HTTP部分功能。
FPNN框架Client部分不支持HTTP功能。
FPNN框架duplex模式下，仅Server端支持接收和回应来自客户端的HTTP请求，但不支持向客户端发送HTTP请求，并接收HTTP请求回应。

  1. FPNN 框架目前仅支持HTTP POST & GET 请求。

    POST Body 支持 Content-Length 和 chunk 两种表述。

  2. HTTP 支持默认关闭，需要显示配置 FPNN.server.http.supported ＝ true 方才接受HTTP请求。

  3. FPNN 默认支持 HTTP 和 TCP 包在同一个链接中混杂传递(FPNN持有该能力，但强烈不建议使用。一般情况下禁止TCP请求和HTTP请求在同一链接中混合发送)。

  4. 如果没有配置 FPNN.server.http.closeAfterAnswered 条目，默认不会在发送完 HTTP 应答后关闭当前链接，而会保持当前链接一段时间。链接保持时间 取决于配置项 FPNN.server.idle.timeout。默认 60 秒。

  5. 如果配置 FPNN.server.http.closeAfterAnswered = true， 会在收到第一个 HTTP 请求后，停止在同一链接中接收新的请求（不论是HTTP还是TCP）。并在answer发送后，关闭链接。

  6. 目前忽略 HTTP 1.1 标准中 Keep-Alive操作，是否关闭链接取决于配置项 FPNN.server.http.closeAfterAnswered 和 FPNN.server.idle.timeout。

  7. 目前不支持HTTP 1.1 标准中连续发送 HTTP 请求时，顺序回应的要求。回应的先后顺序取决于请求的完成先后。

2. 相关配置

  1. FPNN.server.http.supported

    是否允许接收和回应 HTTP 请求。

  2. FPNN.server.http.closeAfterAnswered

    当允许接收 HTTP 请求时，是否在收到任一 HTTP 请求后，停止接收请求，并在 HTTP 应答发送后，关闭链接。
    如果该配置项为 true，则意味着进入传统 HTTP 1.0 一问一答模式。且一个链接只能发送并处理一次 HTTP 请求（同一链接中的TCP请求不受限制，但禁止在这种情况下，混合发送TCP和HTTP请求）。
    当该配置项为 false 时，允许在一个链接中同时发送多个HTTP和TCP请求，且 HTTP 请求和TCP请求可以混合发送。

  3. FPNN.server.idle.timeout

    链接的空置时间。空置超过该时间，链接将会被FPNN框架关闭，并进行资源回收。
    空置状态取决于是否有完整包的传递，而不由是否有byte传递决定。

  4. FPNN.server.http.cross.origin

    支持HTTP跨域访问

3. 违背禁止情况可能出现的意外

  1. FPNN 框架不具备组装 HTTP 请求包，和解释 HTTP 应答包的功能，因此 FPNN 框架无法发送 HTTP 请求包，和接收 HTTP 应答包。 要发送 HTTP 请求，请使用 libCurl。

  2. 当 FPNN.server.http.supported 和 FPNN.server.http.closeAfterAnswered 均为 true，且混合发送 TCP 和 HTTP 请求时，可能会产生如下意外：

    如果在发送HTTP请求之前，发送了TCP请求；且TCP请求的应答在HTTP请求接收完后才完成发送，则将在TCP请求的应答发送完成后，关闭链接。导致HTTP的应答无法发送。

    期望时间顺序为：
    收到TCP请求 —> 收到HTTP请求 —>发送TCP应答 —> 发送HTTP应答 —> 关闭链接

    实际时间顺序为：
    收到TCP请求 —> 收到HTTP请求 —>TCP应答发送完成 —> 关闭链接－－－－ HTTP 应答未发送

    修改：
    因为正常模式下，不会在同一链接中混合发送TCP和HTTP请求。且在同一链接中混合发送TCP请求和HTTP请求属于禁止行为。只有特殊目的，才会允许。
    因此该意外不属于bug，而属于意料之内的情况。因此不会进行修正或者fix。

4. FPNN HTTP 支持原理

HTTP 和 TCP 的大致处理流程
HTTP 和 TCP 的处理流程图

5. WebSocket 支持

FPNN 从 2.0.1 版开始支持 WebSocket。

WebSocket 需要打开 HTTP 支持：

FPNN.server.http.supported = true

FPNN.server.http.closeAfterAnswered 参数不影响 WebSocket 行为。

WebSocket 支持 server push。

注：

  • WebSocket 控制帧中如果包含 payload，payload 将会被忽略。