快應(yīng)用 上傳下載

2020-08-10 14:07 更新

接口聲明

{"name": "system.request"}

導(dǎo)入模塊

import request from '@system.request'
或 
const request = require('@system.request')

接口定義

request.upload(OBJECT)

上傳文件

參數(shù):

參數(shù)名 類型 必填 說明
url String 資源 url
header Object 請(qǐng)求的 header,會(huì)將其所有屬性設(shè)置到請(qǐng)求的 header 部分。User-Agent 設(shè)置在1040版本開始支持。
method String 默認(rèn)為 POST,可以是: POST, PUT
files Array 需要上傳的文件列表,使用 multipart/form-data 方式提交
data 1000+ Array HTTP 請(qǐng)求中其他額外的 form data
success Function 成功返回的回調(diào)函數(shù)
fail Function 失敗的回調(diào)函數(shù)
complete Function 結(jié)束的回調(diào)函數(shù)(調(diào)用成功、失敗都會(huì)執(zhí)行
files參數(shù) :

files參數(shù)是一個(gè)file對(duì)象的數(shù)組,file對(duì)象的結(jié)構(gòu)如下:

參數(shù)名 類型 必填 說明
filename String multipart提交時(shí),header中的文件名
name String multipart提交時(shí),表單的項(xiàng)目名,默認(rèn)file
uri String 文件的本地地址
type String 文件的Content-Type格式,默認(rèn)會(huì)根據(jù)filename或者uri的后綴獲取
data參數(shù)  1000+:
參數(shù)名 類型 必填 說明
name String form元素的名稱。
value String form元素的值。
success返回值:
參數(shù)名 類型 說明
code Integer 服務(wù)器狀態(tài)code
data String 如果服務(wù)器返回的header中type是text/*或application/json、application/javascript、application/xml,值是文本內(nèi)容,否則是存儲(chǔ)的臨時(shí)文件的uri臨時(shí)文件如果是圖片或者視頻內(nèi)容,可以將圖片設(shè)置到image或video控件上顯示
headers Object 服務(wù)器response的所有header

示例:

request.upload({
  url: 'http://www.example.com',
  files: [
    {
      uri: 'internal://xxx/xxx/test',
      name: 'file1',
      filename: 'test.png'
    }
  ],
  data: [
    {
      name: 'param1',
      value: 'value1'
    }
  ],
  success: function(data) {
    console.log('handling success')
  },
  fail: function(data, code) {
    console.log(`handling fail, code = ${code}`)
  }
})

request.download(OBJECT)

下載文件

參數(shù):

參數(shù)名 類型 必填 說明
url String 資源 url
header String 請(qǐng)求的 header,會(huì)將其所有屬性設(shè)置到請(qǐng)求的 header 部分。User-Agent 設(shè)置在 1040 版本開始支持。
description 1010+ String 下載描述,會(huì)用于通知欄標(biāo)題。默認(rèn)為文件名
filename 1010+ String 下載文件名。默認(rèn)從網(wǎng)絡(luò)請(qǐng)求或 url 中獲取
success Function 成功返回的回調(diào)函數(shù)
fail Function 失敗的回調(diào)函數(shù)
complete Function 結(jié)束的回調(diào)函數(shù)(調(diào)用成功、失敗都會(huì)執(zhí)行)
success返回值:
參數(shù)名 類型 說明
token String 下載的token,根據(jù)此token獲取下載狀態(tài)

示例:

request.download({
  url: 'http://www.example.com',
  success: function(data) {
    console.log(`handling success${data.token}`)
  },
  fail: function(data, code) {
    console.log(`handling fail, code = ${code}`)
  }
})

request.onDownloadComplete(OBJECT)

監(jiān)聽下載任務(wù)

參數(shù):

參數(shù)名 類型 必填 說明
token String download接口返回的token
success Function 成功返回的回調(diào)函數(shù)
fail Function 失敗的回調(diào)函數(shù)
complete Function 結(jié)束的回調(diào)函數(shù)(調(diào)用成功、失敗都會(huì)執(zhí)行)
success返回值:
參數(shù)名 類型 說明
uri String 下載文件的Uri
fail返回錯(cuò)誤代碼:
錯(cuò)誤碼  說明
1000 下載失敗
1001 下載任務(wù)不存在

示例:

request.onDownloadComplete({
  token: '123',
  success: function(data) {
    console.log(`handling success${data.uri}`)
  },
  fail: function(data, code) {
    console.log(`handling fail, code = ${code}`)
  }
})

后臺(tái)運(yùn)行限制

manifest 中申請(qǐng)后可用。

后臺(tái)運(yùn)行詳細(xì)用法參見 后臺(tái)運(yùn)行腳本。


以上內(nèi)容是否對(duì)您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號(hào)
微信公眾號(hào)

編程獅公眾號(hào)