Express学习笔记（基本使用，中间件，模块化路由，请求处理）

express笔记

这里不再提及express的定义或者作用等。

1.安装

使用 npm install express (--save) 进行安装

2.基本使用

1）开启服务器

const express= require('express');
const app = express();
app.listen(3000);

2）接收get请求

send()方法：

1. send方法内部会检测响应内容的类型
2. send方法会自动设置http状态码
3. send方法会帮我们自动设置响应的内容类型及编码

app.get('/',(req,res)=>{
    res.send('hello,express!')
})

//send方法也可以直接传递一个对象：
app.get('/',(req,res)=>{
    res.send({name:'Jack',age:20})
})

3.中间件

1）什么是中间件

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

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

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

2）中间件处理请求

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

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

可以调用next方法将请求的控制权交给下一个中间件，直到遇到结束请求的中间件：

app.get('/request',(req,res,next)=>{
    req.name='Jack';
    next();  //使用next继续向下执行
})
app.get('/request',(req,res)=>{
    res.send(req.name);  //传回req.name，值是上一个中间件设置的
})

3）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();
})

4）中间件的应用

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

   app.use('/admin',(req,res,next)=>{
       let isLogin=false;  
       if(isLogin)  //如果登录状态正确，执行下一个请求
           next();
       else
           res.send('您还没有登录，不能访问该页面')
   })
   app.get('/admin',(req,res)=>{
       res.send('您已登录，可以访问当前页面')
   })
   

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

   //网站公告
   app.use((req,res,next)=>{
       res.send('当前网站正在维护...')
   })
   //因为没有next(),后续所有请求不会执行
   

3. 自定义404页面。

   app.use((req,res,next)=>{
       //为客户端响应404状态码以及提示信息
       res.status(404).send('当前访问的页面不存在')
   })
   

5）错误处理中间件

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

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

简单的例子：

app.get('/index',(req,res)=>{
    throw new Error('程序发生未知错误');
    //这里抛出一个错误
})

//错误处理中间件
app.use((err,req,res,next)=>{
    res.status(500).send(err.message);
    //err对象接收错误，message属性即抛出错误的信息
})

读取文件错误的例子：

const fs=require('fs');

app.get('/index',(req,res,next)=>{
    fs.readFile('./demo.txt','utf8',(err,res)=>{
        if(err)
            next(err)   //传入err参数，如果出错执行错误处理中间件
        else 
            res.send(res)
    })
})

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

6）捕获错误

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

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

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

app.get('/',async(req,res,next)=>{ //使用async定义异步函数
  try{
      await User.find({name:'Jack'})
  } catch(ex){
      next(ex);
  }
})

4. 构建模块化路由

1）基础代码

const express =require('express')
//创建服务器
const app =express();

//创建路由对象
const home = express.Router();
//将路由和请求路径进行匹配
app.use('/home',home);

//在home路由下继续创建路由(二级路由)
home.get('/index',()=>{
    // home/index
    res.send('hello')
})
//此时二级路由可以响应  /home/index 

2）多模块

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

5.express请求处理

1）GET参数的获取

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

//接收地址栏中问号后面的参数
//例如： http://localhost:3000/?name=Jack&age=20
app.get('/',(req,res)=>{
    console.log(req.query);
    //-> {"name":"Jack","age":"20"}
})

2）POST参数的获取

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

//引入body-parser模块
const bodyParser = require('body-parser');
//配置body-parse模块
app.use(bodyParser.urlencoded({ extended:false }));
//extended:false 方法内部使用querystring模块处理请求参数的格式
//extended:true  方法内部使用第三方模块qs处理请求参数的格式

//接收请求
app.post('/add',(req,res)=>{
    //接收参数
    console.log(req.body);
})

3）Express路由参数

//在请求的路径上使用  :id  表示接收一个参数，是一个对象，对象名为id
app.get('/find/:id',(req,res)=>{
    console.log(req.params);   
})
//访问localhost/find/123
//->  {id:123}

//使用多个参数：
app.get('/find/:id/:name/:age',(req,res)=>{});   

4）静态资源处理

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

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

则此时就可以访问public文件夹下的各种文件。

express-art-template模板引擎

为了使art-template模板引擎能够更好和express框架配合，模板引擎官方在原有模板引擎的基础上封装了 express-art-template。

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

//1.告诉express框架使用什么模板引擎渲染什么后缀的模板文件
    //当渲染后缀为art的模板时，使用express-art-template
app.engine('art',require('express-art-template'));
//2.设置模板存放目录
app.set('views',path.join(_dirname,'views'));
//3.告诉express框架模板的默认后缀是什么
    //渲染模板时不写后缀，默认拼接art后缀
app.set('view engine','art');

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

index.art文件

{{ msg }}