[NodeJS] Hello World 起步教程

概述:

做数据,免不了需要展示数据,数据可视化是必须经历的步骤。

本文将提供一个NodeJS的起步教程,是笔者这两天探索的小结。

正文: 

1. 为什么使用NodeJS

究竟是以B/S还是C/S的架构去展示数据呢?

我们是这么考虑的,由于我们做的软件会不断调整,需求也会不断调整,如果使用C/S的架构,缺乏一个良好的软件升级机制,那么每次版本更新将会是沉重的灾难。

我们之前已经尝过C/S架构的苦了。既然如此, 就使用B/S架构吧。

但是需要采用什么技术呢?

我们有一套爬虫工具,就是使用NodeJS + Chrome Extension,有些可以复用的模块,为了代码的统一性和完整性,于是我们决定使用NodeJS。

还贪图它对JSON支持的方便,我们的数据库是使用Mongodb,众所周知NodeJS和Mongo是好基友,那就这么办了!

至于服务器的性能,不是我们重点考虑的范畴,因为我们衡量过需求,一个数据展示工具,不可能有1w的并发,以我们现在的状况,有100的并发都是很高了。

而NodeJS支持100并发是绰绰有余啊,具体的性能指标不在本文讨论,网上有大量的文章进行探讨。

2. 为什么使用Express

主流,文档资料齐全,没必要重复造*,清晰,容易上手。

Express官网,英文站 http://expressjs.com/

Express官网,中文站 http://expressjs.jser.us/

3. Hello World 

(1) 安装全局express包

在命令行输入 $ npm install -g express

安装全局express包,使得我们可以像使用npm一样使用express,用来创建项目

(2) 创建项目,安装依赖

先看看如何使用express命令,去片

[NodeJS] Hello World 起步教程

如果没有特殊的需求,直接 $ express ProjectName 即可,它会帮你选择最小的设置项,就是什么都没有,而模板引擎呢就使用NodeJS默认的Jade。

虽然网上有人说Jade干净方便,而且它是NodeJS官方的推荐,但我个人还是喜欢写HTML的方式去组织模板,于是就使用ejs。

去到你需要创建项目的目录中,

在命令行输入 $ express --session --ejs PR

由于在web项目中经常需要用到session,于是我添加--session的选项,最后的 PR(for Product Radar) 就是我的Project Name了。

[NodeJS] Hello World 起步教程

它把整个目录树都输出来了,看着这个目录树也对整个项目的结构有个整体的把握了。

接下来看到它提示你 install dependencies ,非常人性化的提示,你下一步的操作命令都显示出来了。它怎么说,你怎么做就好了。

它会根据自动生成的package.json去安装相应的依赖,也就是express和ejs了。

至此,已经完成项目的创建,$ node app.js 即可运行项目

浏览器访问 http://localhost:3000 能看到Express的欢迎页面。

(3) 分析目录结构

[NodeJS] Hello World 起步教程

/node_modules,不用多说了,就是该项目的依赖包放置的位置,有看前文内容的就不会对当中express和ejs产生疑惑了

/public,公共资源的存放位置,看到它的子目录也很明显了,/js,/css and /imgs

/routes,这个相当于是Controller ,负责对Http请求进行处理和响应,选择渲染某个页面,或者是一些逻辑处理,或者是返回计算结果等

/views,View层,由于我们使用的是ejs模板引擎 ,里面的index.ejs就相当于index.html这样了

app.js,这是一个实至名归的*控制器,项目的配置,请求的分配都在这里

package.json,不用多说了,打开看看,一目了然

(4) Hello World, step by step 

A. 首先,我们看着index.ejs不爽,又或者我们会由前端工程师写好html页面,我们拷到项目当中来,能不能直接了当地使用*.html啊?当然可以!

在app.js中插入/修改以下代码:

 var ejs = require('ejs');
 app.engine('.html', ejs.__express);
 app.set('view engine', 'html');

设定用ejs去解释.html为后缀的文件,关于app.engine的使用,请查看 http://expressjs.jser.us/api.html#app.engine

B. 登录模块

我们要限制home.html需要登录后才能访问,要有一个login.html登陆页,并需要有一个logout方法去处理登出的操作

首先,在app.js中添加路由控制:

         req.session.error = '已登陆';
              }
     next();
 }
 app.get('/', routes.index);
 app.get('/users', user.list);
 
 app.all('/login', notAuthentication);
 app.get('/login', routes.login);
 app.post('/login', routes.doLogin);
 
 app.get('/logout', authentication);
 app.get('/logout', routes.logout);
 app.get('/home', authentication);
 app.get('/home', routes.home);	

在请求login、logout、home前都有一步拦截,如果是请求login,就判断你是否已经登出;如果是请求logout和home,就判断你是否已经登录。

注意,这些路由控制的步骤是有顺序的,在上面的会先执行,注意看到authentication两个函数,最后都有执行next(),意思是把路由控制权交给下一个路由控制器。

C. 修改routes/index.js

1 /*

  exports.doLogin =  
              username: 'admin',
         password: 'admin'
     };
 
              req.session.user = user;
         res.redirect('/home');
     }          req.session.error = '用户名或密码不正确';
         res.redirect('/login');
     }
 
 };
 
    exports.logout =      req.session.user =      res.redirect('/home');
 };
 
    exports.home =      res.render('home', { title: 'homepage',
                           user: res.locals.user});
 };

基本上就是设置跳转,渲染页面,已经session的判断及设置等,清晰明了。

D. 关于其中session的设置,请参考http://blog.fens.me/nodejs-express3/

参考文章:

NodeJS英文站,http://expressjs.com/

NodeJS中文站,http://expressjs.jser.us

Express GitHub,https://github.com/visionmedia/express

更详细的Hello World教程 http://blog.fens.me/nodejs-express3/

上一篇:python date time


下一篇:USB学习笔记连载(十五):USB固件更新以及安装驱动