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 和JavaScript/jQuery 的基本知识，你就可以在Web 开发中运用这些知识。

功能简介：MySQL- node.js平台MySQL驱动，支持事务、连接池、集群、sql注入检测、多做参数传递写法等特性。
主页地址：https://github.com/felixge/node-mysql

功能简介：eventproxy- node.js 异步回调代理。主要用来解决node中深层次回调嵌套的问题，支持很多异步模式：多类型异步、重复异步、持续型异步。
主页地址：https://github.com/JacksonTian/eventproxy

功能简介：javascript的验证工具集，支持两种模式：check(校验)/sanitize(处理)，同时提供了可扩展的错误处理。
主页地址：http://github.com/chriso/node-validator

功能简介：loader- 资源加载工具，可以区分开发模式、发布模式；在发布模式下可进行资源压缩、合并。以实现减少静态资源带宽并且便于实现客户端缓存
主页地址：https://github.com/TBEDP/loader

功能简介：canvas - node.js 常用的图形图像处理库，是很多其它库的基础依赖库
主页地址：https://github.com/learnboost/node-canvas

功能简介：captchagen-node.js常用验证码图片处理库，依赖上面的canvas库
主页地址：http://github.com/wearefractal/captchagen

功能简介：crypto-js- javascript 常用加密库、hash库封装，支持sha-x / md5 / hash等各种加密、hash算法
主页地址：http://github.com/wearefractal/captchagen

功能简介：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

功能简介：excel- node.js excel解析器，支持xlsx(Excel2007+)
主页地址：https://github.com/trevordixon/excel

excel-export

功能简介：net-ping- node.js 对ping的封装，用于测试目标主机是否可达
主页地址：https://bitbucket.org/stephenwvickers/node-net-ping

debug

项目组织结构

npm是管理node.js模块依赖的工具，依赖于开源技术的优势就是你有非常多的优秀库可以帮助你快速构建一个系统，但就像一把双刃剑，由于开源导致版本的升级不可控。这时，一个集中性的模块依赖管理工具的优势就十分明显。它负责帮你管理开源项目的版本，你只需要添加对某个开源模块的依赖即可。

unix/Linux下安装npm:

[javascript] view plain copy

 

 

 

 print?

1. curl http://npmjs.org/install.sh | sudo sh  

如何在项目中使用npm管理你的依赖：

(1)在项目的根目录下创建一个package.json文件

[javascript] view plain copy

 

 

 

 print?

1. $ npm install   

这时你会发现，项目的根目录下多了一个node_modules文件夹，那里面就是从npm远程库里下载的模块然后“安装”到你的项目中的。
现在，你就可以在你的项目中应用你依赖的这些modules了。你可以通过require关键字来使用他们。比如，

[javascript] view plain copy

 

 

 

 print?

1. 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文件夹向上追溯查找，如果都没有找到，则抛出异常。

自动化部署

[javascript] view plain copy

 

 

 

 print?

1. git clone git://github.com/yanghua/FixedAssetManager_Server.git  

项目doc下有四个shell文件：

异常监控与邮件推送

[javascript] view plain copy

 

 

 

 print?

1. app.get("*", others.fourofour);   

(2)业务异常

这种异常通常不会影响到程序的运行，我们以不同的异常代码返回给前端或者终端，来给调用端友好的提示。

(3)应用程序级别的异常或必须处理的错误

这种情况下，应用程序可能没有办法处理异常，也有可能由应用程序抛出。对于这种应用程序级别的异常。我们用两种方式来catch:

[1]利用Express提供的应用程序的异常处理机制：

[javascript] view plain copy

 

 

 

 print?

1. app.error(function(err, req, res, next) {                                             
2.         mailServie.sendMail({                                                     
3.           subject : "FixedAssetManager_Server[App Error]",                    
4.           text    : err.message + " " + err.stack + " " + err.toString()            
5.         });                                                                       
6.         if (err instanceof PageNotFoundError) {                               
7.             res.render("errors/404");                                             
8.         } else if (err instanceof ServerError) {                                      
9.             res.render("errors/500");                                             
10.         }                                                                         
11.     });  

[2]应用程序已经无法响应处理了，则利用node.js提供的，对于进程级别的异常处理方式：

