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