Node.js - 关于 Express 的基本使用

267 阅读4分钟

一起养成写作习惯!这是我参与「掘金日新计划 · 4 月更文挑战」的第6天,点击查看活动详情

什么是 Express

  • Express 是基于 Node.js 平台,快速、开放、极简的Web 开放框架。通俗理解,Express 的作用和 Node.js 内置的 http 模块类似,只不过 http 内置模块用起来复杂,开发效率低,Express是基于内置的 http 模块进一步封装出来的,能够极大的提高开发效率

  • Express 本质:就是一个 npm 上的第三方包,提供快速创建 web 服务器 或 API 接口服务器

  • Express 中文网站:www.expressjs.com.cn


Express 可以做什么

对于前端来说,常见的有俩种服务器

  • Web 网站服务器: 专门对外提供 web 网页资源的服务器
  • API 接口服务器: 专门对外提供 API 接口服务器

Express基本使用

  • 安装

    npm i express@4.17.1
    
  • 创建基本的 web 服务器

    // 导入 express
    const express = require('express')
    
    // 创建 web 服务器
    const app = express()
    
    // 启动 web 服务器
    app.listen(80, () => {
        console.log('express server running at http:127.0.0.1');
    })
    
  • 监听 GET 请求

    通过 app.get() 方法,可以监听客户端的 GET 请求,语法如下

    //参数1:客户端请求的 URL 地址
    //参数2:请求对应的处理函数
    // req: 请求对象(包含了与请求相关的属性和方法)
    // res: 响应对象(包含了与响应相关的属性和方法)
    
    app.get('请求URL', function(req, res) {
        //函数处理
    })
    
  • 监听 POST 请求

    通过 app.post() 方法,可以监听客户端的 POST 请求,语法如下

    //参数1:客户端请求的 URL 地址
    //参数2:请求对应的处理函数
    // req: 请求对象(包含了与请求相关的属性和方法)
    // res: 响应对象(包含了与响应相关的属性和方法)
    
    app.post('请求URL', function(req, res) {
        //函数处理
    })
    
  • 把内容响应给客户端

    通过 res.send() 方法,可以把处理好的内容,发给客户端

    • GET示例(postman GET请求地址为:http://127.0.0.1/user

      const express = require('express')
      const app = express()
      
      app.get('/user', function(req, res) {
          // 向客户端响应一个 JSON 对象
          res.send({
              name: 'lilei',
              age: 18,
              gender: '男'
          })
      })
      
      app.listen(80, () => {
          console.log('express 服务器运行在 http://127.0.0.1.80')
      })
      
    • POST示例(postman POST请求地址为:http://127.0.0.1/user

      const express = require('express')
      const app = express()
      
      app.post('/user', function(req, res) {
          // 向客户端响应一个 文本字符串
          res.send('请求成功')
      })
      
      app.listen(80, () => {
          console.log('express 服务器运行在 http://127.0.0.1.80')
      })
      
  • 获取 URL 中携带的查询参数

    • 通过 req.query 对象,可以访问到客户端通过查询字符串的形式,发送到服务器的参数

      app.get('/', (req, res) => {
          //res.query 默认是一个空对象
          //例如客户端使用 ?name=lilei&age=18 这种查询字符串形式,发送到服务器的参数
          //通过 req.query 对象访问到
          //req.query.name
          //req.query.age
          console.log(req.query)
      })
      
    • 示例(postman GET请求地址为:http://127.0.0.1/?name=lilei&age=18

      const express = require('express')
      const app = express()
      
      app.get('/', (req, res) => {
          console.log(req.query)
          res.send('请求成功')
      })
      
      app.listen(80, () => {
          console.log('express 服务器运行在 http://127.0.0.1.80')
      })
      

      log:

      Snip20220329_2.png

  • 获取 URL 中的动态参数

    • 通过 req.params 对象,可以访问到 URL 中,通过 : 匹配到的动态参数

      // URL 地址中,可以通过 : 参数名 的形式,匹配动态参数值
      
      app.get('/user/:name/:age', (req, res) => {
          //req.params 默认是一个空对象
          //里面存放着通过 : 动态匹配到的参数值
          console.log(req.params)
      })
      
    • 示例 (postman GET请求地址为:http://127.0.0.1/user/lilei/18

      const express = require('express')
      const app = express()
      
      app.get('/user/:name/:age', (req, res) => {
          console.log(req.params)
          res.send('请求成功')
      })
      
      app.listen(80, () => {
          console.log('express 服务器运行在 http://127.0.0.1.80')
      })
      

      log:

      Snip20220329_1.png


Express 托管静态资源

  • 通过express.static(),可以非常方便地创建一个静态资源服务器

  • Express 在指定的静态目录中查找文件,并对外提供资源的访问路径。因此,存放静态文件的目录不会出现在 URL 中

  • 托管多个静态资源目录

    如果要托管多个静态资源目录,请多次调用 express.static() 函数

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

    访问静态资源文件时, express.static() 函数会根据目录的添加顺序查找所需要的文件

  • 挂载路径前缀

    如果希望在托管的静态资源访问路径之前,挂载路径前缀,则可以使用以下方式

    app.use('/public',express.static('public'))
    app.use('/files',express.static('files'))
    

Express 安装并使用nodemon

  • 为什么使用 nodemon

    在编写调试 Node.js 项目时,如果修改了项目代码,则需要频繁的手动 close 掉,然后再重新启动,非常繁琐。可以使用 nodemon ( www.npmjs.com/package/nod… ) 这个工具,她能够监听项目文件的变动,当代码被修改后,nodemon 会自动帮我们重启项目,极大方便了开发和调试

  • 安装 nodemon

    npm install -g nodemon
    
  • 使用 nodemon

    当基于 Node.js 编写了一个网站应用的时候,传统方式,是运行 node app.js 命令,来启动项目,这样做的坏处是:代码被修改之后,需要手动重启项目

    现在,可以将 node 命令替换为 nodemon 命令,使用 nodemon app.js 来启动项目,这样做的坏处是:代码被修改之后,会被 nodemon 监听到,从而实现自动启动项目的效果

    // 手动启动项目
    node app.js
    
    // 自动启动项目
    nodemon app.js