node.js整理 01代码的组织和部署

模块

require(函数)

• 用于在当前模块中加载和使用别的模块，传入一个模块名，返回一个模块导出对象。
• 模块名可以使用相对路径（以./开头），或者是绝对路径（以/或C:之类的盘符开头；注意单个模块名默认指向node_modules文件）。
• 模块名中的.js扩展名能够省略。
• 能够加载和使用一个JSON文件。

exports(对象)

• 当前模块的导出对象，用于导出模块公有方法和属性。
• 别的模块经过require函数使用当前模块时获得的就是当前模块的exports对象。

module(对象)

• 经过module对象能够访问到当前模块的一些相关信息，但最多的用途是替换当前模块的导出对象。
• 如将模块导出对象改为一个函数

module.exports = function () {
    console.log('Hello World!');
};

模块初始化

• NodeJS使用CMD模块系统
• 一个模块中的JS代码仅在模块第一次被使用时执行一次，并在执行过程当中初始化模块的导出对象。以后，缓存起来的导出对象被重复利用。

var counter1 = require('./util/counter');
var  counter2 = require('./util/counter');

//counter1和counter2是同样的

主模块

• 经过命令行参数传递给NodeJS以启动程序的模块被称为主模块。
• 主模块负责调度组成整个程序的其它模块完成工做

二进制模块

• 通常使用JS编写模块，但NodeJS也支持使用C/C++编写二进制模块。
• 编译好的二进制模块除了文件扩展名是.node外，和JS模块的使用方式相同。

模块路径解析规则

• 内置模块: 若是传递给require函数的是NodeJS内置模块名称，不作路径解析，直接返回内部模块的导出对象，例如require('fs')。

• node_modules目录: NodeJS定义了一个特殊的node_modules目录用于存放模块。例如某个模块的绝对路径是/home/user/hello.js，在该模块中使用require('foo/bar')方式加载模块时，则NodeJS依次尝试使用如下路径。

/home/user/node_modules/foo/bar
 /home/node_modules/foo/bar
 /node_modules/foo/bar

• NODE_PATH环境变量: 与PATH环境变量相似，NodeJS容许经过NODE_PATH环境变量来指定额外的模块搜索路径。NODE_PATH环境变量中包含一到多个目录路径，路径之间在Linux下使用:分隔，在Windows下使用;分隔。例如定义了如下NODE_PATH环境变量：

NODE_PATH=/home/user/lib:/home/lib

当使用require('foo/bar')的方式加载模块时，则NodeJS依次尝试如下路径。

/home/user/lib/foo/bar
/home/lib/foo/bar

包（package）

index.js

• 若是在导入文件的时候没有指明文件名，默认加载index.js文件

//node/person/index.js

var head = require('./head');
var body = require('./body');

exports.create = function(name) {
  return {
    name: name,
    head: head.create,
    body: body.create
  }
};

//node/main.js

var index = require('./lib');

这样将person当作一个包

• package.json

*若是cat文件夹中package.json文件这样定义,在以前的状况，就会优先加载main指定的文件;

{
  "name": "cat",
  "main": "./main"
}

命令行程序

• 在任何目录下都能像是一个命令行程序运行程序

Linux系统下设置(以路径/home/user/bin/node-echo.js为例)

• 在shell脚本中，能够经过#!注释来指定当前脚本使用的解析器。因此首先在node-echo.js文件顶部增长如下一行注释，代表当前脚本使用NodeJS解析。

#! /usr/bin/env node

NodeJS会忽略掉位于JS模块首行的#!注释

• 而后，使用如下命令赋予node-echo.js文件执行权限。

$ chmod +x /home/user/bin/node-echo.js

• 最后，在PATH环境变量中指定的某个目录下，例如在/usr/local/bin下边建立一个软链文件，文件名与但愿使用的终端命令同名，命令以下：

$ sudo ln -s /home/user/bin/node-echo.js /usr/local/bin/node-echo

这样处理后，就能够在任何目录下使用node-echo命令。

Windows设置

• 假设node-echo.js存放在C:\Users\user\bin目录，而且该目录已经添加到PATH环境变量里了。

*接下来须要在该目录下新建一个名为node-echo.cmd的文件，文件内容以下：

@node "C:\User\user\bin\node-echo.js" %*

工程目录

一个标准的工程目录

- /home/user/workspace/node-echo/   # 工程目录
    - bin/                          # 存放命令行相关代码
        node-echo
    + doc/                          # 存放文档
    - lib/                          # 存放API相关代码
        echo.js
    - node_modules/                 # 存放三方包
        + argv/
    + tests/                        # 存放测试用例
    package.json                    # 元数据文件
    README.md                       # 说明文件

NPM

同NodeJS一块儿安装的包管理工具，能解决NodeJS代码部署上的问题，常见的使用场景：

• 容许用户从NPM服务器下载别人编写的三方包到本地使用: npmjs.org包名搜索

• 容许用户从NPM服务器下载并安装别人编写的命令行程序到本地使用: 方法与三方包相似

• 容许用户将本身编写的包或命令行程序上传到NPM服务器供别人使用: 第一次使用NPM发布代码前须要注册一个帐号。终端下运行npm adduser，以后按照提示作便可;

package.json的基本结构

{
    "name": "node-echo",           # 包名，在NPM服务器上需要保持惟一
    "version": "1.0.0",            # 当前版本号
    "dependencies": {              # 三方包依赖，须要指定包名和版本号
        "argv": "0.0.2"
      },
    "main": "./lib/echo.js",       # 入口模块位置
    "bin" : {
        "node-echo": "./bin/node-echo"      # 命令行程序名和主模块位置
    }
}

以后，就能够在package.json所在目录下运行npm publish发布代码。

版本号: 语义版本号分为X.Y.Z三位，分别表明主版本号、次版本号和补丁版本号。当代码变动时，版本号按如下原则更新。

• 若是只是修复bug，须要更新Z位。

• 若是是新增了功能，可是向下兼容，须要更新Y位。

• 若是有大变更，向下不兼容，须要更新X位。

在申明三方包依赖时，除了可依赖于一个固定版本号外，还可依赖于某个范围的版本号。

其余命令

• npm help <command>可查看某条命令的详细帮助。

• 在package.json所在目录下使用npm install . -g可先在本地安装当前命令行程序，可用于发布前的本地测试。

• npm update <package>能够把当前目录下node_modules子目录里边的对应模块更新至最新版本。

• 使用npm update <package> -g能够把全局安装的对应命令行程序更新至最新版。

• 使用npm cache clear能够清空NPM本地缓存，用于对付使用相同版本号发布新版本代码的人。

• 使用npm unpublish <package>@<version>能够撤销发布本身发布过的某个版本代码。