Node.js express

1. express 介绍

  • express 是一个基于 Node.js 平台的极简、灵活的 WEB 应用开发框架,官方网址:https://www.expressjs.com.cn/
  • 简单来说,express 是一个封装好的工具包,封装了很多功能,便于我们开发 WEB 应用(HTTP 服务)

2. express 使用

2.1 express 下载

express 本身是一个 npm 包,所以可以通过 npm 安装

npm init
npm i express

2.2 express 初体验

可以按照这个步骤进行操作:

  1. 创建 JS 文件,键入如下代码
js 复制代码
//1. 导入 express
const express = require('express');

//2. 创建应用对象
const app = express();

//3. 创建路由规则
app.get('/home', (req, res) => {
	res.end('hello express server');
});

//4. 监听端口 启动服务
app.listen(3000, () =>{
	console.log('服务已经启动, 端口监听为 3000...');
});
  1. 命令行下执行该脚本
bash 复制代码
node <文件名>
# 或者
nodemon <文件名>
  1. 然后在浏览器就可以访问 http://127.0.0.1:3000/home

3. express 路由

3.1 什么是路由

官方定义: 路由确定了应用程序如何响应客户端对特定端点的请求

3.2 路由的使用

一个路由的组成有 请求方法路径回调函数 组成

express 中提供了一系列方法,可以很方便的使用路由,使用格式如下:

app.<method>(path,callback)

  • 代码示例:
js 复制代码
//导入 express
const express = require('express');

//创建应用对象
const app = express();

//创建 get 路由
app.get('/home', (req, res) => {
	res.send('网站首页');
});

//首页路由
app.get('/', (req,res) => { // 首页路由路径为一个"/"
	res.send('我才是真正的首页');
});

//创建 post 路由
app.post('/login', (req, res) => {
	res.send('登录成功');
});

//匹配所有的请求方法
app.all('/search', (req, res) => {
	res.send('1 秒钟为您找到相关结果约 100,000,000 个');
});

//自定义 404 路由
app.all("*", (req, res) => {
	res.send('<h1>404 Not Found</h1>')  // 直接发送一个html元素展示页面
});

//监听端口 启动服务
app.listen(3000, () =>{
	console.log('服务已经启动, 端口监听为 3000');
});

3.3 获取请求参数

express 框架封装了一些 API 来方便获取请求报文中的数据,并且兼容原生 HTTP 模块的获取方式

js 复制代码
//导入 express
const express = require('express');

//创建应用对象
const app = express();

//获取请求的路由规则
app.get('/request', (req, res) => {
	//1. 获取报文的方式与原生 HTTP 获取方式是兼容的
	console.log(req.method);
	console.log(req.url);
	console.log(req.httpVersion);
	console.log(req.headers);
	
	//2. express 独有的获取报文的方式
	//获取查询字符串
	console.log(req.query); // 『相对重要』
	// 获取指定的请求头
	console.log(req.get('host'));
	res.send('请求报文的获取');
});

//启动服务
app.listen(3000, () => {
	console.log('启动成功....')
})

3.4 获取路由参数

路由参数指的是 URL 路径中的参数(数据)

js 复制代码
app.get('/:id.html', (req, res) => {
	res.send('商品详情, 商品 id 为' + req.params.id);
});

4. express 响应设置

express 框架封装了一些 API 来方便给客户端响应数据,并且兼容原生 HTTP 模块的获取方式

js 复制代码
//获取请求的路由规则
app.get("/response", (req, res) => {
	//1. express 中设置响应的方式兼容 HTTP 模块的方式
	res.statusCode = 404;
	res.statusMessage = 'xxx';
	res.setHeader('abc','xyz');
	res.write('响应体');
	res.end('xxx');
	
	//2. express 的响应方法
	res.status(500); //设置响应状态码
	res.set('xxx','yyy');//设置响应头
	res.send('中文响应不乱码');//设置响应体
	//连贯操作
	res.status(404).set('xxx','yyy').send('你好朋友')
	
	//3. 其他响应
	res.redirect('http://atguigu.com')//重定向
	res.download('./package.json');//下载响应
	res.json();//响应 JSON
	res.sendFile(__dirname + '/home.html') //响应文件内容
});

