使用Node.js完成的第一个项目的实践总结
这是一个资产管理项目，主要的目的就是实现对资产的无纸化管理。通过为每个资产生成二维码，来联合移动终端完成对资产的审核等。这个项目既提供了Web端的管理界面也提供移动端(Andorid)的资产审核、派发等相关功能。
我们用Node.js构建该项目的Web端以及移动端的Serveice API。
项目主框架:Express 简介
Express 是一个非常流行的node.js的web框架。基于connect(node中间件框架)。提供了很多便于处理http请求等web开发相关的扩展。
Express简单的结构图：
Express的特性：
基于Connect构建健壮的路由提供丰富的HTTP处理方法支持众多视图模板引擎(14+)内容协商专注于提供高性能环境基于配置快速构建可执行的应用程序高测试覆盖率
前端框架简介
Bootstrap是Twitter推出的一个用于的开源工具包。它由Twitter的设计师MarkOtto和JacobThornton合作开发，是一个CSS/HTML框架。Bootstrap是简洁、直观、强悍的前端开发框架，让web开发更迅速、简单。
同时，很多基于Bootstrap的开源插件也让Bootstrap社区更加活跃。
最新的Bootstrap3提供了非常强的定制化特性。包括Less，jQuery插件等。
Bootstrap 为您提供了所有这些基本的模块- Grid、Typography、Tables、Forms、Buttons和Responsiveness。
此外，还有大量其他有用的前端，比如Dropdowns、Navigation、Modals、Typehead、Pagination、Carousal、Breadcrumb、Tab、Thumbnails、Headers等等。
有了这些，你可以搭建一个Web 项目，并让它运行地更快速更轻松。
此外，由于整个框架是基于模块的，你可以通过定制你自己的CSS来使得它满足你的特殊需求。
它是基于几种最佳实践，我们认为这是一个很好的开始学习现代Web 开发的时机，一旦你掌握了HTML 和Script/jQuery 的基本知识，你就可以在Web 开发中运用这些知识。
Ember.js是一个的MVC框架，它由Apple前雇员创建的SproutCore2.0改名进化而来。
构建一个Ember应用程序，通常会使用到六个主要部件：应用程序（Application）、模型（Model）、视图（View）、模板（Template）、路由（Routing）和控制器（Controller）。
这里我们server端主要依赖express框架，它提供的这些功能跟express有些是相同的。我们主要应用了Ember的模板组件，Express对于它提供了很好的集成。我们只需要进行很简单的配置即可：
app.set('view engine', 'html');
app.set('views', path.join(__dirname, 'views'));
app.set(&view options&, {layout : false});
app.register('.html', require('ejs'));
测试框架简介
should 是用于node.js的一个表述性、可读性很强的测试无关的&断言&库。它是BDD风格的，用一个单例的不可枚举的属性访问器扩展了Object的prototype，允许你表述对象应该展示的行为。
should的一个特性是可以支持链式断言，比如：
user.should.be.an.instanceOf(Object).and.have.property('name', 'tj');
user.pets.should.be.instanceof(Array).and.have.lengthOf(4);
Mocha是一个简单、灵活、有趣的javascript测试框架。它可以同时适用于node.js跟端。可以很轻松得完成同步、异步测试，对产生异常的测试用例提供灵活以及准确的报告。可以通过接口实现BDD、TDD、QUnit风格。
mocha + should.js
mocha是可以实现BDD模式的测试框架，而should.js是BDD模式的断言库。把它们结合起来，可以组建出一个非常灵活，并且不失表述性的测试框架。我们所有给终端的接口，都基于它们完成了测试。
项目组件 - node modules
功能简介：mysql- node.js平台mysql驱动，支持事务、连接池、集群、sql注入检测、多做参数传递写法等特性。
主页地址：https://github.com/felixge/node-mysql
eventproxy
功能简介：eventproxy- node.js 异步回调代理。主要用来解决node中深层次回调嵌套的问题，支持很多异步模式：多类型异步、重复异步、持续型异步。
主页地址：https://github.com/JacksonTian/eventproxy
功能简介：javascript的验证工具集，支持两种模式：check(校验)/sanitize(处理)，同时提供了可扩展的错误处理。
主页地址：http://github.com/chriso/node-validator
功能简介：embered.jsjavascript 模板引擎（可以跟express集成，作为服务端模板引擎）
主页地址：https://github.com/visionmedia/ejs
功能简介：loader- 资源加载工具，可以区分开发模式、发布模式；在发布模式下可进行资源压缩、合并。以实现减少静态资源带宽并且便于实现客户端缓存
主页地址：https://github.com/TBEDP/loader
功能简介：canvas - node.js 常用的图形图像处理库，是很多其它库的基础依赖库
主页地址：https://github.com/learnboost/node-canvas
captchagen
功能简介：captchagen-node.js常用验证码图片处理库，依赖上面的canvas库
主页地址：http://github.com/wearefractal/captchagen
功能简介：crypto-js- javascript 常用库、hash库封装，支持sha-x / md5 / hash等各种加密、hash算法
主页地址：http://github.com/wearefractal/captchagen
nodemailer
功能简介：nodemailer- 邮件发送工具，支持SMTP等邮件发送协议
主页地址：http://github.com/andris9/nodemailer
功能简介：qrcode- node.js服务端的qrcode生成器。支持多种输出类型（dataUrl/file/bitArray）
主页地址：http://github.com/soldair/node-qrcode
功能简介：qrcode- node.js服务端的qrcode生成器。支持多种输出类型（dataUrl/file/bitArray）
主页地址：http://github.com/soldair/node-qrcode
功能简介：excel- node.js excel解析器，支持xlsx(Excel2007+)
主页地址：https://github.com/trevordixon/excel
excel-export
功能简介：excel-export- node.js excel生成器，支持导出excel
主页地址：https://github.com/functionscope/Node-Excel-Export
功能简介：net-ping- node.js 对ping的封装，用于测试目标主机是否可达
主页地址：https://bitbucket.org/stephenwvickers/node-net-ping
功能简介：debug- node.js debug工具，对console.log的封装，支持多种颜色输出。
主页地址：https://github.com/visionmedia/debug
项目组织结构
NPM - Node.js 模块依赖管理工具
npm是管理node.js模块依赖的工具，依赖于开源技术的优势就是你有非常多的优秀库可以帮助你快速构建一个，但就像一把双刃剑，由于开源导致版本的升级不可控。这时，一个集中性的模块依赖管理工具的优势就十分明显。它负责帮你管理开源项目的版本，你只需要添加对某个开源模块的依赖即可。
unix/linux下安装npm:
curl http://npmjs.org/install.sh | sudo sh
如何在项目中使用npm管理你的依赖：
(1)在项目的根目录下创建一个package.json文件
在dependencies下添加所需要依赖的模块，示例如下：
打开terminal，进入项目的根目录下:
$ cd projectPath
安装这些module到本地repository:
$ npm install
这时你会发现，项目的根目录下多了一个node_modules文件夹，那里面就是从npm远程库里下载的模块然后&安装&到你的项目中的。
现在，你就可以在你的项目中应用你依赖的这些modules了。你可以通过require关键字来使用他们。比如，
require(&eventproxy&);
Node.js 模块加载机制
node.js的模块加载基于CommonJS规范。
在Node.js中，将模块分为两大类：
(1)原生模块
原生模块在Node.js源代码编译的时候编译进了二进制执行文件，加载速度最快。
(2)文件模块
node.js依赖modulepath（模块路径）来加载module，而modulepath的生成规则主要是从当前文件目录开始查找node_modules文件夹，然后依次进入父目录查找父目录下的node_modules目录直至到根目录下得node_modules目录。所以在require的时候，如果带上module的路径，则按照该路径查找，如果没有就按照上面的node_modules文件夹向上追溯查找，如果都没有找到，则抛出异常。
自动化部署
项目环境的构建、部署都是自动化的。
我们假设项目最终会发布在任意版本的Ubuntuserver上。在安装git的前提下，通过如下命令去clone项目到本地：
git clone git://github.com/yanghua/FixedAssetManager_Server.git
项目doc下有四个shell文件：
node_install_ubuntu.sh - 在ubuntuserver上安装node.js的脚本
node-canvas-install_ubuntu.sh - 在Ubuntuserver上安装node-canvas的脚本
mysql_install_ubuntu.sh - 在Ubuntu server上安装mysql的脚本
dispatch.sh - 部署项目的脚本
将它们copy到当前用户的home目录下，依次执行即可。整个过程几乎实现了无需人为干涉的&自动化&。
pm2 - 线上监控管理工具
pm2是非常优秀工具，它提供对基于node.js的项目运行托管服务。它基于命令行界面，提供很多特性：
内置的负载均衡器（使用nodecluster module）
以守护进程运行
0s(不间断)重启
为ubuntu/ CentOS 提供启动脚本
关闭不稳定的进程（避免无限死循环）
基于控制台监控
远程控制以及实时监控接口
pm2使用nodecluster构建一个内置的负载均衡器。部署多个app的实例来达到分流的目的以减轻单app处理的压力。
异常监控与邮件推送
node.js 到处都是异步调用。常用的try/catch同步捕获异常并处理的方式，在这里不起作用了。这是因为很多callback已经离开了当时try的上下文，导致无法获取异常产生的堆栈信息。基于这个问题，我们对异常处理的模式按类型进行区分处理：
(1)http请求异常
这种异常Express就可以进行处理。如果是非法请求，在路由的时候，对未匹配的请求进行统一处理：
app.get(&*&, others.fourofour);
(2)业务异常
这种异常通常不会影响到程序的运行，我们以不同的异常代码返回给前端或者终端，来给调用端友好的提示。
(3)应用程序级别的异常或必须处理的错误
这种情况下，应用程序可能没有办法处理异常，也有可能由应用程序抛出。对于这种应用程序级别的异常。我们用两种方式来catch:
[1]利用Express提供的应用程序的异常处理机制：
app.error(function(err, req, res, next) {
mailServie.sendMail({
subject : &FixedAssetManager_Server[App Error]&,
: err.message + &\n& + err.stack + &\n& + err.toString()
if (err instanceof PageNotFoundError) {
res.render(&errors/404&);
} else if (err instanceof ServerError) {
res.render(&errors/500&);
[2]应用程序已经无法响应处理了，则利用node.js提供的，对于进程级别的异常处理方式：
process.on(&uncaughtException&, function (err) {
mailServie.sendMail({
subject : &FixedAssetManager_Server[App Error]&,
: err.message + &\n& + err.stack + &\n& + err.toString()
这两种应用程序级别的异常，优先级都比较高，因此我们采用了邮件通知的策略，来辅助开发人员进行快速定位并修复。
静态资源优化：压缩合并与缓存
web应用中对于资源的定义大致分为：静态资源、动态资源两种。动态资源通常是可变的，需要进行相应处理的，而静态资源在线上通常都是不会变的。常见的静态资源有：javascript文件、css文件、图片文件等。对于这些静态文件，我们通过设置过期时间来进行缓存。而对于文本文件，由于浏览器的解析行为，对他们进行合并或者压缩都不会产生影响。
这里需要提到我们在组件中介绍的Loader。在项目刚被clone下来的时候，需要先执行makebuild来对项目进行初始化。在初始化的过程中，Loader会对项目的views文件夹中的文件进行扫描。它通常会扫描html界面：查找类似于如下的片段：
&%- Loader(&/public/stylesheets/login.min.css&)
.css(&/public/libs/bootstrap/css/bootstrap.min.css&)
.css(&/public/stylesheets/login.css&)
.done(assets)
&%- Loader(&/public/libs/js/login.min.js&)
.js(&/public/libs/jquery/jquery-1.10.2.min.js&)
.js('/public/libs/bootstrap/js/bootstrap.min.js')
.js(&/public/libs/CryptoJS_v3.1.2/rollups/sha256.js&)
.js(&/public/libs/js/login.js&)
.done(assets)
去查找.css()以及.js()方法中的这些路径参数，并对这些文件进行合并或压缩混淆(这取决于配置)，来产生一份assets.json（资产列表）文件。这里面定义了一些键值对，键为上面代码段中Loader()方法后面跟的参数，值为具体合并后文件的路径。这样，Loader会根据配置来判断加载类型。如果当前为开发模式或者为debug模式，则调用.js()/.css()，基于其中的路径参数来生成&script/&
。如果为发布模式，则根据.done()里的assets键值对，结合Loader()的参数，来输出合并后的文件。以减少前端http请求数量以及总大小。对publich文件夹下的文件，设置静态文件缓存：
//config for production env
app.configure(&production&, function () {
app.use('/public', express.static(staticDir, { maxAge: maxAge }));
app.use(express.errorHandler());
app.set('view cache', true);
因为设置了缓存，在重新改动这些静态文件再发布的时候，如果缓存时间太长，则客户端的静态文件可能不会被替换。对于这个问题，Loader通过在文件的后缀追加一个版本号来作为参数。这样，当重新生成assets.json的时候每个文件会产生新的版本号，浏览器会请求&新文件&替换掉客户端老的缓存文件。
Restful风格的URL
Restful以&Resource&为核心概念，认为URL是用来表示一种资源。而不应该表示一个动作或者其他的东西。而动作，比如&CRUD&正好对应http的四个method:get/post/put/delete。本项目中，我们大部分的URL以Restful风格为主，但没有严格贯彻执行。
前端内容模板化、组件化
前端我们采用的是ejs的模板来构建，它很好得实现了html的片段化、组件化。有一个基础的模板，别的都只是一块html片段。它们在服务端完成组合、解析，生成完整的html流输出到客户端。
这样的开发模式，使得前端代码的划分比较清晰，组件化也使得代码的复用变得更容易。
在项目初始化的过程中，我们使用makefile文件来使得一些动作自动化运行。比如我们之前提到过的构建assets.json来合并文件的动作，就是通过执行makebuild文件来完成的。
目前，Node.js还没有很强大的调试工具。常用的辅助诊断方式就是打log。但繁多的日志输出，混杂在http log里实在是不方便判断。我们在项目中使用了debug module来进行debug，他支持对log加不同颜色的key word并且还支持timestamp。你在一大堆日志中，一眼就足以区分是从哪个module或者组件输出的。我们在项目中对不同的layer应用不同的关键字：
var debug4Ctrller
= require(&debug&)(&controller&);
var debug4Proxy
= require(&debug&)(&proxy&);
var debug4Lib
= require(&debug&)(&lib&);
var debug4Test
= require(&debug&)(&test&);
var debug4Other
= require(&debug&)(&other&);
将其置为全局：
global.debugCtrller = debug4C
global.debugProxy
global.debugLib
global.debugTest
global.debugOther
这样你在controller层的log就可以以如下方式log：
debugCtrller(&XXX %s&, &YYY&);
& 总结 & TODO
由于边摸索边构建，在代码规范性上还有待进一步重构。同时，对CNode官方社区的开源代码表示感谢，它真的让我们学到了许多。本文所述项目开源在github