go - http.Hijacker 的返回值是什么？

Question

一个http.Hijacker Go 标准库中定义了一个 Hijack() 方法，其签名如下:

Hijack() (net.Conn, *bufio.ReadWriter, error)

前两个返回值的含义是什么？ net.Conn 和 *bufio.ReadWriter 都有 Write() 方法。两者有什么区别？我应该使用哪一个来向网络发送数据？

Answer 1

返回的net.Conn是底层io.Reader对于 ReadWriter.Reader和底层io.Writer对于 ReadWriter.Writer .

ReadWriter.Reader 可以包含从客户端缓冲的数据。 ReadWriter.Writer 是在 Hijack 实现中创建的，可以忽略。

如果应用程序正在从客户端读取数据，并且客户端数据可能已被缓冲，则应用程序必须至少读取 Reader.Buffered()直接从 net.Conn 读取之前，先从 ReadWriter.Reader 读取字节。

如果应用程序要使用bufio包来缓冲网络IO，那么应用程序可以通过使用返回的bufio.Reader来减少内存分配的数量。和 bufio.Writer .

否则，应用程序可以使用 net.Conn直接读写。

如果应用程序确实使用 bufio.Writer，而不是直接写入 net.Conn，则应用程序可能需要通过调用 Writer.Flush 来显式刷新缓冲区。 .

应用程序必须使用 net.Conn 关闭连接并设置截止时间。

在早期版本的 net/http 包中，服务器使用 bufio.Writer 进行网络 IO，并从 Hijack 方法返回该 bufio.Writer。当实现更改为使用不同的缓冲机制时，bufio.Writer 的创建被移至 Hijack 方法。

一些例子:

Server sent events :ReadWriter.Reader 可以被忽略，因为应用程序不会从连接中读取。使用 ReadWriter.Writer 来减少分配。

WebSockets :客户端在发送握手请求之后、收到握手响应之前发送数据是错误的。鉴于此，数据不应在 ReadWriter.Reader 中缓冲。在可能使用 Reader.Buffered() != 0 检查意外数据后，应用程序可以选择忽略 ReadWriter.Reader。