express搭建简单的后台服务器(基础篇)

express搭建简单的后台服务器(基础篇)

本文简单对express的一些重要基础知识做一下记录,以加深自己对express基础的了解。

不得不说的路由

作为一个后台服务器,你必须要处理来自客户端的各种请求。这个时候,就要先定义各种请求的处理器,也就是路由。
引用express官方的解释。

路由是由一个 URI、HTTP 请求(GET、POST等)和若干个句柄组成,它的结构如下: app.METHOD(path, [callback…], callback), app 是 express 对象的一个实例, METHOD 是一个 HTTP 请求方法, path 是服务器上的路径, callback 是当路由匹配时要执行的函数。

路由方法

路由method有很多种,我们常见的有POST,GET两种。基本的写法如下。这里的路由地址可以是字符串,也可以是字符串模式或者正则表达式,req是请求对象,res是响应对象,next()负责将控制权交给下一个中间件。中间件的概念后面会提到。

1
2
3
4
5
6
7
8
9
10
11
// GET method route
app.get('/', function (req, res, next) {
res.send('GET request to the homepage');
next();
});

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

还有一种不区分请求方式的写法,不管使用 GET、POST、PUT、DELETE 或其他任何 http 模块支持的 HTTP 请求,句柄都会得到执行。

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

app.route()

通过这个方法创建路由路径的链式路由句柄。由于路径在一个地方指定,这样做有助于创建模块化的路由,而且减少了代码冗余和拼写错误。书写格式如下:

1
2
3
4
5
6
7
8
9
10
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 实例是一个完整的中间件和路由系统。这样我们就可以在一个文件中专门做路由处理,而在app.js中use这个中间件。
例如我们在一个routes.js文件中这样使用。

1
2
3
4
5
6
7
8
9
// routes.js文件
var express = require('express');
var router = express.Router();
// 定义网站主页的路由
router.get('/', function(req, res) {
res.send('home page');
});
// 这里把中间件导出,供app.js使用
module.exports = router;

app.js中这样使用:

1
2
3
4
5
6
7
var router = require('./router');
// 其他处理逻辑代码
...
...
...
// 最后use路由中间件
app.use('/', router);

静态文件

使用静态文件服务

express的静态文件可以放在public文件夹中。通过Express内置的express.static可以方便地托管静态文件,例如图片、CSS、JavaScript 文件等。

1
app.use(express.static('public'));

然后就可以访问public中的静态资源了。

1
http://localhost:3000/images/avatar.jpg

多个静态资源文件夹

如果静态资源存放在多个目录下面,我们可以多次调用 express.static 中间件。例如:

1
2
app.use(express.static('public'));
app.use(express.static('assets'));

挂在虚拟目录下

1
app.use('/resourse', express.static('public'));

那么访问的方式就是

1
http://localhost:3000/resourse/images/avatar.jpg

中间件

定义

什么叫中间件,引用官方的解释就是:

中间件(Middleware) 是一个函数,它可以访问请求对象(request object (req)), 响应对象(response object (res)), 和 web 应用中处于请求-响应循环流程中的中间件,一般被命名为 next 的变量。Express 是一个自身功能极简,完全是由路由和中间件构成一个的 web 开发框架:从本质上来说,一个 Express 应用就是在调用各种中间件。

中间件可以做的事情

(1)执行任何代码
(2)修改请求和响应对象
(3)终结请求-响应循环
(4)调用堆栈中的下一个中间件

中间件分类

应用级中间件

应用级中间件绑定到app对象,使用 app.use() 和 app.METHOD()。其中METHOD 是需要处理的 HTTP 请求的方法,例如 GET, PUT, POST 等等,全部小写。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
// 没有挂载路径的中间件,应用的每个请求都会执行该中间件
app.use(function (req, res, next) {
console.log('Time:', Date.now());
next();
});

// 挂载至 /user/:id 的中间件,任何指向 /user/:id 的请求都会执行它
app.use('/user/:id', function (req, res, next) {
console.log('Request Type:', req.method);
next();
});
// app.get
// app.post
// ...

路由级中间件

就是上文中说到的 express.Router(),是由app.use来调用。

错误处理中间件

错误处理中间件有 4 个参数,定义错误处理中间件时必须使用这 4 个参数。即使不需要 next 对象,也必须在签名中声明它,否则中间件会被识别为一个常规中间件,不能处理错误。

1
2
3
4
app.use(function(err, req, res, next) {
console.error(err.stack);
res.status(500).send('Something broke!');
});

内置中间件

express.static 是 Express 唯一内置的中间件。它负责在 Express 应用中托管静态资源。一般用法如下:

1
app.use(express.static(path.join(__dirname, 'public'), option));

express.static可以传option参数,option具体内容如下:
express.static传参

第三方中间件

第三方提供的中间件,如 cookie-parser等。也是由app.use加载。

1
2
3
var cookieParser = require('cookie-parser');
// 加载用于解析 cookie 的中间件
app.use(cookieParser());

扫一扫下方小程序码或搜索Tusi博客,即刻阅读最新文章!

Tusi博客

You forgot to set the qrcode for Alipay. Please set it in _config.yml.
You forgot to set the qrcode for Wechat. Please set it in _config.yml.
You forgot to set the business and currency_code for Paypal. Please set it in _config.yml.
You forgot to set the url Patreon. Please set it in _config.yml.
Your browser is out-of-date!

Update your browser to view this website correctly. Update my browser now

×