request主要给应用提供上传下载文件、后台传输代理的基础能力。
场景一:上传下载进度回调。
方式一:使用request.agent.create下载文件开启进度回调,当前规格是约1s一次回调。
//进度回调的Callback
let progressCallback = (progress: request.agent.Progress) => {
console.info('download task progress:'+progress.sizes+'/'+progress.processed); };
request.agent.create(context, config1).then((task: request.agent.Task) => {
console.log(task.tid)
//开启进度回调监听
task.on('progress', progressCallback);
console.info(`Succeeded in creating a download task. result: ${task.tid}`);
task.on('completed', createOnCallback);
task.start((err: BusinessError) => {
if (err) {
console.error(`Failed to start the download task, Code: ${err.code}, message: ${err.message}`);
return;
}
console.info(`Succeeded in starting a download task.`);
});
console.info(`Succeeded in creating a download task. result: ${task.tid}`);
}).catch((err: BusinessError) => {
console.error(`Failed to create a download task, Code: ${err.code}, message: ${err.message}`);
});
方式二:使用request.downloadFile下载文件,传入context和DownloadConfig,开启进度回调。
request.downloadFile(context.getApplicationContext(), {
url: 'xxxxx',
filePath: filesDir + '/文件路径',
enableMetered: true
}).then((downloadTask: request.DownloadTask) => {
let progresCallback = (receivedSize: number, totalSize: number) => {
console.info("download receivedSize:" + receivedSize + " totalSize:" + totalSize);
};
//开启进度回调
downloadTask.on('progress', progresCallback);
})
场景二:暂停恢复下载。
要实现按钮点击暂停/恢复下载,需要先将Task传入,然后调用pause()暂停/resume()恢复下载任务。
request.agent.create(getContext(), config).then((task: request.agent.Task) => {
// pause暂停任务
task.pause((err: BusinessError) => {
if (err) {
console.error(`Failed to pause the download task, Code: ${err.code}, message: ${err.message}`);
return;
}
console.info(`Succeeded in pausing a download task. `);
});
console.info(`Succeeded in creating a download task. result: ${task.tid}`);
}).catch((err: BusinessError) => {
console.error(`Failed to create a download task, Code: ${err.code}, message: ${err.message}`);
});
request.agent.create(getContext(), config).then((task: request.agent.Task) => {
// resume恢复下载任务
task.resume((err: BusinessError) => {
if (err) {
console.error(`Failed to resume the download task, Code: ${err.code}, message: ${err.message}`);
return;
}
console.info(`Succeeded in resuming a download task. `);
});
console.info(`Succeeded in creating a download task. result: ${task.tid}`);
}).catch((err: BusinessError) => {
console.error(`Failed to create a download task, Code: ${err.code}, message: ${err.message}`);
});
场景三:后台上传下载,应用长时任务。
requestdownload接口默认是后台任务,支持应用长时任务。
request.agent需要配置为BACKGROUND模式,后台任务默认会有系统通知。
gauge:后台任务的过程进度通知策略,仅应用于后台任务,默认值为false。
false:代表仅完成或失败的通知。
true:发出每个进度,已完成或失败的通知。
上传任务配置:
let attachments: Array<request.agent.FormItem> = [{
name: "createTest",
value: {
filename: "createTest.mp4",
mimeType: "application/octet-stream",
path: "./createTest.mp4",
}
}];
let config: request.agent.Config = {
//任务操作选项。UPLOAD表示上传任务。DOWNLOAD表示下载任务。
action: request.agent.Action.UPLOAD,
url: 'http://127.0.0.1',
title: 'createTest',
description: 'Sample code for create task',
//下载的模式,FOREGROUND表示前台任务;BACKGROUND表示后台任务。
mode: request.agent.Mode.BACKGROUND,
//覆写配置true,覆盖已存在的文件。 false,下载失败。
overwrite: false,
method: "PUT",
data: attachments,
saveas: "./",
network: request.agent.Network.CELLULAR,
//是否允许在按流量计费的网络中工作,默认为false。
metered: false,
roaming: true,
//是否为后台任务启用自动重试,仅应用于后台任务,默认为true。
retry: true,
//是否允许重定向,默认为true。
redirect: true,
index: 0,
gauge: true,
//如果设置为true,在上传/下载无法获取文件大小时任务失败。
precise: false,
token: "it is a secret",
//任务的优先级。任务模式相同的情况下,该配置项的数字越小优先级越高,默认值为0。
priority:0
};
request.agent.create(getContext(), config, (err: BusinessError, task: request.agent.Task) => {
if (err) {
console.error(`Failed to create a download task, Code: ${err.code}, message: ${err.message}`);
return;
}
console.info(`Succeeded in creating a download task. result: ${task.config}`);
});
下载任务配置:
let config1: request.agent.Config = {
action: request.agent.Action.DOWNLOAD,
url: "https://fe-static.xhscdn.com/mp/red/bc446184a0c84aa785ea3cada920f6ac.zip",
overwrite: true,
method: 'GET',
//保存的地址,默认为cache目录下,如果需要保存在子目录下需要提前手动创建。
saveas: './',
mode: request.agent.Mode.BACKGROUND,
gauge: true,
priority:0
}
let createOnCallback2 = (progress: request.agent.Progress) => {
console.info('download task pro.'+progress.sizes+'/'+progress.processed);
};
let createOnCallback = (progress: request.agent.Progress) => {
console.info('downloadTask complete,filesDir:' );
};
let createOnCallback1 = (progress: request.agent.Progress) => {
console.info('download task failed.'+progress);
};
request.agent.create(context, config1).then((task: request.agent.Task) => {
console.log(task.tid)
task.on('progress', createOnCallback2);
task.on('failed', createOnCallback1);
console.info(`Succeeded in creating a download task. result: ${task.tid}`);
task.on('completed', createOnCallback);
task.start((err: BusinessError) => {
if (err) {
console.error(`Failed to start the download task, Code: ${err.code}, message: ${err.message}`);
return;
}
console.info(`Succeeded in starting a download task.`);
});
console.info(`Succeeded in creating a download task. result: ${task.tid}`);
}).catch((err: BusinessError) => {
console.error(`Failed to create a download task, Code: ${err.code}, message: ${err.message}`);
});
场景四:断点续传。
断点续传的场景,如果是因网络等问题导致的任务失败,用户可以改为使用api10后台任务设置retry属性为true,这样内部会有自动暂停,网络恢复时自动重试,内部能续传时自动续传。on(‘pause’) 回调会监听到它的暂停状态。
场景五:获取服务端返回的headers信息,用于后续处理。
订阅on(‘response’)事件返回的headers中包含有header和body,可以通过解析返回的headers来进行后续处理。
let responseCallback = (response: request.agent.HttpResponse) => {
console.info('download task response.'+JSON.stringify(response)+JSON.stringify(response.headers));
};
task.on('response',responseCallback)
鸿蒙全栈开发全新学习指南
有很多小伙伴不知道学习哪些鸿蒙开发技术?不知道需要重点掌握哪些鸿蒙应用开发知识点?而且学习时频繁踩坑,最终浪费大量时间。所以要有一份实用的鸿蒙(HarmonyOS NEXT)学习路线与学习文档用来跟着学习是非常有必要的。
针对一些列因素,整理了一套纯血版鸿蒙(HarmonyOS Next)全栈开发技术的学习路线,包含了鸿蒙开发必掌握的核心知识要点,内容有(ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、WebGL、元服务、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、OpenHarmony驱动开发、系统定制移植等等)鸿蒙(HarmonyOS NEXT)技术知识点。
本路线共分为四个阶段:
第一阶段:鸿蒙初中级开发必备技能
第二阶段:鸿蒙南北双向高工技能基础:gitee.com/MNxiaona/733GH
第三阶段:应用开发中高级就业技术
第四阶段:全网首发-工业级南向设备开发就业技术:gitee.com/MNxiaona/733GH
《鸿蒙 (Harmony OS)开发学习手册》(共计892页)
如何快速入门?
1.基本概念
2.构建第一个ArkTS应用
3.……
开发基础知识:gitee.com/MNxiaona/733GH
1.应用基础知识
2.配置文件
3.应用数据管理
4.应用安全管理
5.应用隐私保护
6.三方应用调用管控机制
7.资源分类与访问
8.学习ArkTS语言
9.……
基于ArkTS 开发
1.Ability开发
2.UI开发
3.公共事件与通知
4.窗口管理
5.媒体
6.安全
7.网络与链接
8.电话服务
9.数据管理
10.后台任务(Background Task)管理
11.设备管理
12.设备使用信息统计
13.DFX
14.国际化开发
15.折叠屏系列
16.……
鸿蒙开发面试真题(含参考答案):gitee.com/MNxiaona/733GH
鸿蒙入门教学视频:
美团APP实战开发教学:gitee.com/MNxiaona/733GH
写在最后
- 如果你觉得这篇内容对你还蛮有帮助,我想邀请你帮我三个小忙:
- 点赞,转发,有你们的 『点赞和评论』,才是我创造的动力。
- 关注小编,同时可以期待后续文章ing🚀,不定期分享原创知识。
- 想要获取更多完整鸿蒙最新学习资源,请移步前往小编:
gitee.com/MNxiaona/733GH