在微信小程序進(jìn)行網(wǎng)絡(luò)通信,只能和指定的域名進(jìn)行通信,微信小程序包括四種類型的網(wǎng)絡(luò)請求。
這里以介紹 wx.request
, wx.uploadFile
, wx.dowloadFile
三種網(wǎng)絡(luò)請求為主
要微信小程序進(jìn)行網(wǎng)絡(luò)通信,必須先設(shè)置域名,不然會出現(xiàn)錯誤:
需要在微信公眾平臺的小程序中設(shè)置域名。
在微信小程序的 設(shè)置界面 可以看到設(shè)置選項:
選擇 開發(fā)設(shè)置
:
開發(fā)設(shè)置
可以看到服務(wù)器設(shè)置:
在這里可以設(shè)置對應(yīng)四種網(wǎng)絡(luò)訪問的域名,每一種類型的網(wǎng)絡(luò)請求需要設(shè)置一個域名,注意如果在這里設(shè)置域名為 https://example.com/api/
,那么 https://example.com/api
是無法調(diào)用的,必須加上后面 /
。
使用 wx.request
可以發(fā)起一個http請求,一個微信小程序被限制為同時只有5個網(wǎng)絡(luò)請求。
function queryRequest(data){
wx.request({
url:"https://example.com/api/",
data:data,
header:{
// "Content-Type":"application/json"
},
success:function(res){
console.log(res.data)
},
fail:function(err){
console.log(err)
}
})
}
上面的代碼會發(fā)送一個http get請求,然后打印出返回的結(jié)果。其中的參數(shù)也比較容易理解。
url
服務(wù)器的url地址data
請求的參數(shù)可以采用String data:"xxx=xxx&xxx=xxx"
的形式或者Object data:{"userId":1}
的形式header
設(shè)置請求的headersuccess
接口成功的回調(diào)fail
接口失敗的回調(diào)另外還有兩個參數(shù)沒有在代碼里:
method
complete
上傳文件的api為 wx.uploadFile
,該api會發(fā)起一個 http post
請求,其中的 Content-type
為 multipart/form-data
。服務(wù)器端需要按照該 Content-type
類型接收文件,示例代碼:
function uploadFile(file,data) {
wx.uploadFile({
url: 'http://example.com/upload',
filePath: file,
name: 'file',
formData:data,
success:function(res){
console.log(res.data)
},
fail:function(err){
console.log(err)
}
})
}
其中的 url
, header
, success
, fail
以及 complete
和普通的http請求是一樣的。
這里有區(qū)別的參數(shù)是:
name
文件對應(yīng)的key,服務(wù)器端需要通過 name
參數(shù)獲取文件formData
http請求中可以使用的其他參數(shù)
下載文件的api為 wx.downloadFile
,該api會發(fā)起一個http get請求,并在下載成功之后返回文件的臨時路徑,示例代碼:
function downloadFile(url,typ,success){
wx.downloadFile({
url:url,
type:typ,
success:function(res){
if(success){
success(res.tempFilePath)
}
},
fail:function(err){
console.log(err)
}
})
}
其中的 url
, header
, fail
, complete
和 wx.uploadFile
的參數(shù)使用是一致的,其中有區(qū)別的參數(shù)是:
type
:下載資源的類型,用于客戶端自動識別,可以使用的參數(shù) image/audio/video
success
:下載成功之后的回調(diào),以 tempFilePath
的參數(shù)返回文件的臨時目錄: res={tempFilePath:'文件路徑'}
下載成功后的是臨時文件,只會在程序本次運(yùn)行期間可以使用,如果需要持久的保存,需要調(diào)用方法 wx.saveFile
主動持久化文件,實(shí)例代碼:
function svaeFile(tempFile,success){
wx.saveFile({
tempFilePath:tempFile,
success:function(res){
var svaedFile=res.savedFilePath
if(success){
success(svaeFile)
}
}
})
}
使用 wx.saveFile
保存臨時文件到本地,提供給小程序下次啟動時使用,其中的參數(shù):
tempFilePath
需要被保存文件的路徑
success
保存成功的回調(diào),返回保存成功的路徑,使用 res.savedFilePath
可以獲取保存成功的路徑fail
失敗的回調(diào)complete
結(jié)束的回調(diào)
app.js中調(diào)整設(shè)置:
"networkTimeout":{
"request": 10000,
"connectSocket": 10000,
"uploadFile": 10000,
"downloadFile": 10000
}
這里設(shè)置的超時時間對應(yīng)著四種類型的網(wǎng)絡(luò)請求。