一、 前言
本系列文章旨在快速复习并上手轻量级服务器开发Node技术,并在适当分享在项目实战过程中遇到的一些比较有价值的知识内容:
- 01-📝Node.js核心知识|Node开发概述【了解Node开发、Node运行环境搭建
- 02-📝Node.js核心知识|Node.js语法【ES6+Node模块API】
- 03-📝Node.js核心知识|模块加载及第三方包【Node.js模块化开发、系统模块、 第三方模块、模块的加载机制、package.json文件】
- 04-📝Node.js核心知识|请求响应原理及HTTP协议【服务器基础概念、创建web服务器、 HTTP协议、HTTP请求与响应、异步编程】
- 05-📝Node.js核心知识|MongoDB数据库【数据库概述及环境搭建、MongoDB增删改查】
- 06-📝Node.js核心知识|模板引擎artTemplate【模板引擎概念、模板引擎语法、模板引擎案例】
- 07-📝Node.js核心知识| Express框架【Express框架简介及初体验、Express中间件、Express框架请求处理、模板引擎】
搭建博客站点实战笔记待输出
正所谓,抬头看路纲举目张,我们学习一项技能是要有清晰的任务目标的，不然就容易脱离原本的路线,不断胡乱发散,导致自己的精力消耗,但收获不大。因此我们不妨先划定一个大纲,然后一步一步来吃透这些具备可实践性的知识点。避免不必要的口水话,让所学一步一步变现！
本系列文章内容篇幅如下:
- 一、了解Node开发
- 了解Node开发
- Node运行环境搭建
- Node.js语法快速入门
- Node.js模块化开发
- 服务器端基础概念
- MongoDB数据库
- 模板引擎artTemplate
- Express框架简介及初体验
- Express中间件
- Express框架请求处理
- express-art-template模板引擎
- 项目环境搭建
- 项目功能实现
- 项目包含的知识点
二、Express框架简介及初体验
Express框架简介及初体验
1. Express框架是什么
Express是一个基于Node平台的web应用开发框架，它提供了一系列的强大特性，帮助你创建各种Web应用。我们可以使用 npm install express 命令进行下载。
2. Express框架特性
- 提供了方便简洁的路由定义方式
- 对获取HTTP请求参数进行了简化处理
- 对模板引擎支持程度高，方便渲染动态HTML页面
- 提供了中间件机制有效控制HTTP请求
- 拥有大量第三方中间件对功能进行扩展
3. 原生Node.js与Express框架对比之路由
app.on('request', (req, res) => {
// 获取客户端的请求路径
let { pathname } = url.parse(req.url);
// 对请求路径进行判断 不同的路径地址响应不同的内容
if (pathname == '/' || pathname == 'index') {
res.end('欢迎来到首页');
} else if (pathname == '/list') {
res.end('欢迎来到列表页页');
} else if (pathname == '/about') {
res.end('欢迎来到关于我们页面')
} else {
res.end('抱歉, 您访问的页面出游了');
}
});
// 当客户端以get方式访问/时
app.get('/', (req, res) => {
// 对客户端做出响应
res.send('Hello Express');
});
// 当客户端以post方式访问/add路由时
app.post('/add', (req, res) => {
res.send('使用post方式请求了/add路由');
});
4. 原生Node.js与Express框架对比之获取请求参数
app.on('request', (req, res) => {
// 获取GET参数
let {query} = url.parse(req.url, true);
// 获取POST参数
let postData = '';
req.on('data', (chunk) => {
postData += chunk;
});
req.on('end', () => {
console.log(querystring.parse(postData)
}));
});
app.get('/', (req, res) => {
// 获取GET参数
console.log(req.query);
});
app.post('/', (req, res) => {
// 获取POST参数
console.log(req.body);
})
5. Express初体验
使用Express框架创建web服务器及其简单，调用express模块返回的函数即可。
// 引入Express框架
const express = require('express');
// 使用框架创建web服务器
const app = express();
// 当客户端以get方式访问/路由时
app.get('/', (req, res) => {
// 对客户端做出响应 send方法会根据内容的类型自动设置请求头
res.send('Hello Express'); // Hello Express
{say: 'hello'}
});
// 程序监听3000端口
app.listen(3000);
三、Express中间件
1. 什么是中间件
中间件就是一堆方法，可以接收客户端发来的请求、可以对请求做出响应，也可以将请求继续交给下一个中间件继续处理。
- 中间件主要由两部分构成，中间件方法以及请求处理函数。
- 中间件方法由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. 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();
});
3. 中间件应用
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);
}
});
});
5. 捕获错误
-
在node.js中，异步API的错误信息都是通过回调函数获取的，支持Promise对象的异步API发生错误可以通过catch方法捕获。
异步函数执行如果发生错误要如何捕获错误呢？ -
try catch 可以捕获异步函数以及其他同步代码在执行过程中发生的错误，但是不能其他类型的API发生的错误。
app.get("/", async (req, res, next) => {
try {
await User.find({name: '张三'})
}catch(ex) {
next(ex);
}
});
四、Express框架请求处理
1. 构建模块化路由
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);
2. 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"}
});
3. POST参数的获取
Express中接收post请求参数需要借助第三方包 body-parser。
// 引入body-parser模块
const bodyParser = require('body-parser');
// 配置body-parser模块
app.use(bodyParser.urlencoded({ extended: false }));
// 接收请求
app.post('/add', (req, res) => {
// 接收请求参数
console.log(req.body);
})
4. Express路由参数
app.get('/find/:id', (req, res) => {
console.log(req.params); // {id: 123}
});
localhost:3000/find/123
5. 静态资源的处理
通过Express内置的express.static可以方便地托管静态文件，例如img、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
五、express-art-template模板引擎
1. 模板引擎
- 为了使art-template模板引擎能够更好的和Express框架配合，模板引擎官方在原art-template模板引擎的基础上封装了express-art-template。
- 使用
npm install art-template express-art-template命令进行安装。
// 当渲染后缀为art的模板时 使用express-art-template
app.engine('art', require('express-art-template'));
// 设置模板存放目录
app.set('views', path.join(__dirname, 'views'));
// 渲染模板时不写后缀 默认拼接art后缀
app.set('view engine', 'art');
app.get('/', (req, res) => {
// 渲染模板
res.render('index');
});
2. app.locals 对象
将变量设置到app.locals对象下面，这个数据在所有的模板中都可以获取到。
app.locals.users = [{
name: '张三',
age: 20
},{
name: '李四',
age: 20
}]
