微信小程序网络封装(简单高效)
废话引言
小程序虽然出世很久了，但一直没怎么接触到小程序开发。吉他兴趣班老师想弄一个小程序发布课程信息和打卡功能，作为IT一员就自愿加入了这个小程序开发小组中。虽然小程序面向的是前端工程师，但作为移动端程序猿感觉甚是友好，加上有点前端基础就更是觉得入手很easy啦。
微信小程序的网络请求很便捷，直接调用就可以了。但最好还是根据需求，处理一些参数回调信息，进行二次封装，为整个小程序应用直接提供调方法接口岂不是更好？
利用网络请求的一贯思维，分三个回调：onStart：开始请求, onSuccess：请求成功回调, onFailed：请求失败回调, 意思就是字面意思~
netUtil.js 网络请求工具封装
在utils目录下创建一个netUtil.js文件
/**
* 供外部post请求调用
*/
function post(url, params, onStart, onSuccess, onFailed) {
request(url, params, "POST", onStart, onSuccess, onFailed);
}
/**
* 供外部get请求调用
*/
function get(url, params, onStart, onSuccess, onFailed) {
request(url, params, "GET", onStart, onSuccess, onFailed);
}
/**
* function: 封装网络请求
* @url URL地址
* @params 请求参数
* @method 请求方式：GET/POST
* @onStart 开始请求,初始加载loading等处理
* @onSuccess 成功回调
* @onFailed 失败回调
*/
function request(url, params, method, onStart, onSuccess, onFailed) {
onStart(); //request start
wx.request({
url: url,
data: dealParams(params),
method: method,
header: { 'content-type': 'application/json' },
success: function (res) {
if (res.data) {
/** start 根据需求 接口的返回状态码进行处理 */
if (res.data.error_code == 0) {
onSuccess(res.data); //request success
} else {
onFailed(res.data.msg); //request failed
}
/** end 处理结束*/
}
},
fail: function (error) {
onFailed(""); //failure for other reasons
}
})
}
/**
* function: 根据需求处理请求参数：添加固定参数配置等
* @params 请求参数
*/
function dealParams(params) {
return params;
}
module.exports = {
postRequest: post,
getRequest: get,
}
小案例使用说明：笑话大全接口
简要描述：用户注册接口
请求URL：http://v.juhe.cn/joke/content/list.php
请求方式：GET
参数：
| 参数名 | 必选 | 类型 | 说明 |
|---|---|---|---|
| sort | 否 | string | 降序“des”，升序“asc” |
| page | 否 | int | 页数，默认1 |
| pageSize | 否 | string | 默认每页加载20条数据 |
| time | 是 | string | 时间戳10位 |
| key | 是 | string | appkey |
返回示例
{
"error_code": 0,
"reason": "Success",
"result": {
"data": [
{
"content": "某先生是地方上的要人。一天，他像往常一样在书房里例览当日报纸，突然对妻子大声喊道：喂，安娜，你看到今天早报上的流言蜚语了吗？真可笑！他们说，你收拾行装出走了。你听见了吗？安娜、你在哪儿？安娜？啊！",
"hashId": "90B182FC7F74865B40B1E5807CFEBF41",
"unixtime": 1418745227,
"updatetime": "2014-12-16 23:53:47"
},
{
"content": "有一天我看着报纸，小声嘟囔着一篇文章的题目鸟儿也有外语，丈夫听了对了一句：鸟儿当然也有‘外遇'。原来丈夫听错了，我笑得前仰后合。",
"hashId": "206F5C52FD2ED94772CBC66C8AC61F2A",
"unixtime": 1418745227,
"updatetime": "2014-12-16 23:53:47"
}
]
}
}
小程序页面js文件中引入netUtil
var netUtil = require("../../utils/network.js"); //require引入
Page({
data: {
jokeList: {}
},
onLoad: function (options) {
var url = "http://v.juhe.cn/joke/content/list.php";
var params = {
sort: "",
page: 1,
pagesize: 5,
time: "1418816972",
key: "746dfdb4cd8445d30a8f915fd2b5f76b",
}
netUtil.getRequest(url, params, this.onStart, this.onSuccess, this.onFailed); //调用get方法情就是户数
},
onStart: function () { //onStart回调
wx.showLoading({
title: '正在加载',
})
},
onSuccess: function (res) { //onSuccess回调
wx.hideLoading();
this.setData({
jokeList: res.result.data //请求结果数据
})
},
onFailed: function (msg) { //onFailed回调
wx.hideLoading();
if (msg) {
wx.showToast({
title: msg,
})
}
},
})
在wxml文件中绑定请求的笑话大全列表：jokeList
<view>
<block wx:for="{{jokeList}}" wx:for-item="item" wx:key="idx">
<view class='joke_container'>
<text>{{item.content}}</text>
</view>
</block>
</view>
