HttpClient 类 抽象 接口

用于与 HTTP 服务器通信的 HTTP 客户端。

注意： 应避免直接使用 HttpClient 进行 HTTP 请求。您可以通过 IOClient 适配器在 package:http 中间接使用 HttpClient。

使用更高级的库，如 package:http，可以在代码中做最小修改即可切换实现。例如，package:http 的 Client 具有浏览器实现以及适用于 Android 和 iOS 的使用平台原生 HTTP 客户端的实现。与 HttpClient 不同，这些原生实现可以与代理、VPN 等一起工作。

向 HTTP 服务器发送 HTTP 请求并接收响应。在多个对同一服务器的请求之间保持状态，包括会话 Cookie 和其他 Cookie。

HttpClient 包含多种方法将 HttpClientRequest 发送到 Http 服务器并接收 HttpClientResponse。例如，您可以使用 get、getUrl、post 和 postUrl 方法分别进行 GET 和 POST 请求。

简单 GET 请求示例

getUrl 请求是两步过程，由两个 Future 触发。当第一个 future 完成并返回一个 HttpClientRequest 时，底层的网络连接已建立，但尚未发送数据。在第一个 future 的回调函数中，可以在请求上设置 HTTP 头部和主体。要么是请求对象的第一次写入，要么是调用 close，都会将请求发送到服务器。

从服务器接收到 HTTP 响应后，第二个 future（由 close 返回）完成，并返回一个 HttpClientResponse 对象。此对象提供了对响应头和主体的访问。主体作为由 HttpClientResponse 实现的流可用。如果存在主体，则必须读取它。否则，会导致资源泄漏。如果主体未使用，请考虑使用 HttpClientResponse.drain。

var client = HttpClient();
try {
  HttpClientRequest request = await client.get('localhost', 80, '/file.txt');
  // Optionally set up headers...
  // Optionally write to the request object...
  HttpClientResponse response = await request.close();
  // Process the response
  final stringData = await response.transform(utf8.decoder).join();
  print(stringData);
} finally {
  client.close();
}

通过 getUrl 和 open 等方法创建 HttpClientRequest 的 future。

HTTPS 连接

HttpClient 可以进行 HTTPS 请求，使用 TLS（SSL）安全网络协议连接到服务器。使用 https: 方案调用 getUrl 将自动工作，如果服务器的证书由 Mozilla 编译的默认知名受信任 CA（证书授权中心）签名。

要添加自定义受信任证书颁发机构或向请求客户端证书的服务器发送证书，请将SecurityContext对象作为可选的context参数传递给HttpClient构造函数。可以在SecurityContext对象上设置所需的选项。

头部信息

所有HttpClient请求默认设置以下头部信息

Accept-Encoding: gzip

这允许HTTP服务器在可能的情况下对正文使用gzip压缩。如果不希望这种行为，请将Accept-Encoding头部信息设置为其他内容。要关闭对响应的gzip压缩，请清除此头部信息

 request.headers.removeAll(HttpHeaders.acceptEncodingHeader)

关闭HttpClient

HttpClient支持持久连接并缓存网络连接，以便在可能的情况下重用它们来处理多个请求。这意味着在请求完成后，网络连接可以保持开启状态一段时间。使用HttpClient.close强制HttpClient对象关闭并关闭空闲网络连接。

开启和关闭代理

默认情况下，HttpClient使用环境中的代理配置，请参阅findProxyFromEnvironment。要关闭代理的使用，请将findProxy属性设置为null。

HttpClient client = HttpClient();
client.findProxy = null;