第3 章 Node.js 的Web 应用

本章将介绍Node.js 的Web 应用，主要包括HTTP 服务器、Node.js 静态资源管理、

Node.js 的文件处理功能、Cookie 和Session 的应用、Node.js 安全加密，介绍Node.js

如何与Nginx 搭档。

本章将会结合"文字直播Web 应用"来贯穿本章的知识点。文字直播应用是一个长连

接多请求的应用，Node.js 在这方面具有非常大的优势，因此本章使用该例子来介绍本章知

识点。该应用使用Node.js 开发可以在很大程度上降低服务器压力，同时给予用户一个更

好的在线体验。文字直播Web 应用需求简单介绍如下。

用户：直播员(需登录)，游客。

直播方式：直播员登录后台，输入相应的直播信息，可包含图片和文字。

技术统计：需在线实时记录运动员数据。

游客讨论：游客可实时进行在线讨论。

微博分享：游客可通过腾讯微博和新浪微博分享直播内容。

3.1 HTTP 服务器

本节将介绍如何应用Node.js 创建一个HTTP 服务器来处理客户端的POST 和GET 数

据请求，以及服务器端Node.js 如何实现url 路由请求处理。会介绍Node.js 模块中的

HTTP 和HTTPS。重点是介绍如何实现Node.js 的服务器路由。

3.1.1 简单的HTTP 服务器

创建一个HTTP 服务器的相关知识点在Node.js 的配置开发已经有所介绍。应用

Node.js HTTP 模块中的createServer() API。代码如下：

var http = require('http');

/ 应用Node.js 的原生模块HTTP 来实现Web 服务器创建 /

http.createServer(function(req, res) {

res.writeHead(200, { 'Content-Type': 'text/plain' });

res.end('Hello World\n');

}).listen(1337, "127.0.0.1");

console.log('Server running at 127.0.0.1:1337/');

http.createServer()接收一个request 事件函数，该事件函数有两个参数request 和

Node.js 开发实战详解

·78 ·

response，request 是 http.ServerReques1的实例对象，response 则为http.ServerRespons2实例

对象。request 对象主要是获取请求资源信息，包括请求的url、客户端参数、资源文件、

header 信息、HTTP 版本、设置客户端编码等。Response 对象主要是响应客户端请求数据，

包括HTTP 的header 处理、HTTP 请求返回码、响应请求数据等。

http.createServer()调用返回的是一个server 对象，server 对象拥有listen 和close 方法，

listen 方法可以指定监听的IP 和端口。

实例介绍：创建一个HTTP 服务器，获取并输出请求url、method 和headers，同时根

据请求资源做不同的输出。

当请求'/index'，返回200，并且返回一个html 页面数据到客户端。

当请求'/img'，返回200，并且返回一个图片数据。

若为其他情况，则返回404，并输出'can not find source'。

先创建HTTP 服务器，使用switch 判断请求资源类型分配。代码如下：

/ http.js /

var http = require('http'),

fs = require('fs'),

url = require('url');

/ 创建http 服务器 /

http.createServer(function(req, res) {

/ 获取Web 客户端请求路径 /

var pathname = url.parse(req.url).pathname;

/ 打印客户端请求req 对象中的url、method 和headers 属性 /

console.log(req.url);

console.log(req.method);

console.log(req.headers);

/ 根据pathname，路由调用不同处理逻辑 /

switch(pathname){

case '/index' : resIndex(res); // 响应HTML 页面到Web 客户端

break;

case '/img' : resImage(res); // 响应图片数据到Web 客户端

break;

default : resDefault(res); // 响应默认文字信息到Web 客户端

break;

}

}).listen(1337);

[代码说明]

var pathname = url.parse(req.url).pathname：获取客户端请求路径。

console.log(req.url)：输出请求url。

console.log(req.method)：输出请求方法。

console.log(req.headers)：输出请求header 信息。

resIndex(res)：判断请求参数是否为/index，如果是就执行resIndex(res)。

resImage(res)：判断请求参数是否为/img，如果是就执行resImage(res)。

resDefault(res)：返回404 not find。

1 参考网站nodejs.org/api/http.html#http_class_http_serverrequest。

2 参考网站nodejs.org/api/http.html#http_class_http_serverresponse。

第3 章 Node.js 的Web 应用

·79·

记住要把res 参数传递到处理返回函数，如果需要执行HTTP 响应请求时，也必须将

req 传递到处理函数。代码如下：

/

@desc 创建resIndex 响应首页html 函数

@parameters res HTTP 响应对象

/

function resIndex(res){

/ 获取当前index.html 的路径 /

var readPath = __dirname + '/' +url.parse('index.html').pathname;

var indexPage = fs.readFileSync(readPath);

res.writeHead(200, { 'Content-Type': 'text/html' });

res.end(indexPage);

}

/

@desc 创建resImage 响应image 函数

@parameters res HTTP 响应对象

/

function resImage(res){

/ 获取当前image 的路径 /

var readPath = __dirname + '/' +url.parse('logo.png').pathname;

var indexPage = fs.readFileSync(readPath);

res.writeHead(200, { 'Content-Type': 'image/png' });

res.end(indexPage);

}

/

@desc 创建resDefault 响应404 函数

@parameters res HTTP 响应对象

/

function resDefault(res){

res.writeHead(404, { 'Content-Type': 'text/plain' });

res.end('can not find source');

}

[代码说明]

resIndex(res)处理并返回'Content-Type': 'text/html'的html 页面。

esImage(res)处理并返回'Content-Type': 'image/png'的png 图片。

resDefault(res)处理并返回404 输出'can not find source'。

