HTTP#

http 模块提供一些进行 http 请求的函数。

http.get(url[, options, callback])#

• url {string} 请求的 URL 地址，需要以"http://"或"https://"开头。如果 url 没有以"http://"开头，则默认为"http://"。
• options {Object} 请求选项。参见[http.request()][]。
• callback {Function} 回调函数，可选，其参数是一个[Response][]对象。如果不加回调函数，则该请求将阻塞、同步地执行。

对地址 url 进行一次 HTTP GET 请求。如果没有回调函数，则在请求完成或失败时返回此次请求的响应(参见[Response][])。

最简单 GET 请求如下:

1console.show();
2var r = http.get("www.baidu.com");
3log("code = " + r.statusCode);
4log("html = " + r.body.string());

采用回调形式的 GET 请求如下：

1console.show();
2http.get("www.baidu.com", {}, function (res, err) {
3    if (err) {
4        console.error(err);
5        return;
6    }
7    log("code = " + res.statusCode);
8    log("html = " + res.body.string());
9});

如果要增加 HTTP 头部信息，则在 options 参数中添加，例如：

1console.show();
2var r = http.get("www.baidu.com", {
3    headers: {
4        "Accept-Language": "zh-cn,zh;q=0.5",
5        "User-Agent": "Mozilla/5.0(Macintosh;IntelMacOSX10_7_0)AppleWebKit/535.11(KHTML,likeGecko)Chrome/17.0.963.56Safari/535.11",
6    },
7});
8log("code = " + r.statusCode);
9log("html = " + r.body.string());

一个请求天气并解析返回的天气 JSON 结果的例子如下：

1var city = "广州";
2var res = http.get("http://www.sojson.com/open/api/weather/json.shtml?city=" + city);
3if (res.statusCode != 200) {
4    toast("请求失败: " + res.statusCode + " " + res.statusMessage);
5} else {
6    var weather = res.body.json();
7    log(weather);
8    toast(util.format("温度: %s 湿度: %s 空气质量: %s", weather.data.wendu, weather.data.shidu, weather.quality));
9}

http.post(url, data[, options, callback])#

• url {string} 请求的 URL 地址，需要以"http://"或"https://"开头。如果 url 没有以"http://"开头，则默认为"http://"。
• data {string} | {Object} POST 数据。
• options {Object} 请求选项。
• callback {Function} 回调，其参数是一个[Response][]对象。如果不加回调参数，则该请求将阻塞、同步地执行。

对地址 url 进行一次 HTTP POST 请求。如果没有回调函数，则在请求完成或失败时返回此次请求的响应(参见[Response][])。

其中 POST 数据可以是字符串或键值对。具体含义取决于 options.contentType 的值。默认为"application/x-www-form-urlencoded"(表单提交), 这种方式是 JQuery 的 ajax 函数的默认方式。

一个模拟表单提交登录淘宝的例子如下:

1var url = "https://login.taobao.com/member/login.jhtml";
2var username = "你的用户名";
3var password = "你的密码";
4var res = http.post(url, {
5    "TPL_username": username,
6    "TPL_password": password,
7});
8var html = res.body.string();
9if (html.contains("页面跳转中")) {
10    toast("登录成功");
11} else {
12    toast("登录失败");
13}

http.postJson(url[, data, options, callback])#

• url {string} 请求的 URL 地址，需要以"http://"或"https://"开头。如果 url 没有以"http://"开头，则默认为"http://"。
• data {Object} POST 数据。
• options {Object} 请求选项。
• callback {Function} 回调，其参数是一个[Response][]对象。如果不加回调参数，则该请求将阻塞、同步地执行。

以 JSON 格式向目标 Url 发起 POST 请求。如果没有回调函数，则在请求完成或失败时返回此次请求的响应(参见[Response][])。

JSON 格式指的是，将会调用JSON.stringify()把 data 对象转换为 JSON 字符串，并在 HTTP 头部信息中把"Content-Type"属性置为"application/json"。这种方式是 AngularJS 的 ajax 函数的默认方式。

一个调用图灵机器人接口的例子如下：

1var url = "http://www.tuling123.com/openapi/api";
2r = http.postJson(url, {
3    key: "65458a5df537443b89b31f1c03202a80",
4    info: "你好啊",
5    userid: "1",
6});
7toastLog(r.body.string());

http.postMultipart(url, files[, options, callback])#

• url {string} 请求的 URL 地址，需要以"http://"或"https://"开头。如果 url 没有以"http://"开头，则默认为"http://"。
• files {Object} POST 数据。
• options {Object} 请求选项。
• callback {Function} 回调，其参数是一个Response对象。如果不加回调参数，则该请求将阻塞、同步地执行。

