HttpRequest 类 抽象 接口

一个包含 HTTP 请求内容和信息的服务器端对象。

HttpRequest 对象由一个 HttpServer 生成，该服务器在一个特定的主机和端口上监听 HTTP 请求。对于收到的每个请求，HttpServer（一个 Stream），生成一个 HttpRequest 对象并将其添加到流中。

HttpRequest 对象将请求体内容以字节列表流的形式传输。该对象还包含有关请求的信息，例如方法、URI 和头信息。

以下代码中，一个 HttpServer 监听 HTTP 请求。当服务器收到请求时，它使用 HttpRequest 对象的 method 属性来分发请求。

final HOST = InternetAddress.loopbackIPv4;
final PORT = 80;

HttpServer.bind(HOST, PORT).then((_server) {
  _server.listen((HttpRequest request) {
    switch (request.method) {
      case 'GET':
        handleGetRequest(request);
        break;
      case 'POST':
        ...
    }
  },
  onError: handleError);    // listen() failed.
}).catchError(handleError);

HttpRequest 对象通过 response 属性提供了对相关 HttpResponse 对象的访问。服务器将响应写入 HttpResponse 对象的主体。例如，以下是一个响应请求的函数

void handleGetRequest(HttpRequest req) {
  HttpResponse res = req.response;
  res.write('Received request ${req.method}: ${req.uri.path}');
  res.close();
}