HttpResponse 类 抽象 接口

HTTP 响应，用于将服务器返回的头部和数据发送到客户端，以响应 HTTP 请求。

每个 HttpRequest 对象都通过 response 属性提供对其相关 HttpResponse 对象的访问。服务器通过写入 HttpResponse 对象将响应发送到客户端。

写入响应

此类实现了 IOSink。设置头部后，可以使用源自 IOSink 的方法（如 writeln()）来写入 HTTP 响应的主体。使用 close() 方法关闭响应并发送到客户端。

server.listen((HttpRequest request) {
  request.response.write('Hello, world!');
  request.response.close();
});

首次使用 IOSink 方法时，会发送请求头部。在发送后调用任何更改头部的方 法会抛出异常。

设置头部

HttpResponse 对象包含一些用于设置响应 HTTP 头部的属性。当通过 IOSink 写入字符串数据时，使用的编码由 "Content-Type" 头部的 "charset" 参数确定。

HttpResponse response = ...
response.headers.contentType
    = ContentType("application", "json", charset: "utf-8");
response.write(...);  // Strings written will be UTF-8 encoded.

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

HttpResponse response = ...
response.headers.add(HttpHeaders.contentTypeHeader, "text/plain");
response.write(...);  // Strings written will be ISO-8859-1 encoded.

如果设置了不支持的 contentType，将抛出异常。