seajs 3.0.0 源码阅读笔记

写笔记的时候才注意到我看的源代码是 3.0.0 的,但是官方发布的最新版本是 2.3.0。相信大部分是相同的,所以先把这个记完,再看一次 2.3.0 的代码。

seajs 的源代码可以在 github上获取。seajs 在文档“如何参与开发”中说明了阅读顺序,当然为了便于阅读,在了解了目录结构之后,我直接阅读了合并好的 sea-debug.js

整个seajs采用的是2空格缩进,避免分号的写法,我不是很习惯,但不影响阅读。

文件/目录结构

文档中各个源文件所包含的内容大致如下:

intro.js 
文件头

sea.js 
定义全局 global.seajs 对象和 seajs.data 对象

util-lang.js,语言相关工具 
定义用于判断对象类型的 isXxxxx() 函数,以及一个与语言无关的 cid()

util-events.js 
定义 seajs 的事件处理相关函数,包括 on()off()emit()

util-path.js 
定义用于路径处理的工具函数

util-request.js 
定义请求文件的工具函数 seajs.request() 等

util-deps.js 
定义用于分析依赖关系的 parseDependencies()

module.js 
seajs 的核心,模块类。 
也包含部分 seajs 的方法

config.js 
定义 seajs.config(),以及 data 部分属性的默认值

所以合并之后的整个 seajs 代码看起来就像这样

(function(global, undefiend) {
  global.seajs = {
    data: {}
  }
  var isObject = function() {}
  var isString = function() {}
  var isArray = function() {}
  var isFunction = function() {}
  var cid = function() {}
  data.events = {}
  seajs.on = function() {}
  seajs.off = function() {}
  seajs.emit = function() {}
  // path utils, and
  seajs.resolve = function() {}
  var loaderDir
  var parseDependencies = function() {}
  function Module() {}
  seajs.config = function() {}
})(this);

isXxxx 用于判断对象类型

首先是定义了一个产生 isXxxx 的函数工厂 isType()

function isType(type) {
  return function(obj) {
    return {}.toString.call(obj) == "[object " + type + "]"
  }
}

从这个工厂的代码可以看出来,isXxxx() 主要是通过 Object.prototype.toString 的值来判断对象类型的。

当然也有例外:

// 毕竟 Array.isArray() 是 [native code],效果会高得多
var isArray = Array.isArray || isType("Array")

这里有几件事情我不是很明白:

  1. 就是为什么不使用 typeof 运算符来判断类型,一般语言中运算符实现会比比较字符串快得多。
  2. {}.toString.call(obj) 和 Object.prototype.toString.call(obj) 的作用是一样的,但是在运行时,每执行一次 isXxxx 就会产生一个新的 {} 对象;而 Object.prototype 始终都是同一个对象,似乎可以减少不少开销
  3. jQuery 的 isFunction() 等方法都是通过 jQuery.type() 来实现的,而 jQuery.type 中则是通过定义了一个 class2type 字典对象来做类型映射,
jQuery.each("Boolean Number String Function Array Date RegExp Object Error".split(" "), function(i, name) {
    class2type[ "[object " + name + "]" ] = name.toLowerCase();
});

这种作法也会比每次都拼字符串("[object " + type + "]")来比较要效率高一些吧。

不过 seajs 和 jquery 都没有直接依赖 typeof 运算符来实现 isXxxx,我相信绝对不是偶然,一定有啥原因,不过这个原因我目前就不清楚了,希望玉伯能看到这个博客,稍作解释

事件

seajs 只为全局对象 seajs 添加了事件处理。事件的回调函数链保存在 seajs.data.events 中,以事件名称为 key,Array 对象保存的回调函数链为 value。

因为 seajs 的事件主要为了插件而定义,所以对参数并没有严格的校验。比如

// 自定义一个比较奇葩的事件,这不会报错
seajs.on(null, "fake callback");
// 但是执行就会出错了
seajs.emit("null")
// 输出:TypeError: string is not a function

看样子,插件开发者得自己注意下这个问题了。

看完 seajs 的源码,大概定义了这么一些事件

  1. error,貌似跟 NodeJS 有点关系,没仔细看
  2. load,在模块对象状态变成 LOADING 后触发,参数是所有依赖模块的 URI。
      // Emit `load` event for plugins such as combo plugin
      var uris = mod.resolve()
      emit("load", uris)
  3. exec,在模块对象状态变成 EXECUTED 后触发,参数就是模块对象本身
  4. fetch,在模块对象状态刚变成 FETECHING 时触发,参数是一个临时对象emitData,事件结果保存在 emitData.requestUri,用于后面的 request 请求数据。
      // Emit `fetch` event for plugins such as combo plugin
      var emitData = { uri: uri }
      emit("fetch", emitData)
      var requestUri = emitData.requestUri || uri
  5. request,在 fetch 事件后对 emitData.requestUri || uri 进行了处理之后,通过 seajs.request() 请求数据之前触发,参数是一个临时对象,变量名复用的 emitData。事件处理完成后根据 emitData.requested 的值来判断是否需要调用 seajs.request 请求数据。
      // Emit `request` event for plugins such as text plugin
      emit("request", emitData = {
        uri: uri,
        requestUri: requestUri,
        onRequest: onRequest,
        charset: isFunction(data.charset)
          ? data.charset(requestUri) || ‘utf-8‘
          : data.charset
      })
      if (!emitData.requested) {
        // ...
      }
  6. resolve,在 Module.resolve 中调用 seajs.resolve() 之前触发,参数是一个临时对象 emitData。事件中如果产生了有效的 emitData.uri,则不再调用seajs.resolve()
      // Emit `resolve` event for plugins such as text plugin
      var emitData = { id: id, refUri: refUri }
      emit("resolve", emitData)
      return emitData.uri || seajs.resolve(emitData.id, refUri)
  7. config,在 seajs.config() 中,完成对 config 对象的处理之后触发,参数就是 config 对象。
    seajs.config = function(configData) {
      // ...
      emit("config", configData)
      return seajs
    }

