nodejs express

Posted 2020-09-12 沧海一滴

安装

假设您已经安装了 Node.js，创建目录以保存应用程序，并将其设置为工作目录。
$ mkdir myapp
$ cd myapp
使用 npm init 命令为应用程序创建 package.json 文件。 有关 package.json 工作方式的更多信息，请参阅 Specifics of npm’s package.json handling。

$ npm init
此命令提示您输入若干项，例如应用程序的名称和版本。 现在，只需按回车键以接受其中大多数项的缺省值，但以下情况例外：
entry point: (index.js)
输入 app.js，或者您希望使用的任何主文件名称。如果希望文件名为 index.js，请按回车键以接受建议的缺省文件名。
在 app 目录中安装 Express，然后将其保存在依赖项列表中。例如：

$ npm install express --save
要暂时安装 Express 而不将其添加到依赖项列表中，请省略 --save 选项：

$ npm install express
采用 --save 选项安装的 Node 模块已添加到 package.json 文件中的 dependencies 列表。 今后运行 app 目录中的 npm install 将自动安装依赖项列表中的模块。

http://expressjs.com/zh-cn/starter/installing.html

Hello world 示例
这基本上是您可以创建的最简单的 Express 应用程序。这是单个文件应用程序 — 根本不需要动用 Express 生成器。Express 生成器的作用就像是为完整的应用程序建立一个“脚手架”，包含各种用途的 javascript 文件、Jade 模板和子目录。
首先创建名为 myapp 的目录，切换到此目录，然后运行 npm init。根据安装指南将 express 安装为依赖项。

在 myapp 目录中，创建名为 app.js 的文件，然后添加以下代码：

var express = require(‘express‘);
var app = express();

app.get(‘/‘, function (req, res) {
res.send(‘Hello World!‘);
});

app.listen(3000, function () {
console.log(‘Example app listening on port 3000!‘);
});

应用程序会启动服务器，并在端口 3000 上侦听连接。此应用程序以“Hello World!”响应针对根 URL (/) 或路由的请求。对于其他所有路径，它将以 404 Not Found 进行响应。
req（请求）和 res（响应）与 Node 提供的对象完全相同，所以您可以在不涉及 Express 的情况下调用 req.pipe()、req.on(‘data‘, callback) 和要执行的其他任何函数。
使用以下命令运行应用程序：
$ node app.js
然后，在浏览器中装入 http://localhost:3000/ 以查看输出。
http://expressjs.com/zh-cn/starter/hello-world.html

基本路由
路由用于确定应用程序如何响应对特定端点的客户机请求，包含一个 URI（或路径）和一个特定的 HTTP 请求方法（GET、POST 等）。
每个路由可以具有一个或多个处理程序函数，这些函数在路由匹配时执行。
路由定义采用以下结构：
app.METHOD(PATH, HANDLER)
其中：
app 是 express 的实例。
METHOD 是 HTTP 请求方法。
PATH 是服务器上的路径。
HANDLER 是在路由匹配时执行的函数。
本教程假定创建了名为 app 的 express 实例且服务器正在运行。如果您对创建和启动应用程序并不熟悉，请参阅 Hello world 示例。
以下示例演示了如何定义简单路由。

以主页上的 Hello World! 进行响应：
app.get(‘/‘, function (req, res) {
res.send(‘Hello World!‘);
});

在根路由 (/) 上（应用程序的主页）对 POST 请求进行响应：
app.post(‘/‘, function (req, res) {
res.send(‘Got a POST request‘);
});

对 /user 路由的 PUT 请求进行响应：
app.put(‘/user‘, function (req, res) {
res.send(‘Got a PUT request at /user‘);
});

对 /user 路由的 DELETE 请求进行响应：
app.delete(‘/user‘, function (req, res) {
res.send(‘Got a DELETE request at /user‘);
});
有关路由的更多详细信息，请参阅路由指南。
http://expressjs.com/zh-cn/starter/basic-routing.html

