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 整合模板引擎

在项目中安装对应的模板引擎npm包：
设置以下运用程序设置：
- views: 模板文件所在的目录。例如：app.set('views', './views')。注意第一个参数是固定的写法 'views',第二个参数是模板文件所在的根路径
- view engine: 要使用的模板引擎。例如：app.set('view engine','pug')。第一个参数是固定的写法，第二个参数是模板文件的后缀名。
使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 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...');
 });

Express 后台接口开发

json 接口开发

Express 框架开发json 接口十分简单，使用响应方法：res.json(); 将数据传递给客户端即可。

参考下面的代码：

 //========== Express 框架开发后台接口 ==============
 const express = require('express');
 const app = express();
 const database = require('./database');
 
 //指定api路径 （json接口）
 app.get('/all-book',function (req,res) {
 	database.getAllData('book', function (result) {
 		res.json(result);
 	});
 });
 
 app.listen(3002, function (err) {
 	console.log('server running');
 });

jsonp 接口开发

Express 框架的jsonp接口开始与json接口开发十分的类似，使用 res.jsonp(); 方法即可。
默认情况下Express jsonp的回调函数的名称为 callback，可以通过 app.set('jsonp callback name',name); 来改变jsonp回调函数的名称。

参考下面的代码：

 //========== Express 框架开发后台接口 ==============
 const express = require('express');
 const app = express();
 const database = require('./database');

 // 指定api路径 （jsonp接口)
 app.set('jsonp callback name', 'jsonp');
 app.get('/all-book', function (req, res) {
 	database.getAllData('book', function (result) {
 		res.jsonp(result);
 	});
 });
 
 app.listen(3002, function (err) {
 	console.log('server running');
 });

Express 框架解决跨域问题

当我们在浏览器的console控制台中看到类似如下的信息：

Access to XMLHttpRequest at 'http://localhost:3001/books' from origin 'http://localhost:63342'
has been blocked by CORS policy: No 'Access-Control-Allow-Origin' header is present on the requested resource.

这表示存在着跨域问题。解决的办法就是在拦截每个请求的路由上添加'Access-Control-Allow-Origin' header。

下面是node express框架解诀跨域问题的代码，注意解决跨域的代码要放在处理路由的代之前，否则将会不起作用：

//===== 项目入口文件 =====
const express = require('express');
const app = express();
const bodyParser = require('body-parser');
const router = require('./router');

//----- 配置跨域 -----
// express框架解决跨域问题的代码，注意该代码要放在 app.use(router); 之前
app.all('*', (req, res, next) => {
    res.header("Access-Control-Allow-Origin", "*");
    res.header("Access-Control-Allow-Headers", "X-Requested-With");
    res.header("Access-Control-Allow-Methods", "PUT,POST,GET,DELETE,OPTIONS");
    res.header("X-Powered-By", 'Express');
    res.header("Content-Type", "application/json;charset=utf-8");
    next();
});

//----- 配置路由 -----
app.use(router);

//----- 配置参数解析-----
app.use(bodyParser.urlencoded({extended:true}));
app.use(bodyParser.json());

//----- 监听端口 -----
const port = process.env.port || 3001;
app.listen(port,(error) => {
    console.log(`server running on ${port}`);
});

Express 中有用的属性或方法

request(请求)

req.headers: 获取请求头

response（响应）

res.redirect(url)：重定向到指定的url页面。url: 重定向的页面的路径。
res.status(code): 向客户端响应状态码。如 res.status(400).json({flag:0});