向目标地址发起类型为 multipart/form-data 的请求（通常用于文件上传等), 其中 files 参数是{name1: value1, name2: value2, ...}的键值对，value 的格式可以是以下几种情况：

1. string
2. 文件类型，即 open()返回的类型
3. [fileName, filePath]
4. [fileName, mimeType, filePath]

其中 1 属于非文件参数，2、3、4 为文件参数。举个例子，最简单的文件上传的请求为：

1var res = http.postMultipart(url, {
2    file: open("/sdcard/1.txt"),
3});
4log(res.body.string());

如果使用格式 2，则代码为

1var res = http.postMultipart(url, {
2    file: ["1.txt", "/sdcard/1.txt"],
3});
4log(res.body.string());

如果使用格式 3，则代码为

1var res = http.postMultipart(url, {
2    file: ["1.txt", "text/plain", "/sdcard/1.txt"],
3});
4log(res.body.string());

如果使用格式 2 的同时要附带非文件参数"appId=abcdefghijk"，则为:

1var res = http.postMultipart(url, {
2    appId: "adcdefghijk",
3    file: open("/sdcard/1.txt"),
4});
5log(res.body.string());

http.request(url[, options, callback])#

• url {string} 请求的 URL 地址，需要以"http://"或"https://"开头。如果 url 没有以"http://"开头，则默认为"http://"。
• options {Object} 请求选项。参见[http.buildRequest()][]。
• callback {Function} 回调，其参数是一个[Response][]对象。如果不加回调参数，则该请求将阻塞、同步地执行。

对目标地址 url 发起一次 HTTP 请求。如果没有回调函数，则在请求完成或失败时返回此次请求的响应(参见[Response][])。

选项 options 可以包含以下属性：

• headers {Object} 键值对形式的 HTTP 头部信息。有关 HTTP 头部信息，参见菜鸟教程：HTTP 响应头信息。
• method {string} HTTP 请求方法。包括"GET", "POST", "PUT", "DELET", "PATCH"。
• contentType {string} HTTP 头部信息中的"Content-Type", 表示 HTTP 请求的内容类型。例如"text/plain", "application/json"。更多信息参见菜鸟教程：HTTP contentType。
• body {string} | {Array} | {Function} HTTP 请求的内容。可以是一个字符串，也可以是一个字节数组；或者是一个以BufferedSink为参数的函数。

该函数是 get, post, postJson 等函数的基础函数。因此除非是 PUT, DELET 等请求，或者需要更高定制的 HTTP 请求，否则直接使用 get, post, postJson 等函数会更加方便。

Response#

HTTP 请求的响应。

Response.statusCode#

• {number}

当前响应的 HTTP 状态码。例如 200(OK), 404(Not Found)等。

有关 HTTP 状态码的信息，参见菜鸟教程：HTTP 状态码。

Response.statusMessage#

• {string}

当前响应的 HTTP 状态信息。例如"OK", "Bad Request", "Forbidden"。

有关 HTTP 状态码的信息，参见菜鸟教程：HTTP 状态码。

例子：

1var res = http.get("www.baidu.com");
2if (res.statusCode >= 200 && res.statusCode < 300) {
3    toast("页面获取成功!");
4} else if (res.statusCode == 404) {
5    toast("页面没找到哦...");
6} else {
7    toast("错误: " + res.statusCode + " " + res.statusMessage);
8}

Response.headers#

• {Object}

当前响应的 HTTP 头部信息。该对象的键是响应头名称，值是各自的响应头值。 所有响应头名称都是小写的(吗)。

有关 HTTP 头部信息，参见菜鸟教程：HTTP 响应头信息。

例子:

1console.show();
2var res = http.get("www.qq.com");
3console.log("HTTP Headers:");
4for (var headerName in res.headers) {
5    console.log("%s: %s", headerName, res.headers[headerName]);
6}

Response.body#

• {Object}

当前响应的内容。他有以下属性和函数：

• bytes() {Array} 以字节数组形式返回响应内容
• string() {string} 以字符串形式返回响应内容
• json() {Object} 把响应内容作为 JSON 格式的数据并调用 JSON.parse，返回解析后的对象
• contentType {string} 当前响应的内容类型

Response.request#

• {Request} 当前响应所对应的请求。参见[Request][]。

Response.url#

• {number} 当前响应所对应的请求 URL。

Response.method#

• {string} 当前响应所对应的 HTTP 请求的方法。例如"GET", "POST", "PUT"等。