急速入门Express框架必看

Express框架是什么

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

Express框架特性

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

原生Node.js与Express框架对比之路由

在这里插入图片描述

原生Node.js与Express框架对比之获取请求参数

在这里插入图片描述

Express初体验

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

中间件

什么是中间件

中间件就是一堆方法,可以接受客户端发来的请求,可以对请求做成响应,也可以将请求继续交给下一个中间件继续处理
在这里插入图片描述

中间件的使用

中间件主要由两个部分构成,中间件方法和请求处理函数,中间件方法由Express提供,负责拦截请求,请求处理函数由开发人员提供,负责处理请求

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

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

// 引入express框架
const express = require('express');
// 创建网站服务器
const app = express();

app.get('/request', (req, res, next) => {
	// 给req对象添加一个name属性
	req.name = "张三";
	// 提交给下一个中间件
	next();
})

app.get('/request', (req, res) => {
	// 响应页面
	res.send(req.name)
})

// 监听端口
app.listen(3000);
console.log('网站服务器启动成功');

app.use中间件用法

在这里插入图片描述
示例代码:

// 引入express框架
const express = require('express');
// 创建网站服务器
const app = express();

// 接收所有请求的中间件
app.use((req, res, next) => {
	console.log('请求走了app.use中间件');
	next()
})

// 当客户端访问/request请求的时候走当前中间件
app.use('/request', (req, res, next) => {
	console.log('请求走了app.use / request中间件')
	next()
})

app.get('/list', (req, res) => {
	res.send('/list')
})

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

app.get('/request', (req, res) => {
	res.send(req.name)
})

// 监听端口
app.listen(3000);
console.log('网站服务器启动成功');

中间件应用

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

示例代码-检测登陆状态

    // 1.引入express框架
    const express = require('express');
    // 2.创建网站服务器
    const app = express();
    // 4.监听请求
    app.use('/admin', (req, res, next) => {
    	// 用户没有登录
    	let isLogin = true;
    	// 如果用户登录
    	if (isLogin) {
    		// 让请求继续向下执行
    		next()
    	}else {
    		// 如果用户没有登录 直接对客户端做出响应
    		res.send('您还没有登录 不能访问/admin这个页面')
    	}
    })
    app.get('/admin', (req, res) => {
    	res.send('您已经登录 可以访问当前页面')
    })
    // 3.监听端口
    app.listen(3000);
    console.log('网站服务器启动成功');

示例代码-网站维护

    // 1.引入express框架
    const express = require('express');
    // 2.创建网站服务器
    const app = express();
    // 4.监听请求
    // 网站公告
    app.use((req, res, next) => {
    res.send('当前网站正在维护...')
    })
    // 3.监听端口
    app.listen(3000);
    console.log('网站服务器启动成功');

示例代码=自定义404

    // 1.引入express框架
    const express = require('express');
    // 2.创建网站服务器
    const app = express();
    // 4.监听请求
    app.use((req, res, next) => {
    	// 为客户端响应404状态码以及提示信息
    	res.status(404).send('当前访问的页面是不存在的')
    })
    // 3.监听端口
    app.listen(3000);
    console.log('网站服务器启动成功');

错误处理中间件

在程序执行过程中,不可避免的会出现一些错误,例如文件读取失败,数据库连接失败等,错误处理中间件是一个集中处理错误的地方

// 引入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方法来传递到错误中间件中
			next(err);
		}else {
			res.send(result)
		}
	})
})

// 错误处理中间
app.use((err, req, res, next) => {
	res.status(500).send(err.message);
})

// 监听端口
app.listen(3000);
console.log('网站服务器启动成功');

小结

  • 如果是同步的错误,直接会被错误中间件进行捕获处理,我们可以在代码中利用 throw new Error(); 对象来抛出错误
  • 如果是异步的错误,必须要通过next方法,里面携带错误参数,这样才会被错误中间件进行捕获

捕获错误

在node.js中,异步API的错误信息都是通过回调函数获取的,支持Promise对象的异步API发生错误可以通过catch方法捕获。

异步函数执行如果发生错误要如何捕获错误呢?

try catch 可以捕获异步函数以及其他同步代码在执行过程中发生的错误,但是不能其他类型的API发生的错误。

// 引入express框架
const express = require('express');
const fs = require('fs');
const promisify = require('util').promisify;
// 内置的模块和很多其他库不能使用Promises。这些库能够将传统的回调方法转换为Promise
const readFile = promisify(fs.readFile);
// 创建网站服务器
const app = express();

app.get('/index', async (req, res, next) => {
	try {
		await readFile('./aaa.js')
	}catch (ex) {
		next(ex);
	}
})

// 错误处理中间
app.use((err, req, res, next) => {
	res.status(500).send(err.message);
})

// 监听端口
app.listen(3000);
console.log('网站服务器启动成功');

构建路由模块化

在实际项目中,一个功能模块的请求的接口比较多的,如果全部写在一起,那么后续很难维护,所以我们构建一个路由的模块化,把相同的功能逻辑的接口抽取成一个模块,这样方便维护

构建模块化路由的基础代码

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

// 端口监听
app.listen(3000);

构建模块化路由
程序主入口

// 引入express框架
const express = require('express');
// 创建网站服务器
const app = express();
// 引入路由模块
const home = require('./route/home');
const admin = require('./route/admin');
// 利用user方法来绑定路由
app.use('/home', home);
app.use('/admin', admin);

// 端口监听
app.listen(3000);

模块一

// 引入express第三方库
const express = require('express');
 // 创建路由
const admin = express.Router();
 // 匹配路径
admin.get('/index', (req, res) => {
	res.send('欢迎来到博客管理页面')
});
// 把当前路由对象导出
module.exports = admin;