[javascript] view plain copy

 

 

 

 print?

1. process.on("uncaughtException", function (err) {                                      
2.         mailServie.sendMail({                                                     
3.             subject : "FixedAssetManager_Server[App Error]",                      
4.             text    : err.message + " " + err.stack + " " + err.toString()          
5.         });                                                                       
6.     });   

这两种应用程序级别的异常，优先级都比较高，因此我们采用了邮件通知的策略，来辅助开发人员进行快速定位并修复。

静态资源优化：压缩合并与缓存

[html] view plain copy

 

 

 

 print?

1. <!-- style -->                                                                      
2.     <%- Loader("/public/stylesheets/login.min.css")                            
3.       .css("/public/libs/bootstrap/css/bootstrap.min.css")                        
4.       .css("/public/stylesheets/login.css")                                       
5.       .done(assets)                                                               
6.       %>                                                                       
7.     <!-- script -->                                                                 
8.     <%- Loader("/public/libs/js/login.min.js")                                     
9.       .js("/public/libs/jquery/jquery-1.10.2.min.js")                             
10.       .js('/public/libs/bootstrap/js/bootstrap.min.js')                           
11.       .js("/public/libs/CryptoJS_v3.1.2/rollups/sha256.js")                       
12.       .js("/public/libs/js/login.js")                                                 
13.       .done(assets)                                                               
14.     %>  

去查找.css()以及.js()方法中的这些路径参数，并对这些文件进行合并或压缩混淆(这取决于配置)，来产生一份assets.json（资产列表）文件。这里面定义了一些键值对，键为上面代码段中Loader()方法后面跟的参数，值为具体合并后文件的路径。这样，Loader会根据配置来判断加载类型。如果当前为开发模式或者为debug模式，则调用.js()/.css()，基于其中的路径参数来生成<script/> <link />。如果为发布模式，则根据.done()里的assets键值对，结合Loader()的参数，来输出合并后的文件。以减少前端http请求数量以及总大小。对publich文件夹下的文件，设置静态文件缓存：

[javascript] view plain copy

 

 

 

 print?

1. //config for production env                                                       
2. app.configure("production", function () {                                             
3.     app.use('/public', express.static(staticDir, { maxAge: maxAge }));                
4.     app.use(express.errorHandler());                                              
5.     app.set('view cache', true);                                                      
6. });  

因为设置了缓存，在重新改动这些静态文件再发布的时候，如果缓存时间太长，则客户端的静态文件可能不会被替换。对于这个问题，Loader通过在文件的后缀追加一个版本号来作为参数。这样，当重新生成assets.json的时候每个文件会产生新的版本号，浏览器会请求“新文件”替换掉客户端老的缓存文件。

Restful风格的URL

Restful以“Resource”为核心概念，认为URL是用来表示一种资源。而不应该表示一个动作或者其他的东西。而动作，比如“CRUD”正好对应http的四个method:get/post/put/delete。本项目中，我们大部分的URL以Restful风格为主，但没有严格贯彻执行。

前端内容模板化、组件化

前端我们采用的是ejs的模板来构建，它很好得实现了html的片段化、组件化。有一个基础的模板，别的都只是一块html片段。它们在服务端完成组合、解析，生成完整的html流输出到客户端。
这样的开发模式，使得前端代码的划分比较清晰，组件化也使得代码的复用变得更容易。

makefile

在项目初始化的过程中，我们使用makefile文件来使得一些动作自动化运行。比如我们之前提到过的构建assets.json来合并文件的动作，就是通过执行makebuild文件来完成的。

增强的Debug模块

目前，Node.js还没有很强大的调试工具。常用的辅助诊断方式就是打log。但繁多的日志输出，混杂在http log里实在是不方便判断。我们在项目中使用了debug module来进行debug，他支持对log加不同颜色的key word并且还支持timestamp。你在一大堆日志中，一眼就足以区分是从哪个module或者组件输出的。我们在项目中对不同的layer应用不同的关键字：

[javascript] view plain copy

 

 

 

 print?

1. var debug4Ctrller   = require("debug")("controller");  
2. var debug4Proxy     = require("debug")("proxy");  
3. var debug4Lib       = require("debug")("lib");  
4. var debug4Test      = require("debug")("test");  
5. var debug4Other     = require("debug")("other");  

