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.

如果没有提供 charset，将使用默认的 ISO-8859-1（拉丁 1）。

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

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