modeJS 深了解（1）： Node.js + Express 构建网站预备知识

转载：http://www.cnblogs.com/zhongweiv/p/nodejs_express_webapp1.html

<!DOCTYPE html>
<html>
  <head>
    <title><%= title %></title>
    <link rel='stylesheet' href='/stylesheets/style.css' />
  </head>
  <body>     
    <a href="/">首页</a>     
    <a href="/subform">如何提交表单并接收参数?</a>
    <a href="/usesession">如何使用session?</a>
    <a href="/usecookies">如何使用cookies?</a>
    <a href="/usecrypto">如何字符串加密?</a>
  </body>
</html>

在app.js文件中添加如下代码

var subform = require('./routes/subform');
var usesession = require('./routes/usesession');
var usecookies = require('./routes/usecookies');
var usecrypto = require('./routes/usecrypto');            

...

app.use('/subform', subform);
app.use('/usesession', usesession);
app.use('/usecookies', usecookies);
app.use('/usecrypto', usecrypto);

通过URL访问后，根据路由规则先到哪个文件，这里再说明下（app.js中有如下内容）：

app.use([path], function)

var routes = require('./routes/index');
var users = require('./routes/users');

app.use('/', routes);
app.use('/users', users);

上面代码表示当用户使用/访问时，调用自定义变量routes，即 routes 目录下的 index.js 文件，其中.js后缀省略;

　　　　　　用/users访问时，调用自定义变量uses，即 routes 目录下 users.js 文件

在app.js中添加8000端口监听并运行

...
app.listen(8000);
...

　　运行界面如下：

　　点击各链接都能正常跳转到对应的页面！这样第一步的目录就算达到了！

如何提取页面中的公共部分?

　　在上一步创建的网站中每个页面都几乎一样，现在都只有导航部分？每个页都要写？当然不是，我们可以提取出来

在views目录下新建一个nav.ejs文件，并添加如下代码

<a href="/">首页</a>     
<a href="/subform">如何提交表单并接收参数?</a>
<a href="/usesession">如何使用session?</a>
<a href="/usecookies">如何使用cookies?</a>
<a href="/usecrypto">如何字符串加密?</a>

把views目录下index.ejs、subform.ejs、usesession.ejs、usecookies.ejs、usecrypto.ejs修改成如下代码

<!DOCTYPE html>
<html>
  <head>
    <title><%= title %></title>
    <link rel='stylesheet' href='/stylesheets/style.css' />
  </head>
  <body>     
      <% include nav %>       # 若改为了其他引擎，例如 nav.html， 此处则需写成 <% include nav.html %>
  </body>
</html>

　　运行页面，发现和上次运行时没有作何区别，有了这样的办法更有利于减少重复代码、也更有利于统一布局！

<% include 文件名 %> express提供include来嵌入其它页，这和html嵌入其它页类似

如果用过express2.0版本的会发现当时没有这个include，用的是一个模版文件layout.ejs来布局!

如何提交表单并接收参数?

　　如果要做一个网站应用，不可避免的会遇到表单的提交及获取参数的值，下面我们来看看用node.js + express怎么做

先来构建一个表单简单模拟登录GET方式提交数据

打开subform.ejs文件，修改文件代码为如下：

<!DOCTYPE html>
<html>
  <head>
    <title><%= title %></title>
    <link rel='stylesheet' href='/stylesheets/style.css' />
  </head>
  <body>     
      <% include nav %>
      
      <form>
          用户名：<input type="text" id="txtUserName" name="txtUserName" />
          密码：<input type="password" id="txtUserPwd" name="txtUserPwd" />
          <input type="submit" value="提交">
      </form>
    
  </body>
</html>

subform.ejs 示例代码

subform.ejs 示例代码

打开subform.js我们试着接收参数值并输出到控制台

var express = require('express');
var router = express.Router();

router.get('/', function(req, res) {
  var 
  userName = req.query.txtUserName,
  userPwd = req.query.txtUserPwd,
  userName2 = req.param('txtUserName'),
  userPwd2 = req.param('txtUserPwd');

  console.log('req.query用户名:'+userName);
  console.log('req.query密码:'+userPwd);
  console.log('req.param用户名:'+userName2);
  console.log('req.param密码:'+userPwd2);

  res.render('subform', { title: '提交表单及接收参数示例' });
});

module.exports = router;

subform.js get方式源码

subform.js get方式源码

运行，并提交表单在浏览器中运行：http://localhost:8000/subform，输入表单项并提交，可以发现url发生了变化

　　可以发现url中出现了我表单中输入并要提交的值！

　　我们再看看控制台的输出

　　我们完成了GET方式提交表单并接收到了值，不错^_^!（稍后在后面再去讲得到值的方式和区别）

　　再来在上面的代码基础上去修改一下表单的method简单模拟登录POST方式提交数据

首先修改一下subform.ejs文件中的form标签，修改为如下：

<form method="post">
...
</form>

再在subform.js中添加代码，接收post提交、接收参数并输出到控制台

...