路由

路由表示应用程序端点 (URI) 的定义以及端点响应客户机请求的方式。 有关路由的简介，请参阅基本路由。

以下代码是非常基本的路由示例。

var express = require(‘express‘);
var app = express();

// respond with "hello world" when a GET request is made to the homepage
app.get(‘/‘, function(req, res) {
res.send(‘hello world‘);
});

路由方法
路由方法派生自 HTTP 方法之一，附加到 express 类的实例。

以下代码是为访问应用程序根目录的 GET 和 POST 方法定义的路由示例。

// GET method route
app.get(‘/‘, function (req, res) {
res.send(‘GET request to the homepage‘);
});

// POST method route
app.post(‘/‘, function (req, res) {
res.send(‘POST request to the homepage‘);
});

Express 支持对应于 HTTP 方法的以下路由方法：get、post、put、head、delete、options、trace、copy、lock、mkcol、move、purge、propfind、proppatch、unlock、report、mkactivity、checkout、merge、m-search、notify、subscribe、unsubscribe、patch、search 和 connect。

要路由会转换为无效 JavaScript 变量名称的方法，请使用括号表示法。例如，app[‘m-search‘](‘/‘, function ...
有一种特殊路由方法：app.all()，它并非派生自 HTTP 方法。该方法用于在所有请求方法的路径中装入中间件函数。

在以下示例中，无论您使用 GET、POST、PUT、DELETE 还是在 http 模块中支持的其他任何 HTTP 请求方法，都将为针对“/secret”的请求执行处理程序。

app.all(‘/secret‘, function (req, res, next) {
console.log(‘Accessing the secret section ...‘);
next(); // pass control to the next handler
});

路由路径
路由路径与请求方法相结合，用于定义可以在其中提出请求的端点。路由路径可以是字符串、字符串模式或正则表达式。

Express 使用 path-to-regexp 来匹配路由路径；请参阅 path-to-regexp 文档以了解定义路由路径时所有的可能性。Express Route Tester 是用于测试基本 Express 路由的便捷工具，但是它不支持模式匹配。
查询字符串不是路由路径的一部分。
以下是基于字符串的路由路径的一些示例。

此路由路径将请求与根路由 / 匹配。

app.get(‘/‘, function (req, res) {
res.send(‘root‘);
});

此路由路径将请求与 /about 匹配。

app.get(‘/about‘, function (req, res) {
res.send(‘about‘);
});

此路由路径将请求与 /random.text 匹配。

app.get(‘/random.text‘, function (req, res) {
res.send(‘random.text‘);
});

以下是基于字符串模式的路由路径的一些示例。

此路由路径将匹配 acd 和 abcd。

app.get(‘/ab?cd‘, function(req, res) {
res.send(‘ab?cd‘);
});

此路由路径将匹配 abcd、abbcd、abbbcd 等。

app.get(‘/ab+cd‘, function(req, res) {
res.send(‘ab+cd‘);
});

此路由路径将匹配 abcd、abxcd、abRABDOMcd、ab123cd 等。

app.get(‘/ab*cd‘, function(req, res) {
res.send(‘ab*cd‘);
});

此路由路径将匹配 /abe 和 /abcde。

app.get(‘/ab(cd)?e‘, function(req, res) {
res.send(‘ab(cd)?e‘);
});

字符 ?、+、* 和 () 是其正则表达式同应项的子集。基于字符串的路径按字面理解连字符 (-) 和点 (.)。
基于正则表达式的路由路径的示例：

此路由路径将匹配名称中具有“a”的所有路由。

app.get(/a/, function(req, res) {
res.send(‘/a/‘);
});

此路由路径将匹配 butterfly 和 dragonfly，但是不匹配 butterflyman、dragonfly man 等。

app.get(/.*fly$/, function(req, res) {
res.send(‘/.*fly$/‘);
});

路由处理程序
您可以提供多个回调函数，以类似于中间件的行为方式来处理请求。唯一例外是这些回调函数可能调用 next(‘route‘) 来绕过剩余的路由回调。您可以使用此机制对路由施加先决条件，在没有理由继续执行当前路由的情况下，可将控制权传递给后续路由。

路由处理程序的形式可以是一个函数、一组函数或者两者的结合，如以下示例中所示。

单个回调函数可以处理一个路由。例如：

app.get(‘/example/a‘, function (req, res) {
res.send(‘Hello from A!‘);
});

多个回调函数可以处理一个路由（确保您指定 next 对象）。例如：

app.get(‘/example/b‘, function (req, res, next) {
console.log(‘the response will be sent by the next function ...‘);
next();
}, function (req, res) {
res.send(‘Hello from B!‘);
});

一组回调函数可以处理一个路由。例如：

var cb0 = function (req, res, next) {
console.log(‘CB0‘);
next();
}

var cb1 = function (req, res, next) {
console.log(‘CB1‘);
next();
}

var cb2 = function (req, res) {
res.send(‘Hello from C!‘);
}

app.get(‘/example/c‘, [cb0, cb1, cb2]);

独立函数与一组函数的组合可以处理一个路由。例如：

var cb0 = function (req, res, next) {
console.log(‘CB0‘);
next();
}

var cb1 = function (req, res, next) {
console.log(‘CB1‘);
next();
}

app.get(‘/example/d‘, [cb0, cb1], function (req, res, next) {
console.log(‘the response will be sent by the next function ...‘);
next();
}, function (req, res) {
res.send(‘Hello from D!‘);
});

响应方法
下表中响应对象 (res) 的方法可以向客户机发送响应，并终止请求/响应循环。如果没有从路由处理程序调用其中任何方法，客户机请求将保持挂起状态。

方法	描述
res.download()	提示将要下载文件。
res.end()	结束响应进程。
res.json()	发送 JSON 响应。
res.jsonp()	在 JSONP 的支持下发送 JSON 响应。
res.redirect()	重定向请求。
res.render()	呈现视图模板。
res.send()	发送各种类型的响应。
res.sendFile	以八位元流形式发送文件。
res.sendStatus()	设置响应状态码并以响应主体形式发送其字符串表示。

app.route()
您可以使用 app.route() 为路由路径创建可链接的路由处理程序。 因为在单一位置指定路径，所以可以减少冗余和输入错误。有关路由的更多信息，请参阅 Router() 文档。

以下是使用 app.route() 定义的链式路由处理程序的示例。

app.route(‘/book‘)
.get(function(req, res) {
res.send(‘Get a random book‘);
})
.post(function(req, res) {
res.send(‘Add a book‘);
})
.put(function(req, res) {
res.send(‘Update the book‘);
});

express.Router
使用 express.Router 类来创建可安装的模块化路由处理程序。Router 实例是完整的中间件和路由系统；因此，常常将其称为“微型应用程序”。

以下示例将路由器创建为模块，在其中装入中间件，定义一些路由，然后安装在主应用程序的路径中。

在应用程序目录中创建名为 birds.js 的路由器文件，其中包含以下内容：

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

// middleware that is specific to this router
router.use(function timeLog(req, res, next) {
console.log(‘Time: ‘, Date.now());
next();
});
// define the home page route
router.get(‘/‘, function(req, res) {
res.send(‘Birds home page‘);
});
// define the about route
router.get(‘/about‘, function(req, res) {
res.send(‘About birds‘);
});

module.exports = router;

接着，在应用程序中装入路由器模块：

var birds = require(‘./birds‘);
...
app.use(‘/birds‘, birds);

此应用程序现在可处理针对 /birds 和 /birds/about 的请求，调用特定于此路由的 timeLog 中间件函数。
http://expressjs.com/zh-cn/guide/routing.html