nodeJS 입문 예 1 - 모듈 (Modules)

var circle = require('./circle.js');
console.log( 'The area of a circle of radius 4 is '
           + circle.area(4));

var PI = Math.PI;

exports.area = function (r) {
  return PI * r * r;
};

exports.circumference = function (r) {
  return 2 * PI * r;
};

console.log('a starting');
exports.done = false;
var b = require('./b.js');
console.log('in a, b.done = %j', b.done);
exports.done = true;
console.log('a done');

console.log('b starting');
exports.done = false;
var a = require('./a.js');
console.log('in b, a.done = %j', a.done);
exports.done = true;
console.log('b done');

console.log('main starting');
var a = require('./a.js');
var b = require('./b.js');
console.log('in main, a.done=%j, b.done=%j', a.done, b.done);  main.js  a.js ，a.js  b.js，  b.js    a.js。                 b.js a.js     。 b.js    ，           a.js   

$ node main.js
main starting
a starting
b starting
in b, a.done = false
b done
in a, b.done = true
a done
in main, a.done=true, b.done=true                ，         。 

Core Modules （核心模块）

Node有几个编译成二进制的模块。这些模块在NODE文档中有详尽的描述。

核心模块的定义在node的源码文件夹lib/文件夹中。

如果require（）鉴定通过，核心模块将优先加载。例如，require("http")将总是返回建立的http模块，即使有一个文件的名字。

File Modules （文件模块）

如果执行的文件名没有找到，node将尝试加载请求后缀为.js、.json和.node    文件名相同的文件。.js文件解析成JavaScript的文本文件，

.json文件解析成JSON文本文件，.node文件解析成用dlopen加载的编译的附加模块

模块前缀为“./”是一个调用require()加载的文件的相对路径。也就是说，用require('./circle')加载时找到此文件，circle.js必须要和foo.js在同一目录下面。

没有'/'或者'./'前缀表示文件时，模块是核心模块或者是从node_modules文件夹里加载。

从`node_modules`文件夹中加载

如果通过require()标识模块不是本地模块，并且没有以'/'、'../'或者'./'开头，node从当前模块的父目录开始，添加/node_modules，并尝试从本地加载模块。

如果没有在这里找到，将会从父文件夹查找，直到达到最顶层文件夹。

例如，如果 '/home/ry/projects/foo.js'调用require('bar.js')，node将以以下本地路径查找，顺序如下：

• /home/ry/projects/node_modules/bar.js
• /home/ry/node_modules/bar.js
• /home/node_modules/bar.js
• /node_modules/bar.js

这允许程序设置依赖的本地化，所以不会引起冲突。

文件夹作为模块（Folders as Modules ）

这非常方便地组织程序和libraries    到一个独立的目录下，并且对library提供一个简单的入口点。在某个文件夹有三种方式作为参数传递给require()。

第一种在文件夹的根路径下（在main 模块中申明描述的）创建一个package.json文件。一个package.json文件的例子如下：

{ "name" : "some-library",
  "main" : "./lib/some-library.js" }      ./some-library     ，require('./some-library')     。./some-library/lib/some-library.js。   package.json   Node    。         package.json  ，node           index.js  index.node  。  ：      package.json  ，    require('./some-library')      

var EventEmitter = require('events').EventEmitter;

module.exports = new EventEmitter();

//              'ready'  。
setTimeout(function() {
  module.exports.emit('ready');
}, 1000);         ，     ： 

var a = require('./a');
a.on('ready', function() {
  console.log('module a is ready');
});     module.exports      。            。       ： 

setTimeout(function() {
  module.exports = { a: "hello" };
}, 0);

var x = require('./x');
console.log(x.a);

   Y       X
1、  X     
   a.      。
   b.  

2、  X './'    '/'    '../'  。
   a.      （LOAD_AS_FILE(Y + X)） 
   b.      （LOAD_AS_DIRECTORY(Y + X)）
3、      （LOAD_NODE_MODULE(X, dirname(Y))）
4、       "not found"。


       LOAD_AS_FILE(X) 1、  X     ， JavaScript    X。   2、  X.js     ， JavaScript    X。
3、  X.node     ，        X.node。  


        LOAD_AS_DIRECTORY(X) 1、  X/package.json     ， a.  X/package.json，      ('main' field) b.   M = X + json  (json main field) c.     M 2、  X/index.js     ，   JavaScript    X/inde.js。  。 3、  X/index.node     ，           ，  。 

       LOAD_NODE_MODULES(X, START) 1、  DIRS = NODE_MODULES_PATHS(START)。 2、           a.    (DIR/X) LOAD_AS_FILE(DIR/X) b.    (DIR/X) LOAD_DIRECTORY(DIR/X)  NODE_MODULES_PATHS(START) 1、  PARTS = path split(START) 2、  ROOT = PARTS ‘node_modules’         。
3、  I = PARTS - 1
4、  DIRS = []
5、while I > ROOT
a.   PARTS[I] = "node_modules" CONTINUE
c.DIR = （PARTS[0...I]+ 'node_modules'     ）
b.DIRS = DIRS + DIR
c.  I = I - 1 1. let PARTS = path split(START)
6、  DIRS