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 允许的任何形式（即 datetime.timedelta 或相对于 IOLoop.time 的绝对时间）指定。

同样，当用户需要特定源端口时，可以使用 source_port 参数指定。

在版本 4.5 中更改: 添加了 source_ip 和 source_port 参数。

在版本 5.0 中更改: 添加了 timeout 参数。