Express框架

2020-11-11 16:23:59 浏览数 (1)

Express框架

1.Express框架简介及初体验

1.1 Express框架是什么

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

1.2 Express框架特性

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

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

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

1.5 Express初体验

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

下载express模块 npm install express

代码语言:javascript复制
// 引入express模块
const express = require('express');
​
//创建网站服务器
const app = express();
​
// 当客户端以get方式访问/路由时
app.get('/', (req, res) => {
    // send()
    // 1. send方法内部会检测响应内容的类型
    // 2. send方法会自动设置http状态码
    //3.发送方法会帮我们自动设置响应的内容类型及编码
    res.send('hellow express');
})
app.get('/list', (req, res) => {
    res.send({
​
        name: '张三',
        age: 20
​
    })
})
// 监听端口
app.listen(3000);
console.log('服务器启动成功');

2. 中间件

2.1 什么是中间件

中间件就是一堆方法,可以接收客户端发来的请求、可以对请求做出响应,也可以将请求继续交给下一个中间件继续处理。

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

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

代码语言:javascript复制
// 引入express模块
const express = require('express');
​
// 创建网站服务器
const app = express();
​
app.get('/request', (req, res, next) => {
    req.name = '张三丰';
    next();
})
app.get('/request', (req, res) => {
    res.send(req.name);
})
​
app.listen(3000);
console.log('服务器启动成功');

2.2 app.use中间件用法

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

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

代码语言:javascript复制
app.get('/request', (req, res, next) => {
    req.name = '张三丰';
    next();
})
app.get('/request', (req, res) => {
    res.send(req.name);
})

2.3 中间件应用

  1. 路由保护,客户端在访问需要登录的页面时,可以先使用中间件判断用户登录状态,用户如果未登录,则拦截请求,直接响应,禁止用户进入需要登录的页面。
  2. 网站维护公告,在所有路由的最上面定义接收所有请求的中间件,直接为客户端做出响应,网站正在维护中。
  3. 自定义404页面
代码语言:javascript复制
// 网站公告
// app.use((req, res, next) => {
//     res.send('网站正在维护中,将于11月3日八点开启...')
// })
app.use('/admin', (req, res, next) => {
    // flase 用户没有登陆  true用户已经登陆
    let isLogin = true;
    // 如果用户登录
    if (isLogin) {
        // 请求继续向下执行
        next();
    } else {
        // 如果用户没有登陆 直接对客户端做出响应
        res.send('您还没有登录,不可以访问 /admin这个页面');
    }
})
app.get('/admin', (req, res) => {
    res.send('您已经登录,可以访问当前页面');
})
​
app.use((req, res, next) => {
    // status(404) 自定义404页面
    res.status(404).send('您访问的页面不存在');
})

2.4 错误处理中间件

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

当程序出现错误时,调用next()方法,并且将错误信息通过参数的形式传递给next()方法,即可触发错误处理中间件。

代码语言:javascript复制
// 引入express框架
const express = require('express');
const fs = require('fs');
​
// 创建网站服务器
const app = express();
​
app.get('/index', (req, res, next) => {
    // 手动抛出错误
    // throw new Error('程序出现未知错误...')
    // res.send('程序正常运行');
    fs.readFile('./01.js', 'utf8', (err, result) => {
        if (err != null) {
            next(err);
        } else {
            res.send(result);
        }
    })
​
})
​
// 错误处理中间件
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发生的错误。

代码语言:javascript复制
// 引入express框架
const express = require('express');
const fs = require('fs');
const promisify = require('util').promisify;
const readFile = promisify.readFile;
​
// 创建网站服务器
const app = express();
​
app.get('/index', async (req, res, next) => {
    try {
        await readFile('./aaa');
    } catch (er) {
        next(er);
    }
​
})
​
// 错误处理中间件
app.use((err, req, res, next) => {
    res.status(500).send(err.message)
})
​
app.listen(3000);
console.log('服务器启动成功');

