jQuery进阶：用最文雅的体式格局写ajax要求

2024年4月15日 192次阅读 来源: Carl

也许你也能够尝尝：
xfire: 简朴文雅、高度可设置的fetch接口批量天生东西

起首须要一个设置文件

var api = {
    basePath: 'http://192.168.200.226:58080',
    pathList: [
        {
            name: 'agentHeartBeat',
            path:'/api/csta/agent/heartbeat/{{agentId}}/{{type}}/{{something}}',
            method:'get'
        },
        {
            name: 'setAgentState',
            path: '/api/csta/agent/state',
            method: 'post'
        },
        {
            name: 'getAgents',
            path: '/user/agent/{{query}}',
            method: 'get'
        }
    ]
}

然后须要一个要领，把设置文件天生接口

function WellApi(Config){
var headers = {};
var Api = function(){};

Api.pt = Api.prototype;

var util = {
    ajax: function(url, method, payload) {
        return $.ajax({
            url: url,
            type: method || "get",
            data: JSON.stringify(payload),
            headers: headers,
            dataType: "json",
            contentType: 'application/json; charset=UTF-8'
        });
    },

    /**
     * [render 模板衬着]
     * 重要用于将 /users/{{userId}} 和{userId: '89898'}转换成/users/89898，和mastache语法差不多，
     * 固然我们没必要为了这么小的一个功能来引入一个模板库
     * query字符串能够当作一个参数通报进来
     * 比方： /users/{{query}}和{query:'?name=jisika&sex=1'}
     * @Author   Wdd
     * @DateTime 2017-03-13T19:42:58+0800
     * @param    {[type]} tpl [description]
     * @param    {[type]} data [description]
     * @return   {[type]} [description]
     */
    render: function(tpl, data){
        var re = /{{([^}]+)?}}/;
        var match = '';

        while(match = re.exec(tpl)){
            tpl = tpl.replace(match[0],data[match[1]]);
        }

        return tpl;
    }
};

/**
 * [setHeader 暴露设置头部信息的要领]
 * 有些要领须要特定的头部信息，比方登录以后才猎取sesssionId,然后接见一切的接口时，必需照顾sessionId
 * 才够接见
 * @Author   Wdd
 * @DateTime 2017-03-13T10:34:03+0800
 * @param    {[type]} headers [description]
 */
Api.pt.setHeader = function(headers){
    headers = headers;
};

/**
 * [fire 发送ajax要求，this会绑定到每一个接口上]
 * @Author   Wdd
 * @DateTime 2017-03-13T19:42:13+0800
 * @param    {[type]} pathParm [description]
 * @param    {[type]} payload [description]
 * @return   {[type]} [description]
 */
function fire(pathParm, payload){
    var url = util.render(this.path, pathParm);
    return util.ajax(url, this.method, payload);
}


/**
 * [for 遍历一切接口]
 * @Author   Wdd
 * @DateTime 2017-03-13T19:49:33+0800
 * @param    {[type]} var i [description]
 * @return   {[type]} [description]
 */
for(var i=0; i < Config.pathList.length; i++){

    Api.pt[Config.pathList[i].name] = {
        path: Config.basePath + Config.pathList[i].path,
        method: Config.pathList[i].method,
        fire: fire
    };
}

return new Api();
}

试用一下

<!DOCTYPE html>
<html>
<head>
    <meta charset="utf-8">
    <title></title>
    <script src="http://cdn.bootcss.com/jquery/1.11.3/jquery.min.js"></script>
    <script src="api.js"></script>
    <script src="jquery-ajax.js"></script>
</head>
<body>

<script type="text/javascript">
    var saas = WellApi(api);

    saas.agentHeartBeat.fire({agentId: '5001@1011.cc', type:'a', something: 'test'})
    .done(function(res){
        console.log('心跳胜利');
    })
    .fail(function(res){
        console.log('心跳失利');
    });
    
    // 假如没有参数要衬着到途径上，谁人第一个参数能够传空对象
    saas.setAgentState.fire({}, {status: 'Ready'})
    .done(function(res){
        console.log('设置胜利');
    })
    .fail(function(res){
        console.log('设置失利');
    });


</script>
</body>
</html>

注重点

fire(pathParm, payload)中的pathParm是终究会被衬着到要求的途径内里，而paylaod代表要求体。

比方：

// 途径这么写
/api/{{version}}/agent/{{id}}/{{somethingElse}}

// pathParm如许写
{version: 1, id: '2', somethingElse: 'sss'}

// 终究途径会被衬着成
/api/1/agent/2/sss

path内里不单单议可放一个变量的，详细能够参考mustache语法，上面代码里的render是以最简朴的完成。

长处与扩大

  • [长处]：相似与promise的回调体式格局
  • [长处]：增添一个接口只是须要增添一个设置文件，很轻易
  • [扩大]：当前的ajax 的contentType我只写了json，有兴致能够扩大其他的数据类型
  • [瑕玷]：没有对函数参数举行校验
    原文作者：Carl
    原文地址: https://segmentfault.com/a/1190000008678653
    本文转自网络文章，转载此文章仅为分享知识，如有侵权，请联系博主进行删除。
点赞