独木舟的木

iOS Developer

0%

Node.js 实战_5.Connect 自带的中间件

发表于 更新于 分类于 Valine：
本文字数： 2.4k 阅读时长 ≈ 2 分钟

💡
这一章是《Node.js 实战》笔记，但是书中的源码实现与官方文档有出入，Connect “自带” 的中间件好像是需要单个独立导入才能使用。
以下仅作为记录，实际项目使用待研究验证。

Connect 自带的中间件

Connect 自带的中间件可以满足常见的 Web 程序开发需求：

  • 会话管理；
  • cookie 解析；
  • 请求主体解析
  • 请求日志
  • …

下面的这些中间件是独立呈现的，需要 npm 单独导入

Connect 中间件

image

解析 cookie、请求主体和查询字符串的中间件

Connect 的 cookie 解析器支持常规 cookie、签名 cookie 和特殊的 JSON cookie。
req.cookies 默认是用常规未签名 cookie 组装而成的。如果你想支持 session () 中间件要求的签名 cookie，在创建 cookieParser () 实例时要传入一个加密用的字符串。

const connect = require('connect');

// 作为参数传给cookieParser()的秘钥用来对cookie签名和解签
var app = connect()
    .use(connect.cookieParser('tobi is a cook ferret')) 
    .use(function (req, res) {
        console.log(req.cookies);
        console.log(req.signedCookies);
        res.end('hello\n');
    })
    .listen(3000);

// 不带cookie
// curl http://localhost:3000/

// 常规cookie
// curl http://localhost:3000/ -H "Cookie: foo=bar, bar=baz"

签名 cookie

签名 cookie 更适合敏感数据，因为用它可以验证 cookie 数据的完整性，有助于防止中间人攻击。有效的签名 cookie 放在 req.signedCookies 对象中。

假设你设定了一个键为 name，值为 luna 的签名 cookie。cookieParser 会将 cookie 编码为 luna.PQLM0wNvqOQEObZXUkWbS5m6Wlg。每个请求中的哈希值都会检查，如果 cookie 完好无损地传上来，它会被解析为 req.signedCookies.name:

特别的 JSON cookie 带有前缀 j:，告诉 Connect 它是一个串行化的 JSON。 JSON cookie 既可以是签名的，也可以是未签名的。

curl http://localhost:3000/ -H 'Cookie: foo=bar, bar=j:{"foo":"bar"}'

设定出站 cookie

cookieParser () 中间件没有提供任何通过 Set-Cookie 响应头向 HTTP 客户端写出站 cookie 的功能。但 Connect 可以通过 res.setHeader () 函数写入多个 Set-Cookie 响应头。

const connect = require('connect');

var app = connect()
    .use(function (req, res) {
        res.setHeader('Set-Cookie', 'foo=bar'); // 设定cookie：foo=bar
        res.setHeader('Set-Cookie', 'tobi=ferret; Expires=Tue, 08 Jun 2021 10:18:14 GMT'); // 设定cookie有效期
        res.end();
    }).listen(3000);

// curl http://localhost:3000/ --head

bodyParser ()：解析请求主体

bodyParser () 组件为你提供了 req.body 属性，可以用来解析 JSON、x-www-form-urlencoded 和 multipart/form-data 请求。如果是 multipart/form-data 请求，比如文件上传，则还有 req.files 对象。

var app = connect()
    .use(connect.bodyParser())
    .use(function(req, res) {
        // ...注册用户
        res.end('Registered new user: ' + req.body.username);
    }).listen(3000);

因为 bodyParser () 是根据 Content-Type 解析数据的，输入形式是抽象的，所以你的程序中只需要关心 req.body 数据对象的结果。

limit ()：请求主体的限制

目的：帮助过滤巨型的请求。

query ()：查询字符串解析

  • bodyParser ()：解析 POST 请求
  • query ()：解析 GET 请求。

query 中间件可以将请求发送过来的查询字符串以 JSON 格式作为响应返回去。

实现 Web 程序核心功能的中间件

  • logger ()：提供灵活的请求日志；
  • favicon ()：帮你处理 /favicon.ico 请求（favicon 是网站的小图标）;
  • methodOverride ()：让没有能力的客户端透明地重写 req.method;
  • vhost ()：在一个服务器上设置多个网站 (虚拟主机);
  • session ()：管理会话数据。

处理 Web 程序安全的中间件

  • basicAuth ()：为保护数据提供了 HTTP 基本认证；
  • csrf ()：实现对跨站请求伪造 (CSRF) 攻击的防护；
  • errorhandler ()：帮你在开发过程中进行调试。

提供静态文件服务的中间件

  • static ()：将文件系统中给定根目录下的文件返回给客户端；
  • compress ()：压缩响应，很适合跟 static () 一起使用；
  • directory ()：当请求的是目录时，返回那个目录的列表。

欢迎关注我的其它发布渠道