微信小程序設(shè)置http請(qǐng)求的步驟詳解
http請(qǐng)求介紹
HTTP(HyperText Transfer Protocol)是一套計(jì)算機(jī)通過(guò)網(wǎng)絡(luò)進(jìn)行通信的規(guī)則。計(jì)算機(jī)專(zhuān)家設(shè)計(jì)出HTTP,使HTTP客戶(hù)(如Web瀏覽器)能夠從HTTP服務(wù)器(Web服務(wù)器)請(qǐng)求信息和服務(wù),HTTP目前協(xié)議的版本是1.1.HTTP是一種無(wú)狀態(tài)的協(xié)議,無(wú)狀態(tài)是指Web瀏覽器和Web服務(wù)器之間不需要建立持久的連接,這意味著當(dāng)一個(gè)客戶(hù)端向服務(wù)器端發(fā)出請(qǐng)求,然后Web服務(wù)器返回響應(yīng)(response),連接就被關(guān)閉了,在服務(wù)器端不保留連接的有關(guān)信息.HTTP遵循請(qǐng)求(Request)/應(yīng)答(Response)模型。Web瀏覽器向Web服務(wù)器發(fā)送請(qǐng)求,Web服務(wù)器處理請(qǐng)求并返回適當(dāng)?shù)膽?yīng)答。所有HTTP連接都被構(gòu)造成一套請(qǐng)求和應(yīng)答。
微信小程序設(shè)置http請(qǐng)求
在微信小程序進(jìn)行網(wǎng)絡(luò)通信,只能和指定的域名進(jìn)行通信,微信小程序包括四種類(lèi)型的網(wǎng)絡(luò)請(qǐng)求。
1、普通HTTPS請(qǐng)求(wx.request
)
2、上傳文件(wx.uploadFile
)
3、下載文件(wx.downloadFile
)
4、WebSocket通信(wx.connectSocket
)
這里以介紹wx.request
,wx.uploadFile
,wx.dowloadFile
三種網(wǎng)絡(luò)請(qǐng)求為主
設(shè)置域名
要微信小程序進(jìn)行網(wǎng)絡(luò)通信,必須先設(shè)置域名,不然會(huì)出現(xiàn)錯(cuò)誤:
URL 域名不合法,請(qǐng)?jiān)?mp 后臺(tái)配置后重試
需要在微信公眾平臺(tái)的小程序中設(shè)置域名。
在微信小程序的設(shè)置界面可以看到設(shè)置選項(xiàng):
設(shè)置
選擇開(kāi)發(fā)設(shè)置:
開(kāi)發(fā)設(shè)置
可以看到服務(wù)器設(shè)置:
服務(wù)器設(shè)置
在這里可以設(shè)置對(duì)應(yīng)四種網(wǎng)絡(luò)訪(fǎng)問(wèn)的域名,每一種類(lèi)型的網(wǎng)絡(luò)請(qǐng)求需要設(shè)置一個(gè)域名,注意如果在這里設(shè)置域名為https://example.com/api/,那么https://example.com/api是無(wú)法調(diào)用的,必須加上后面/。
http請(qǐng)求
使用wx.request
可以發(fā)起一個(gè)http請(qǐng)求,一個(gè)微信小程序被限制為同時(shí)只有5個(gè)網(wǎng)絡(luò)請(qǐng)求。
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) } }) }
上面的代碼會(huì)發(fā)送一個(gè)http get請(qǐng)求,然后打印出返回的結(jié)果。其中的參數(shù)也比較容易理解。
url
服務(wù)器的url地址
data
請(qǐng)求的參數(shù)可以采用String data:"xxx=xxx&xxx=xxx"
的形式或者Object data:{"userId":1}
的形式
header
設(shè)置請(qǐng)求的header
success
接口成功的回調(diào)
fail
接口失敗的回調(diào)
另外還有兩個(gè)參數(shù)沒(méi)有在代碼里:
method http
的方法,默認(rèn)為GET請(qǐng)求
complete
調(diào)用接口結(jié)束之后的回調(diào),無(wú)論成功或者失敗該接口都會(huì)被調(diào)用
上傳文件
上傳文件的api為wx.uploadFile
,該api會(huì)發(fā)起一個(gè)http post請(qǐng)求,其中的Content-type
為multipart/form-data
。服務(wù)器端需要按照該Content-type
類(lèi)型接收文件,示例代碼:
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ǐng)求是一樣的。
這里有區(qū)別的參數(shù)是:
name
文件對(duì)應(yīng)的key
,服務(wù)器端需要通過(guò)name
參數(shù)獲取文件
formData http
請(qǐng)求中可以使用的其他參數(shù)
下載文件
下載文件的api為wx.downloadFile
,該api會(huì)發(fā)起一個(gè)http get請(qǐng)求,并在下載成功之后返回文件的臨時(shí)路徑,示例代碼:
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
:下載資源的類(lèi)型,用于客戶(hù)端自動(dòng)識(shí)別,可以使用的參數(shù)image/audio/video
success
:下載成功之后的回調(diào),以tempFilePath
的參數(shù)返回文件的臨時(shí)目錄:res={tempFilePath:'文件路徑'}
下載成功后的是臨時(shí)文件,只會(huì)在程序本次運(yùn)行期間可以使用,如果需要持久的保存,需要調(diào)用方法wx.saveFile
主動(dòng)持久化文件,實(shí)例代碼:
function svaeFile(tempFile,success){ wx.saveFile({ tempFilePath:tempFile, success:function(res){ var svaedFile=res.savedFilePath if(success){ success(svaeFile) } } }) }
使用wx.saveFile
保存臨時(shí)文件到本地,提供給小程序下次啟動(dòng)時(shí)使用,其中的參數(shù):
tempFilePath
需要被保存文件的路徑
success
保存成功的回調(diào),返回保存成功的路徑,使用res.savedFilePath
可以獲取保存成功的路徑
fail
失敗的回調(diào)
complete
結(jié)束的回調(diào)
超時(shí)的設(shè)置
可以在app.js中設(shè)置networkTimeout
可以設(shè)置四種類(lèi)型網(wǎng)絡(luò)訪(fǎng)問(wèn)的超時(shí)時(shí)間:
"networkTimeout":{ "request": 10000, "connectSocket": 10000, "uploadFile": 10000, "downloadFile": 10000 }
這里設(shè)置的超時(shí)時(shí)間對(duì)應(yīng)著四種類(lèi)型的網(wǎng)絡(luò)請(qǐng)求。
總結(jié)
以上就是這篇文章的全部?jī)?nèi)容了,希望本文的內(nèi)容對(duì)大家的學(xué)習(xí)或者工作能帶來(lái)一定的幫助,如果有疑問(wèn)大家可以留言交流。
相關(guān)文章
gVim, gVim Easy, gVim Read-only 的簡(jiǎn)單區(qū)別
今天打算好好學(xué)習(xí)一下python,買(mǎi)了一本書(shū)看了介紹無(wú)語(yǔ)了,gVim, gVim Diff, gVim Easy, gVim Read-only 的簡(jiǎn)單區(qū)別,需要的朋友可以參考下2016-01-01WebSocket部署到服務(wù)器出現(xiàn)連接失敗問(wèn)題的分析與解決
這篇文章主要給大家介紹了關(guān)于WebSocket部署到服務(wù)器出現(xiàn)連接失敗問(wèn)題的分析與解決方法,文中給出了詳細(xì)的介紹供大家參考學(xué)習(xí),文末也給出了demo下載地址,需要的朋友們可以下載學(xué)習(xí),下面隨著小編來(lái)一起學(xué)習(xí)學(xué)習(xí)吧。2017-10-10IDEA中g(shù)it撤回上一次push的方法(指定回到某個(gè)版本)
這篇文章主要介紹了IDEA中g(shù)it撤回上一次push(指定回到某個(gè)版本),本文通過(guò)場(chǎng)景圖文的形式給大家介紹的非常詳細(xì),對(duì)大家的學(xué)習(xí)或工作具有一定的參考借鑒價(jià)值,需要的朋友可以參考下2020-11-11Clion、IEDA、pycharm的一些簡(jiǎn)單設(shè)置步驟(設(shè)置中文菜單、輸出中文、字體大小、背景顏色主題)
這篇文章主要介紹了Clion、IEDA、pycharm的一些簡(jiǎn)單設(shè)置步驟(設(shè)置中文菜單、輸出中文、字體大小、背景顏色主題),本文通過(guò)圖文并茂的形式給大家介紹的非常詳細(xì),具有一定的參考借鑒價(jià)值,需要的朋友可以參考下2020-08-08