Module 类

Module 类才是 seajs 的重头戏,核心的核心。seajs 作为一个模块加载器,所以模块都是以一个 Module 对象保存在 cachedMods 中的。

var cachedMods = seajs.cache = {}

每个模块都有 8 种状态,它一定是在这 8 种状态之一,而且貌似状态改变还是不可逆的。

var STATUS = Module.STATUS = {
  // 没定义状态值为 0 的状态常量,这是初始状态
  // 1 - The `module.uri` is being fetched
  FETCHING: 1,
  // 2 - The meta data has been saved to cachedMods
  SAVED: 2,
  // 3 - The `module.dependencies` are being loaded
  LOADING: 3,
  // 4 - The module are ready to execute
  LOADED: 4,
  // 5 - The module is being executed
  EXECUTING: 5,
  // 6 - The `module.exports` is available
  EXECUTED: 6,
  // 7 - 404
  ERROR: 7
}

其中 SAVED 状态可以理解为 FETCHED 状态。除了初始状态 0 和错误状态 ERROR: 7 之外,其它 6 个状态都是成对出现的,即 ING 状态和 ED 状态,这三对状态清晰的划分出来三个处理过程:fetch、load、exec,对应于模块对象的 3 个方法:fetch()load()exec()

从代码内容来看,这三个主要过程方法主要功能分别可以用一句话说明:

  • fetch,从 URL 加载模块定义,得到 factory 函数,并将 factory 函数赋值给对应的模块对象(通过 Module.get() 创建或获取);
  • load,fetch 并 load 所有依赖模块,并在保证所有依赖模块都是 LOADED 状态之后,调用入口模块(_entry)的 callback(貌似只有通过 seajs.use() 创建的匿名模块才有 callback
  • exec,在调用这个方法的时候,可以保证所有依赖模块都已经是 LOADED 状态了,所以 exec就只是简单的执行 factory 函数,并返回 exports。factory 只执行一次,然后将 exports 缓存下来。

现在来看看入口函数 seajs.use()、模块定义函数 define()、模块关系过程处理方法 fetch(),load()exec() 的主要调用关系:

// seajs.use 只调用了 Module.use,所以它们的调用关系可以看作等同
seajs.use = Module.use = function() {
  Module.get()
  exec()        // 通过 _entry.callback 调用
  load()
}
define = Module.define = function() {
  Module.save(id, factory)
}
Module.prototype.fetch = function() {
  define()      // 通过 seajs.request() 调用
  load()
}
Module.prototype.load = function() {
  pass()
  fetch()
  // [递归]
  // 结束的条件是 _entry.remain === 1,
  // 即当前是最后一个依赖模块
  // 递归结束时调用 _entry.callback,即调用了 exec
  load()  
}
Module.prototype.exec = function() {
  exec()        // 通过 define 中定义的 factory 函数调用
}
Module.prototype.pass = function() {
  // [递归]
  // 结束条件是把 _entry 传递到最末一层依赖
  // 递归过程通过 _entry.remain 进行了引用记数
  pass()
}

各函数和方法具体处理过程看代码就明白了,因为递归关系有点复杂,还有一些回调关系在里面,所以看起来有点绕,不过还算是看得明白。

http://seajs.org 引用的 seajs 版本是 2.2.1,从这引页面的控制输出 seajs.Modules.prototype 来看,并没有定义 pass() 方法,所以对 _entry 的处理可能会有点不一样,稍后看了 seajs 2.2.3 版本的代码就知道了。

时间: 2024-08-05 06:26:32

seajs 3.0.0 源码阅读笔记的相关文章

CI框架源码阅读笔记3 全局函数Common.php

从本篇开始,将深入CI框架的内部,一步步去探索这个框架的实现.结构和设计. Common.php文件定义了一系列的全局函数(一般来说,全局函数具有最高的加载优先权,因此大多数的框架中BootStrap引导文件都会最先引入全局函数,以便于之后的处理工作). 打开Common.php中,第一行代码就非常诡异: if ( ! defined('BASEPATH')) exit('No direct script access allowed'); 上一篇(CI框架源码阅读笔记2 一切的入口 index

源码阅读笔记 - 1 MSVC2015中的std::sort

大约寒假开始的时候我就已经把std::sort的源码阅读完毕并理解其中的做法了,到了寒假结尾,姑且把它写出来 这是我的第一篇源码阅读笔记,以后会发更多的,包括算法和库实现,源码会按照我自己的代码风格格式化,去掉或者展开用于条件编译或者debug检查的宏,依重要程度重新排序函数,但是不会改变命名方式(虽然MSVC的STL命名实在是我不能接受的那种),对于代码块的解释会在代码块前(上面)用注释标明. template<class _RanIt, class _Diff, class _Pr> in

CI框架源码阅读笔记5 基准测试 BenchMark.php

上一篇博客(CI框架源码阅读笔记4 引导文件CodeIgniter.php)中,我们已经看到:CI中核心流程的核心功能都是由不同的组件来完成的.这些组件类似于一个一个单独的模块,不同的模块完成不同的功能,各模块之间可以相互调用,共同构成了CI的核心骨架. 从本篇开始,将进一步去分析各组件的实现细节,深入CI核心的黑盒内部(研究之后,其实就应该是白盒了,仅仅对于应用来说,它应该算是黑盒),从而更好的去认识.把握这个框架. 按照惯例,在开始之前,我们贴上CI中不完全的核心组件图: 由于BenchMa

CI框架源码阅读笔记2 一切的入口 index.php

上一节(CI框架源码阅读笔记1 - 环境准备.基本术语和框架流程)中,我们提到了CI框架的基本流程,这里这次贴出流程图,以备参考: 作为CI框架的入口文件,源码阅读,自然由此开始.在源码阅读的过程中,我们并不会逐行进行解释,而只解释核心的功能和实现. 1.       设置应用程序环境 define('ENVIRONMENT', 'development'); 这里的development可以是任何你喜欢的环境名称(比如dev,再如test),相对应的,你要在下面的switch case代码块中

CI框架源码阅读笔记4 引导文件CodeIgniter.php

到了这里,终于进入CI框架的核心了.既然是"引导"文件,那么就是对用户的请求.参数等做相应的导向,让用户请求和数据流按照正确的线路各就各位.例如,用户的请求url: http://you.host.com/usr/reg 经过引导文件,实际上会交给Application中的UsrController控制器的reg方法去处理. 这之中,CodeIgniter.php做了哪些工作?我们一步步来看. 1.    导入预定义常量.框架环境初始化 之前的一篇博客(CI框架源码阅读笔记2 一切的入

IOS测试框架之:athrun的InstrumentDriver源码阅读笔记

athrun的InstrumentDriver源码阅读笔记 作者:唯一 athrun是淘宝的开源测试项目,InstrumentDriver是ios端的实现,之前在公司项目中用过这个框架,没有深入了解,现在回来记录下. 官方介绍:http://code.taobao.org/p/athrun/wiki/instrumentDriver/ 优点:这个框架是对UIAutomation的java实现,在代码提示.用例维护方面比UIAutomation强多了,借junit4的光,我们可以通过junit4的

jdk源码阅读笔记之java集合框架(二)(ArrayList)

关于ArrayList的分析,会从且仅从其添加(add)与删除(remove)方法入手. ArrayList类定义: p.p1 { margin: 0.0px 0.0px 0.0px 0.0px; font: 18.0px Monaco } span.s1 { color: #931a68 } public class ArrayList<E> extends AbstractList<E> implements List<E> ArrayList基本属性: /** *

Yii源码阅读笔记 - 日志组件

?使用 Yii框架为开发者提供两个静态方法进行日志记录: Yii::log($message, $level, $category);Yii::trace($message, $category); 两者的区别在于后者依赖于应用开启调试模式,即定义常量YII_DEBUG: defined('YII_DEBUG') or define('YII_DEBUG', true); Yii::log方法的调用需要指定message的level和category.category是格式为“xxx.yyy.z

Spark源码阅读笔记之Broadcast(一)

Spark源码阅读笔记之Broadcast(一) Spark会序列化在各个任务上使用到的变量,然后传递到Executor中,由于Executor中得到的只是变量的拷贝,因此对变量的改变只在该Executor有效.序列化后的任务的大小是有限制的(由spark.akka.frameSize决定,值为其减去200K,默认为10M-200K),spark会进行检查,超出该限制的任务会被抛弃.因此,对于需要共享比较大的数据时,需要使用Broadcast. Spark实现了两种传输Broadcast的机制:

Apache Storm源码阅读笔记

欢迎转载,转载请注明出处. 楔子 自从建了Spark交流的QQ群之后,热情加入的同学不少,大家不仅对Spark很热衷对于Storm也是充满好奇.大家都提到一个问题就是有关storm内部实现机理的资料比较少,理解起来非常费劲. 尽管自己也陆续对storm的源码走读发表了一些博文,当时写的时候比较匆忙,有时候衔接的不是太好,此番做了一些整理,主要是针对TridentTopology部分,修改过的内容采用pdf格式发布,方便打印. 文章中有些内容的理解得益于徐明明和fxjwind两位的指点,非常感谢.