数据请求


数据请求

icon-note.gif 说明:

  • 从API Version 6开始,该接口不再维护,推荐使用新接口@ohos.net.http

  • 本模块首批接口从API version 3开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。

导入模块

import fetch from '@system.fetch';
1

fetch.fetch

fetch(Object): void

通过网络获取数据。

需要权限: ohos.permission.INTERNET

系统能力: SystemCapability.Communication.NetStack

参数:

参数名 类型 必填 说明
url string 资源地址。
data string | Object 请求的参数,可选类型是字符串或者json对象。详见表 data与Content-Type关系。
header Object 设置请求的header。
method string 请求方法默认为GET,可选值为:OPTIONS、GET、HEAD、POST、PUT、DELETE、TRACE。
responseType string 默认会根据服务器返回header中的Content-Type确定返回类型,支持文本和json格式。详见success返回值。
success Function 接口调用成功的回调函数。
fail Function 接口调用失败的回调函数。
complete Function 接口调用结束的回调函数。

表1 data与Content-Type关系

data Content-Type 说明
string 不设置 Content-Type默认为 text/plain,data值作为请求的body。
string 任意 Type data值作为请求的body。
Object 不设置 Content-Type默认为application/x-www-form-urlencoded,data按照资源地址规则进行encode拼接作为请求的body。
Object application/x-www-form-urlencoded data按照资源地址规则进行encode拼接作为请求的body。

success返回值:

参数名 类型 说明
code number 表示服务器的状态code。
data string | Object 返回数据类型由responseType确定,详见表 responseType与success中data关系。
headers Object 表示服务器response的所有header。

表2 responseType与success中data关系

responseType data 说明
string 服务器返回的header中的type如果是text/*或application/json、application/javascript、application/xml,值为文本内容。
text string 返回文本内容。
json Object 返回json格式的对象。

示例:

export default {
  data: {
    responseData: 'NA',
    url: "test_url",
  },
  fetch: function () {
    var that = this;
    fetch.fetch({
      url: that.url,
      success: function(response) {
        console.info("fetch success");
        that.responseData = JSON.stringify(response);
      },
      fail: function() {
        console.info("fetch fail");
      }
    });
  }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19

icon-note.gif 说明: 默认支持https,如果要支持http,需要在config.json里增加network标签,属性标识 "cleartextTraffic": true。即:

{
  "deviceConfig": {
    "default": {
      "network": {
        "cleartextTraffic": true
      }
      ...
    }
  }
  ...
}
1
2
3
4
5
6
7
8
9
10
11