dojo/request模块整体架构解析

本文涉及的产品
全局流量管理 GTM,标准版 1个月
云解析 DNS,旗舰版 1个月
公共DNS(含HTTPDNS解析),每月1000万次HTTP解析
简介:

 总体说明

  做前端当然少不了ajax的使用,使用dojo的童鞋都知道dojo是基于模块化管理的前端框架,其中对ajax的处理位于dojo/request模块。一般情况下我们使用ajax请求只需要引入dojo/request模块,然后按照文档的说明制定参数即可。实际上dojo在这一模块的处理中抽象了很多概念:

  • 平台侦探器:dojo/request/default
  • 请求分发器:dojo/request/registry
  • 全局通知器:dojo/request/notify
  • 数据传输器:dojo/request/xhr dojo/request/script dojo/request/iframe dojo/request/node
  • 数据转化器:dojo/request/handlers

  处理器的总体关系如下图所示:

  

  正是这些概念使得dojo在ajax请求上能够提供强大的扩展性和简捷的接口。

 

  Provider

  请求传输器被称为Provider,dojo框架自身提供了以下4个provider

  • dojo/request/xhr 提供跨浏览器的XMLHttpRequest,在浏览器端它被作为默认的provider
  • dojo/request/node 用于node平台的异步请求,在node下呗当做默认的provider。dojo是可以运行在node平台下的,当然需要做一些配置,这是另一篇文章的主要内容
  • dojo/request/iframe 不刷新浏览器传输form表单,在文件上传时经常用到
  • dojo/request/script 常以jsonp方式来进行跨域请求

  所有dojo自带的Provider返回一个promise对象,其中有一个不在标准规范内的属性:response。该属性是一个标准promise对象,该对象将一个代表服务器端响应结果的对象作为fulfill状态的值。这个对象有以下几个属性:

  关于这几个Provider的详细讲解请继续关注下一篇文章

  

  default

  一般情况下我们发送ajax请求时只需引入dojo/request即可,实际上这是在default中根据不同的运行平台自动给我们提供了一个默认的provider。


define([
    'exports',
    'require',
    '../has'
], function(exports, require, has){
    //读取dojoConfig中的配置信息
    var defId = has('config-requestProvider'),
        platformId;
    
    //根据不同平台选择不同的provider
    if(has('host-browser') || has('host-webworker')){
        platformId = './xhr';
    }else if(has('host-node')){
        platformId = './node';
    /* TODO:
    }else if(has('host-rhino')){
        platformId = './rhino';
   */
    }

    if(!defId){
        defId = platformId;
    }

    exports.getPlatformDefaultId = function(){
        return platformId;
    };
    //作为插件使用,是跟参数选择provider
    exports.load = function(id, parentRequire, loaded, config){
        require([id == 'platform' ? platformId : defId], function(provider){
            loaded(provider);
        });
    };
});

  代码中关于exports跟require模块的说明请看我的上一篇博客:require、module、exports dojo中的三个特殊模块标识

  上述内容关于load的函数的出现,意味着该模块可以作为“插件”使用。dojo插件主要用于加载一些非AMD的资源,比如css、html。dojo中常用的插件有5个:

  • dojo/domReady 
  • dojo/text 用于加载静态资源文件
  • dojo/i18n 加载国际化语言文件
  • dojo/has 用于特性检测
  • dojo/require

  当在define或require中一个模块引用包含一个!,dojo的加载器会自动将这个模块引用字符串在!处分开,左边部分作为一个模块引用对待,右边部分,等待左边模块加载完毕后交由模块的load方法处理;


exports.load = function(id, parentRequire, loaded, config){
        require([id == 'platform' ? platformId : defId], function(provider){
            loaded(provider);
        });
    };

  关于load函数的几个参数:

  • id:代表!右侧部分
  • parentRequire:上下文智能的require请求器
  • loaded:id模块加载完毕后的回调
  • config:猜测是dojo/_base/config

  后三个参数是dojo自己来处理,一般情况下我们不需要关心。

  关于插件还要在说几句:
  dojo中不会像缓存module一样缓存插件所加载的资源比如:我们可以多次引用同一个module,但是这个module只会加载一次,这是AMD规范所强制规定的。但是我如果多次dojo/text!./template.html这个template.html会被加载多次。

  

  notify

  notify是全局的ajax事件通知器,负责全局范围内的ajax事件监听,有类似于jquery中ajaxStart、ajaxComplete的事件。