router.post('/',function(req, res){
  var 
  userName = req.body.txtUserName,
  userPwd = req.body.txtUserPwd,
  userName2 = req.param('txtUserName'),
  userPwd2 = req.param('txtUserPwd');

  console.log('req.body用户名:'+userName);
  console.log('req.body密码:'+userPwd);
  console.log('req.param用户名:'+userName2);
  console.log('req.param密码:'+userPwd2);

　res.render('subform', { title: '提交表单及接收参数示例' });

});

...

运行，并提交表单在浏览器中运行：http://localhost:8000/subform，输入表单项并提交，可以发现url不会发生变化

　　改为post方式后，会发现不会跟get方式提交一样在url中出现了表单中输入并要提交的值！

　　我们再看看控制台的输出

　　OK，我们完成了POST提交表单并接收参数!

　　再回过头看看GET和POST方式接收值，从直接效果上来看　

req.query：我用来接收GET方式提交参数

req.body：我用来接收POST提交的参数

req.params：两种都能接收到

大家自行看看Express的Request部分的API: http://expressjs.com/api.html#req.params

这里着重解释一下req.body，Express处理这个post请求是通过中间件bodyParser，你可以看到app.js中有一块代码

...

var bodyParser = require('body-parser');

...

app.use(bodyParser.json());
app.use(bodyParser.urlencoded());

...

　　没有这个中间件Express就不知道怎么处理这个请求，通过bodyParser中间件分析 application/x-www-form-urlencoded和application/json请求，并把变量存入req.body，这种我们才能够获取到！

如何字符串加密?

　　当我们提交表单后，比如密码这些敏感信息，不做个加密处理那也太不把用户私密信息当回事了，Node.js提供了一个加密模块 Crypto http://nodejs.org/api/crypto.html

　　下面我们用个示例使用一下

打开usecrypto.js，修改代码为如下：

var express = require('express');
var router = express.Router();
var crypto = require('crypto');

/* GET home page. */
router.get('/', function(req, res) {
  
  res.render('usecrypto', { title: '加密字符串示例' });
 
});

router.post('/',function(req, res){
  var 
  userName = req.body.txtUserName,
  userPwd = req.body.txtUserPwd;

  //生成口令的散列值
  var md5 = crypto.createHash('md5');   //crypto模块功能是加密并生成各种散列
  var en_upwd = md5.update(userPwd).digest('hex');

  console.log('加密后的密码:'+en_upwd);
  
  res.render('usecrypto', { title: '加密字符串示例' });
});

module.exports = router;

打开usecrypto.ejs，修改代码为如下

<!DOCTYPE html>
<html>
  <head>
    <title><%= title %></title>
    <link rel='stylesheet' href='/stylesheets/style.css' />
  </head>
  <body>     
      <% include nav %>

      <form method="post">
          用户名：<input type="text" id="txtUserName" name="txtUserName" />
          密码：<input type="password" id="txtUserPwd" name="txtUserPwd" />
          <input type="submit" value="提交">
      </form>
  </body>
</html>

运行，输入并提交表单，查看控件台输出

　　成功MD5方式加密！

　　其中用到了createHash(algorithm)方法 ,这是利用给定的算法生成hash对象

　　Node.js提供的加密模块功能非常强大，Hash算法就提供了MD5、sha1、sha256等，根据需要去使用

　　update(data, [input_encoding])方法，可以通过指定的input_encoding和传入的data数据更新hash对象，input_encoding为可选参数，没有传入则作为buffer处理（input_encoding可为'utf-8'、'ascii'等）

　　digest([encoding])方法，计算数据的hash摘要值，encoding是可选参数，不传则返回buffer (encoding可为 'hex'、'base64'等)；当调用digest方法后hash对象将不可用；

如何使用session?

　　Internet通讯协议分为stateful和stateless两类，对Web开发有一定了解的应该知道，http是stateless协议，客户端发送请求到服务端建立一个连接，请求得得到响应后连接即中断，服务器端不会记录状态，因此服务器端想

　　要确定是哪个客户端提交过来的请求，那就必须要借助一些东西去完成，就是session和cookies，现在我们先说说session，以及在nodejs下使用session !

　　session存在于服务器端，需要cookies的协助才能完成；服务器端和客户端通过session id来建立联系（具体session和cookies怎么协作的，可以自已去补充点相关知识，这里只简单提一下，不展开了，要不然这篇文章就更杂了^_^!）

