Express 框架
简介
-
Express 是基于Node.js 的极简web框架，它的运用十分的广泛。
-
Express 是一个路由和中间件web框架，其自身只有最低程度的功能：Express应用程序基本上是一系列中间件函数调用。
-
npm 安装：
npm install express --save -
express 入门案例：
const app = require('express')();
app.get('/', function (req, res) {
res.send('hello');
});
app.listen(3000,function () {
console.log('running...');
});
在Express 中提供静态文件
- 为了提供如图像、css文件和JavaScript文件之类的静态文件，请使用Express中的express.static 内置中间件函数。
- 将包含静态资源的目录的名称（即静态资源的根路径）传递给express.static 中间件函数，以便开始直接提供这些文件。例如，使用以下代码在名为
public的目录中提供图像、css文件和JavaScript文件。 - 使用
app.use(express.static('rootpath'))加载静态资源 - use() 方法的第一个参数可以指定一个虚拟路径。
- 可以指定多个目录作为静态资源目录，只需要将use()重复调用多次即可。
- 参考下面的代码：
//========== express 静态资源托管 ============
const EXPRESS = require('express');
const APP = EXPRESS();
APP.use('/static',EXPRESS.static('public'));
APP.use(EXPRESS.static('doc'));
APP.listen(3000,function () {
console.log('Express server running...');
});
Express 路由
基础路由
-
路由：根据请求路径和请求方式进行路径分发处理
-
http常用的请求方式：
- post 添加操作
- get 查询操作
- put 更新操作
- delete 删除操作
- get 为url 地址栏传递参数，而 post、 put、和delete 则通过请求体（body）传递参数。
-
restful api : 一种特定格式的URL
-
express 基础路由，参考下面的代码：
const EXPRESS = require('express');
const APP = EXPRESS();
//express基础路由
APP.get('/',function (req,res) {
res.send('get data');
});
APP.post('/',function (req,res) {
res.send('post data');
});
APP.put('/',function (req,res) {
res.send('put data');
});
APP.delete('/',function (req,res) {
res.send('delete data');
});
//直接使用use 可以拦截所有的请求
APP.use(function (req,res) {
res.send('ok');
});
APP.listen(3000,function () {
console.log('APP running...');
});
- app.route(): 为路由路径创建可连接的路由处理程序。因为在单一位置指定路径，所以可以减少冗余和输入错误。参考下面的代码：
app.route('/login')
.get(function (req,res) {
res.send('get ');
})
.post(function (req,res) {
res.send('post');
})
.put(function (req,res) {
res.send('put');
});
- express.Router: 使用express.Router类来创建可安装的模块化路由处理程序。Router实例是完整的中间件和路由系统；因此，常常称其为“微型应用程序”。参考下面的代码：
//============= 路由器处理模块 ==================
const express = require('express');
const router = express.Router();
//------------ 处理路由 -------------
router.get('/',function (req,res) {
res.send('ok');
});
//------------- 导出路由模块 -----------
module.exports = router;
express 中间件
-
中间件就是处理过程的一个环节，其本质是一个函数。
-
中间件函数能够访问请求对象（req),响应对象（res)以及应用程序的请求/响应循环中的下一个中间件函数。下一个中间函数通常由名为next的变量表示。
-
中间件函数可以执行以下任务：
- 执行任何代码
- 对请求和响应对象进行更改
- 结束请求/响应循环
- 调用堆栈中的下一个中间件函数
-
如果当前中间件函数没有结束请求/响应循环，那么它必须调用next()，以将控制权传递给下一个中间件函数。否则，请求将保持挂起状态。
-
Express 应用程序可以使用以下类型的中间件
- 应用层中间件
- 路由层中间件
- 错误处理中间件
- 内置中间件
- 第三方中间件
应用层中间件
-
使用app.use()和app.METHOD()函数将应用层中间件绑定到应用程序对象的实例，其中METHOD是中间件函数处理的请求方法的小写（如 get，post等）
-
应用层中间件的简单示例，参考下面的代码：
- 使用 app.use()
//=========== express 中间件 ==============
const EXPRESS = require('express');
const APP = EXPRESS();
let total = 0; //记录被访问的次数
APP.use('/www', function (req, res, next) {
console.log(`有人访问了, 访问时间：${Date.now()}`);
next(); //将控制权传递给下一个中间件函数
});
APP.use('/www', function (req, res, next) {
//记录访问日志
console.log('访问了：/www');
next();
});
APP.use('/www', function (req, res) {
total += 1;
console.log(`被访问的次数：${total} \n`);
res.send('result');
});
APP.listen(3000,function () {
console.log('APP running...');
});
- 使用 app.METHOD() ,注意 next('route') 是将控制权交给下个路由。参考下面的代码：
let cb0 = function (req, res, next) {
console.log('cb0');
next();
};
let cb1 = function (req, res, next) {
console.log('cb2');
next();
};
let cb2 = function (req, res) {
res.send('Hello word');
};
APP.get('/abc', [cb0, cb1, cb2]);
APP.listen(3000, function () {
console.log('APP running...');
});
路由器层中间件
-
路由器层中间件的工作方式与应用层中间件基本相同，差异之处在于它绑定到express.Router()的实例
-
使用方式：
const router = express.Router();，使用router.use() 和router.METHOD() 函数装入路由器层中间件。 -
参考下面的代码：
//=========== 路由器层中间件 ============
const EXPRESS = require('express');
const APP = EXPRESS();
const ROUTER = EXPRESS.Router();
ROUTER.get('/login',function (req,res,next) {
console.log(req.url);
next();
});
ROUTER.get('/login', function (req, res,next) {
res.send('router');
});
APP.listen(3000, function () {
console.log('server running...');
});
错误处理中间件
- 错误处理中间件函数的定义方式与其他中间件函数基本相同，差别在于错误处理函数有四个变量(err,req,res,next)；必须提供四个变量，即使无需使用next对象，也必须指定，否则next对象将被解析为常规中间件，从而无法处理错误。
- 请在其他app.use() 和路由调用之后，最后定义错误处理中间件。
- 参考下面的代码：
const EXPRESS = require('express');
const APP = EXPRESS();
APP.use('/', function (req, res) {
throw new Error('fail');
});
APP.use(function (err, req, res, next) {
console.log(err);
res.status(500).send('Something broke');
});
APP.listen(3000, function () {
console.log('running...');
});
内置中间件模块
- 自v.x 起，Express不再依赖于Connect。除了express.static外，Express 随附的所有中间件函数以单独模块的形式提供。
第三方中间件
-
使用第三方中间件向Express程序添加功能需要先安装该中间件
-
安装方式如：
npm install cookie-parser --save -
使用方式如下所示：
const EXPRESS = require('express');
const APP = EXPRESS();
const COOKIE = require('cookie');
APP.use(COOKIE());
Express 参数处理
- 使用
body-parser第三方中间件，安装方式：npm install body-parser - get 请求使用
req.query获得提交的数据 - post 请求使用
req.body获得提交的数据 - 参考下面的代码：
//========= express 参数处理 =============
const EXPRESS = require('express');
const APP = EXPRESS();
const bodyParser = require('body-parser');
//加载静态资源
APP.use('/static', EXPRESS.static('public'));
//使用参数解析中间件
//解析 application/x-www-form-urlencoded
APP.use(bodyParser.urlencoded({extended: false}));
//解析 application/json
APP.use(bodyParser.json());
// 获取get参数
APP.get('/login', function (req, res) {
console.log(req.query);
res.send('get params');
});
// 获取post 参数
APP.post('/login', function (req, res) {
console.log(req.body);
res.send('post params')
});
APP.listen(3000, function () {
console.log('server running...');
});
- Express 处理restful api 形式url的参数：
- 使用 req.params 属性得到参数对象，然后根据需要取出想要的数据即可
- 参考下面的代码：
//========== express 处理restful api ==========
const express = require('express');
const app = express();
const database = require('./database');
// 请求的url： http://localhost:3000/books/book/15
app.get('/books/book/:id', function (req,res) {
let id = req.params.id;
database.getById('book', id, function (result) {
res.json(result);
});
});
app.listen('3001', function (err) {
console.log('running...');
});
