【HarmonyOS】@ohos.request 上传下载的那些事儿

【关键字】

@ohos.request、上传下载​

【写在前面】

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

【上传开发步骤】

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

"reqPermissions": [{"name": "ohos.permission.INTERNET"}
]        

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

let file = {filename: "test", name: "test", uri: "internal://cache/test.jpg", type: "jpg"};let uploadTask;request.upload({url: 'http://xxx/upload/',header: {},method: "POST",files: [file],data: [{name: "test", value: "value"}]}).then((data) => {console.error('test data: ' + JSON.stringify(data));uploadTask = data;// 可通过progress判断进度是否完成，uploadedSize等于totalSize表示上传成功// API9可通过complete监听上传任务是否完成uploadTask.on('progress', function callback(uploadedSize, totalSize) {console.info("upload totalSize:" + totalSize + "  uploadedSize:" + uploadedSize);});}).catch((err) => {console.error('Failed to request the upload. Cause: ' + JSON.stringify(err));})

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

【下载开发步骤】

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

【参考文档】

上传下载：文档中心

【FAQ】

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

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

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

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

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

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