Node.js之Express框架的使用

偏执的太偏执、 2023-02-17 03:59 6阅读 0赞

### Node.js之Express框架的使用 ###

*  Node.js之Express框架的使用
 *   *  1 Express框架介绍
     *   *  1.1 Express框架简介与特性
         *  1.2 Express初步使用
     *  2 Express框架中间件
     *   *  2.1 中间件介绍
         *  2.2 app.use中间件的用法
         *  2.3 中间件应用
         *  2.4 错误处理中间件
         *  2.5 异步函数错误的捕获
     *  3 Express框架请求处理
     *   *  3.1 构建模块化路由
         *  3.2 get请求参数
         *  3.3 post请求参数
         *  3.4 Express路由参数
         *  3.5 静态资源访问功能
     *  4 express-art-template模板引擎
     *   *  4.1 Express中模板引擎的用法
         *  4.2 app.locals对象

# Node.js之Express框架的使用 #

## 1 Express框架介绍 ##

### 1.1 Express框架简介与特性 ###

**1.Express介绍：**  
Express是一个基于Node平台的web应用开发框架，它提供了一系列的强大特性，帮助你创建各种Web应用。  
我们可以使用 npm install express 命令进行下载。

**2.Express框架特性 ：**

*  提供了方便简洁的路由定义方式
 *  对获取HTTP请求参数进行了简化处理
 *  对模板引擎支持程度高，方便渲染动态HTML页面
 *  提供了中间件机制有效控制HTTP请求
 *  拥有大量第三方中间件对功能进行扩展

### 1.2 Express初步使用 ###

使用Express框架创建web服务器及其简单，调用express模块返回的函数即可。

// 引入express框架
    const express = require('express');
    // 创建网站服务器
    const app = express();
    
    app.get('/' , (req, res) => { 
    	// send()
    	// 1. send方法内部会检测响应内容的类型
    	// 2. send方法会自动设置http状态码
    	// 3. send方法会帮我们自动设置响应的内容类型及编码
    	res.send('Hello. Express');
    })
    
    app.get('/list', (req, res) => { 
    	res.send({ name: '张三', age: 20})
    })
    
    // 监听端口
    app.listen(3000);
    console.log('网站服务器启动成功');

## 2 Express框架中间件 ##

### 2.1 中间件介绍 ###

1.中间件就是一堆方法，可以接收客户端发来的请求、可以对请求做出响应，也可以将请求继续交给下一个中间件继续处理。  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQzNTM3NzIx_size_16_color_FFFFFF_t_70_pic_center]  
2.中间件主要由两部分构成，中间件方法以及请求处理函数。  
中间件方法由Express提供，负责拦截请求，请求处理函数由开发人员提供，负责处理请求。

app.get('请求路径', '处理函数')   // 接收并处理get请求
     app.post('请求路径', '处理函数')  // 接收并处理post请求

3.可以针对同一个请求设置多个中间件，对同一个请求进行多次处理。  
默认情况下，请求从上到下依次匹配中间件，一旦匹配成功，终止匹配。  
可以调用next方法将请求的控制权交给下一个中间件，直到遇到结束请求的中间件。

app.get('/request', (req, res, next) => { 
         req.name = "张三";
         next();
     });
     app.get('/request', (req, res) => { 
         res.send(req.name);
     });

### 2.2 app.use中间件的用法 ###

app.use匹配所有的请求方式，可以直接传入请求处理函数，代表接收所有的请求。

app.use((req, res, next) => { 
         console.log(req.url);
         next();
     });

app.use第一个参数也可以传入请求地址，代表不论什么请求方式，只要是这个请求地址就可以接收这个请求。

app.use('/admin', (req, res, next) => { 
         console.log(req.url);
         next();
     });

### 2.3 中间件应用 ###

1.路由保护，客户端在访问需要登录的页面时，可以先使用中间件判断用户登录状态，用户如果未登录，则拦截请求，直接响应，禁止用户进入需要登录的页面；  
2.网站维护公告，在所有路由的最上面定义接收所有请求的中间件，直接为客户端做出响应，网站正在维护中；  
3.自定义404页面。

// 引入express框架
    const express = require('express');
    // 创建网站服务器
    const app = express();
    
    // 网站公告
    // app.use((req, res, next) => { 
    // res.send('当前网站正在维护...')
    // })
    
    app.use('/admin', (req, res, next) => { 
    	// 用户没有登录
    	let isLogin = true;
    	// 如果用户登录
    	if (isLogin) { 
    		// 让请求继续向下执行
    		next()
    	}else { 
    		// 如果用户没有登录 直接对客户端做出响应
    		res.send('您还没有登录 不能访问/admin这个页面')
    	}
    })
    
    app.get('/admin', (req, res) => { 
    	res.send('您已经登录 可以访问当前页面')
    })
    
    app.use((req, res, next) => { 
    	// 为客户端响应404状态码以及提示信息
    	res.status(404).send('当前访问的页面是不存在的')
    })
    
    // 监听端口
    app.listen(3000);
    console.log('网站服务器启动成功');

### 2.4 错误处理中间件 ###

在程序执行的过程中，不可避免的会出现一些无法预料的错误，比如文件读取失败，数据库连接失败；错误处理中间件是一个集中处理错误的地方。

