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();
}