express框架的学习与基本使用

1. 认识express框架

Express是一个基于Node平台的web应用开发框架，它提供了一系列的强大特性：

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

以下为express框架的基本使用：

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

server.get('/', (req, res) => {
    // send()方法能自动检测响应内容，自动设置http状态码，自动设置响应内容类型以及编码
    res.send('hello,express!');
});
server.get('/index', (req, res) => {
    res.send({ name: 'lxz', age: 22 });
});

server.listen(3000);
console.log('服务器启动成功');

2. express中间件

中间件就是一堆方法，可以接收客户端发来的请求、可以对请求做出响应，也可以将请求继续交给下一个中间件继续处理。中间件主要由两部分构成，中间件方法以及请求处理函数；中间件方法由Express提供，负责拦截请求，请求处理函数由开发人员提供，负责处理请求。

server.get() 以及 server.post()也是中间件

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

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

server.get('/index', (req, res, next) => {
    req.name = '这是test file';
    next();
});
server.get('/index', (req, res) => {
    res.send(req.name);
});

server.listen(3000);
console.log('服务器启动成功');

server.use() 匹配所有的请求方式，可以直接传入请求处理函数，代表接收所有的请求。其中第一个参数也可以传入请求地址，代表不论什么请求方式，只要是这个请求地址就接收这个请求。

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

// 接收所有的请求不论请求方式以及地址
server.use((req, res, next) => {
    console.log('从use经过');
    next();
});
// 当地址为/index时，请求的方式可为post / get
server.use('/index', (req, res, next) => {
    console.log('当地址为/index时');
    next();
});
server.use('/list', (req, res) => {
    res.send('This is list')
})
server.get('/index', (req, res, next) => {
    req.name = '这是test file';
    next();
});
server.get('/index', (req, res) => {
    res.send(req.name);
});

server.listen(3000);
console.log('服务器启动成功');

中间件的应用场景有以下情况：

1. 路由保护
2. 自定义404页面
3. 网站维护公告

const express = require('express');

const server = express();

// 用于网站维护
/* server.use((req, res, next) => {
    res.send('网站正在维护中');
}) */

// 路由保护
server.get('/admin', (req, res, next) => {
    let flag = true;
    if (flag) {
        next();
    } else {
        res.send('你没有登陆')
    }
})
server.get('/admin', (req, res) => {
    res.send('这是登陆成功以后的页面');
})

// 用于编辑404页面
server.use((req, res, next) => {
    res.status(404).send('<h1>404</h1>你访问的页面不存在');
})

server.listen(3000);
console.log('服务器已经成功启动');

在程序执行的过程中，不可避免的会出现一些无法预料的错误，比如文件读取失败，数据库连接失败。错误处理中间件是一个集中处理错误的地方。当程序出现错误时，调用next()方法，并且将错误信息通过参数的形式传递给next()方法，即可触发错误处理中间件。

// 错误处理中间件示例代码（同步API）
const express = require('express');
const fs = require('fs');

const server = express();

server.get('/index', (req, res, next) => {
    // 通过throw抛出错误
    // throw new Error('程序发生了未知错误');
    fs.readFile('./1.txt', 'utf-8', (err, result) => {
        if (err != null) {
            // 将错误传递给下一个中间件
            next(err);
        } else {
            res.send(result);
        }
    })
})

// 错误护理中间件
server.use((err, req, res, next) => {
    // err.message 是错误的详情
    res.status(500).send(err.message);
})

server.listen(3000);
console.log('服务器已经成功启动');

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

// 捕获异步函数的错误
const express = require('express');
const fs = require('fs');
const promisify = require('util').promisify;
const readFile = promisify(fs.readFile); // 将fs.readFile处理成支持异步函数的方法

// 创建网站服务器
const server = express();

// try catch 能捕获异步函数以及同步函数的错误，但是无法捕获其他API的错误（promise)
server.get('/index', async(req, res, next) => {
    try {
        await readFile('./1.js')
    } catch (err) {
        next(err)
    }
})

// 错误护理中间件(只能处理同步性的错误)
server.use((err, req, res, next) => {
    // err.message 是错误的详情
    res.status(500).send(err.message);
})

server.listen(3000);
console.log('服务器已经成功启动');

3. express的请求处理以及引擎模板

在express中为实现路由提供了模块化路由的构建：

/****************main.js**************/
const express = require('express');

// 创建服务器对象
const server = express();
// 引入二级路由
const home = require('./home.js');
const admin = require('./admin.js');

server.use('/home', home);
server.use('/admin', admin);


server.listen(3000);
console.log("服务器启动成功");

/****************admin.js**************/
const express = require('express');

const admin = express.Router();

admin.get('/index', (req, res) => {
    res.send('欢迎来到admin页面');
})

module.exports = admin;

/****************admin.js**************/
const express = require('express');

const home = express.Router();

home.get('/index', (req, res) => {
    res.send('欢迎来到home页面');
})

module.exports = home;

express框架中更是为了get参数以及post参数的获取提供了快捷的方法：

/********************get参数的获取***************/
// 引入express框架
const express = require('express');
// 创建网站服务器
const server = express();

// 在express框架中 req对象下拥有着qurey  可直接获取get方式传递的参数
server.get('/index', (req, res) => {
    res.send(req.query);
})

// express路由参数 通过req.params获取
server.get('/other/:name/:age', (req, res) => {
    res.send(req.params);
})

server.listen(3000);
console.log('服务器启动成功');

/********************post参数的获取***************/
// 引入express框架
const express = require('express');
// 引入body-parser模块
const bodyParser = require('body-parser');
// 创建网站服务器
const server = express();

// 拦截所有的请求
// 当extended: false 时方法内部使用querystring模块处理请求参数的格式
// 当extended: true 时方法内部使用第三方模块qs处理请求参数的格式
// 通过处理后req对象中拥有着body 获取通过post传递的参数
server.use(bodyParser.urlencoded({ extended: false }));

server.post('/index', (req, res) => {
    res.send(req.body);
})

server.listen(3000);
console.log('服务器启动成功');

而对于静态资源的获取，express也提供了相应的方法:

// 实现静态资源的获取
server.use('/static',express.static(path.join(__dirname, 'public')))
// 获取了静态资源的获取，就能够自由的访问静态资源

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

const express = require('express');
const path = require('path');

const server = express();

// 第一个参数时要渲染的后缀，第二个参数是选择什么搜索引擎进行渲染
server.engine('art', require('express-art-template'));
// 第一个参数是存放模板的目录名，第二个参数是存放模板的地址
server.set('views', path.join(__dirname, 'views'));
// 第一个参数配置默认模板配置项view engine,第二个参数为默认后缀
server.set('view engine', 'art');

server.get('/index', (req, res) => {
    // render()方法能够自动拼接模板路径/拼接模板后缀/模板与数据之间的连接/并且自动响应给客户端
    res.render('index', {
        msg: '这是index'
    })
})
server.get('/list', (req, res) => {
    res.render('list', {
        msg: '这是list'
    })
})

server.listen(3000);
console.log("服务器启动成功");

有必要补充的是，在实际开发工程中经常有一些公共的数据需要提供给模板使用，为了避免代码冗余，.locals()方法因此诞生，存储于此方法下的代码可以在任何的模板下使用：

// server.locals中的数据可在所有的模板中使用
server.locals.users = [{
    name: "abc",
    age: "18"
}, {
    name: "aaa",
    age: "11"
}]