1# 上传和下载 2 3### 介绍 4本示例使用[@ohos.request](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis-basic-services-kit/js-apis-request.md)接口创建上传和下载任务，实现上传、下载功能，hfs作为服务器，实现了文件的上传和下载和任务的查询功能。 5 6### 效果预览 7 8| 主页 | 上传 | 片段上传 | 下载 | 证书锁定 | 9| :---------------------------------------: | :---------------------------------------: | :--------------------------------------: | :--------------------------------------: | ---------------------------------------- | 10|  |  |  |  |  | 11 12使用说明 13 141.本示例功能需要先配置服务器环境后使用，具体配置见[上传下载服务配置](./environment)。 15 162.首页展示上传、下载和证书锁定三个入口组件，点击进入对应的页面，如果要使用后台下载任务，请开启后台任务开关。 17 183.上传页面： 19 20点击 **+**，**从相册选择**拉起图库选择照片，图片选择页面支持拍照，选择照片后点击**上传**进行上传。 21 22可选的，点击缩略图，显示文件片段上传配置选项弹窗，可以配置上传起点和终点，取值为闭区间；起点默认为0，终点默认为文件结尾。点击**上传**进行选中文件片段以及后续文件全部内容上传。 23 24点击**返回**键或片段上传配置选项弹窗外区域，取消片段上传。 25 26在首页中打开后台任务开关后，上传页面开启的是后台上传任务，后台任务在应用退出到后台时可以在通知栏看到任务状态。 27 28后台上传**暂停**时，需要服务器支持上传暂停服务（HFS暂不支持此操作）。如仍然使用HFS作为服务器，此时HFS服务将中断文件写入，立即将当前传输的数据保存为文件片段。点击**继续**时则会重新生成一份文件，并在新文件中开始写入。 29 304.下载页面： 31 32点击文件列表选择要下载的文件后，点击**下载**选择指定路径后开始下载。 33 34点击**查看下载文件**进入下载文件页面，点击文件夹查看文件夹内的文件。 35 36在首页中打开后台任务开关后，下载页面开启的是后台下载任务，后台任务在应用退出到后台时可以在通知栏看到任务状态。 37 38前台下载时只支持单文件下载，后台下载时支持选择多个文件下载。 39 40后台下载**暂停**时，本示例功能将自动记录断点。此时HFS服务仍会进行一定时间的传输，但是传输的数据并不会被接受。点击**继续**后将会从上次暂停的断点继续下载。 41 425.证书锁定页面： 43 44点击**下载**按钮会使用get方式访问百度，并在空白处显示返回的响应header内容。 45 46点击**上传**按钮会使用post方式访问百度，并在空白处显示返回的响应header内容。 47 48以上功能需要在src/main/resources/base/profile/network_config.json中配置domains和digest，只有你配置的证书信息通过验证，上传和下载才可以正常响应；否则将无法正常访问百度，会通过toast提示上传或者下载失败，日志中会有具体错误信息。如果你要访问的服务器根证书不在系统中，你需要把它的根证书放到src/main/resources/resfile目录下。 49 50如示例中访问百度，则digest需要取百度服务器的证书生成： 51 52```bash 53cat server.crt \ 54| openssl x509 -noout -pubkey \ 55| openssl pkey -pubin -outform der \ 56| openssl dgst -sha256 -binary \ 57| openssl enc -base64 58``` 59 60因为服务器证书可能定期更新，所以digest的值需要与服务端证书对应，及时更新。 61 62 63 64 65 66 67### 工程目录 68 69``` 70UploadAndDownload 71├── AppScope 72│ └── app.json5 //APP信息配置文件 73├── entry/src/main //应用首页 74│ ├── ets 75│ │ ├── entryability 76│ │ ├── components //自定义组件 77│ │ ├── pages 78│ │ │ ├── Index.ets //主页入口 79│ │ │ ├── Download.ets //下载页面 80│ │ │ ├── DownloadFiles.ets //查看下载文件页面 81│ │ │ ├── Upload.ets //上传页面 82│ │ │ ├── CertLock.ets //证书锁定页面 83│ └── module.json5 84│ 85├── features/uploadanddownload/src/main //上传和下载 86│ ├── ets 87│ │ ├── Index.ets //对外提供的接口列表 88│ │ ├── components 89│ │ │ └── FileBrowse.ets //查看下载文件组件 90│ │ ├── download //下载任务相关 91│ │ ├── upload //上传任务相关 92│ │ ├── utils //相关工具类 93│ └── module.json5 94``` 95 96### 具体实现 97 98* 该示例分为三个模块： 99 * 上传模块 100 * 使用[@ohos.request](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis-basic-services-kit/js-apis-request.md)中API 12接口agent.create创建上传任务，调用@ohos.request中的Task相关接口实现上传任务的创建、取消、进度加载，失败的任务会调用查询接口获取失败原因并打印在日志中，支持多个文件上传及片段上传。 101 * 源码链接：[RequestUpload.ets](./features/uploadanddownload/src/main/ets/upload/RequestUpload.ets)，[AddPictures.ets](./entry/src/main/ets/components/AddPictures.ets)，[Upload.ets](./entry/src/main/ets/pages/Upload.ets) 102 * 参考接口：[@ohos.request](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis-basic-services-kit/js-apis-request.md)，[@ohos.file.picker](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis-core-file-kit/js-apis-file-picker.md) 103 104 * 下载模块 105 106 * 使用[@ohos.request](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis-basic-services-kit/js-apis-request.md)中API 12接口agent.create创建上传任务，调用@ohos.request中的Task相关接口实现上传任务的创建、取消、进度加载，失败的任务会调用查询接口获取失败原因并打印在日志中，前台下载任务只支持单个文件下载，后台下载任务支持多文件下载。使用[@ohos.file.fs](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis-core-file-kit/js-apis-file-fs.md)完成指定路径的创建和查询已下载的文件。 107 * 源码链接：[RequestDownload.ets](./features/uploadanddownload/src/main/ets/download/RequestDownload.ets)，[Download.ets](./entry/src/main/ets/pages/Download.ets)，[FileUtils.ets](./features/uploadanddownload/src/main/ets/utils/FileUtils.ets)，[FileBrowse.ets](./features/uploadanddownload/src/main/ets/components/FileBrowse.ets) 108 * 参考接口：[@ohos.request](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis-basic-services-kit/js-apis-request.md)，[@ohos.file.fs](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis-core-file-kit/js-apis-file-fs.md) 109 110 * 证书锁定模块 111 112 * 使用[@ohos.request](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis-basic-services-kit/js-apis-request.md)中API 12接口agent.create创建上传任务，调用@ohos.request中的Task相关接口实现通过get或者post方式访问指定的网页，点击按钮后会在空白处显示返回的响应header内容。你需要提前在src/main/resources/base/profile/network_config.json中配置domains和digest，只有你配置的证书信息通过验证，上传和下载才可以正常响应。如果你要访问的服务器根证书不在系统中，你需要把它的根证书放在src/main/resources/resfile目录下。 113 114 * 源码链接，[CertLock.ets](./entry/src/main/ets/pages/CertLock.ets) 115 116 * 参考接口：[@ohos.request](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis-basic-services-kit/js-apis-request.md) 117 118 119 120 121 122### 相关权限 123 124[ohos.permission.INTERNET](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/security/AccessToken/permissions-for-all.md#ohospermissioninternet) 125 126[ohos.permission.READ_MEDIA](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/security/AccessToken/permissions-for-all.md#ohospermissionread_media) 127 128### 依赖 129 130[上传下载服务配置](./environment)。 131 132### 约束与限制 133 1341.本示例仅支持标准系统上运行，支持设备：RK3568。 135 1362.本示例为Stage模型，支持API12版本SDK，SDK版本号(API Version 12),镜像版本号(5.0) 137 1383.本示例需要使用DevEco Studio 版本号(4.1 Release)及以上版本才可编译运行。 139 1404.运行本示例需全程联网。 141 142### 下载 143 144如需单独下载本工程，执行如下命令： 145 146```bash 147git init 148git config core.sparsecheckout true 149echo code/BasicFeature/Connectivity/UploadAndDownload/ > .git/info/sparse-checkout 150git remote add origin https://gitee.com/openharmony/applications_app_samples.git 151git pull origin master 152```
