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 删除操作
- 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 整合模板引擎
- 在项目中安装对应的模板引擎npm包:
- 设置以下运用程序设置:
- views: 模板文件所在的目录。例如:
app.set('views', './views')
。注意第一个参数是固定的写法 ‘views’,第二个参数是模板文件所在的根路径 - view engine: 要使用的模板引擎。例如:
app.set('view engine','pug')
。 第一个参数是固定的写法,第二个参数是模板文件的后缀名。
- views: 模板文件所在的目录。例如:
- 使express兼容模板引擎 例如:
app.engine('art',require('express-art-template'));
- 通过
res.render('模板名称',data);
来渲染模板。 - 具体参考下面的代码:
//============ express 整合模板引擎 ================ const express = require('express'); const app = express(); const path = require('path'); //设置模板的路径 app.set('views',path.join(__dirname,'views')); //设置模板引擎 app.set('view engine', 'art'); //使express兼容art-template模板引擎 app.engine('art',require('express-art-template')); let data = { //水果---模板引擎渲染需要的数据 title: '水果', list: ['apple', 'banana', 'chestnut'] }; app.get('/',function (req,res) { res.render('list.art',data); }); app.listen(3000, function () { console.log('running...'); });
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 BODY_PARSER = 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 中有用的方法
response(响应)
- res.redirect(url):重定向到指定的url页面。url: 重定向的页面的路径。