5. express 中间件

5.1 什么是中间件

中间件(Middleware)本质是一个回调函数
中间件函数 可以像路由回调一样访问 请求对象(request)响应对象(response)

5.2 中间件的作用

中间件的作用 就是 使用函数封装公共操作,简化代码

5.3 中间件的类型

  • 全局中间件
  • 路由中间件

5.3.1 定义全局中间件

每一个请求 到达服务端之后 都会执行全局中间件函数

  • 声明中间件函数
js 复制代码
let recordMiddleware = function(request,response,next){
	//实现功能代码
	//.....
	//执行next函数(当如果希望执行完中间件函数之后,仍然继续执行路由中的回调函数,必须调用next)
	next();
}
  • 应用中间件

app.use(recordMiddleware);

  • 声明时可以直接将匿名函数传递给 use
js 复制代码
app.use(function (request, response, next) {
	console.log('定义第一个中间件');
	next();
})

代码示例:

js 复制代码
/**
 * 记录每个请求的 url 与 IP 地址
 */
//导入 express
const express = require('express');
const fs = require('fs');
const path = require('path');

//创建应用对象
const app = express();

//声明中间件函数
function recordMiddleware(req, res, next){
  //获取 url 和 ip
  let {url, ip} = req;
  //将信息保存在文件中 access.log
  fs.appendFileSync(path.resolve(__dirname, './access.log'), `${url}  ${ip}\r\n`);
  //调用 next
  next();
}

//使用中间件函数
app.use(recordMiddleware);

//创建路由
app.get('/home', (req, res) => {
  res.send('前台首页');
});

app.get('/admin', (req, res) => {
  res.send('后台首页');
});

app.all('*',(req, res) => {
  res.send('<h1>404 Not Found</h1>')
})

//监听端口, 启动服务
app.listen(3000, () => {
  console.log('服务已经启动, 端口 3000 正在监听中....')
})

5.3.2 多个全局中间件

express 允许使用 app.use() 定义多个全局中间件

js 复制代码
app.use(function (request, response, next) {
	console.log('定义第一个中间件');
	next();
})

app.use(function (request, response, next) {
	console.log('定义第二个中间件');
	next();
})

5.3.3 定义路由中间件

如果 只需要对某一些路由进行功能封装 ,则就需要路由中间件

调用格式如下:

js 复制代码
app.get('/路径',`中间件函数`,(request,response)=>{
	...
});

app.get('/路径',`中间件函数1`,`中间件函数2`,(request,response)=>{
	...
});

代码示例:

js 复制代码
/**
 * 针对 /admin  /setting 的请求, 要求 URL 携带 code=521 参数, 如未携带提示『暗号错误』  
 */

//导入 express
const express = require('express');

//创建应用对象
const app = express();

//创建路由
app.get('/home', (req, res) => {
  res.send('前台首页');
});

//声明中间件
let checkCodeMiddleware = (req, res, next) => {
  //判断 URL 中是否 code 参数等于 521
  if(req.query.code === '521'){
    next();
  }else{
    res.send('暗号错误');
  }
}

//后台
app.get('/admin', checkCodeMiddleware, (req, res) => {
  res.send('后台首页');
});

//后台设置
app.get('/setting', checkCodeMiddleware, (req, res) => {
  res.send('设置页面');
});

app.all('*',(req, res) => {
  res.send('<h1>404 Not Found</h1>')
})

//监听端口, 启动服务
app.listen(3000, () => {
  console.log('服务已经启动, 端口 3000 正在监听中....')
})

5.4 静态资源中间件

express 内置处理静态资源的中间件

js 复制代码
//引入express框架
const express = require('express');

//创建服务对象
const app = express();

