模块 http

超文本传输协议模块,用以支持 http 协议处理

对象

Request

创建一个 http 请求对象,参见 HttpRequest

HttpRequest http.Request;

Response

创建一个 http 响应对象,参见 HttpResponse

HttpResponse http.Response;

创建一个 http cookie 对象,参见 HttpCookie

HttpCookie http.Cookie;

Server

创建一个 http 服务器,参见 HttpServer

HttpServer http.Server;

Client

创建一个 http 客户端,参见 HttpClient

HttpClient http.Client;

HttpsServer

创建一个 https 服务器,参见 HttpsServer

HttpsServer http.HttpsServer;

Handler

创建一个 http 协议处理器对象,参见 HttpHandler

HttpHandler http.Handler;

静态函数

fileHandler

创建一个 http 静态文件处理器,用以用静态文件响应 http 消息

static Handler http.fileHandler(String root,
    Object mimes = {},
    Boolean autoIndex = false);

调用参数:

返回结果:

fileHandler 支持 gzip 预压缩,当请求接受 gzip 编码,且相同路径下 filename.ext.gz 文件存在时,将直接返回此文件, 从而避免重复压缩带来服务器负载。


request

发送 http 请求到指定的流对象,并返回结果

static HttpResponse http.request(Stream conn,
    HttpRequest req) async;

调用参数:

返回结果:


请求指定的 url,并返回结果

static HttpResponse http.request(String method,
    String url,
    Object headers = {});

调用参数:

返回结果:


请求指定的 url,并返回结果

static HttpResponse http.request(String method,
    String url,
    SeekableStream body,
    Map headers) async;

调用参数:

返回结果:


请求指定的 url,并返回结果

static HttpResponse http.request(String method,
    String url,
    SeekableStream body,
    Object headers = {});

调用参数:

返回结果:


请求指定的 url,并返回结果

static HttpResponse http.request(String method,
    String url,
    Buffer body,
    Object headers = {});

调用参数:

返回结果:


get

用 GET 方法请求指定的 url,并返回结果,等同于 request("GET", ...)

static HttpResponse http.get(String url,
    Object headers = {});

调用参数:

返回结果:


post

用 POST 方法请求指定的 url,并返回结果,等同于 request("POST", ...)

static HttpResponse http.post(String url,
    SeekableStream body,
    Object headers = {});

调用参数:

返回结果:


用 POST 方法请求指定的 url,并返回结果,等同于 request("POST", ...)

static HttpResponse http.post(String url,
    Buffer body,
    Object headers = {});

调用参数:

返回结果:


用 POST 方法请求指定的 url,并返回结果,等同于 request("POST", ...)

static HttpResponse http.post(String url,
    Object headers = {});

调用参数:

返回结果:


del

用 DELETE 方法请求指定的 url,并返回结果,等同于 request("DELETE", ...)

static HttpResponse http.del(String url,
    Object headers = {});

调用参数:

返回结果:


put

用 PUT 方法请求指定的 url,并返回结果,等同于 request("PUT", ...)

static HttpResponse http.put(String url,
    SeekableStream body,
    Object headers = {});

调用参数:

返回结果:


用 PUT 方法请求指定的 url,并返回结果,等同于 request("PUT", ...)

static HttpResponse http.put(String url,
    Buffer body,
    Object headers = {});

调用参数:

返回结果:


用 PUT 方法请求指定的 url,并返回结果,等同于 request("PUT", ...)

static HttpResponse http.put(String url,
    Object headers = {});

调用参数:

返回结果:


patch

用 PATCH 方法请求指定的 url,并返回结果,等同于 request("PATCH", ...)

static HttpResponse http.patch(String url,
    SeekableStream body,
    Object headers = {});

调用参数:

返回结果:


用 PATCH 方法请求指定的 url,并返回结果,等同于 request("PATCH", ...)

static HttpResponse http.patch(String url,
    Buffer body,
    Object headers = {});

调用参数:

返回结果:


用 PATCH 方法请求指定的 url,并返回结果,等同于 request("PATCH", ...)

static HttpResponse http.patch(String url,
    Object headers = {});

调用参数:

返回结果:

静态属性

cookies

List, 返回http客户端的 HttpCookie 对象列表

static readonly List http.cookies;

timeout

Integer, 查询和设置超时时间

static Integer http.timeout;

enableCookie

Boolean, cookie功能开关,默认开启

static Boolean http.enableCookie;

autoRedirect

Boolean, 自动redirect功能开关,默认开启

static Boolean http.autoRedirect;

userAgent

String, 查询和设置 http 请求中的浏览器标识

static String http.userAgent;

成员属性

maxBodySize

Integer, 查询和设置 body 最大尺寸,以 MB 为单位,缺省为 -1,不限制尺寸

Integer http.maxBodySize;