解析Node.js基于模块和包的代码部署方式


Posted in Javascript onFebruary 16, 2016

模块路径解析规则

有经验的 C 程序员在编写一个新程序时首先从 make 文件写起。同样的,使用 NodeJS 编写程序前,为了有个良好的开端,首先需要准备好代码的目录结构和部署方式,就如同修房子要先搭脚手架。本章将介绍与之相关的各种知识。

模块路径解析规则
我们已经知道,require函数支持斜杠(/)或盘符(C:)开头的绝对路径,也支持./开头的相对路径。但这两种路径在模块之间建立了强耦合关系,一旦某个模块文件的存放位置需要变更,使用该模块的其它模块的代码也需要跟着调整,变得牵一发动全身。因此,require函数支持第三种形式的路径,写法类似于foo/bar,并依次按照以下规则解析路径,直到找到模块位置。

内置模块

如果传递给 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

我们已经知道了 JS 模块的基本单位是单个 JS 文件,但复杂些的模块往往由多个子模块组成。为了便于管理和使用,我们可以把由多个子模块组成的大模块称做包,并把所有子模块放在同一个目录里。

在组成一个包的所有子模块中,需要有一个入口模块,入口模块的导出对象被作为包的导出对象。例如有以下目录结构。

- /home/user/lib/
  - cat/
    head.js
    body.js
    main.js

其中 cat 目录定义了一个包,其中包含了 3 个子模块。main.js 作为入口模块,其内容如下:

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

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

在其它模块里使用包的时候,需要加载包的入口模块。接着上例,使用 require('/home/user/lib/cat/main')能达到目的,但是入口模块名称出现在路径里看上去不是个好主意。因此我们需要做点额外的工作,让包使用起来更像是单个模块。

index.js
当模块的文件名是 index.js,加载模块时可以使用模块所在目录的路径代替模块文件路径,因此接着上例,以下两条语句等价。

var cat = require('/home/user/lib/cat');
var cat = require('/home/user/lib/cat/index');

这样处理后,就只需要把包目录路径传递给 require 函数,感觉上整个目录被当作单个模块使用,更有整体感。

package.json
如果想自定义入口模块的文件名和存放位置,就需要在包目录下包含一个 package.json 文件,并在其中指定入口模块的路径。上例中的 cat 模块可以重构如下。

- /home/user/lib/
  - cat/
    + doc/
    - lib/
      head.js
      body.js
      main.js
    + tests/
    package.json

其中package.json内容如下。

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

如此一来,就同样可以使用 require('/home/user/lib/cat')的方式加载模块。NodeJS 会根据包目录下的 package.json 找到入口模块所在位置。

Javascript 相关文章推荐
js,jQuery 排序的实现代码,网页标签排序的实现,标签排序
Apr 27 Javascript
jQuery-ui引入后Vs2008的无智能提示问题解决方法
Feb 10 Javascript
Javascript中arguments用法实例分析
Jun 13 Javascript
CSS中position属性之fixed实现div居中
Dec 14 Javascript
基于bootstrap的文件上传控件bootstrap fileinput
Dec 23 Javascript
jQuery判断邮箱格式对错实例代码讲解
Apr 12 jQuery
简述jQuery Easyui一些用法
Aug 01 jQuery
JavaScript实现的简单加密解密操作示例
Jun 01 Javascript
微信小程序局部刷新触发整页刷新效果的实现代码
Nov 21 Javascript
vue中选项卡点击切换且能滑动切换功能的实现代码
Nov 25 Javascript
Vue+Typescript中在Vue上挂载axios使用时报错问题
Aug 07 Javascript
一文帮你理解PReact10.5.13源码
Apr 03 Javascript
javascript每日必学之基础入门
Feb 16 #Javascript
快速掌握Node.js环境的安装与运行方法
Feb 16 #Javascript
js实现异步循环实现代码
Feb 16 #Javascript
JavaScript实现跑马灯抽奖活动实例代码解析与优化(二)
Feb 16 #Javascript
JavaScript实现跑马灯抽奖活动实例代码解析与优化(一)
Feb 16 #Javascript
javascript HTML+CSS实现经典橙色导航菜单
Feb 16 #Javascript
JavaScript中使用数组方法汇总
Feb 16 #Javascript
You might like
杏林同学录(一)
2006/10/09 PHP
PHP7标量类型declare用法实例分析
2016/09/26 PHP
php 遍历目录,生成目录下每个文件的md5值并写入到结果文件中
2016/12/12 PHP
解决laravel(5.5)访问public报错的问题
2019/10/12 PHP
jQuery Select(单选) 模拟插件 V1.3.62 改进版
2010/07/17 Javascript
javascript中的float运算精度实例分析
2010/08/21 Javascript
jQuery1.4.2与老版本json格式兼容的解决方法
2011/02/12 Javascript
javascript生成随机数的方法
2014/05/16 Javascript
javascript实现阻止iOS APP中的链接打开Safari浏览器
2014/06/12 Javascript
JavaScript通过元素的ID和name设置样式
2014/07/08 Javascript
有关json_decode乱码及NULL的问题
2015/10/13 Javascript
js自定义select下拉框美化特效
2016/05/12 Javascript
AngularJS内建服务$location及其功能详解
2016/07/01 Javascript
JavaScript中的对象继承关系
2016/08/01 Javascript
Angular.js实现注册系统的实例详解
2016/12/18 Javascript
vue.js国际化 vue-i18n插件的使用详解
2017/07/07 Javascript
echarts饼图扇区添加点击事件的实例
2017/10/16 Javascript
jQuery+SpringMVC中的复选框选择与传值实例
2018/01/08 jQuery
js canvas实现二维码和图片合成的海报
2020/11/19 Javascript
SVM基本概念及Python实现代码
2017/12/27 Python
Python numpy中矩阵的基本用法汇总
2019/02/12 Python
详解python算法之冒泡排序
2019/03/05 Python
详解django使用include无法跳转的解决方法
2020/03/19 Python
python中random.randint和random.randrange的区别详解
2020/09/20 Python
Python爬虫之Selenium中frame/iframe表单嵌套页面
2020/12/04 Python
Python APScheduler执行使用方法详解
2020/12/10 Python
Canon佳能美国官方商店:购买数码相机、数码单反相机、镜头和打印机
2016/11/15 全球购物
Origins悦木之源英国官网:雅诗兰黛集团高端植物护肤品牌
2017/11/06 全球购物
认识深刻的检讨书
2014/02/16 职场文书
珍惜时间演讲稿
2014/05/14 职场文书
授权委托书怎么写
2014/09/25 职场文书
大学生团日活动总结
2015/05/06 职场文书
初中班级口号霸气押韵
2015/12/24 职场文书
银行文明优质服务培训心得体会
2016/01/09 职场文书
导游词之上饶龟峰
2019/10/25 职场文书
python获取淘宝服务器时间的代码示例
2021/04/22 Python