zoukankan      html  css  js  c++  java
  • jQuery.extend 函数详解

    JQuery的extend扩展方法:
          Jquery的扩展方法extend是我们在写插件的过程中常用的方法,该方法有一些重载原型,在此,我们一起去了解了解。
          一、Jquery的扩展方法原型是:   

    extend(dest,src1,src2,src3...);


          它的含义是将src1,src2,src3...合并到dest中,返回值为合并后的dest,由此可以看出该方法合并后,是修改了dest的结构的。如果想要得到合并的结果却又不想修改dest的结构,可以如下使用:

    var newSrc=$.extend({},src1,src2,src3...)//也就是将"{}"作为dest参数。


          这样就可以将src1,src2,src3...进行合并,然后将合并结果返回给newSrc了。如下例:

    var result=$.extend({},{name:"Tom",age:21},{name:"Jerry",sex:"Boy"})

          那么合并后的结果

    result={name:"Jerry",age:21,sex:"Boy"}


          也就是说后面的参数如果和前面的参数存在相同的名称,那么后面的会覆盖前面的参数值。

          二、省略dest参数
          上述的extend方法原型中的dest参数是可以省略的,如果省略了,则该方法就只能有一个src参数,而且是将该src合并到调用extend方法的对象中去,如:
       1、$.extend(src)
       该方法就是将src合并到jquery的全局对象中去,如:

    $.extend({
    hello:function(){alert('hello');}
    });


       就是将hello方法合并到jquery的全局对象中。
       2、$.fn.extend(src)
       该方法将src合并到jquery的实例对象中去,如:

    $.fn.extend({
    hello:function(){alert('hello');}
    });

       就是将hello方法合并到jquery的实例对象中。

       下面例举几个常用的扩展实例:

    $.extend({net:{}});

       这是在jquery全局对象中扩展一个net命名空间。

    $.extend($.net,{
    hello:function(){alert('hello');}
    })


        这是将hello方法扩展到之前扩展的Jquery的net命名空间中去。

       三、Jquery的extend方法还有一个重载原型:  

    extend(boolean,dest,src1,src2,src3...)


          第一个参数boolean代表是否进行深度拷贝,其余参数和前面介绍的一致,什么叫深层拷贝,我们看一个例子:

    var result=$.extend( true, {},
    { name: "John", location: {city: "Boston",county:"USA"} },
    { last: "Resig", location: {state: "MA",county:"China"} } );


          我们可以看出src1中嵌套子对象location:{city:"Boston"},src2中也嵌套子对象location:{state:"MA"},第一个深度拷贝参数为true,那么合并后的结果就是: 

    result={name:"John",last:"Resig",
    location:{city:"Boston",state:"MA",county:"China"}}

           也就是说它会将src中的嵌套子对象也进行合并,而如果第一个参数boolean为false,我们看看合并的结果是什么,如下:

    var result=$.extend( false, {},
    { name: "John", location:{city: "Boston",county:"USA"} },
    { last: "Resig", location: {state: "MA",county:"China"} }
    );


         那么合并后的结果就是:

    result={name:"John",last:"Resig",location:{state:"MA",county:"China"}}

    $.Deferred源码结构

     
        /**
        Deferred 委托人对象,对委托人管理
        */
        jQuery.extend({
            /**
            创建一个Deferred对象,"延迟"到未来某个点再执行。我们称之为Deferred,也就是委托人,回调函数就是观察者
            方式:在函数内部,创建一个deferred,为deferred添加一些方法,通过func.call(deferred,deferred)方式把这个deferred对象插入到func函数参数中
            目的:处理耗时操作的问题(回调函数),为了对这些操作更好的控制,提供了统一的编程接口(API)。
            * @param {Function} func    回调函数 (使用call方式,将deferred代入到函数的参数中)
            * @return {Object} deferred 延迟对象        
            */
            Deferred: function (func) {
                /**
                 * 创建一个数据元组集
                 * 每个元组分别包含一些与当前委托人(deferred)相关的信息: 
                 * 
                 Deferred自身则围绕这三个对象进行更高层次的抽象
                        通知(触发回调函数列表执行(函数名))
                        观察者(添加回调函数(函数名))
                        观察者对象(jQuery.Callbacks对象)
                        委托人状态(第三组数据除外)
                 * 总体而言,三个元组会有对应的三个callbacklist对应于doneList, failList, processList
                 * resolve  委托人接到通知,告诉观察者执行“已完成”操作(deferred对象的执行状态从“未完成”变为“已完成”,触发done(侦听器))
                 * reject   委托人接到通知,告诉观察者执行“已拒绝”操作,deferred对象的执行状态,从“未完成”变为“已失败”,触发fail(侦听器)
                 * notify   委托人接到通知,告诉观察者执行“还在进行中,或者未完成”操作
                 * done     成功(回调函数)
                 * fail     失败(回调函数)
                 * progress 未完成
                 * resolved 完成状态
                 * rejected 失败状态
                 */
                var tuples = [
     
                        // action 执行状态, add listener 添加侦听器(事件处理函数),listener list 侦听器列表(事件处理函数列表),final state 最终状态  
                        ["resolve", "done", jQuery.Callbacks("once memory"), "resolved"],
                        ["reject", "fail", jQuery.Callbacks("once memory"), "rejected"],
                        ["notify", "progress", jQuery.Callbacks("memory")]
                ],
                // 委托人三种状态,(deferred的状态)分为三种:pending(挂起状态) resolved(完成状态) rejected(失败状态)  
                    state = "pending",
                    
                    /**
                    * 创建一个promise对象 也就是一个受限制的委托人,只能执行观察者,不能通知观察者
                    * 作用:1.在初始化deferred对象时,promise对象里的方法会被extend到deferred中去,作为引用
                    *       2.保护deferred对象,使其无法改变deferred对象的执行状态,要想改变执行状态,只能操作原来的deferred对象,仅支持done,fail,progress方法
                    */
                    promise = {
                        /**
                        返回委托人状态
                        * return {String} 返回委托人状态(外面只读)
                        */
                        state: function () {
                            return state;
                        },
                        /**
                        不管最后是resolve还是reject,都会触发fn
                        不管委托人发出什么样的通知都会去执行观察者
                        同时在doneList和failList的list里添加回调函数(引用),不管deferred对象的执行状态成功还是失败,回调函数都会被执行 
                        * return {Object} 返回当前委托人                  
                        */
                        always: function () {
                            deferred.done(arguments).fail(arguments);
                            return this;
                        },
                        /**
                        接受三个参数,对应3种状态的回调函数,这三个回调函数,必须返回deferred对象
                        * @param {Function} fnDone 成功的观察者,done()方法的回调函数
                        * @param {Function} fnFail 失败的观察者,fail()方法的回调函数
                        * @param {Function} fnProgress 打酱油的观察者,progress()方法的回调函数   
                        * @return {Object} 返回一个受到限制的委托人
                        */
                        then: function ( /* fnDone, fnFail, fnProgress */) {
                            // 声明一个变量,并把参数引用赋值给funs
                            var fns = arguments;
                            // newDefer 创建一个新的委托人
                            return jQuery.Deferred(function (newDefer) {
                                jQuery.each(tuples, function (i, tuple) {
                                    // i     当前tuples的下标
                                    // tuple 当前tuples[i]的值                                
                                    var action = tuple[0],// 当前委托人状态 tuple[0]对应三种最终状态resolve,reject,notify
                                        fn = jQuery.isFunction(fns[i]) && fns[i];// 当前观察者
    
                                    /**
                                    老版的委托人发出的通知绑定不同的观察者                               
                                    * deferred指老版的委托人
                                    * tuple[1]指[done | fail | progress]
                                    * fn 老版委托人的观察者
                                    * 分别为deferred的三个callbacklist(状态)添加回调函数,根据fn的是否是函数,分为两种情况:
                                    * 1. fn不是函数,(例如:undefined和null),直接链接到newDefer的通知([resolve | reject | notify]方法),也就是说新的委托人newDefer的通知依赖外层调用者(老版委托人)deferred执行的观察者(done,fail,progress)
                                    * 2. fn是函数,根据返回值(ret)是否为委托人deferred对象,分为两种情况:
                                    *    a) 返回值是deferred对象,那么将新委托人newDefer的通知([resolve | reject | notify]方法)添加到ret对象对应的观察者上,也就说newDefer的执行依赖ret的状态
                                    *    b) 返回值不是deferred对象,那么将ret作为newDefer的参数,判断this是否为老版委托人deferred,是则将newDefer作为上下文环境,不是将this作为上下文执行环境,然后执行对应的回调函数列表,Ps:此时newDefer的执行(通知)依赖外层的调用者deferred的状态(观察者)。
                                    */
                                    //相当于deferred.done,deferred.fail,deferred.progess三种状态;
                                    deferred[tuple[1]](function () {
                                        // 执行老版委托人传递的参数(回调函数)
                                        var returned = fn && fn.apply(this, arguments);
                                        if (returned && jQuery.isFunction(returned.promise)) {
                                            returned.promise()
                                                .done(newDefer.resolve)
                                                .fail(newDefer.reject)
                                                .progress(newDefer.notify);
                                        } else {
                                            newDefer[action + "With"](this === promise ? newDefer.promise() : this, fn ? [returned] : arguments);
                                        }
                                    });
                                });
                                // 清空变量,内存回收
                                fns = null;
                            }).promise();//返回一个受到限制的委托人
                        },
    
                        /**
                        为委托人加入一些限制(为deferred添加一个promise方法)       
                        * @param  {Object}  委托人或空值
                        * @return {Object}  假如对象存在,将promise添加到这个对象中,不存在返回promise对象
                        */
                        promise: function (obj) {
                            return obj != null ? jQuery.extend(obj, promise) : promise;
                        }
                    },
                    // 声明变量 创建一个委托人
                    deferred = {};
     
                // 添加一个方法名pipe与then相同,一般使用pipe进行filter操作
                promise.pipe = promise.then;
     
                
                jQuery.each(tuples, function (i, tuple) {
                    //声明一个局部变量,将观察器对象引用给list,3个$.Callback()的实例 
                    var list = tuple[2],
                        stateString = tuple[3]; //委托人的最终状态 resolved,rejected
     
                    // 为观察者对象添加函数(回调函数)
                    // promise[done|fail|progress]=list.add;
                    // 这三个方法分别引用三个不同的观察者对象的add方法,往观察者对象回调函数列表list添加回调函数[done|fail|progress],互不打扰
                    promise[tuple[1]] = list.add;
     
                    /*
                    观察者对象
                    * add  添加回调函数  
                    * fire 调用fireWidth
                    * fireWidth  去执行回调函数
                    */
                    // 检测stateString是否有值,progress没有值,所以预先向[done|fail]添加一些定义好的回调函数
                    // 定义好的回调函数:1.修改委托人的状态;2.禁用相反的观察者对象;3.加锁(挂起)正在进行的观察者对象
                    if (stateString) {
                        list.add(function () {
                            // state = [ resolved | rejected ]
                            // 修改最新的委托人状态
                            state = stateString;
                             //禁用对立的那条队列
                            //注意 0^1 = 1   1^1 = 0
                            //即是成功的时候,把失败那条队列禁用
                            //即是成功的时候,把成功那条队列禁用
                            // [ reject_list | resolve_list ].disable; progress_list.lock
                        }, tuples[i ^ 1][2].disable, tuples[2][2].lock);
                    }
                    // 将委托人的通知和观察者对象的执行回调函数(观察者函数) 联系起来
                    // deferred[ resolve | reject | notify ]
                    deferred[tuple[0]] = function () {
                        deferred[tuple[0] + "With"](this === deferred ? promise : this, arguments);
                        return this;
                    };
                    deferred[tuple[0] + "With"] = list.fireWith;
                });
     
    
                // 为委托人添加一个被限制的委托人对象 (将promise对象extend到deferred中)
                promise.promise(deferred);
     
    
                // 检测func是否存在,存在将生成的委托人对象作为这个函数的默认参数,以及将this指向这个委托人
                if (func) {
                    func.call(deferred, deferred);
                }
     
    
                // 返回委托人对象
                return deferred;
            },
     
            //注意到$.when是多任务的
            //当一个任务失败的时候,代表整个都失败了。
            //任务是Deferred实例,成为异步任务
            //任务是普通function时,成为同步任务
            when: function (subordinate /* , ..., subordinateN */) {
                var i = 0,
                    //arguments是多个任务
                    resolveValues = core_slice.call(arguments),
                    length = resolveValues.length,
                    
                    //还没完成的异步任务数
                    //subordinate && jQuery.isFunction(subordinate.promise)判断subordinate是不是Deferred的实例对象
                    remaining = length !== 1 || (subordinate && jQuery.isFunction(subordinate.promise)) ? length : 0,
     
                     //只有一个异步任务的时候
                    deferred = remaining === 1 ? subordinate : jQuery.Deferred(),
                    
                    //用于更新 成功|处理 中两个状态
                    //这里不考虑失败的状态是因为:
                    //当一个任务失败的时候,代表整个都失败了。
                    updateFunc = function (i, contexts, values) {
                        return function (value) {
                            contexts[i] = this;
                            values[i] = arguments.length > 1 ? core_slice.call(arguments) : value;
                            
                            //处理中,派发正在处理事件
                            if (values === progressValues) {
                                deferred.notifyWith(contexts, values);
                            } else if (!(--remaining)) {
                              //成功,并且最后剩余的异步任务为0了
                              //说明所有任务都成功了,派发成功事件出去
                              //事件包含的上下文是当前任务前边的所有任务的一个集合                        
                                deferred.resolveWith(contexts, values);
                            }
                        };
                    },
     
                    progressValues, progressContexts, resolveContexts;
     
                 //如果只有一个任务,可以不用做维护状态的处理了
                //只有大于1个任务才需要维护任务的状态
                if (length > 1) {
                    progressValues = new Array(length);
                    progressContexts = new Array(length);
                    //事件包含的上下文是当前任务前边的所有任务的一个集合,逐步更新
                    resolveContexts = new Array(length);
                    for (; i < length; i++) {
                        if (resolveValues[i] && jQuery.isFunction(resolveValues[i].promise)) {
                         //如果是异步任务
                            resolveValues[i].promise()
                                 //成功的时候不断更新自己的状态
                                .done(updateFunc(i, resolveContexts, resolveValues))
                                 //当一个任务失败的时候,代表整个都失败了。直接派发一个失败即可
                                .fail(deferred.reject)
                                //正在处理的时候也要不断更新自己的状态
                                .progress(updateFunc(i, progressContexts, progressValues));
                        } else {
                            //如果是同步任务,则remain不应该计它在内
                            --remaining;
                        }
                    }
                }
     
                //传进来的任务都是同步任务
                if (!remaining) {
                    deferred.resolveWith(resolveContexts, resolveValues);
                }
     
                return deferred.promise();
            }
        });
     

     

  • 相关阅读:
    常用字段类型
    触发事件中的sender
    $符号基本用法$() ${} $(())
    expect语法
    apt 和 apt-get的区别
    python字符串中 r'', b'', u'', f'' 的含义
    linux正则表达式
    Linux下apt-get命令详解(安装、卸载、更新、查询软件包)
    创建linux service服务
    Ubuntu下deb包的解包、打包
  • 原文地址:https://www.cnblogs.com/zknublx/p/5981082.html
Copyright © 2011-2022 走看看