define(['../Evented', '../_base/lang', './util'], function(Evented, lang, util){
    // module:
    //        dojo/request/notify
    // summary:
    //        Global notification API for dojo/request. Notifications will
    //        only be emitted if this module is required.
    //
    //        | require('dojo/request', 'dojo/request/notify',
    //        |     function(request, notify){
    //        |         notify('load', function(response){
    //        |             if(response.url === 'someUrl.html'){
    //        |                 console.log('Loaded!');
    //        |             }
    //        |         });
    //        |         request.get('someUrl.html');
    //        |     }
    //        | );

    var pubCount = 0,
        slice = [].slice;
    //实例化dojo/Evented对象,负责分发事件
    var hub = lang.mixin(new Evented, {
        onsend: function(data){
            if(!pubCount){
                this.emit('start');
            }
            pubCount++;
        },
        _onload: function(data){
            this.emit('done', data);
        },
        _onerror: function(data){
            this.emit('done', data);
        },
        _ondone: function(data){
            if(--pubCount <= 0){
                pubCount = 0;
                this.emit('stop');
            }
        },
        emit: function(type, event){
            var result = Evented.prototype.emit.apply(this, arguments);

            // After all event handlers have run, run _on* handler
            //运行完标准事件处理函数后,再来运行本身的私有函数。
            //load和error事件处理完后触发done事件
            //done事件处理完毕后,再来运行本身的_ondone函数,然后触发stop事件
            if(this['_on' + type]){
                this['_on' + type].apply(this, slice.call(arguments, 1));
            }
            return result;
        }
    });

    function notify(type, listener){
        // summary:
        //        Register a listener to be notified when an event
        //        in dojo/request happens.
        // type: String?
        //        The event to listen for. Events emitted: "start", "send",
        //        "load", "error", "done", "stop".
        // listener: Function?
        //        A callback to be run when an event happens.
        // returns:
        //        A signal object that can be used to cancel the listener.
        //        If remove() is called on this signal object, it will
        //        stop the listener from being executed.
        return hub.on(type, listener);
    }
    notify.emit = function(type, event, cancel){
        return hub.emit(type, event, cancel);
    };

    // Attach notify to dojo/request/util to avoid
    // try{ require('./notify'); }catch(e){}
    return util.notify = notify;
});

  最后的一句:util.notify= notify; util将notify与provider关联起来。

 

  registry

  该模块可以在不同的情况下使用不同的provider;匹配的条件可以是正则表达式、字符串或者函数。通过registry可以根据不同的条件注册不同的provider。


require(["dojo/request/registry", "dojo/Deferred"], function(request, Deferred){
  request.register("crossdomain/ie", xdrProvider);

  var xdrProvider = function(url, options){
    var def = new Deferred();
    xdr = new XDomainRequest();
    if (xdr) {
      xdr.onerror = function(){
        def.reject('error');
      };
      xdr.ontimeout = function(){
        def.reject('timeout');
      };
      xdr.onprogress = function(){
        def.progress('progress');
      };
      xdr.onload = function(res){
        def.resolve(res);
      };
      xdr.timeout = 6000;
      xdr.open(options.method, url);
      xdr.send(serilize(options.data));
    } else {
        def.reject("Failed to create");
    }
    
    return def;
  }
  
  request.get("crossdomain/ie/getData", {
    method: "get",
    data:{id:'ie9'}
  }).then(function(text){
    // Do something with the response
  });

});

  以下便是registry的源码:


define([
    'require',
    '../_base/array',
    './default!platform',//想想notify中的load函数
    './util'
], function(require, array, fallbackProvider, util){
    var providers = [];

    function request(url, options){
        var matchers = providers.slice(0),//作用类似clone
            i = 0,
            matcher;

        while(matcher=matchers[i++]){
            if(matcher(url, options)){//匹配provider
                return matcher.request.call(null, url, options);
            }
        }
        //fallbackProvider由default根据不同平台注入默认的provider
        return fallbackProvider.apply(null, arguments);
    }

    function createMatcher(match, provider){
        var matcher;

        if(provider){
            if(match.test){
                // RegExp
                matcher = function(url){
                    return match.test(url);
                };
            }else if(match.apply && match.call){
                matcher = function(){
                    return match.apply(null, arguments);
                };
            }else{
                matcher = function(url){
                    return url === match;
                };
            }

            matcher.request = provider;
        }else{
            // If only one argument was passed, assume it is a provider function
            // to apply unconditionally to all URLs
            matcher = function(){
                return true;
            };

            matcher.request = match;
        }

        return matcher;
    }

    request.register = function(url, provider, first){
        var matcher = createMatcher(url, provider);
        providers[(first ? 'unshift' : 'push')](matcher);

        return {
            remove: function(){
                var idx;
                if(~(idx = array.indexOf(providers, matcher))){
                    providers.splice(idx, 1);
                }
            }
        };
    };
    //这里意味着registry也可以使用插件的写法,作用是替换一个默认的provider
    request.load = function(id, parentRequire, loaded, config){
        if(id){
            // if there's an id, load and set the fallback provider
            require([id], function(fallback){
                fallbackProvider = fallback;//js中的词法作用域,load中永远能够访问到fallbackProvider变量。
                loaded(request);
            });
        }else{
            loaded(request);
        }
    };

    util.addCommonMethods(request);

    return request;
});


  handlers

  XMLHttpRequest对象请求成功后返回的数据格式只有text跟xml两种,handlers根据request中指定的handleAs参数将请求成功后的数据转化为指定类型。与jquery中的类型转化器作用类似。

  dojo中提供了以下三种数据转化器:

  

  此外,handlers有跟registry类似的register方法,可以让我们自定义数据转化器。


