express框架的初步使用

Express框架是什么

Express是一个基于Node平台的web应用开发框架，它提供了一系列的强大特性，帮助你创建各种Web应用。

Express框架特性

提供了方便简洁的路由定义方式
对获取HTTP请求参数进行了简化处理 也就是说不用对请求参数格式进行转化 不用添加date end 事件
对模板引擎支持程度高，方便渲染动态HTML页面 容易和模板引擎进行协同工作
提供了中间件机制有效控制HTTP请求 中间件：对请求的拦截
拥有大量第三方中间件对功能进行扩展 基于插件可以实现各种功能

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

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

框架入门写法

//01.js 框架入门
//引入框架
const express = require('express');
//返回值是一个方法 调用方法就可以创建网站服务器
//使用框架不需要使用http的creatSever
const app = express();
//创建路由的方法和使用router模块的方法其实差不多 get与post
app.get('/', (req, res) => {
    //不再使用end方法进行相应
    //框架里使用send方法  可以自动检测响应内容的类型设置与http状态码到响应报文中
    res.send('HELLO EXPRESS');
});
app.get('/list', (req, res) => {
    //send还可以传递对象  end方法无法传递对象
    res.send({ name: 'kevin', age: 18 })
});
//exress的另一个好处  会将出现的错误也显示在页面上方便调试
//监听端口
app.listen(3000);
console.log('网站服务器启动成功 奥里给');

框架中间件

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

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

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

//中间件
// 引入express框架
const express = require('express');
// 创建网站服务器
const app = express();
app.get('/request', (req, res, next) => {
    req.name = "张三";
    //默认下请求从上到下进行匹配 一旦匹配成功就终止匹配
    //next方法将请求的控制权交给下一个中间件 直到结束
    next();
})
app.get('/request', (req, res) => {
    res.send(req.name)
})
// 监听端口
app.listen(3000);
console.log('网站服务器启动成功');

app.use中间件用法

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

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

//app.use用法  匹配所有的请求
const express = require('express');
const app = express();
//第一个参数是匹配地址 可以省略 代表接受所有的响应
//next很重要 可以调用next方法将请求的控制权交给下一个中间件，直到遇到结束请求的中间件。
app.use((req, res, next) => {
    console.log('123');
    next()
});
//第一个参数传入代表接受/request的post 与get请求
app.use('/request', (req, res, next) => {
    console.log('456');
    next()
})

中间件应用

路由保护，客户端在访问需要登录的页面时，可以先使用中间件判断用户登录状态，用户如果未登录，则拦截请求，直接响应，禁止用户进入需要登录的页面。

app.use('/admin', (req, res, next) => {
    //现在使用一个变量模拟登陆状态
    let isLogin = false;
    //如果登录继续进行  如果没登录提示
    if (isLogin) {
        next()
    } else {
        res.send('你还没有登陆需要登陆')
    }
});
app.get('/admin', (req, res) => {
    res.send('您已经登录 可以访问当前页面')
});

网站维护公告，在所有路由的最上面定义接收所有请求的中间件，直接为客户端做出响应，网站正在维护中（这个一般写在最前面）

app.use((req, res, next) => {
 res.send('当前网站正在维护...')
})

自定义404页面 一般写在最后面

//第三个应用 自定义404页面
//当访问的地址不存在 定义一个专门路由 提示不存在
//这个应用一般写在所有的最后面
app.use((req, res, next) => {
    // 为客户端响应404状态码以及提示信息
    //  status可以为客户端响应状态码
    res.status(404).send('当前访问的页面是不存在的')
})

错误处理中间件

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

异步api出错的话需要在回调函数提前把err通过next传出

//错误处理中间件
// 引入express框架
const express = require('express');
const fs = require('fs');
// 创建网站服务器
const app = express();
app.get('/index', (req, res, next) => {
    //同步函数出错的话会自动触发后面的错误处理
    // throw new Error('程序发生了未知错误')
    fs.readFile('./015.js', 'utf8', (err, result) => {
        if (err != null) {
            //异步api出错的话需要在回调函数提前把err通过next传出
            next(err)
        } else {
            res.send(result)
        }
    })
    // res.send('程序正常执行')
});
// 错误处理中间件  统一处理错误的地方
//四个形参 多一个err
app.use((err, req, res, next) => {
    res.status(500).send(err.message);
})
// 监听端口
app.listen(3000);
console.log('网站服务器启动成功');

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

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);
})

Express请求处理

构建模块化路由

基础方法（写在一起）：

//构建模块化路由的基础方法
// 引入express框架
const express = require('express');
// 创建网站服务器
const app = express();
// 创建路由对象
const home = express.Router();
// 为路由对象匹配请求路径  具体的操作要在二级路由进行
app.use('/home', home);
// 创建二级路由
home.get('/index', (req, res) => {
    res.send('欢迎来到博客首页页面')
});
// 访问/home/index时出现 欢迎来到博客首页
// 端口监听
app.listen(3000);

模块化写法：

获取GET参数

Express框架中使用req.query即可获取GET参数，框架内部会将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。
req.body

// 引入express框架
const express = require('express');
//接受post请求需要使用body-parser模块
const bodyParser = require('body-parser');
// 创建网站服务器
const app = express();
// 拦截所有请求
// extended: false 方法内部使用querystring模块处理请求参数的格式
// extended: true 方法内部使用第三方模块qs处理请求参数的格式
// 流程：将参数解析成对象 给req添加body属性 把值赋给Body  next将控制权转移给下一个
app.use(bodyParser.urlencoded({ extended: false }))
app.post('/add', (req, res) => {
    // 接收post请求参数
    res.send(req.body)
})
// 端口监听
app.listen(3000);

Express路由参数 另一种获取get参数的方式

// 引入express框架
const express = require('express');
const bodyParser = require('body-parser');
// 创建网站服务器
const app = express();
//:id 是一种占位符
app.get('/index/:id/:name/:age', (req, res) => {
    // 接收post请求参数
    res.send(req.params) //得到的是对象
})
//例如输入/index//kevin/18
// 端口监听
app.listen(3000);

静态资源的处理

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

const express = require('express');
const path = require('path');
const app = express();
// 实现静态资源访问功能
//客户端发来请求 自动进行判断
//如果是请求静态资源 则将静态资源根据提供的地址进行调用
//如果不是静态资源 调用next方法 将控制权移交
app.use('/static', express.static(path.join(__dirname, 'public')))
// 端口监听
app.listen(3000);

express-art-template模板引擎

为了使art-template模板引擎能够更好的和Express框架配合，模板引擎官方在原art-template模板引擎的基础上封装了express-art-template。
使用npm install art-template express-art-template命令进行安装。
1.告诉express框架使用什么模板引擎渲染什么后缀的模板文件

// 1.告诉express框架使用什么模板引擎渲染什么后缀的模板文件
//   1.1.模板后缀
//   1.2.使用的模板引擎
app.engine('art', require('express-art-template'));

2.告诉express框架模板拼接的文件存放的位置是什么 views是固定的

// 2.告诉express框架模板存放的位置是什么 views是固定的
app.set('views', path.join(__dirname, 'views'));

3.告诉express框架模板的默认后缀是什么 渲染模板的时候可以不写后缀

// 3.告诉express框架模板的默认后缀是什么  渲染模板的时候可以不写后缀
app.set('view engine', 'art');

app.get('/index', (req, res) => {
    // 1. 拼接模板路径
    // 2. 拼接模板后缀
    // 3. 哪一个模板和哪一个数据进行拼接
    // 4. 将拼接结果响应给了客户端
    res.render('index', {
        msg: 'message'
    })
});

app.locals 对象

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