Express框架

Express是一个基于Node平台的web应用开发框架,它提供了强大的特性,帮助创建各种web应用,使用npm install express命令下载;

特点:

1.提供了方便简单的路由定义;

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

3.对模板引擎支持程度高,方便渲染html页面;

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

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

1.res.send()方法响应

//引入express模块
//返回值是一个方法
const express = require('express');

//创建网站服务器
const app = express();
app.get('/',(req,res)=>{
    //send()方法  自动监测响应类型,帮我们把响应类型自动设置到响应头当中
    //还可以设置响应类型的编码,防止出现乱码情况,还可以自动设置http状态码
    // 1. send方法内部会检测响应内容的类型
	// 2. send方法会自动设置http状态码
	// 3. send方法会帮我们自动设置响应的内容类型及编码
    res.send('Hello,express');
})
app.get('/list',(req,res)=>{
    res.send({name:'张三',age:18});
})
//监听端口
app.listen(3000);
console.log('网站服务器启动成功');

2.中间件

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

中间件由两部分组成,中间件方法和请求处理函数;

中间件方法由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.1 app.use中间件用法

使用app.use()方法定义中间件;

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

app.use((req,res,next)=>{
    console.log('请求走了app.use中间件');
    next();
})
//中间件函数有三个参数,分别为请求对象req,响应对象res,释放控制权方法next;
//中间件函数中的代码执行完成后需要调用next()方法,才开始执行下一个中间件,否则请求将挂起;

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

app.use('/admin',(req,res,next)=>{
    console.log('请求走了app.use/admin中间件');
    next();
})

2.2中间件的应用

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

// //匹配所有的请求路径,,网站公告
// app.use((req,res,next)=>{
//     res.send('当前网站正在维护.......');
// })

app.use('/admin',(req,res,next)=>{
    // 用户没有登录
    let isLogin = true;
    //如果用户登录
    if(isLogin){
        //让请求继续向下执行
        next();
    }else {
        //如果用户没有登录,直接对客户端作出响应
        res.send('您还没有登录,不能访问这个页面');
    }
})
app.get('/admin',(req,res)=>{
    res.send('您已经登录,可以访问当前页面');
})
//访问除了上边写过的页面外,其他所有页面都不存在
app.use((req,res,next)=>{
    //为客户端响应404状态码,以及提示信息
    res.status(404).send('当前访问的页面不存在');
})

//监听端口
app.listen(3000);
console.log('网站服务器启动成功');

2.3错误处理中间件

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

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

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

app.get('/index', (req, res, next) => {
	// throw new Error('程序发生了未知错误')
	fs.readFile('./01.js', 'utf8', (err, result) => {
		//读取文件失败
		if (err != null) {
			//把错误传递给下边捕获错误信息
			next(err);
		}else {
			//读取文件成功响应文件内容
			res.send(result)
		}
	})
    // res.send('程序正常执行');
})

//错误处理中间
//里边传递一个请求的处理函数,第一个参数err错误对象,第二个req请求对象
//第三个是响应对象,第四个是next
app.use((err, req, res, next) => {
    //服务器发生错误状态码是500,err.massage保存错误信息
    res.status(500).send(err.message);
})
//监听端口
app.listen(3000);
console.log('网站服务器启动成功');

2.4捕获错误

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

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

 app.get("/", async (req, res, next) => {
     try {
         await User.find({name: '张三'})
     }catch(ex) {
         next(ex);
     }
 });

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

3.模块化路由

//调用express下面的Router方法,返回值是一个路由对象,
//然后可以在home路由对象下边挂载二级路由
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);

4.GET参数获取

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

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

5.POST参数获取

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

 // 引入body-parser模块
 const bodyParser = require('body-parser');
 // 配置body-parser模块
// extended:false  在方法的内部使用内部模块querystring来处理请求参数的格式
// extended:true 方法内部使用第三方模块qs处理请求参数
 app.use(bodyParser.urlencoded({ extended: false }));
 // 接收请求
 app.post('/add', (req, res) => {
    // 接收post请求参数
    console.log(req.body);
 }) 

6.Express路由参数

app.get('/index/:id/:name/:age',(req,res)=>{
    //接收post请求参数
    res.send(req.params);
})
//地址栏中输入http://localhost:3000/index/100/zhangsan/20
//响应结果
{"id":"100","name":"zhangsan","age":"20"}

7.静态资源

通过Express内置的express.static可以方便的托管静态文件,例如图片,css,JavaScript文件等;

app.use(express.static('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

8.express-art-template模板引擎

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

安装

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

使用

varexpress = require('express');
var app = express();
/* start**以下几个配置完成后才可以使用res.render()方法渲染模板**** */
// 告诉express框架模板所在位置,告诉express框架使用什么模板引擎,渲染什么后缀的模板文件
//app.set()方法是对express框架配置,第一个参数模板位置配置,项目名字叫views,是框架内部规定好的,
//第二个参数就是模板位置,拼接的绝对路径
app.set('views',path.join(__dirname,'views'));
// 告诉express框架模板的默认后缀是什么
app.set('view engine','art');
//当渲染后缀为art的模板时,所使用的模板引擎是什么;第一个参数是后缀名(art),第二个参数是引入的模板引擎模块
app.engine('art',require('express-art-template'));
//模板中的相对路径是是相对于地址栏中的请求路径的
/*end *********** */


admin.get('/', (req, res) => {
    // 使用res.render来渲染登录模板
    res.render('views文件夹下的文件名');
});