3. Express请求处理

3.1 构建模块化路由

代码语言:javascript复制
// 创建路由对象
const home = express.Router();
// 为路由对象匹配请求路径
app.use('/home', home);
// 创建二级路由
home.get('/index', (req, res) => {
    // /home/index
    res.send('欢迎来到播客首页');
})

3.2 GET参数的获取

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

3.3 POST参数的获取

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

代码语言:javascript复制
// 拦截所有请求
//extended: false 方法内部使用querystring模块处理请求参数的格式
//extended: true方法内部使用第三方模块qs处理请求参数的格式
app.use(bodyparser.urlencoded({
    extended: false
}));
app.post('/add', (req, res) => {
    // 接收post请求参数
    res.send(req.body);
})

app.use方法:

代码语言:javascript复制
// 拦截所有请求
app.use(fn({
    a: 1
}));
​
function fn(obj) {
    return function (req, res, next) {
        if (obj.a == 2) {
            console.log(req.url);
        } else {
            console.log(req.method);
        }
        next();
    }
}
app.get('/', (req, res) => {
    // 接收post请求参数
    res.send('ok');
})

3.4 Express路由参数

代码语言:javascript复制
app.get('/index/:id/:name/:age', (req, res) => {
    // 接收post请求参数
    res.send(req.params);
})

3.5 静态资源的处理

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

代码语言:javascript复制
// 实现静态资源访问功能
app.use(express.static(path.join(__dirname, 'public')));

现在,public 目录下面的文件就可以访问了。

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

4. express-art-template模板引擎

模板引擎

  • 为了使art-template模板引擎能够更好的和Express框架配合,模板引擎官方在原art-template模板引擎的基础上封装了express-art-template。
  • 使用npm install art-template express-art-template命令进行安装。
代码语言:javascript复制
//1.告诉express框架使用什么模板引擎渲染什么后缀的模板文件
//(1).模板后缀
//(2).使用的模板引擎
app.engine('art', require('express-art-template'))
// 2.告诉express框架模板存放的位置是什么
//(1) 第一个views 是express框架的配置项名字  第二个views是文件夹名字
app.set('views', path.join(__dirname, 'views'));
// 3.告诉express框架模板的默认后缀是什么
app.set('view engine', 'art');
app.get('/index', (req, res) => {
    res.render('index', {
        msg: 'message'
    })
})
​
app.get('/list', (req, res) => {
    // res.render 做了很多处理,分别有
    // 1.拼接模板路径
    // 2.拼接模板后缀
    // 3.哪一个模板和哪一个数据进行拼接
    //4.将拼接结果响应给了客户端
    res.render('list', {
        msg: 'list page'
    })
})

app.locals 对象

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

代码语言:javascript复制
//1.告诉express框架使用什么模板引擎渲染什么后缀的模板文件
//(1).模板后缀
//(2).使用的模板引擎
app.engine('art', require('express-art-template'))
// 2.告诉express框架模板存放的位置是什么
//(1) 第一个views 是express框架的配置项名字  第二个views是文件夹名字
app.set('views', path.join(__dirname, 'views'));
// 3.告诉express框架模板的默认后缀是什么
app.set('view engine', 'art');
​
app.locals.users = [{
    name: '迪丽热巴',
    age: 20
}, {
    name: '张子枫',
    age: 18
}]
app.get('/index', (req, res) => {
    res.render('index', {
        msg: '首页'
    })
})
​
app.get('/list', (req, res) => {
    // res.render 做了很多处理,分别有
    // 1.拼接模板路径
    // 2.拼接模板后缀
    // 3.哪一个模板和哪一个数据进行拼接
    //4.将拼接结果响应给了客户端
    res.render('list', {
        msg: '列表页 '
    })
})
{{msg}}
<ul>
    {{each users}}
    <li>
        {{$value.name}}
        {{$value.age}}
    </li>
    {{/each}}
</ul>

0 人点赞