//静态资源中间件的设置,将当前文件夹下的public目录作为网站的根目录
app.use(express.static('./public')); //当然这个目录中都是一些静态资源
//如果访问的内容经常变化,还是需要设置路由
//但是,在这里有一个问题,如果public目录下有index.html文件,单独也有index.html的路由,
//则谁书写在前,优先执行谁
app.get('/index.html',(request,response)=>{
	respsonse.send('首页');
});

//监听端口
app.listen(3000,()=>{
	console.log('3000 端口启动....');
});

注意事项:

  1. index.html 文件为默认打开的资源
  2. 如果静态资源与路由规则同时匹配,谁先匹配谁就响应
  3. 路由响应动态资源,静态资源中间件响应静态资源

5.5 获取请求体数据 body-parser

express 可以使用 body-parser 包处理请求体

  • 第一步:安装
    npm i body-parser

  • 第二步:导入 body-parser 包
    const bodyParser = require('body-parser');

  • 第三步:获取中间件函数

js 复制代码
//处理 querystring 格式的请求体
let urlParser = bodyParser.urlencoded({extended:false}));

//处理 JSON 格式的请求体
let jsonParser = bodyParser.json();
  • 第四步:设置路由中间件,然后使用 request.body 来获取请求体数据
js 复制代码
app.post('/login', urlParser, (request,response)=>{
	//获取请求体数据
	//console.log(request.body);
	
	//用户名
	console.log(request.body.username);
	
	//密码
	console.log(request.body.userpass);
	response.send('获取请求体数据');
});

获取到的请求体数据:

js 复制代码
[Object: null prototype] { username: 'admin', userpass: '123456' }

6. Router

6.1 什么是 Router

express 中的 Router 是一个完整的中间件和路由系统,可以看做是一个小型的 app 对象。

6.2 Router 作用

对路由进行模块化,更好的管理路由

6.3 Router 使用

创建独立的 JS 文件(homeRouter.js)

js 复制代码
//1. 导入 express
const express = require('express');

//2. 创建路由器对象
const router = express.Router();

//3. 在 router 对象身上添加路由
router.get('/', (req, res) => {
	res.send('首页');
})

router.get('/cart', (req, res) => {
	res.send('购物车');
});

//4. 暴露
module.exports = router;

主文件

js 复制代码
const express = require('express');
const app = express();

//5.引入子路由文件
const homeRouter = require('./routes/homeRouter');

//6.设置和使用中间件
app.use(homeRouter);
app.listen(3000,()=>{
	console.log('3000 端口启动....');
})

7. EJS 模板引擎

7.1 什么是模板引擎

模板引擎是分离 用户界面和业务数据 的一种技术

7.2 什么是 EJS

7.3 EJS 初体验

下载安装EJS

bash 复制代码
npm i ejs --save

代码示例

js 复制代码
//1.引入ejs
const ejs = require('ejs');

//2.定义数据
let person = ['张三','李四','王二麻子'];

//3.ejs解析模板返回结构
//<%= %> 是ejs解析内容的标记,作用是输出当前表达式的执行结构
let html = ejs.render('<%= person.join(",") %>', {person:person});

//4.输出结果
console.log(html);

命令行下运行

  • 代码示例:
js 复制代码
//1. 安装 EJS
//2. 导入 EJS
const ejs = require('ejs');
const fs = require('fs');

//字符串
let china = '中国';
// let str = `我爱你 ${china}`;
let weather = '今天天气不错~';

//声明变量
let str = fs.readFileSync('./01_html.html').toString();

//使用 ejs 渲染
let result = ejs.render(str, {china: china, weather});

console.log(result);
  • html:
html 复制代码
<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8">
  <meta http-equiv="X-UA-Compatible" content="IE=edge">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  <title>Document</title>
</head>
<body>
  <h2>我爱你 <%= china %></h2>
  <p><%= weather %></p>
</body>
</html>

7.4 列表渲染

  • js
js 复制代码
const ejs = require('ejs');
//西游记
const xiyou = ['唐僧','孙悟空','猪八戒','沙僧'];

