Node.js - 03:Express框架

        express 是一个基于 Node.js 平台的极简、灵活的 WEB 应用开发框架,官方网址:https://www.expressjs.com.cn/

        简单来说,express 是一个封装好的工具包,封装了很多功能,便于我们开发 WEB 应用(HTTP 服务)

1、使用

1.1 下载

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

npm init

npm i express

1.2 使用
// 导入
const express = require('express')
// 创建应用对象
const app = express()
// 创建路由
app.get('/home', (req, resp) => [
  resp.end('end...')
])
// 监听端口,启动服务
app.listen(9000, () => {
  console.log('success')
})

2、路由

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

2.1 使用

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

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

app.<method>(path,callback)

//导入 express
const express = require('express')
//创建应用对象
const app = express()
//创建 get 路由
app.get('/home', (req, res) => {
    res.send('home')
});
//首页路由
app.get('/', (req,res) => {
    res.send('home')
});
//创建 post 路由
app.post('/login', (req, res) => {
    res.send('login success')
});
//匹配所有的请求方法
app.all('/search', (req, res) => {
    res.send('search')
});
//自定义 404 路由
app.all("*", (req, res) => {
    res.send('<h1>404 Not Found</h1>')
});
//监听端口 启动服务
app.listen(3000, () =>{
    console.log('服务已经启动, 端口监听为 3000')
});
2.2 获取请求参数

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

//导入 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.path)
    //获取查询字符串
    console.log(req.query)  // 相对重要
    //获取ip
    console.log(req.ip)
    // 获取指定的请求头
    console.log(req.get('host'))
    res.send('请求报文的获取')
});
//启动服务
app.listen(3000, () => {
    console.log('server success....')
})
2.3 获取路由参数

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

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

3、响应设置

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

//获取请求的路由规则
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') //响应文件内容
});

4、express中间件

中间件(Middleware)本质是一个回调函数

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

作用:使用函数封装公共操作,简化代码

类型:全局中间件、路由中间件

4.1 全局中间件
// 导入
const express = require('express')
const fs = require('fs')
const path = require('path')
// 创建应用对象
const app = express()
// 声明中间件函数
function recordMiddleware(req, res, next) {
  let { url, ip } = req
  fs.readFileSync(path.resolve(__dirname, './home.log'), `${url} ${ip}\r\n`)
  next()
}
// 使用中间件函数
app.use()
// 创建路由
app.get('/home', (req, res) => {

  res.send('home')
})
app.get('/admin', (req, res) => {

  res.send('admin')
})
app.all('*', (req, res) => {
  res.send('<h3>404 Not Found</h3>')
})
// 监听端口,启动服务
app.listen(9000, () => {
  console.log('success')
})

应用多个全局中间件:

app.use(function (request, response, next) {
    console.log('定义第一个中间件')
    next()
})
app.use(function (request, response, next) {
    console.log('定义第二个中间件')
    next()
})
4.2 路由中间件
// 导入
const express = require('express')
// 创建应用对象
const app = express()

// 创建路由
app.get('/home', (req, res) => {

  res.send('home')
})
// 声明中间件
let checkCodeMiddleware = (req, res, next) => {
  if (req.query.code === '521') {
    next()
  } else {
    res.send('no success')
  }
}
// checkCodeMiddleware放在受约束的路由中,在路径后面
app.get('/admin', checkCodeMiddleware, (req, res) => {
  res.send('admin')
})
app.get('/setting', (req, res) => {

  res.send('setting')
})
app.all('*', (req, res) => {
  res.send('<h1>404 Not Found</h1>')
})
// 监听端口,启动服务
app.listen(9000, () => {
  console.log('success')
})

