Connect模块解析转载-白红宇

Connect模块解析转载

阅读量：6406 次

发布时间：2019-06-23

本文共 6124 字，大约阅读时间需要 20 分钟。

来自对《了不起的Node.js》一书的学习

Connect

Node.js为常规的网络应用提供了基本的API。然而，实际情况下，绝大部分网络应用都需要完成一系列类似的操作，这些类似的操作你一定不想每次都重复地基于原始的API去实现。

Connect是一个基于HTTP服务器的工具集，它提供了一种新的组织代码的方式来与请求、响应对象进行交互，称为中间件（middleware）。

中间件具有代码复用的好处。

案例

　　需求：实现一个后台服务，能响应浏览器请求站点目录下的images下的.jpg图片，并返回图片。

使用HTTP构建一个简单的网站

创建server.js，实现该服务器的基本功能（解析请求的URL地址，根据不同的URL请求，对应不同的操作，如：请求.jpg图片），代码如下所示：

/**

* 模块依赖

var http = require('http'),

fs = require('fs');

/**

* 创建服务器

var server = http.createServer(function(req, res) {

// 检查URL是否和服务器目录下的文件匹配，如果匹配，则读取该文件并展示出来

// 请求.jpg图片

if('GET' == req.method

&& '/images' == req.url.substr(0, 7)

&& '.jpg' == req.url.substr(-4)) {

// 返回对应图片

// ...

} else if('GET' == req.method && '/' == req.url) {

// 发送html文件，默认请求index.html

// ...

} else {

// 处理其他请求，返回404错误码

res.writeHead(404);

res.end('Not found');

}

});

server.listen(3000);

　　接下来的任务，当然是完成处理对应的请求。

2. 首先是请求图片时，使用fs.stat来检查文件是否存在。这里使用Node中的全局常量__dirname来获取当前服务器所在的路径。在

// 返回对应图片

代码下，增加对应操作：

fs.stat(__dirname + req.url, function(err, stat) {

// 如果检查文件是否存在时发生错误，则终止进程并发送HTTP 404状态码告知无法找到请求的图片。

// 对于stat成功但是路径所表示的并非是文件时，也要做此处理。

if(err || !stat.isFile()) {

res.writeHead(404);

res.end('Not Found');

return;

}

// 发送图片资源

});

　　接下来解决的问题是，发送图片资源或文件资源的问题，实际上也是服务器返回响应消息的问题。那么想想，如何返回呢？我们需要设置响应消息的Content-Type头信息，告诉浏览器，现在服务器将返回什么类型的数据。

3. 对于返回图片资源或文件资源的操作，区别只于在文件的路径和Content-Type头信息的不同而已，那么可以封装为如下方法：

/**

* 根据文件路径来获取文件内容，并添加'Content-Type'头信息

* @param {[type]} path 文件路径

* @param {[type]} type Content-Type头信息

* @return {[type]} [description]

function server(path, type) {

res.writeHead(200, {'Content-Type': type});

fs.createReadStream(path).pipe(res);

}

　　在对应发送图片资源的注释处，添加如下代码：

// 发送图片资源

serve(__dirname + req.url, 'application/jpg');

　　在对应发送html文件的注释处，添加如下代码：

// 发送html文件，默认请求index.html

// ...

serve(__dirname + '/index.html', 'text/html');

　　server.js完成！

4. 此外，补充一下 index.html 的内容：

<!DOCTYPE html>

<head>

<title>使用HTTP构建一个简单的网站</title>

<style>

img {

width: 300px;

}

</style>

</head>

<body>

<h1>My website</h1>

</body>

</html>

　　简单的显示4张图片（其实对应的就是4个请求.jpg图片资源的请求）。

5. 运行 node server.js，在浏览器中访问 http://127.0.0.1:3000，就能看到刚实现的网站了！如：

　　server.js的完整代码如下：

/**

* 模块依赖

var http = require('http'),

fs = require('fs');

/**

* 创建服务器

var server = http.createServer(function(req, res) {

// 检查URL是否和服务器目录下的文件匹配，如果匹配，则读取该文件并展示出来

// 请求.jpg图片

if('GET' == req.method

&& '/images' == req.url.substr(0, 7)

&& '.jpg' == req.url.substr(-4)) {

// 返回对应图片

// ...

fs.stat(__dirname + req.url, function(err, stat) {

// 如果检查文件是否存在时发生错误，则终止进程并发送HTTP 404状态码告知无法找到请求的图片。

// 对于stat成功但是路径所表示的并非是文件时，也要做此处理。

if(err || !stat.isFile()) {

res.writeHead(404);

res.end('Not Found');

return;

}

// 发送图片资源

serve(__dirname + req.url, 'application/jpg');

});

} else if('GET' == req.method && '/' == req.url) {

// 发送html文件，默认请求index.html

// ...

// console.log(__dirname);

serve(__dirname + '/index.html', 'text/html');

} else {

// 处理其他请求，返回404错误码

res.writeHead(404);

res.end('Not found');

}

/**

* 根据文件路径来获取文件内容，并添加'Content-Type'头信息

* @param {[type]} path 文件路径

* @param {[type]} type Content-Type头信息

* @return {[type]} [description]

function serve(path, type) {

res.writeHead(200, {'Content-Type': type});

fs.createReadStream(path).pipe(res);

}

});

server.listen(3000);

通过Connect实现一个简单的网站

　　接下来这个例子是要实现一个网站，该例子展示了创建网站时一些常见的任务：

　　- 托管静态文件。

　　- 处理错误以及损坏或者不存在的URL。

　　- 处理不同类型的请求。

　　基于http模块API之上的Connect，提供了一些工具方法能够让这些重复性的处理便于实现，以至于让开发者能够更加专注在应用本身。

1. 初始化项目——npm init，创建package.json文件，并在其中声明对“connect”模块的依赖：

{

"name": "my-website",

"version": "0.0.1",

"description": "",

"main": "index.js",

"scripts": {

"test": "echo \"Error: no test specified\" && exit 1"

"author": "",

"license": "ISC",

"dependencies": {

"connect": "1.8.7"

}

　　使用 npm install 命令安装依赖。

2. 在server.js中使用use()方法来添加static中间件。（中间件是什么呢？我也不清楚耶，快看到下一节了。中间件，其实就是一个简单的JavaScript函数。）

/**

* 模块依赖

var connect = require('connect');

/**

* 创建服务器

var server = connect.createServer();

/**

* 处理静态文件

* 这里，我们配置static中间件——通过传递一些参数给connect.static方法，该方法本身会返回一个方法

* （被返回的方法应该是中间件吧~）

server.use(connect.static(__dirname + '/website'));

server.listen(3000);

　　运行 node server.js（啊？这就好了？！刚写一堆，现在用了Connect模块就几行而已了？没错，是的）。试着在浏览器访问，成功见到index.html的样子了！那我们访问不存在的url呢（事实上，Connect会帮我们处理404的情况），例如，我们可以访问 /test 来验证。浏览器将显示如下结果：

Cannot GET /test

　　注：记得把index.html 和 images文件夹等静态资源放置到项目目录下的website文件夹下。

中间件

　　在没有使用中间件的情况下，处理请求的这些代码都放在一个简单的事件处理器中（createServer的回调函数中），这将会是一个非常复杂的处理过程。而使用中间件后会将应用拆分为更小单元（让代码有更强大的表达能力），还能够实现很好的重用性。

　　如之前用HTTP方式所写的应用，使用中间件模式可以写成这样（当然这里也仍然需要到Connect模块啦） server-http.js：

/**

* 模块依赖

var connect = require('connect');

var fs = require('fs');

var serve =

/**

* 根据文件路径来获取文件内容，并添加'Content-Type'头信息