　　express中可以用中间件来使用session，express-session(https://github.com/expressjs/session ) 可以存在内存中，也可以存在mongodb、redis等中...

　　更多中间件：https://github.com/senchalabs/connect#middleware

　　下面我们通过示例看看怎么使用session (内存方式)

　　示例设计思路：使用两个页面，一个登录，两个页都判断是否有这个session,如果有，显示已登录，没有则显示一个登录按钮，点此按钮，记录session

首先通过npm安装这个中间件，打开package.json文件，在dependencies节点下添加一个键值对 "express-session" : "latest"

  "dependencies": {
    ...,
    "express-session" : "latest" 
  }

　　lateset：最新的

cd到项目根目录下，执行npm install

打开app.js，添加如下代码

var express = require('express');
var path = require('path');
var favicon = require('static-favicon');
var logger = require('morgan');
var cookieParser = require('cookie-parser');
var bodyParser = require('body-parser');
var session = require('express-session');

...      

//这里传入了一个密钥加session id
app.use(cookieParser('Wilson'));
//使用靠就这个中间件
app.use(session({ secret: 'wilson'}));

...

　这些options就不解释了，通过上面中间件的链接，自已看一下

我这里使用 usesession 和 usecookies 作示例，修改 js 和 ejs 如下

<!DOCTYPE html>
<html>
  <head>
    <title><%= title %></title>
    <link rel='stylesheet' href='/stylesheets/style.css' />
  </head>
  <body>     
      <% include nav %>

      <% if(locals.islogin){ %>
         用户已登录
    <% } else { %>
         <form method="post">          
              <input type="submit" value="登录">
          </form>
    <% } %>
  </body>
</html>

usesession.ejs 和 usecookies.ejs

usesession.ejs 和 usecookies.ejs

var express = require('express');
var router = express.Router();

router.get('/', function(req, res) {
  
  if(req.session.islogin)
  {
       console.log('usesession:' + req.session.islogin);
     res.locals.islogin = req.session.islogin;      
  }

  res.render('usesession', { title: '使用session示例' });
});

router.post('/', function(req, res) {
  
  req.session.islogin = 'success';
  res.locals.islogin = req.session.islogin;

  res.render('usesession', { title: '使用session示例' });
});

module.exports = router;

usession.js

var express = require('express');
var router = express.Router();

router.get('/', function(req, res) {

  if(req.session.islogin)
  {
      console.log('usecookies:' + req.session.islogin);
    res.locals.islogin = req.session.islogin;      
  }

  res.render('usecookies', { title: '使用cookies示例' });
});

router.post('/', function(req, res) {
  
  req.session.islogin = 'success';
  res.locals.islogin = req.session.islogin;

  res.render('usecookies', { title: '使用cookies示例' });
});

module.exports = router;

usecookies.js 示例代码

usecookies.js

运行并查看

　　第一次运行时，查看两个页，效果如下：

点击登录按钮后，再查看这两个页

关闭浏览器，再打开查看这两个页，如第5步截图效果

　　session的使用成功!

　　官方示例：https://github.com/visionmedia/express/blob/master/examples/session/index.js

如何使用cookies?

　　如果是登录，那常见就是“记录密码”或“自动登录”功能，这个一般用 cookies来完成

　　cookies存在客户端，安全性较低，一般要存入加密后的信息；建议要设置使用过期时间或不使用时删除掉

　　express也同样可以用中间件来使用：https://github.com/expressjs/cookie-parser

老套路，通过一个示例了解一下

　示例设计思路：在上面session示例的基础上，在usecookies部分登录同时记录cookies，来自动登录

在上面session示例的基础上修改一下usecookies.js

var express = require('express');
var router = express.Router();

router.get('/', function(req, res) {
   
  if(req.cookies.islogin)
  { 
       console.log('usecookies-cookies:' + req.cookies.islogin);
       req.session.islogin = req.cookies.islogin;
  }  
  
  if(req.session.islogin)
  {
      console.log('usecookies:' + req.session.islogin);
    res.locals.islogin = req.session.islogin;      
  }

  res.render('usecookies', { title: '使用cookies示例' });
});

router.post('/', function(req, res) {
  
  req.session.islogin = 'success';
  res.locals.islogin = req.session.islogin;

  res.cookie('islogin', 'sucess', { maxAge: 60000 });

  res.render('usecookies', { title: '使用cookies示例' });
});

module.exports = router;

运行访问 http://localhost:8000/usecookies，点击登录按钮登录成功并记录cookies

maxAge为过期时长，毫秒为单位，我设置一分钟

关闭浏览器，再次访问http://localhost:8000/usecookies ，页面显示已登录
再次关闭浏览器，过一分钟再访问http://localhost:8000/usecookies，页面不再是已登录，而是显示登录按钮，表示cookies过期，不会自动登录

　　cookies的使用到此也成功！

　　官方示例：https://github.com/visionmedia/express/blob/master/examples/cookies/app.js　　　

如何清除session和cookies?

　　清除非常简单，就不用示例说明了，有兴趣自已定义个路由规则，试试

//清除cookies
res.clearCookie('islogin');
  
//清除session
req.session.destroy();

写在之后

　　最近比较忙，更新距上了篇时间较长了，本篇东西讲的比较杂，讲到的也比较有限，主要是为了后来会写的一个示例打基础；

　　本篇内容讲到的一些知识点，其实都可以单独拿一整篇去讲，本篇基本原则是为了看了之后能使用；

　　要想弄清楚原理或者更多的相关知识，自已可以花点时间去了解，或者找点资料去丰富一下，当然也可以留言，在我觉得我没乱说的情况下我会尽量解答^_^！

Next： modeJS（2）深了解： nodeJS 项目架构详解（app.js + Express + Http）