使用RequireJS并实现一个自己的模块加载器 (一)

RequireJS & SeaJS

在 模块化开发 开发以前，都是直接在页面上引入 script 标签来引用脚本的，当项目变得比较复杂，就会带来很多问题。

JS项目中的依赖只有通过引入JS的顺序来确定，项目会变得复杂难以维护。
复杂的脚本会暴露很多全局变量，比如 $,_. ... 。
同步加载的时候，网页会停止渲染，加载时间越长，网页失去响应的事件就越长。

于是，AMD 规范就诞生了，AMD 即为异步模块定义，有效避免同步加载导致页面的假死现象。RequireJS 是一个 AMD 的实现，后来还有CMD规范，玉伯的而SeaJS 是 CMD 的一个实现，两者最大的区别就是

RequireJS 是预加载，而sea.js 是懒加载，也就是按需加载

什么意思？？

比如下面的代码

define(function(require,exports,module){

    // do something

    var mod1 = require('./mod1');

    // do something

    var mod2 = require('./mod2');

})

RequireJS 会全部找到这个模块的依赖，并在开始执行是就加载全部的依赖，

而SeaJS 则是按需加载，直到遇到 require 才会加载。

RequireJS 内部通过 Function.prototype.toString() ，然后使用正则匹配所有的require 方法，将其转化为

