断断续续的我又回来了,虽然没几个人看,但是呢自己总要有点仪式感。主要是最近又写了一个小程序,发现写完 vue 回头写微信小程序 简直顺畅的不得了,比我直接用 Android 切过去可真的好太多了。OK,废话停止,正文开始...
官方文档 微信小程序-网络
前提:
已在 微信公众平台 ==》开发 ==》 开发管理 ==》 服务器域名 request合法域名 中配置请求的基础域名。还有 uploadFile合法域名、socket合法域名 等,按照需求配置相关域名即可。多个域名用 ;(英文;) 隔开即可。
例如:请求的路径为 https://www.baidu.com/api,只需配置 https://www.baidu.com
准备:
首先 了解清楚以下:
请求url: 微信小程序中唯一必填字段,
请求方式 :一般是 GET/POST,微信小程序默认GET
请求头:
content-type :请求的参数格式,微信小程序默认 ‘application/json’,常用的还有 "application/x-www-form-urlencoded" ,
Accept:接收的数据格式, 一般为'application/json'
请求参数:根据请求头设置的参数格式写对应的参数即可,如果没有则不写
对于请求参数不理解的 可以看 HTTP请求中的参数提交 && GET和POST两种基本请求方法的区别
)
开始使用:
相关 API 使用的聚合数据 免费API, 需要可自己注册账号获取即可 https://www.juhe.cn
let city = '上海';
let key = '6483ffe27e1425d240365e190a7993dc';
wx.request({
url:'https://apis.juhe.cn/simpleWeather/query?city='+city+'&key='+key,
method:'GET',//请求方式
header:{
'content-type': 'application/x-www-form-urlencoded'//请求头 根据项目配置
},
success(res){
console.log('success =====',res)
},
fail(res){
console.log('fail =====',res)
},
complete(res){
console.log('complete =====',res)
}
})
var params = {
city: '上海',
key: '6483ffe27e1425d240365e190a7993dc' }
wx.request({
url: 'https://apis.juhe.cn/simpleWeather/query',
method:'POST',//请求方式
data:params,//参数
header:{
'content-type': 'application/x-www-form-urlencoded'//请求头 根据项目配置
},
success(res){
console.log('success =====',res)
},
fail(res){
console.log('fail =====',res)
},
complete(res){
console.log('complete =====',res)
}
})
无论使用哪种方式都可以请求到数据:
只要和确定好请求参数,请求头,请求方式,就可以正常获取到数据。
BUT 网络请求是异步的,也就是你不能把获取到的数据 return 给调用者,需要通过回调把数据传回给调用者。(PS:如果你非要每次请求都单独写一个请求方法,完全可以在异步回调中直接处理,但是 应该没有这样的吧 会把自己累死的)
封装:
1、封装网络请求,要清楚哪些是可变的,哪些是不变的。
通常来说 header 不会每次都变,当然 也有可能会变化 (万一后台就是玩呢,同一个项目不同的请求非要搞不同的 header 呢 ,嗯 前端的脾气就是这样被磨没的。所以针对这种情况也写好,整的死死的,来啥样的 照收不误。但是代码还是要尽量保持整洁 毕竟维护的还是我们自己),参数/请求地址url/请求方法,肯定是会变的。
2、对请求结果的处理
通常会把成功获取数据的交给调用者自己处理,如果失败 还是统一处理比较好,毕竟每次调用都处理失败 也是挺多冗余代码的。
var defaultHeader = {
'Accept': 'application/json',
'content-type': 'application/x-www-form-urlencoded',
}
request:function(url,method,header,data,successCB,failCB){
wx.showLoading({
title: '加载中...',
mask:true
})
wx.request({
url: rootUrl + url,
method:method,
data:data?data:'',
header:header?header: defaultHeader,
success(res){
if(res.statusCode==200){
// 处理数据 不需要返回所有数据
if(successCB && typeof successCB == "function"){
successCB(res.data)
}
}else{
// 服务器错误 此时给出提示 且 不允许用户下一步操作
wx.showModal({
title:'温馨提示',
content:'出错了,请稍后重试',
showCancel:false,
})
}
},
fail(res){
// 提示报错信息
wx.showModal({
showCancel: false,
content: res.errMsg
});
// 调用者处理,也可不处理
if(failCB && typeof failCB == "function"){
failCB(res)
}
},
complete(res){
// 无论成功失败 加载结束 加载框消失
wx.hideLoading({
complete: (res) => {
// 这里处理下 否则真机会报错
//in promise) MiniProgramError {"errMsg":"hideLoading:fail:toast can't be found"}
console.log('hideLoading',res)
},
})
}
})
}
主要的请求写好了,这样的话这个请求方法的参数也太多了,所以,多写个方法简化下
get:function(url,data, successCB, failCB){
return request(url,data,'GET',data, successCB, failCB)
},
post:function(url,data, successCB, failCB){
return request(url,data,'POST',data, successCB, failCB)
},
调用
// =========GET============
let city = '上海';
let key = '6483ffe27e1425d240365e190a7993dc';
this.get('simpleWeather/query?city='+city+'&key='+key,null,function(res){
console.log('success===',res)
}, function(err){
console.log('fail===', err)
});
// =========POST============
let param = {
city:'上海',
key:'6483ffe27e1425d240365e190a7993dc'
}
this.post('simpleWeather/query',param,function(res){
console.log('success===',res)
}, function(err){
console.log('fail===', err)
});
使用Promise封装:
Promise 解决异步回调嵌套问题
使用 Promise 最大的好处就是可以 链式调用! && 回调方法! 链式调用让代码简洁、易读,尤其是代码的请求存在前后关系的时候,
promiseRequest:function(url,data,method,header){
var defaultHeader = {
'Accept': 'application/json',
'content-type': 'application/x-www-form-urlencoded',
}
return new Promise(function(resolve,reject){
wx.request({
url: rootUrl + url,
method: method,
data: data ? data : '',
header: header?header:defaultHeader,
success(res) {
if (res.statusCode == 200) {
// 处理数据 不需要返回所有数据
resolve(res.data)
} else {
// 服务器错误 此时给出提示 且 不允许用户下一步操作
wx.showModal({
title: '温馨提示',
content: '出错了,请稍后重试',
showCancel: false,
})
}
},
fail(res) {
// 提示报错信息
wx.showModal({
showCancel: false,
content: res.errMsg
});
let errorMsg = errorMsg(res)
reject(errorMsg)
},
complete(res) {
// 无论成功失败 加载结束 加载框消失
wx.hideLoading({
complete: (res) => {
// 这里处理下 否则真机会报错
//in promise) MiniProgramError {"errMsg":"hideLoading:fail:toast can't be found"}
console.log('hideLoading', res)
},
})
}
})
})
},
可以看到 和封装前最大的区别就是 成功和失败的回调。
继续写一层方便调用
get:function(url,data){
return this.promiseRequest(url,data,'GET',null)
},
post:function(url,data){
return this.promiseRequest(url,data,'POST',null)
},
调用
get('simpleWeather/query?city='+city+'&key='+key,null).then(res=>{
console.log('success get===',res)
}).catch(error=>{
console.log('error get===',error)
})
let param = {
city:'上海',
key:'6483ffe27e1425d240365e190a7993dc'
}
post('simpleWeather/query',param).then(res=>{
console.log('success get===',res)
}).catch(error=>{
console.log('error get===',error)
})
至此 已完成微信小程序网络请求的基本使用和封装。
但是 其实还有一个隐藏的小问题,通常一个页面会调用多个接口,在第一个接口返回服务器问题的时候,应该取消其他的网络请求,目前还没找到解决方案,希望了解的朋友可以说下,先谢了
最后惯例给自己一句话:
好好地生活和工作很重要,但关照自己的内心更重要
如果心太疲惫 不防换个让心舒服的环境