Ruby Buffering.read_nonblock用法及代码示例

read_nonblock(maxlen, buf=nil, exception: true)

以非阻塞方式最多读取maxlen 个字节。

当没有数据可以读取而不阻塞时，它会引发 OpenSSL::SSL::SSLError 扩展 IO::WaitReadable 或 IO::WaitWritable 。

IO::WaitReadable 表示 SSL 需要在内部读取，因此当底层 IO 可读时，应再次调用 read_nonblock 。

IO::WaitWritable 表示 SSL 需要在内部写入，因此在底层 IO 可写后应再次调用 read_nonblock 。

OpenSSL::Buffering#read_nonblock 需要两个救援子句，如下所示：

# emulates blocking read (readpartial).
begin
  result = ssl.read_nonblock(maxlen)
rescue IO::WaitReadable
  IO.select([io])
  retry
rescue IO::WaitWritable
  IO.select(nil, [io])
  retry
end

请注意， read_nonblock 写入底层 IO 的一个原因是当对等方请求新的 TLS/SSL 握手时。有关详细信息，请参阅 openssl 常见问题解答。 www.openssl.org/support/faq.html

通过将关键字参数 exception 指定为 false ，您可以指示 read_nonblock 不应引发 IO::Wait*able 异常，而是返回符号 :wait_writable 或 :wait_readable。在 EOF 处，它将返回 nil 而不是引发 EOFError 。