将其置为全局：

[javascript] view plain copy

 

 

 

 print?

1. global.debugCtrller = debug4Ctrller;  
2. global.debugProxy   = debug4Proxy;  
3. global.debugLib     = debug4Lib;  
4. global.debugTest    = debug4Test;  
5. global.debugOther   = debug4Other;  

[javascript] view plain copy

 

 

 

 print?

1. debugCtrller("XXX %s", "YYY");  

这样在Terminal中，输出的log会按照不同的颜色进行区分，辨别性明显增强：

一切都可自动化——Grunt

为什么需要任务运行器？

为什么使用Grunt?

[javascript] view plain copy

 

 

 

 print?

1. npm install -g grunt-cli  

2：在项目的根目录下新建一个Gruntfile.js文件，该文件为grunt的配置、初始化文件

[javascript] view plain copy

 

 

 

 print?

1. npm install grunt --save-dev      

依赖会被自动写入package.json的devDependencies项中。

关于Gruntfile的编写规则，详细请查看，Gruntjs中文文档。

统一的代码风格

自动格式化工具

强制检查工具

Express 2.x to 3.x 接口适配与调整

[javascript] view plain copy

 

 

 

 print?

1. <% layout('layout') -%>  

来标识一个component会套用某个模板，而在3.x中ejs模板引擎，改为采用middleware的方式使用：（需要安装一个module:express-partials）

[javascript] view plain copy

 

 

 

 print?

1. app.use(require('express-partials')());  

与此同时，3.x专门提供了一个设置引擎的接口：

[javascript] view plain copy

 

 

 

 print?

1. app.engine('html', require('ejs').renderFile);  

替代了原先2.x的：

[javascript] view plain copy

 

 

 

 print?

1. app.register('.html', require('ejs'));  

2、处理错误的方式改变：

2.x处理错误有专门的一个API:

[javascript] view plain copy

 

 

 

 print?

1. app.error(function(err, req, res, next) {                                             
2.     //error logic handle                                                      
3. };  

3.x退而采用middleware的方式来处理：

[javascript] view plain copy

 

 

 

 print?

1. app.use(function(err, req, res, next) {                                           
2.     //error logic handle                                                      
3. }  

更多express2.x to 3.x的改变，可以看看官方给出的变更列表。

从EventProxy 到 async 切换

Mongodb for node.js:mongoose的使用

给每个层定义索引文件

supertest 模拟 http request 测试

密码采用混入salt值的方式进行加密

解决linux解压缩包中文乱码

[javascript] view plain copy

 

 

 

 print?

1. LANG=C 7z e `source zip file path` -o`target path`    

其中参数“e”表示释放所有文件到目标路径（递归所有压缩包中的子文件夹），参数“-O”指定解压到的路径（注意参数-O跟输出路径中间无空格）。

这一步只是完成了解压，文件名这时还是乱码的。此时需要linux上专门的转码工具——convmv来进行编码转换！

如果该命令不存在，可以先apt-getinstall一下，然后运行如下命令：

[javascript] view plain copy

 

 

 

 print?

1. convmv -f cp936 -t utf8 -r --notest -- `target path`/*  

该命令的意思是：对`targetpath`下的所有文件，从cp936编码转换成utf8编码，其中的--notest表示不进行测试，直接转换。如果你想确保转码安全，可以先进行测试，看是否会产生乱码，然后再进行转码，测试命令如下：

[javascript] view plain copy

 

 

 

 print?

1. convmv -f cp936 -t utf8 -r -- *  

这是你只要关注文件名是否会产生乱码，无需关注目录名，如果没有乱码，就可以安全转换了。

如果文件内容有乱码，可以借助如下命令对文件进行转码：

[javascript] view plain copy

 

 

 

 print?

1. iconv -f cp936 -t utf8 -o output.txt input.txt  

备注：我这边遇到的是，在一个压缩包内部有文件夹的情况下，在windows压缩，在ubuntu下解压缩产生了中文乱码。但如果只是选中几个文件直接压缩，在ubuntu下不做转码，中文照常显示。

源码 & 总结 & TODO