require(["dojo/request/handlers", "dojo/request", "dojo/dom", "dojo/dom-construct", "dojo/json",
    "dojo/on", "dojo/domReady!"],
function(handlers, request, dom, domConst, JSON, on){
  handlers.register("custom", function(response){
    var data = JSON.parse(response.text);
    data.hello += "!";
    return data;
  });

  on(dom.byId("startButton"), "click", function(){
    domConst.place("<p>Requesting...</p>", "output");
    request("./helloworld.json", {
      handleAs: "custom"
    }).then(function(data){
      domConst.place("<p>data: <code>" + JSON.stringify(data) + "</code>", "output");
    });
  });
});

  如果您看完本篇文章感觉不错,请点击一下下方的推荐来支持一下博主,谢谢!


目录
相关文章
|
3天前
|
安全 Android开发 iOS开发
深入解析:安卓与iOS的系统架构及其对应用开发的影响
本文旨在探讨安卓与iOS两大主流操作系统的架构差异,并分析这些差异如何影响应用开发的策略和实践。通过对比两者的设计哲学、安全机制、开发环境及性能优化等方面,本文揭示了各自的特点和优势,为开发者在选择平台和制定开发计划时提供参考依据。
|
5天前
|
测试技术 数据库 Android开发
深入解析Android架构组件——Jetpack的使用与实践
本文旨在探讨谷歌推出的Android架构组件——Jetpack,在现代Android开发中的应用。Jetpack作为一系列库和工具的集合,旨在帮助开发者更轻松地编写出健壮、可维护且性能优异的应用。通过详细解析各个组件如Lifecycle、ViewModel、LiveData等,我们将了解其原理和使用场景,并结合实例展示如何在实际项目中应用这些组件,提升开发效率和应用质量。
|
2天前
|
前端开发 Python
解析数据的Beautiful Soup 模块(二)
解析数据的Beautiful Soup 模块(二)
11 1
|
13天前
|
物联网 5G SDN
5G 网络架构全解析:RAN、核心网和接入网
5G 网络架构全解析:RAN、核心网和接入网
50 8
|
2天前
|
运维 负载均衡 安全
深度解析:Python Web前后端分离架构中WebSocket的选型与实现策略
深度解析:Python Web前后端分离架构中WebSocket的选型与实现策略
10 0
|
2天前
|
JSON API 开发者
深入解析Python网络编程与Web开发:urllib、requests和http模块的功能、用法及在构建现代网络应用中的关键作用
深入解析Python网络编程与Web开发:urllib、requests和http模块的功能、用法及在构建现代网络应用中的关键作用
6 0
|
2天前
|
XML 数据格式 开发者
解析数据的Beautiful Soup 模块(一)
解析数据的Beautiful Soup 模块(一)
18 0
|
2月前
|
监控 网络协议 Java
Tomcat源码解析】整体架构组成及核心组件
Tomcat,原名Catalina,是一款优雅轻盈的Web服务器,自4.x版本起扩展了JSP、EL等功能,超越了单纯的Servlet容器范畴。Servlet是Sun公司为Java编程Web应用制定的规范,Tomcat作为Servlet容器,负责构建Request与Response对象,并执行业务逻辑。
Tomcat源码解析】整体架构组成及核心组件
|
2月前
|
存储 NoSQL Redis
redis 6源码解析之 object
redis 6源码解析之 object
60 6
|
27天前
|
存储 缓存 Java
什么是线程池?从底层源码入手,深度解析线程池的工作原理
本文从底层源码入手,深度解析ThreadPoolExecutor底层源码,包括其核心字段、内部类和重要方法,另外对Executors工具类下的四种自带线程池源码进行解释。 阅读本文后,可以对线程池的工作原理、七大参数、生命周期、拒绝策略等内容拥有更深入的认识。
什么是线程池?从底层源码入手,深度解析线程池的工作原理

热门文章

最新文章

推荐镜像

更多