HarmonyOS@ohos.request 上传那些事儿

【关键字】

@ohos.request、上传下载

【写在前面】

在进行HarmonyOS应用开发时，可能需要进行上传或下载文件功能开发，本文章主要进行上传下载相关功能介绍和一些注意事项及FAQ。

【上传开发步骤】

步骤1：上传下载接口需要申请ohos.permission.INTERNET权限，如下：

1.  
   "reqPermissions": [
2.  
   {
3.  
   "name": "ohos.permission.INTERNET"
4.  
   }
5.  
   ]

步骤2：API9以下版本调用request.upload接口，API9可以调用request.uploadFile接口，参数详见官方文档说明，代码如下：

1.  
   let file = {
2.  
   filename: "test", name: "test", uri: "internal://cache/test.jpg", type: "jpg"
3.  
   };
4.  
   let uploadTask;
5.  
   request.upload({
6.  
   url: 'http://xxx/upload/',
7.  
   header: {},
8.  
   method: "POST",
9.  
   files: [file],
10.  
    data: [
11.  
    {
12.  
    name: "test", value: "value"
13.  
    }
14.  
    ]
15.  
    }).then((data) => {
16.  
    console.error('test data: ' JSON.stringify(data));
17.  
    uploadTask = data;
18.  
    // 可通过progress判断进度是否完成，uploadedSize等于totalSize表示上传成功
19.  
    // API9可通过complete监听上传任务是否完成
20.  
    uploadTask.on('progress', function callback(uploadedSize, totalSize) {
21.  
    console.info("upload totalSize:" totalSize " uploadedSize:" uploadedSize);
22.  
    });
23.  
    }).catch((err) => {
24.  
    console.error('Failed to request the upload. Cause: ' JSON.stringify(err));
25.  
    })

步骤3：上传任务是否完成可根据API版本，参考文档使用不同接口进行监听，走到监听回调即表示文件上传成功了。

【下载开发步骤】

下载功能开发同上传类似，同样需要申请ohos.permission.INTERNET权限，再根据不同API版本，参考文档调用不同接口即可；官方文档每个接口均有示例说明，此处不再赘述。

【参考文档】

上传下载：文档中心

【FAQ】

问题1：使用download下载功能，文件较大时，将应用切换到后台，发现下载任务停止了，如何才能让应用运行在后台时，保持下载功能？

----可将downloadTask变量定义为全局变量，若非全局变量，在应用运行后台时，会导致task任务终止，即下载任务停止。同理，上传功能也一样处理。

问题2：上传或下载过程中，on('progress') 任务进度监听会走几次？

----on('progress') 仅用于显示上传下载进度，若网速情况良好或者文件大小不是很大的情况下，progress可能仅回调一次，回调次数与网速与下载文件大小均有关系

问题3：若http接口有返回数据，上传下载接口回调是否可以获取返回的数据？

----上传下载接口仅支持进行文件上传和下载功能，接口回调仅用于监听上传下载是否完成，无法在回调中接收数据。

这篇好文章是转载于：学新通技术网