当前位置:   article > 正文

鸿蒙语言基础类库:【@system.request (上传下载)】_鸿蒙 上传文件 文件参数名

鸿蒙 上传文件 文件参数名

上传下载

说明:

  • 从API Version 6开始,该接口不再维护,推荐使用新接口[@ohos.request]。
  • 本模块首批接口从API version 4开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。

导入模块

import request from '@system.request';
  • 1

权限列表

ohos.permission.INTERNET。

request.upload

upload(Object): void

上传文件。

参数:

参数名类型必填说明
urlstring上传服务器地址。
headerObject请求头。
methodstring请求方法:POST、PUT。缺省POST。
filesArray待上传文件列表。请使用multipart/form-data进行提交。
dataArray请求的表单数据。
successFunction接口调用成功的回调函数。
failFunction接口调用失败的回调函数。
completeFunction接口调用结束的回调函数。

表1 File

参数名类型必填说明
filenamestringmultipart 提交时,请求头中的文件名。
namestringmultipart 提交时,表单项目的名称,缺省为file。
uristring文件的本地存储路径。
typestring文件的内容类型,默认根据文件名或路径的后缀获取。

表2 RequestData

参数名类型必填说明
namestring表示form 元素的名称。
valuestring表示form 元素的值。

success返回值:

参数名类型说明
codenumber服务器返回的HTTP状态码。
datastring服务器返回的内容。根据返回头内容中的type决定该值的类型。
headersObject服务器返回的返回头内容。

fail返回值中的data中的code为HTTP状态码。

示例:

export default {    
  upLoad() {
    request.upload({
      url: 'http://www.path.com',
      files: [
        {
           uri: 'internal://cache/path/to/file.txt',
           name: 'file',
           filename: 'file.txt',
        },
      ],
      data:[
        {
          name: 'name1',
          value: 'value',
         },
       ],
       success: function(data) {
         console.log('upload success, code:' + data.code);
       },
       fail: function() {
         console.log('upload fail');
       },
     });
  }
}
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26

request.download

download(Object): void

下载文件。

参数:

参数名类型必填说明
urlstring资源地址。
headerObject请求头。
descriptionstring资源地址的下载描述,默认为文件名称。
filenamestring本次下载文件的名称。默认从本次请求或资源地址中获取。
successFunction接口调用成功的回调函数。
failFunction接口调用失败的回调函数。
completeFunction接口调用结束的回调函数。

success返回值:

参数名类型说明
tokenstring表示下载的 token,获取下载状态的依据。

fail返回错误代码:

错误码说明
400表示下载任务失败。

示例:

export default {    
  downLoad() {        
    request.download({            
      url: 'http://www.path.com',            
      success: function(data) {                
        console.log('call success callback success: ' + data.token);            
      },            
      fail: function(data, code) {                
        console.log('handling fail');            
      },        
    });    
  }
}
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13

request.onDownloadComplete

onDownloadComplete(Object): void

获取下载任务状态。

参数:

参数名类型必填说明
tokenstringdownload 接口返回的结果 token。
successFunction接口调用成功的回调函数。
failFunction接口调用失败的回调函数。
completeFunction接口调用结束的回调函数。

success返回值:

参数名类型说明
uristring表示下载文件的uri。

fail返回错误代码:

错误码说明
400表示下载任务失败。
401表示不存在该下载任务。

示例:

export default {    
  onDownloadComplete() {        
    request.onDownloadComplete({            
      token: 'token-index',            
      success: function(data) {                
        console.log('download success, uri:' + data.uri);            
      },            
      fail: function(data, code) {                
        console.log('download fail');            
      },
    });    
  }
}
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
声明:本文内容由网友自发贡献,不代表【wpsshop博客】立场,版权归原作者所有,本站不承担相应法律责任。如您发现有侵权的内容,请联系我们。转载请注明出处:https://www.wpsshop.cn/w/盐析白兔/article/detail/965456
推荐阅读
相关标签
  

闽ICP备14008679号