HttpClientRequest 类 抽象 接口

客户端连接的 HTTP 请求。

要设置请求，请使用此类提供的 headers 属性设置头部，并将数据写入请求体。 HttpClientRequest 是一个 IOSink。使用 IOSink 中的方法，如 writeCharCode()，来写入 HTTP 请求体。当第一次使用 IOSink 的方法时，将发送请求头部。在发送后调用任何更改头部的函数会抛出异常。

通过 IOSink 写入字符串数据时，使用的编码由 "Content-Type" 头部中的 "charset" 参数确定。

var client = HttpClient();
HttpClientRequest request = await client.get('localhost', 80, '/file.txt');
request.headers.contentType =
    ContentType('application', 'json', charset: 'utf-8');
request.write('text content👍🎯'); // Strings written will be UTF-8 encoded.

如果没有提供字符集，则默认使用 ISO-8859-1（拉丁 1）。

var client = HttpClient();
HttpClientRequest request = await client.get('localhost', 80, '/file.txt');
request.headers.add(HttpHeaders.contentTypeHeader, "text/plain");
request.write('blåbærgrød'); // Strings written will be ISO-8859-1 encoded

如果在使用不支持的编码和 write() 方法带有字符串参数时抛出异常。