笨鸟学习日记之Express框架入门

Express框架

  • 目录

  • Express框架简介及初体验

  • Express中间件

  • Express框架请求处理

  • epress-art-template模板引擎

官方文档


1.Express框架简介及初体验

1.1 Express框架是什么

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

1.2 Express框架特性

  1. 提供了方便简洁的路由定义方式

  2. 对获取HTTP请求参数进行了简化处理

  3. 对模板引擎支持程度高,方便渲染动态HTML页面

  4. 提供了中间件机制有效控制HTTP请求

  5. 拥有大量第三方中间件对功能进行扩展

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

原生Node.js:

app.on('request', (req, res) => {
     // 获取客户端的请求路径
 const pathname = new URL(req.url, "http://localhost:3000").pathname;
     // 对请求路径进行判断 不同的路径地址响应不同的内容
     if (pathname == '/' || pathname == 'index') {
        res.end('欢迎来到首页');
     } else if (pathname == '/list') {
        res.end('欢迎来到列表页页');
     } else if (pathname == '/about') {
        res.end('欢迎来到关于我们页面')
     } else {
        res.end('抱歉, 您访问的页面出游了');
     }
 });

复制代码

Express框架:

 // 当客户端以get方式访问/时
 app.get('/', (req, res) => {
     // 对客户端做出响应
     res.send('Hello Express');
 });

 // 当客户端以post方式访问/add路由时
 app.post('/add', (req, res) => {
    res.send('使用post方式请求了/add路由');
 });

复制代码

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

原生Node.js:

app.on('request', (req, res) => {
    // 获取GET参数
  const query = new URL(req.url, "http://localhost:3000").searchParams;
    // 获取POST参数
    let postData = '';
    req.on('data', (chunk) => {
        postData += chunk;
    });
    req.on('end', () => {
        console.log(querystring.parse(postData)
    })); 
 });

复制代码

Express框架:

 app.get('/', (req, res) => {
    // 获取GET参数
    console.log(req.query);
 });

 app.post('/', (req, res) => {
    // 获取POST参数
    console.log(req.body);
 }) 

复制代码

1.5 Express初体验

 // 引入Express框架
 const express = require('express');
 // 使用框架创建web服务器
 const app = express();
 // 当客户端以get方式访问/路由时
 app.get('/', (req, res) => {
    // 对客户端做出响应 send方法会根据内容的类型自动设置请求头
    res.send('Hello Express'); // <h2>Hello Express</h2> {say: 'hello'}
 });
 // 程序监听3000端口
 app.listen(3000);

复制代码

2.中间件

2.1什么是中间件

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

image-20210330092305487.png

中间件主要由两部分构成,中间件方法以及请求处理函数。

中间件方法由Express提供,负责拦截请求,请求处理函数由开发人员提供,负责处理请求。

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

可以针对同一个请求设置多个中间件,对同一个请求进行多次处理。

默认情况下,请求从上到下依次匹配中间件,一旦匹配成功,终止匹配。

可以调用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.路由保护,客户端在访问需要登录的页面时,可以先使用中间件判断用户登录状态,用户如果未登录,则拦截请求,直接响应,禁止用户进入需要登录的页面。

// 1.路由保护
app.use((req, res, next) => {
     let isLogined = true;
     if (isLogined) {
        next();
    } else {
         res.send('用户未登录,请登录')
     }
 })
 app.get('/index', (req, res) => {
     res.send('用户已登录,欢迎来到主页面');
 })
复制代码

2.网站维护公告,在所有路由的最上面定义接收所有请求的中间件,直接为客户端做出响应,网站正在维护中。

// 2.网站公告
app.use((req, res) => {
    res.send('网站正在维护中...')
})
复制代码

3.自定义404页面

// 3.404错误页面(放在所有路由最后)
app.use((req, res) => {
    res.status(404).send('错误,页面为找到')//允许链式编程
})
复制代码

2.4 错误处理中间件

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

错误处理中间件是一个集中处理错误的地方。

 app.use((err, req, res, next) => {
     res.status(500).send('服务器发生未知错误');
 })

复制代码

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

app.get("/", (req, res, next) => {
     fs.readFile("/file-does-not-exist", (err, data) => {
         if (err) {
            next(err);
         }
     });
});

复制代码

2.5 捕获错误

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

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

const fs = require('fs');
const promisify = require('util').promisify
const readFile = promisify(fs.readFile);
app.get('/', async (req, res, next) => {
    try {
        let result = await readFile('01.js', 'utf8')
        res.send(result);
    } catch (error) {
        next(error);
    }
})
// 错误处理中间件
app.use((err, req, res, next) => {
    res.status(500).send(err.message);
})
复制代码

3.Express框架请求处理

3.1构建模块化路由

//app.js
const express = require('express') 
 // 创建路由对象
 const home = express.Router();
 // 将路由和请求路径进行匹配
 app.use('/home', home);
  // 在home路由下继续创建路由
 home.get('/index', () => {
          //  /home/index
         res.send('欢迎来到博客展示页面');
 });
复制代码

将上述代码进行模块抽取分离

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

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

复制代码
 // app.js
 const home = require('./route/home.js');
 const admin = require('./route/admin.js');
 app.use('/home', home);
 app.use('/admin', admin);

复制代码

此时想要访问home.js下请求处理的结果需要加上/home路径 admin.js同理

3.2GET参数的获取

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.3POST参数获取

Express框架中使用req.body即可获取POST参数,但是要主要的是默认为underdefine,必须进行中间件的配置 不需要导入第三方模块 现在已经内嵌在Express框架内

// 使用中间件 查看官方文档
app.use(express.json())
// extended :true 方法内部用第三方模块qs处理请求 参数的格式
app.use(express.urlencoded({ extended: true }))
// 获取post参数
app.post('/index', (req, res) => {
    console.log(req.body);
    res.send(req.body);
})
复制代码

3.4Express路由参数

Express框架中使用req.params即可获取对应路由参数的对象类型

app.get('/find/:id', (req, res) => { 
     console.log(req.params); // {id: 123} 
 });
localhost:3000/find/123 //地址栏中输入的值

复制代码

3.5静态资源的处理

Express框架中内置的express.static(param)方法 param参数为静态资源存放的目录 需要进行path.join拼接,可以方便地托管静态文件,例如img、CSS、JavaScript 文件等。

 app.use(express.static(path.join(__dirname,'public'));
复制代码

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

4.express-art-template模板引擎

4.1模板引擎配置

  • 为了使art-template模板引擎能够更好的和Express框架配合,模板引擎官方在原art-template模板引擎的基础上封装了express-art-template。
  • 使用npm install art-template express-art-template命令进行安装。
// 告诉express框架 用什么模板后缀什么模板引擎
app.engine('art', require('express-art-template'));
// 告诉express框架 模板文件的存放位置
app.set('views', path.join(__dirname, 'views'));
// 告诉express框架 模板文件的默认后缀
app.set('view engine', 'art');
复制代码

配置完成后即可使用res.render()方法

app.get('/index', (req, res) => {
    res.render('list', {
        msg: 123
    });//不需要加文件后缀 
})
复制代码

4.2app.locals对象

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

 app.locals.users = [{
     name: '张三',
     age: 20
 },{
     name: '李四',
     age: 20
}]
复制代码
© 版权声明
THE END
喜欢就支持一下吧
点赞0 分享