上传下载

接口声明

在manifest.json文件的 features属性中增加如下配置。

{"name": "system.request"}

导入模块

在调用接口页面的<script>部分增加如下配置。

import request from '@system.request'

或

var request = require("@system.request")

使用限制

接口定义

[h2]request.upload(OBJECT)

描述

上传文件。

从1060版本开始，可以通过 manifest.json 的 config.network 进行网络超时的配置。

OBJECT参数

files参数说明：

data说明：

success返回值：

示例代码

request.upload({
    url: "https://www.example.com",
    header: { "Accept-Encoding": "gzip, deflate", "Accept-Language": "zh-CN,en-US;q=0.8,en;q=0.6" },
    files: [
    {
        uri: "internal://xxx/xxx/test",
        name: "file1",
        type: "test.png"
    }
    ], data: [
    {
        name: "key1",
        value: "value1"
    }
    ],
    success: function (data) { 
        console.log("handling success"); 
    },
    fail: function (data, code) {
        console.log("handling fail, code=" + code);
    }
})

[h2]request.download(OBJECT)

描述

下载文件。

下载后的文件存储在手机中，可通过文件管理器进入 /Android/data/com.huawei.fastapp.dev/files/fastappEngine/ 目录访问，如果用户没有清除快应用的数据，下载的文件将一直保存着。

OBJECT参数

success返回值：

示例代码

request.download({
    url: "https://www.example.com",
    success: function (data) { 
        console.log("handling success" + data.token); 
    },
    fail: function (data, code) {
        console.log("handling fail, code=" + code);
    }
})

[h2]request.onDownloadComplete(OBJECT)

监听下载任务。

OBJECT参数

success返回值：

fail返回错误码：

示例代码

request.onDownloadComplete({
    token: "123",
    success: function (data) {
        console.log("handling success" + data.uri);
    },
    fail: function (data, code) {
        console.log("handling fail, code=" + code);
    }
})

安全要求

对于HTTPS请求，对证书要求如下：

• HTTPS证书必须有效。证书必须被系统信任，不支持自签名证书，部署SSL证书的网站域名必须与证书颁发的域名一致，证书必须在有效期内。
• 从1200版本开始，TLS必须支持1.2及以上版本，请确保HTTPS服务器的TLS版本能够同时支持TLS1.2及以下版本。

  从安全性考虑，建议也支持TLS1.3。1200及以上版本在配置加密套件时排除不安全算法：TEA/DES/DESX/DES40/RC2/RC4/RIPEMD/NULL/SHA0/MD2/MD4/MD5/ANON/TLS_EMPTY_RENEGOTIATION_INFO_SCSV；1200以下版本在配置加密套件时排除不安全算法：TEA/DES/DESX/DES40/RC2/RC4/RIPEMD/eNULL/aNULL/NULL/SHA0/MD2/MD4/MD5/ANON/TLS_EMPTY_RENEGOTIATION_INFO_SCSV。部分CA可能不被操作系统信任，请开发者在选择证书时注意操作系统的相关通告。

Demo

<template>
    <div>
        <div>
            <text>{{componentName}}</text>
        </div>
        <div>
            <div>
                <text>下载文件：{{fileDownloadData}}</text>
            </div>
            <input type="button" onclick="downloadFile" value="下载文件"/>
            <div>
                <text>下载文件路径：{{fileDownloadUri}}</text>
            </div>
            <input type="button" onclick="downloadFileComplete" value="下载文件状态"/>
            <div>
                <text>上传文件：{{fileUploadData}}</text>
            </div>
            <input type="button" onclick="uploadFile" value="上传文件"/>
        </div>
    </div>
</template>
<style>
    @import '../Common/css/common.css';
    .item-container {
        margin-bottom: 50px;
        margin-right: 60px;
        margin-left: 60px;
        flex-direction: column;
    }
    .item-content {
        flex-direction: column;
        background-color: #ffffff;
        padding-left: 30px;
        padding-right: 30px;
        padding-top: 20px;
        padding-bottom: 20px;
        margin-bottom: 30px;
        align-items: flex-start;
    }
    .txt {
        lines: 5;
        padding-top: 15px;
        padding-bottom: 15px;
    }
</style>
<script>
    import request from '@system.request'
    import prompt from '@system.prompt'
    export default {
        data: {
            componentName: 'request',
            fileDownloadData: '',
            fileUploadData: '',
            fileDownloadUri:""
        },
        onInit: function () {
            this.$page.setTitleBar({ text: 'request' })
        },
        downloadFile: function () {
            var that = this;
            // 下载文件，存储在本地
          request.download({
                url: 'https://www.huawei.com/Assets/CBG/img/logo.png',
                description: 'This is description.',
                filename: 'HuaweiLogo.png',
                success: function (ret) {
                    that.fileDownloadData = ret.token;
                    console.log('file_download_data--------' + JSON.stringify(ret.token));
                    prompt.showToast({
                        message: 'file_download_data--------' + JSON.stringify(ret.token)
                    })
                },
              fail: function (errmsg, errcode) {
                  prompt.showToast({
                      message: "下载失败："+errcode + ': ' + errmsg
                  })
              }
            })
        },
        downloadFileComplete: function () {
            var that = this;
            // 下载文件，存储在本地
            console.log('下载文件');
            request.onDownloadComplete({
                token:that.fileDownloadData,
                success: function (ret) {
                    that.fileDownloadUri = ret.uri;
                    console.log('fileDownloadUri--------' + JSON.stringify(ret.uri));
                    prompt.showToast({
                        message: 'fileDownloadUri--------' + JSON.stringify(ret.uri)
                    })
                },
                fail: function (errmsg, errcode) {
                    prompt.showToast({
                        message: "下载失败："+errcode + ': ' + errmsg
                    })
                }
            })
        },
        uploadFile() {
            var that = this;
            // 上传下载好的本地文件．其中，data为请求的参数，files为需要上传的文件列表
            request.upload({
                url: "https://117.78.33.207:48080/uploadDemo/api/uploadFile",
                header:{"Accept-Encoding": "gzip, deflate","Accept-Language": "zh-CN,en-US;q=0.8,en;q=0.6"},
                files: [
                    {
                        uri: that.fileDownloadUri,
                        name: "component_test.png",
                        type:"multipart/form-data"
                    }
                ],
                success: function (ret) {
                    that.fileUploadData = ret.data;
                }
            })
        }
    }
</script>

版本更新说明

相关链接

[h2]FAQ

• 使用request.download下载文件成功后，使用file.move进行移动失败，提示src无效，如何处理？
• 快应用调用request.upload接口上传文件，但是服务器接收的form-data为空，如何处理？

[h2]案例

调用文件下载接口下载的图片无法显示