tornado.tcpclient — IOStream 連線工廠

一個非阻塞的 TCP 連線工廠。

class tornado.tcpclient.TCPClient(resolver: Optional[Resolver] = None)

一個非阻塞的 TCP 連線工廠。

變更於版本 5.0: io_loop 參數（自版本 4.1 起已棄用）已被移除。

coroutine connect(host: str, port: int, af: AddressFamily = AddressFamily.AF_UNSPEC, ssl_options: Optional[Union[Dict[str, Any], SSLContext]] = None, max_buffer_size: Optional[int] = None, source_ip: Optional[str] = None, source_port: Optional[int] = None, timeout: Optional[Union[float, timedelta]] = None) → IOStream

連線到給定的主機和端口。

非同步返回一個 IOStream（如果 ssl_options 不為 None，則返回 SSLIOStream）。

使用 source_ip 關鍵字參數，可以指定建立連線時使用的來源 IP 位址。如果使用者需要解析並使用特定的介面，則必須在 Tornado 之外處理，因為這非常依賴於平台。

如果輸入的 Future 在 timeout 之前未完成，則會引發 TimeoutError，timeout 可以以 IOLoop.add_timeout 允許的任何形式指定（即相對於 IOLoop.time 的 datetime.timedelta 或絕對時間）。

同樣地，當使用者需要特定的來源端口時，可以使用 source_port 參數指定。

變更於版本 4.5: 新增了 source_ip 和 source_port 參數。

變更於版本 5.0: 新增了 timeout 參數。