模块二

// 引入express第三方库
const express = require('express');
// 创建路由
const home = express.Router();
// 匹配路径
home.get('/index', (req, res) => {
	res.send('欢迎来到博客首页页面')
});
// 把当前路由对象导出
module.exports = home;

GET参数的获取

Express框架中使用 req.query 既可以获取GET参数,也就是说,我们不需要再引入URL模块进行参数的获取,框架内部会将GET参数转换成对象并且返回

// 引入express框架
const express = require('express');
// 创建网站服务器
const app = express();

app.get('/index', (req, res) => {
	// 获取get请求参数
	res.send(req.query)
})

// 端口监听
app.listen(3000);

POST参数的获取

Express框架中,接受post参数需要借助第三方包 body-parser

//引入第三方库
const express = require('express');
//引入body-parser模块 Express框架默认使用body-parser作为请求体解析中间件
const bodyParser = require('body-parser');
//创建web服务器
const app = express();
//过滤所有请求
//bodyParser.json()--解析JSON格式
// bodyParser.raw()--解析二进制格式
// bodyParser.text()--解析文本格式
// bodyParser.urlencoded()--解析文本格式
//bodyParser,urlencoded  会检测里面是否有请求参数,如果有请求参数会帮我们进行解析,然后添加一个req.body属性,把值赋值给body属性,在请求中调用了next方法,把请求控制权交给了下个路由
// 拦截所有请求
// extended: false 方法内部使用querystring模块处理请求参数的格式
// extended: true 方法内部使用第三方模块qs处理请求参数的格式
app.use(bodyParser.urlencoded({ extended: false }));//urlencoded返回值刚好是一个函数
app.post('/add', (req, res) => {
    //通过req.body属性来获取post请求参数
    res.send(req.body);
});
//监听端口
app.listen(8080);

Express路由参数

通过路由参数来进行传递,这种方式传递参数,这种方式在很多流行框架中也会看到

// 引入express框架
const express = require('express');
// 创建网站服务器
const app = express();
// 把参数跟在的url后面,以:号作为特殊符号,如果有多个值,用/号隔开
app.get('/index/:id/:name/:age', (req, res) => {
    // 接收post请求参数
    res.send(req.params);{'id':'123','name':'王五','age':'女'}
})
// 端口监听
app.listen(8080);
// 如果通过这种方式获取的参数,那么请求路径上面就是这样去写 http://localhost:8080/index/123/王五/女

静态资源的处理

通过Express内置的 express.static 可以方便的托管静态文件,例如img、css、javascript文件等

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

利用express.static 方法加载静态资源文件夹,那么框架内部会去帮我们判断,用户这次请求是否是静态资源,如果是,就会把当前静态资源返回给用户,并且终止这次请求,如果不是,就会通过next方法传递到下个中间件,一旦在use方法里面开放了静态资源,那么用户就可以通过路径直接请求到我们的静态资源,当然,你的静态资源里面必须要包含此文件

  • http://localhost:3000/images/kitten.jpg
  • http://localhost:3000/css/style.css
  • http://localhost:3000/js/app.js
  • http://localhost:3000/images/bg.png
  • http://localhost:3000/hello.html
// 引入express框架
const express = require('express');
const path = require('path');

// 创建网站服务器
const app = express();
// 实现静态资源访问功能
//app.use(express.static(path.join(__dirname, 'public')));
//http://localhost:3000/default.html
app.use('/add', express.static(path.join(__dirname, 'public')));
//http://localhost:3000/add/default.html

// 监听端口
app.listen(3000);
console.log('网站服务器启动成功');

模板引擎 express-art-template

模板引擎
为了使art-template模板引擎能够更好的和Express框架配合,模板引擎官方在原art-template模板引擎的基础上封装了express-art-tempate;所以我们在express中去使用模板引擎,我们需要下载两个模块

使用npm install art-template express-art-template命令进行安装

在使用express配置模板引擎,一共三个步骤

  • 告诉express框架使用是什么模板引擎,渲染什么后缀名的模板文件
  • 告诉express框架模板存放的位置是什么
  • 告诉express框架模板的默认后缀是什么
// 引入express框架
const express = require('express');
const path = require('path');

// 创建网站服务器
const app = express();
// 1.告诉express框架使用什么模板引擎渲染什么后缀的模板文件
//  1.模板后缀
//  2.使用的模板引擎
app.engine('art', require('express-art-template'));
// 2.告诉express框架模板存放的位置是什么
app.set('views', path.join(__dirname, 'views'));
// 3.告诉express框架模板的默认后缀是什么
app.set('view engine', 'art');
app.get('/index', (req, res) => {
        // 1. 拼接模板路径
        // 2. 拼接模板后缀
        // 3. 哪一个模板和哪一个数据进行拼接
        // 4. 将拼接结果响应给了客服端
        res.render('index', {
            age: 'mc'
        })
    })
    // 监听端口
app.listen(3000);
console.log('网站服务器启动成功');

app.locals对象

将变量设置到app.locals对象下面,那么这个数据在所有的模板中都可以获取到,不需要再另外进行设置

const express = require('express');
const path = require('path');
const app = express();
// 模板配置
app.engine('art', require('express-art-template'))
app.set('views', path.join(__dirname, 'views'))
app.set('view engine', 'art');

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

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

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


// 端口监听
app.listen(3000);

html代码

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <meta http-equiv="X-UA-Compatible" content="ie=edge">
    <title>Document</title>
</head>
<body>
    {{msg}}
    <ul>
        {{each users}}
        <li>{{$value.name}}</li>
        <li>{{$value.age}}</li>
        {{/each}}
    </ul>
</body>
</html>
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值