//原生 JS
// let str = '<ul>';

// xiyou.forEach(item => {
//   str += `<li>${item}</li>`;
// })

// //闭合 ul
// str += '</ul>';

// console.log(str);

// EJS 实现
const fs = require('fs');
let html = fs.readFileSync('./02_西游.html').toString();
let result = ejs.render(html, {xiyou:xiyou});

console.log(result);
  • html
html 复制代码
<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8">
  <meta http-equiv="X-UA-Compatible" content="IE=edge">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  <title>西游四人组</title>
</head>
<body>
  <h2>西游四人组</h2>
  <ul>
    <% xiyou.forEach(item => { %>
    <li><%= item %></li>
    <% }) %>
  </ul>
</body>
</html>

7.5 条件渲染

  • js
js 复制代码
/**
 * 通过 isLogin 决定最终的输出内容
 * true   输出『<span>欢迎回来</span>』
 * false  输出『<button>登录</button>  <button>注册</button>』
 */
// 导入 ejs
const ejs = require('ejs');
const fs = require('fs');
//变量
let isLogin = true;

//原生 JS
// if(isLogin){
//   console.log('<span>欢迎回来</span>')
// }else{
//   console.log('<button>登录</button>  <button>注册</button>');
// }


//EJS 实现
//读取 HTML 内容
let html = fs.readFileSync('./03_home.html').toString();
let result = ejs.render(html, {isLogin: isLogin});

console.log(result);
  • html
html 复制代码
<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8">
  <meta http-equiv="X-UA-Compatible" content="IE=edge">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  <title>Document</title>
</head>
<body>
  <header>
    <% if(isLogin){ %>
    <span>欢迎回来</span>
    <% }else{ %>
    <button>登录</button>  <button>注册</button>
    <% } %>
  </header>
</body>
</html>

7.6 express 中使用 ejs.js

js 复制代码
//导入 express
const express = require('express');
//导入 path
const path = require('path');
//创建应用对象
const app = express();
//1. 设置模板引擎
app.set('view engine', 'ejs');// pug  twing
//2. 设置模板文件存放位置   模板文件: 具有模板语法内容的文件
app.set('views', path.resolve(__dirname, './views'));

//创建路由
app.get('/home', (req, res) => {
  //3. render 响应
  // res.render('模板的文件名', '数据');
  //声明变量
  let title = '尚硅谷 - 让天下没有难学的技术';
  res.render('home', {title});
  //4. 创建模板文件
});

//监听端口, 启动服务
app.listen(3000, () => {
  console.log('服务已经启动, 端口 3000 正在监听中....')
})

7.7 EJS 常用语法

执行JS代码

js 复制代码
<% code %>

输出转义的数据到模板上

js 复制代码
<%= code %>

输出非转义的数据到模板上

js 复制代码
<%- code %>
相关推荐
蔓越莓2 小时前
Node.js系列:事件驱动的核心机制事件循环
node.js
web网站装修工2 小时前
你会选择java还是node做后台管理
java·前端·javascript·vue.js·后端·前端框架·node.js
web网站装修工4 小时前
vue3.0如何快速封装自定义指令!
前端·javascript·vue.js·elementui·前端框架·node.js·vue
m0_748240914 小时前
node.js+npm的环境配置以及添加镜像(保姆级教程)
arcgis·npm·node.js
蒜蓉大猩猩6 小时前
Node.js - Cookie与Session详解
分布式·后端·中间件·node.js
haughtyAndAnd14 小时前
为什么npm i 要加上--save-dev
前端·npm·node.js
dehuisun14 小时前
pnpm安装
node.js
itwlz15 小时前
npm发布组件(vue3+webpack)
前端·npm·node.js
wangbing11251 天前
npm ERR! code CERT_HAS_EXPIRED
前端·npm·node.js
ThomasChan1231 天前
CSS 样式 box-sizing: border-box; 详细解读
前端·javascript·css·node.js·html·css3·html5