Ruby Buffering.write_nonblock用法及代碼示例

write_nonblock(s, exception: true)

以非阻塞方式寫入s。

如果有緩衝數據，則首先刷新。這可能會阻塞。

write_nonblock 返回寫入 SSL 連接的字節數。

當沒有數據可以寫入而不阻塞時，它會引發由 IO::WaitReadable 或 IO::WaitWritable 擴展的 OpenSSL::SSL::SSLError 。

IO::WaitReadable 表示 SSL 需要在內部讀取，因此在底層 IO 可讀後應再次調用 write_nonblock 。

IO::WaitWritable 表示 SSL 需要在內部寫入，因此在底層 IO 可寫後應再次調用 write_nonblock 。

所以 OpenSSL::Buffering#write_nonblock 需要兩個rescue子句如下。

# emulates blocking write.
begin
  result = ssl.write_nonblock(str)
rescue IO::WaitReadable
  IO.select([io])
  retry
rescue IO::WaitWritable
  IO.select(nil, [io])
  retry
end

請注意， write_nonblock 從底層 IO 讀取的一個原因是當對等方請求新的 TLS/SSL 握手時。有關更多詳細信息，請參閱 openssl 常見問題解答。 www.openssl.org/support/faq.html

通過將關鍵字參數 exception 指定為 false ，您可以指示 write_nonblock 不應引發 IO::Wait*able 異常，而是返回符號 :wait_writable 或 :wait_readable。