读RequireJS — Module

Module 即模块,来看下RequireJS怎么定义 Module :

1. 简单的名值对

// Inside file my/shirt.js:
define({
    color: "black",
    size: "unisize"
});

2. 定义成一个Function

// my/shirt.js now does setup work
// before returning its module definition.
define(function () {
    // Do setup work here

    return {
        color: "black",
        size: "unisize"
    }
});

3. 如果 Module 需要依赖别的模块,可以写成这样:

// my/shirt.js now has some dependencies, a cart and inventory
// module in the same directory as shirt.js
define(["./cart", "./inventory"], function(cart, inventory) {
        // return an object to define the "my/shirt" module.
        return {
            color: "blue",
            size: "large",
            addToCart: function() {
                inventory.decrement(this);
                cart.add(this);
            }
        }
    }
);

4. 隐式依赖Function

define(function(require) {
    var mod = require("./relative/name");
});

  


上面这四种比较常用,RequireJS 中的 Module 还有其他的形式,具体可参阅官方文档。

上面四种方式都用到了define(),接下来我们就来看下define的源码:

/**
 * The function that handles definitions of modules. Differs from
 * require() in that a string for the module should be the first argument,
 * and the function to execute after dependencies are loaded should
 * return a value to define the module corresponding to the first argument's
 * name.
 */
define = function (name, deps, callback) {
    var node, context;

    // 可以是匿名模块
    if (typeof name !== 'string') {
        // 调整参数
        callback = deps;
        deps = name;
        name = null;
    }

    // 如果模块没有依赖
    if (!isArray(deps)) {
        callback = deps;
        deps = [];
    }

    // 如果是一个没有传入依赖的Function,即例4所示
    if (!deps.length && isFunction(callback)) {
        // 通过 callback.toString() 找依赖
        // 为了避免 require(xx) 写在注释中
        // 这里先把注释都去掉,再把require的东东加入deps数组
        // 
        // 很变态的一点就是如果callback里写了require
        // 则 callback 必须有形参,不然会被无视
        if (callback.length) {
            callback
                .toString()
                .replace(commentRegExp, "")
                .replace(cjsRequireRegExp, function (match, dep) {
                    deps.push(dep);
                });

            //May be a CommonJS thing even without require calls, but still
            //could use exports, and module. Avoid doing exports and module
            //work though if it just needs require.
            //REQUIRES the function to expect the CommonJS variables in the
            //order listed below.
            // 可能某些模块即使没有调用require,但却仍然要用到exports和module
            // 如果模块仅仅需要require,就应该避免exports和module的开销
            // 注意:依赖的顺序应该确保像下面这样
            //
            // 这里我把中英文都给出了,因为对于这句我一直很疑惑
            // 1个形参 需要 require
            // 大于1个形参 需要 require exports module
            // 1和非1有那么大差别么,请高手指点一下,这句实在很无解
            deps = (callback.length === 1 ? ["require"] : ["require", "exports", "module"]).concat(deps);
        }
    }

    // 应用场景:IE6-8,并且是定义一个匿名模块
    // 个人觉得这个判断没有意义,请看下面的注释
    if (useInteractive) {
        node = currentlyAddingScript || getInteractiveScript();
        if (node) {
            if (!name) {
                name = node.getAttribute("data-requiremodule");
            }
            context = contexts[node.getAttribute("data-requirecontext")];
        }
    }

    // 真正定义模块的操作放到script onload函数中执行,有两个好处:
    // 1.如果一个文件定义了多个模块,这样可以防止过早的分析依赖, 而是等拿到所有依赖之后, 统一进行处理
    // 2.如果是定义匿名模块, define执行中我们是不知道 moduleName的, 但在onload函数中却可以知道
    //
    // 这里有个问题,即下面这行代码表示有context就加入context.defQueue,没有就加入globalDefQueue
    // 很明显,context有值的情况仅在IE6-8会出现,
    // 而在onload时,会把globalDefQueue里的东西全部加入context.defQueue,所以加入谁无所谓
    // 而且在onload函数中所有浏览器都可以拿到moduleName,所以下面这句和上面那个if判断都失去意义了
    // 可以写成 globalDefQueue.push([name, deps, callback]);
    (context ? context.defQueue : globalDefQueue).push([name, deps, callback]);

    return undefined;
};

define() 有三个参数,不传 name 参数表示为匿名模块,匿名只是写法上的匿名,RequireJS 可以通过文件路径确定 moduleName,所以最好别传 name 参数,这样文件目录即使有变动,也不会影响模块的正常使用。

 

这里 callback 参数命名很不好,一般都会叫做factory,取名 callback 完全不知所云。
 

所谓的 define 是干嘛的呢 ?

这个函数用于定义模块,可具名,也可匿名,可有依赖,也可无依赖,factory可以是一个function,也可以是一个object,define 就是为当前的模块绑定一个 factory,当我们要用这个模块的时候,再通过 factory 把它造出来。当然,factory是个object,就不需要再造了。


可以看到模块不是单独存在的,一般都会依赖别的模块,我们知道,在web开发中, 如果要加载一个资源,都需要在回调函数中进行处理,因为加载是异步的。

而 CommonJS 想实现同步加载的概念,所以每次加载一个模块,会首先把依赖分析出来,加载完依赖之后,再去执行factory,这样倒也算是一种模拟同步了。

posted @ 2011-12-31 21:03  越己  阅读(2118)  评论(3编辑  收藏  举报