define(['./mod1',./mod2']function(mod1,mod2)

这种方式。

有很多关于这两种方式的争吵，由于我没有做过较大的项目，所以对于这两种方式在正真项目中使用的区别也不清楚。

回顾 RequireJS

主要接口有两个： require & define,define 是模块的定义方法，require 是模块的使用方法。

define 的参数为 define (id?,deps?,factory)。第一个为模块ID，第2个为依赖列表，第三个是工厂方法。如果不定义ID，则为匿名方法，通常情况，模块ID 等于模块在工程的路径。deps 和 factory 有约定，deps 数组有多少个元素，factory 就会有多少个形参，形参对于与依赖模块工厂函数执行后的返回值。

define ("id",["mod1","mod2"],function(mod1,mod2){

    return {

        ///

    };

})

require 方法和 define 基本一致。

文件目录

└─ use-require/

   ├─ app/

   │  ├─ js/

   │  │  ├─ module/

   │  │  │  ├─ a.js

   │  │  │  └─ b.js

   │  │  ├─ main.js

   │  └─ lib/

   │  │  └─ require.js

   ├─ index.html

   └─ readme.md

现在,需要在 index.html 引导整个程序。

<!DOCTYPE html>

<html lang="en">

<head>

    <meta charset="UTF-8">

    <title>Document</title>

</head>

<body>

     <script src="./app/lib/require.js" data-main="./app/js/main">

    </script>

</body>

</html>

引入 requirejs，并通过 data-main 申明启动 js 文件。

注意： data-main 指向的文件所在路径就是 baseUrl，在这里就是app/js ,

baseUrl 也可以通过require.config 设置。如果没有通过 data-main 属性指定 baseUrl ，也没有通过config的方式显示声明 baseUrl ，那么 baseUrl 默认为加载requirejs的那个页面所在的路径

下面 b 依赖 a ，那么就应该写 module/a,而 main 依赖 b ，写为 module/b ，这个路径会和 baseUrl 拼接，与a ，b 所在的路径无关。有时候，你可能需要生成一个相对于模块的URL地址。你可以将require作为一个依赖注入进来，然后调用require.toUrl()以生成该URL 。
define(["require"], function(require) {

var url = require.toUrl("./style.js");

});

有时候你想避开"baseUrl + paths"的解析过程，而是直接指定加载某一个目录下的脚本。此时可以这样做：如果一个module ID符合下述规则之一，其ID解析会避开常规的"baseUrl + paths"配置，而是直接将其加载为一个相对于当前HTML文档的脚本：

注意是相对于 HTML 文档，因为 js脚本是会被插入到 html 文档中执行的。

以 ".js" 结束。
以 "/" 开始。
包含 URL 协议, 如 "http:" or "https:"。

一般来说，最好还是使用baseUrl及"paths" config去设置module ID。它会给你带来额外的灵活性，如便于脚本的重命名、重定位等。同时，为了避免凌乱的配置，最好不要使用多级嵌套的目录层次来组织代码，而是要么将所有的脚本都放置到baseUrl中，要么分置为项目库/第三方库的一个扁平结构，如下：

└─ project/

   ├─ js/

   │  ├─ app/

   │  │  └─ sub.js

   │  ├─ lib/

   │  │  ├─ jquery.js

   │  │  └─ require.js

   │  └─ app.js

   ├─ index.html

   └─ readme.md

下面自然就顺利成章

申明模块a

define(function() {

    'use strict';

    return {

        name: "hello , i am a"

    }

})

模块 b

define(["module/a"], function(a) {

  'use strict';

    var aName = a.name;

    var name = "hello i am b";

    return {

        sayHello: function() {

            console.log(name + "  my brother is " + aName);

        }

    }

})

在模块b 里面依赖模块a 。

main.js

require(["module/b"], function(b) {

  'use strict';

    b.sayHello();

})

看看效果

如果使用 require.config() 配置呢？

将上面的目录复制一份，命名 use-require-config，目录结构完全一致

main.js

requirejs.config({

    baseUrl: './app/js/module'

})

require([".b"], function(b) {

    'use strict';

    b.sayHello();

})

在这里，将配置放在 main.js 里面,等会儿会讲如果不放在它里面会又什么问题。

模块 b 依赖于 a

define(["./a"], function(a) {

    'use strict';

    var aName = a.name;

    var name = "hello i am b";

    return {

        sayHello: function() {

            console.log(name + "  my brother is " + aName);

        }

    }

})

由于将baseUrl 设置为 app/js/module ，所以这里依赖a 就可以直接写a

在这里，我使用 ./a, 与直接写 a 一模一样，还是使用 baseUrl+ moduleName `来寻找模块路径。

如果不将 requirejs.config 放在main中，而是另外在引入一个script 节点来放置呢

<body>

    <script src="./app/lib/require.js" data-main="./app/js/main">

    </script>

    <script>

        requirejs.config({

           baseUrl: './app/js/module'

        })

    </script>

</body>

在浏览器运行

发现报错了，怎么回事呢？

看它寻找 main.js 的路径

file:///E:/HFLib/module/code/use-require-config/app/js/module/main.js

是 baseUrl + main.js。这说明，配置的 baseUrl 覆盖了为 data-main 配置的路径

也就是说，一旦使用requirejs.config 来配置 baseUrl，那么所有的路径都会以 baseUrl 为基准。

所以，data-main 应改为: ..\main,注意这里必须要使用反斜杠，正斜杠拼接总是会出现问题。

通过这样就可以解决 data-main 和 requirejs.config() 的冲突了。

paths 和 shim 。

当模块名过长是，require.js 为我们提供了路径 paths 的方式。

理想状况下，每个加载的脚本都是通过define()来定义的一个模块；但有些"浏览器全局变量注入"型的传统/遗留库并没有使用define()来定义它们的依赖关系，你必须为此使用shim config来指明它们的依赖关系。

这是我的文件目录

index.html

<body>

    <script src="./app/lib/require.js" data-main="./app/main">

    </script>

</body>

main.js

requirejs.config({

    paths: {

        jQuery: 'lib/jQuery'

    },

    shim: {

        'jQuery': {

            exports: '$'

        }

    }

})

require(['jQuery'], function($) {

    'use strict';

    console.log($);

})

可以看到，已经顺利注入了 jQuery 依赖。

require.js 中还有很多配置和用法，我用的就比较少，就简单介绍到这里。

下来，我要实现一个简化的模块加载器，类似于 require.js.

实现一个自己的模块加载器

太晚了。

就在实现一个自己的模块加载器（二）中实现一个类似 require.js 的Demo 吧。