执行http.js，打开浏览器，输入不同的请求资源，查看和比较不同的返回结果。

node http.js

(1)打开浏览器，输入127.0.0.1:13371，如图3-1 所示返回了404，并输出了'can not find

source'。

1 本文输入的192.168.1.120:1337 为个人的一个测试服务器，和本地服务器IP 地址127.0.0.1:1337

是一致的，读者输入的是127.0.0.1:1337。

Node.js 开发实战详解

·80 ·

图3-1 浏览127.0.0.1:1337 返回Web 页面图

(2)HTTP 新增请求路径/index，127.0.0.1:1337/index，如图3-2 所示返回200，并输出

index.html 页面内容。

图3-2 浏览127.0.0.1:1337/index 返回Web 页面图

(3)改变HTTP 路径为/img，127.0.0.1:1337/img，如图3-3 所示返回200，并输出了一

个png 的logo 图片。

图3-3 浏览127.0.0.1:1337/img 返回Web 页面图

如图3-4 所示为服务器端输出的结果，这里只截取了部分，输出的结果包含了每次请

求的url，method 和请求headers。可以看到每次HTTP 请求都会自带一个/favicon.ico 请求，

这个是网页的ico，是大多数浏览器自我发出的请求，如果需要去除这个请求，可以设置返

回一个有效的/favicon.ico 文件，并且指定expire 时间。

第3 章 Node.js 的Web 应用

·81·

图3-4 Node.js 服务器运行流水日志图

3.1.2 路由处理

了解Node.js 服务器创建功能实现后，接下来介绍根据不同客户端的请求资源路径，

来分配服务器处理逻辑。在3.1.1 节中已经初步了解到可以使用switch 来实现路由，当然

这是一种路由处理办法，但是在请求资源非常复杂时，使用switch 来判断处理就会显得很

庞大，而且难以维护和扩展。本节将介绍两种路由处理方法，大家可根据自己的想法设计

出更多的路由处理方法，另外在本章的习题1 中还会提供第三种路由处理方法。

1.特定规则请求路径

特定规则请求参数：可以根据用户请求的url，依据特定的规则得到相应的执行函数，

例如请求参数/index，根据特定规则转化为resIndex(res, req)方法。

这里将HTTP 的请求路径/index，根据一定的规则得到其处理函数resIndex，当我们需要

新增处理逻辑时，例如/img，则必须在服务器端新增处理函数resImg。具体实现过程如下：

var param = pathname.substr(2),

// 获取客户端请求的url 路径，并获取其及时个参数，将其小写转为大写

firstParam = pathname.substr(1,1).toUpperCase();

// 根据pathname 获取其需要执行的函数名

var functionName = 'res' + firstParam + param;

response = res;

if(pathname == '/'){

resDefault(res)

} else if (pathname == '/favicon.ico') {

return;

}

else{

eval(functionName + '()');

}

[代码说明]

firstParam = pathname.substr(1,1).toUpperCase()：将参数的首字母改为大写，例如

/index，获取i，并将其改为大写的I；

Node.js 开发实战详解

·82 ·

functionName = 'res' + firstParam + param：获取需要执行的函数名，res 为前缀，

firstParam 为首字母，例如/index，firstParam 为I，param 为ndex，因此functionName

为resIndex；

pathname == '/'：无参数时返回default 页面；

pathname == '/favicon.ico'：对于该请求返回空信息；

eval(functionName + '()')：使用eval 执行字符串函数。

该方法有一个很明显的缺点，就是res 和req 参数必须设置为全局变量，否则函数中无

法获取该res 和req 对象参数。

这里只是介绍了一种实现方式，可以根据/param 参数来判断需要调用的模块和函数，

对于小项目而言可以实现这种路由处理。

2.利用附带参数来实现路由处理

利用自带参数来实现路由处理：url 路径指定需要执行的模块，通过在HTTP 的url 中

携带一个c 参数，表示需要调用的模块中的方法名，从而实现简单的路由处理。例如

/image?c=img 表示获取index 模块中img 方法，同样/index?c=index 表示获取index 模块中

的index 方法。具体实现是创建client.js 作为服务器模块，代码如下：

/ 首先require 加载两个模块 /

var http = require('http'),

url = require('url'),

querystring = require("querystring");

/

@desc 创建web 服务器

/

http.createServer(function(req, res) {

/ 获取用户请求的url 路径 /

var pathname = url.parse(req.url).pathname;

if (pathname == '/favicon.ico') { // 过滤浏览器默认请求/favicon.ico

return;

}

/ 根据用户请求的url 路径，截取其中的module 和controller /

var module = pathname.substr(1),

str = url.parse(req.url).query,

controller = querystring.parse(str).c,

classObj = '';

try { // 应用try catch 来require 一个模块，并捕获其异常

classObj = require('./' + module);

}

catch (err) { // 异常错误时，打印错误信息

console.log('chdir: ' + err);

}

if(classObj){ // require 成功时，则应用call 方法，实现类中的方法调用执行

classObj.init(res, req);

classObj[controller].call();

} else { // 调用不存在的模块时，则默认返回404 错误信息

res.writeHead(404, { 'Content-Type': 'text/plain' });

res.end('can not find source');

}

}).listen(1337);

第3 章 Node.js 的Web 应用

·83·

[代码说明]

var pathname = url.parse(req.url).pathname：获取客户端的HTTP 请求路径，也就是

请求模块；

controller = querystring.parse(str).c：获取请求参数c，也就是请求模块的方法；

classObj = require('./' + module)：使用try catch 获取一个require 模块；