// 引入express框架
    const express = require('express');
    const fs = require('fs');
    // 创建网站服务器
    const app = express();
    
    app.get('/index', (req, res, next) => { 
    	// throw new Error('程序发生了未知错误')
    	fs.readFile('./01.js', 'utf8', (err, result) => { 
    		if (err != null) { 
    			next(err)
    		}else { 
    			res.send(result)
    		}
    	})
    
    	// res.send('程序正常执行')
    })
    
    // 错误处理中间
    app.use((err, req, res, next) => { 
    	res.status(500).send(err.message);
    })
    
    // 监听端口
    app.listen(3000);
    console.log('网站服务器启动成功');

### 2.5 异步函数错误的捕获 ###

在node.js中，异步API的错误信息都是通过回调函数获取的，支持Promise对象的异步API发生错误可以通过catch方法捕获。异步函数执行如果发生错误要如何捕获错误呢？  
try catch 可以捕获异步函数以及其他同步代码在执行过程中发生的错误，但是不能其他类型的API发生的错误。

## 3 Express框架请求处理 ##

### 3.1 构建模块化路由 ###

1.构建路由的基础代码：

// 引入express框架
    const express = require('express');
    // 创建网站服务器
    const app = express();
    // 创建路由对象
    const home = express.Router();
    // 为路由对象匹配请求路径
    app.use('/home', home);
    // 创建二级路由
    home.get('/index', (req, res) => { 
    	res.send('欢迎来到博客首页页面')
    })
    
    // 端口监听
    app.listen(3000);

2.构建模块化路由（home.js和admin.js文件在其他路径下）：

// 引入express框架
    const express = require('express');
    // 创建网站服务器
    const app = express();
    
    const home = require('./route/home');
    const admin = require('./route/admin');
    
    app.use('/home', home);
    app.use('/admin', admin);
    
    // 端口监听
    app.listen(3000);

home.js文件如下：

// home.js
     const home = express.Router(); 
     home.get('/index', () => { 
         res.send('欢迎来到博客展示页面');
     });
     module.exports = home;

admin.js文件如下：

// admin.js
     const admin = express.Router();
     admin.get('/index', () => { 
         res.send('欢迎来到博客管理页面');
     });
     module.exports = admin;

### 3.2 get请求参数 ###

Express框架中使用req.query即可获取GET参数，框架内部会将GET参数转换为对象并返回。

// 接收地址栏中问号后面的参数
     // 例如: http://localhost:3000/?name=zhangsan&age=30
     app.get('/', (req, res) => { 
        console.log(req.query); // {"name": "zhangsan", "age": "30"}
     });

### 3.3 post请求参数 ###

Express中接收post请求参数需要借助第三方包 body-parser。

// 引入body-parser模块
     const bodyParser = require('body-parser');
     // 配置body-parser模块
     // 拦截所有请求
    // extended: false 方法内部使用querystring模块处理请求参数的格式
    // extended: true 方法内部使用第三方模块qs处理请求参数的格式
     app.use(bodyParser.urlencoded({  extended: false }));
     // 接收请求
     app.post('/add', (req, res) => { 
        // 接收请求参数
        console.log(req.body);
     })

### 3.4 Express路由参数 ###

// 引入express框架
    const express = require('express');
    const bodyParser = require('body-parser');
    // 创建网站服务器
    const app = express();
    
    app.get('/index/:id/:name/:age', (req, res) => { 
    	// 接收post请求参数
    	res.send(req.params)
    })
    
    // 端口监听
    app.listen(3000);

### 3.5 静态资源访问功能 ###

通过Express内置的express.static可以方便地托管静态文件，例如img、CSS、JavaScript 文件等。

// 实现静态资源访问功能
    app.use('/static',express.static(path.join(__dirname, 'public')))

现在，目录下面的各种文件就可以访问了。

## 4 express-art-template模板引擎 ##

### 4.1 Express中模板引擎的用法 ###

*  为了使art-template模板引擎能够更好的和Express框架配合，模板引擎官方在原art-template模板引擎的基础上封装了express-art-template。
 *  使用npm install art-template express-art-template命令进行安装。

### 4.2 app.locals对象 ###

1.将变量设置到app.locals对象下面，这个数据在所有的模板中都可以获取到。

app.locals.users = [{ 
    	name: 'zhangsan',
    	age: 20
    },{ 
    	name: '李四',
    	age: 30
    }]

2.下面在index.art和list.art文件中都可以引入上述数据：

//1.index.art
    { {  msg }}
    
    <ul>
    	{ { each users}}
    	<li>
    		{ { $value.name}}
    		{ { $value.age}}
    	</li>
    	{ { /each}}
    </ul>
    
    //2.list.art
    { { msg}}
    
    <ul>
    	{ { each users}}
    	<li>
    		{ { $value.name}}
    		{ { $value.age}}
    	</li>
    	{ { /each}}
    </ul>

3.渲染在页面显示

app.get('/index', (req, res) => { 
    	res.render('index', { 
    		msg: '首页'
    	})
    });
    
    app.get('/list', (req, res) => { 
    	res.render('list', { 
    		msg: '列表页'
    	});
    })

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQzNTM3NzIx_size_16_color_FFFFFF_t_70_pic_center]: https://img-blog.csdnimg.cn/20200612142645992.JPG?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQzNTM3NzIx,size_16,color_FFFFFF,t_70#pic_center