定义路由中间件:

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

})

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

})
4.3 静态资源中间件
//引入express框架
const express = require('express')
//创建服务对象
const app = express()
//静态资源中间件的设置,将当前文件夹下的public目录作为网站的根目录
app.use(express.static(__dirname + './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. 路由响应动态资源,静态资源中间件响应静态资源

4.4 获取请求体数据

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

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

npm i body-parser

第二步:导入 body-parser 包

const bodyParser = require('body-parser');

第三步:获取中间件函数

//处理 querystring 格式的请求体

let urlParser = bodyParser.urlencoded({extended:false}));

//处理 JSON 格式的请求体

let jsonParser = bodyParser.json();

第四步:设置路由中间件,然后使用 request.body 来获取请求体数据

app.post('/login', urlParser, (request,response)=>{

        //获取请求体数据

        //console.log(request.body);

        //用户名

        console.log(request.body.username);

        //密码

        console.log(request.body.userpass);

        response.send('获取请求体数据');

});

获取到的请求体数据:

[Object: null prototype] { username: 'admin', userpass: '123456' }

// 导入
const express = require('express')
const bodyParser = require('body-parser')
// 创建应用对象
const app = express()
//处理 querystring 格式的请求体的中间件
let urlParser = bodyParser.urlencoded({ extended: false })
//处理 JSON 格式的请求体的中间件
let jsonParser = bodyParser.json();
// 创建路由
app.get('/login', (req, res) => {
  // 获取html响应内容
  res.sendFile(__dirname + './form.html')
})
app.post('/login', urlParser, (req, res) => {
  console.log(req.body)
  res.send('user data')
})

// 监听端口,启动服务
app.listen(9000, () => {
  console.log('success')
})

5、防盗链

        防止外部网站引用本网站的资源

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

// 创建应用对象
const app = express()
// 声明中间件
app.use((req, res, next) => {
  let referer = req.get('referer')
  // console.log(referer)
  if (referer) {
    // 实例化
    let url = new URL(referer)
    let hostname = url.hostname
    console.log(hostname)
    if (hostname !== '127.0.0.1') {
      res.status(404).send('<h1>404 Not Found</h1>')
    }
    return;
  }
  next()
})
app.use(express.static(__dirname + './test'))

// 监听端口,启动服务
app.listen(9000, () => {
  console.log('success')
})

6、路由模块化

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

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

// /express/01-use.js
const homeRouter = require('./routes/homeRouter')
const adminRouter = require('./routes/adminRouter')
// 导入
const express = require('express')

// 创建应用对象
const app = express()
app.use(homeRouter)
app.use(adminRouter)
app.all('*', (req, res) => {
  res.status(404).send('<h1>404 Not Found</h1>')
})
app.use(express.static(__dirname + './test'))

// 监听端口,启动服务
app.listen(9000, () => {
  console.log('success')
})

封装homeRouter.js

const express = require('express')
// 创建路由对象
const router = express.Router()
// 创建路由规则
router.get('/home', (req, res) => {
  res.send('home')
})
router.get('/s', (req, res) => {
  res.send('s')
})
// 暴露router
module.exports = router

封装adminRouter.js

const express = require('express')
// 创建路由对象
const router = express.Router()
// 创建路由规则
router.get('/admin', (req, res) => {
  res.send('admin')
})
router.get('/setting', (req, res) => {
  res.send('setting')
})
// 暴露router
module.exports = router

7、EJS模板引擎

模板引擎是分离 用户界面和业务数据 的一种技术(分离HTML和服务端的JS)

EJS 是一个高效的 Javascript 的模板引擎

官网: https://ejs.co/

中文站:https://ejs.bootcss.com/

7.1 使用

安装:

npm i ejs --save

//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代码:

<% code %>

//1.引入ejs
const ejs = require('ejs')
//2.定义数据
let person = ['唐僧', '孙悟空', '猪八戒', '沙僧']

let html = ejs.render(`<ul>
  <% person.forEach(item=>{ %>
      <li><%= item %></li>
  <% }) %>
  </ul>`, { person: person })
//4.输出结果
console.log(html)

输出转义的数据到模板上

<%= code %>

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

<%- code %>

7.2 条件渲染
//1.引入ejs
const ejs = require('ejs')

let isLogin = true
let res = ejs.render(`
  <% if(isLogin){ %>
  <span>欢迎回来</span>
  <% }else{ %>
  <button>登陆</button><button>登陆</button>
  <% } %>
  `, { isLogin: isLogin })
console.log(res)
7.3 在express中使用ejs
// ./views/home.ejs
<!DOCTYPE html>
<html lang="en">

<head>
  <meta charset="UTF-8">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  <title>Document</title>
</head>

<body>
  <h2>
    <%= title %>
  </h2>
</body>

</html>
const express = require('express')
const path = require('path')
const app = express()
// 设置模板引擎
app.set('view engine', 'ejs')  //pug twing
// 设置模板文件的存放位置 模板文件:具有模板语法内容的文件
app.set('views', path.resolve(__dirname + './views'))
app.get('/home', (req, res) => {
  // render 响应
  let title = 'home'
  res.render('home', { title })
  // 创建模板文件

})
app.listen(9000, () => {
  console.log('server success')

})
7.4 express-generator工具

        通过应用程序生成工具express-generator可以快速创建一个应用的骨架

安装:

npm install -g express-generator

express

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值