AJAX-第一天入门

学习目标

掌握 axios 相关参数，从服务器获取并解析展示数据
掌握接口文档的查看和使用
掌握在浏览器的 network 面板中查看请求和响应的内容
了解请求和响应报文的组成部分

01.AJAX 概念和 axios 使用

目标

了解 AJAX 概念并掌握 axios 库基本使用

讲解

什么是 AJAX ? mdn
- 使用浏览器的 XMLHttpRequest 对象与服务器通信
什么是服务器？
- 可以暂时理解为提供数据的一台电脑
为何学 AJAX ?
- 以前我们的数据都是写在代码里固定的, 无法随时变化
- 现在我们的数据可以从服务器上进行获取，让数据变活
怎么学 AJAX ?
- 这里使用一个第三方库叫 axios, 后续在学习 XMLHttpRequest 对象了解 AJAX 底层原理
- 因为 axios 库语法简单，让我们有更多精力关注在与服务器通信上，而且后续 Vue，React 学习中，也使用 axios 库与服务器通信
接下来讲解 axios 语法
1. 引入 axios.js 文件到自己的网页中（如果第一个加载不了，可以使用第二个）
  
  https://cdn.jsdelivr.net/npm/axios/dist/axios.min.js
  
  https://cdn.bootcdn.net/ajax/libs/axios/1.3.4/axios.min.js
2. 明确axios函数的使用语法
```
axios({
  url: '目标资源地址'
}).then((result) => {
  // 对服务器返回的数据做后续处理
})
```
  注意：请求的 url 地址, 就是标记资源的网址
  
  注意：then 方法这里先体验使用，由来后续会讲到

用一个需求来体验 axios 语法的使用，从服务器获取省份列表数据，展示到页面上

获取省份列表数据 - 目标资源地址：http://hmajax.itheima.net/api/province

完成效果：

对应代码

<!DOCTYPE html>
<html lang="zh-CN">

<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>AJAX介绍及axios基本使用</title>
</head>

<body>
  <p class="province">
    <!-- 数据渲染到这里 -->
  </p>
  <button class="btn">渲染省份数据</button>
  <!-- 
      axios库地址: https://cdn.jsdelivr.net/npm/axios/dist/axios.min.js
      省份数据地址: http://hmajax.itheima.net/api/province
      需求: 点击按钮 通过 axios 获取省份数据 并渲染
     -->
  <!-- 使用axios记得先导包 -->
  <script src="https://cdn.jsdelivr.net/npm/axios/dist/axios.min.js"></script>
  <script>
    document.querySelector('.btn').addEventListener('click', () => {
      // console.log('点了按钮')
      // 通过 axios 获取省份数据 并渲染
      // 1. 调用axios函数
      axios({
        url: 'http://hmajax.itheima.net/api/province'
      }).then(res => {
        // 2. 接收并使用数据
        // console.log(res)
        // res.data 可以获取服务器返回的数据
        // console.log(res.data)
        console.log(res.data.list)
        document.querySelector('.province').innerText = res.data.list
      })

    })
  </script>
</body>

</html>

小结

AJAX 有什么用？
答案
- 浏览器和服务器之间通信，动态数据交互
AJAX 如何学：
答案
- 先掌握 axios 库使用，再了解 XMLHttpRequest 原理
这一节 axios 体验步骤（语法）？
答案
- 引入 axios 库，使用 axios 相关语法

02.认识 URL

目标

了解 URL 的组成和作用

讲解

为什么要认识 URL ? mdn
- 虽然是后端给我的一个地址，但是哪部分标记的是服务器，哪部分标记的是资源呢？所以为了和服务器有效沟通我们要认识一下
什么是 URL ？
- 统一资源定位符，简称网址，用于定位网络中的资源
- 资源：网页，图片，数据，视频，音频等等
URL 的组成?
- 协议，域名，资源路径（URL 组成有很多部分，我们先掌握这3个重要的部分即可）
什么是 http 协议 ?
- 叫超文本传输协议，规定了浏览器和服务器传递数据的格式（而格式具体有哪些稍后我们就会学到）
什么是域名 ?
- 标记服务器在互联网当中的方位，网络中有很多服务器，你想访问哪一台，就需要知道它的域名才可以
什么是资源路径 ?
- 一个服务器内有多个资源，用于标识你要访问的资源具体的位置
接下来做个需求，访问新闻列表的 URL 网址，打印新闻数据
- 效果图如下：
新闻列表数据 URL 网址：http://hmajax.itheima.net/api/news
```
axios({
  url: 'http://hmajax.itheima.net/api/news'
}).then(result => {
  console.log(result)
})
```

小结

URL 是什么？
答案
- 统一资源定位符，网址，用于访问服务器上资源
请解释这个 URL，每个部分作用？

http://hmajax.itheima.net/api/news
答案
- 协议://域名/资源路径

03.URL 查询参数

目标

掌握-通过URL传递查询参数，获取匹配的数据

讲解

什么是查询参数 ?
- 携带给服务器额外信息，让服务器返回我想要的某一部分数据而不是全部数据
- 举例：查询河北省下属的城市列表，需要先把河北省传递给服务器
查询参数的语法？
- 在 url 网址后面用?拼接，格式参数名=值&参数名=值的查询参数字符串
- 参数名一般是后端规定的，值前端看情况传递即可

axios 如何携带查询参数?

使用 params 选项即可、

axios({
  url: 'http://测试服务器/资源路径',
  params: {
    key: 'value',
    key2: 'value2'
  }
}).then(res => {
  // 接受并使用数据
})

查询城市列表的 url地址：http://hmajax.itheima.net/api/city

参数名：pname （值要携带省份名字）

需求：获取指定省份名字下属的城市列表，展示到页面

<!DOCTYPE html>
<html lang="zh-CN">

<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>
  <button class="btn">获取城市数据并渲染</button>
  <!-- 1. 导包 -->
  <script src="https://cdn.jsdelivr.net/npm/axios/dist/axios.min.js"></script>
  <!-- 
    城市数据:http://hmajax.itheima.net/api/city
      获取某个省所有的城市
      查询参数名:pname
      说明:传递省份或直辖市名比如 北京、广东省…
    需求: 点击按钮 通过axios 获取某个省的城市 并输出
  -->
  <script>
    document.querySelector('.btn').addEventListener('click', function () {
      // console.log('点了按钮哦')
      // 通过axios 获取某个省的城市 并输出
      axios({
        // url: 'http://hmajax.itheima.net/api/city?pname=湖南省',
        url: 'http://hmajax.itheima.net/api/city',
        // 开发中 一般用params 不需要自己拼接字符串避免出错
        params: {
          pname: '湖北省'
        }
      }).then(res => {
        console.log(res.data)
      })
    })
  </script>

</body>

</html>

小结

URL 查询参数有什么用？
答案
- 浏览器提供给服务器额外信息，获取对应的数据
axios 要如何携带查询参数？
答案
- 使用 params 选项，携带参数名和值在对象结构中

04.案例-查询-地区列表

目标

巩固查询参数的使用，并查看多对查询参数如何传递

讲解

需求：根据输入的省份名字和城市名字，查询下属地区列表
- 完成效果如下：
- 相关参数
  
  查询地区: http://hmajax.itheima.net/api/area
  
  参数名：
  
  pname：省份名字
  
  cname：城市名字

正确代码如下：

/*
  http://hmajax.itheima.net/api/area
  传递某个省份内某个城市的所有区县
  查询参数名：pname、cname
  pname说明：传递省份或直辖市名，比如 北京、湖北省…
  cname说明：省份内的城市，比如 北京市、武汉市…
  核心功能：查询地区，并渲染列表
*/
document.querySelector('.my-button').addEventListener('click', function () {
  // console.log('点了按钮哦!')

  // 1.获取输入框的内容
  const pname = document.querySelector('.province').value
  const cname = document.querySelector('.city').value
  console.log('pname:', pname)
  console.log('cname:', cname)

  // 2.查询地区，并渲染列表
  axios({
    url: 'http://hmajax.itheima.net/api/area',
    params: {
      pname, cname // pname: pname,
      // cname: cname
    }
  }).then(res => {
    // console.log(res.data)
    const list = res.data.list
    // console.log('list:', list)
    const htmlArr = list.map(v => `<li class="list-group-item">${v}</li>`)
    // console.log('htmlArr:', htmlArr)
    document.querySelector('.list-group').innerHTML = htmlArr.join('')
  })
})

小结

ES6 对象属性和值简写的前提是什么？
答案
- 当属性名和value位置变量名同名即可简写

05.常用请求方法和数据提交

目标

掌握如何向服务器提交数据，而不单单是获取数据

讲解

想要提交数据，先来了什么是请求方法
- 请求方法是一些固定单词的英文，例如：GET，POST，PUT，DELETE，PATCH（这些都是http协议规定的），每个单词对应一种对服务器资源要执行的操作
  
  [外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-GhYljG1q-1681821589457)(assets/image-20230302145417083.png)]
- 前面我们获取数据其实用的就是GET请求方法，但是axios内部设置了默认请求方法就是GET，我们就没有写
- 但是提交数据需要使用POST请求方法
什么时候进行数据提交呢？
- 例如：多端要查看同一份订单数据，或者使用同一个账号进行登录，那订单/用户名+密码，就需要保存在服务器上，随时随地进行访问
axios 如何提交数据到服务器呢？
- 需要学习，method 和 data 这2个新的选项了（大家不用担心，这2个学完，axios常用的选项就都学完了）
```
axios({
  url:'请求URL',
  method:'post',
  data:{
    key:'value'
  },
})
```
需求：注册账号，提交用户名和密码到服务器保存

注册用户 URL 网址：http://hmajax.itheima.net/api/register

请求方法：POST

参数名：

username：用户名（要求中英文和数字组成，最少8位）

password：密码（最少6位）

小结

请求方法最常用的是哪2个，分别有什么作用？
答案
- POST 提交数据，GET 查询数据
axios 的核心配置项？
答案
- url：目标资源地址，method：请求方法，params：查询参数，data：提交的数据

06.axios 错误处理

目标

掌握接收 axios 响应错误信息的处理语法

讲解

如果注册相同的用户名，则会遇到注册失败的请求，也就是 axios 请求响应失败了，你会在控制台看到如图的错误：
在 axios 语法中要如何处理呢？
- 因为，普通用户不会去控制台里看错误信息，我们要编写代码拿到错误并展示给用户在页面上

使用 axios 的 catch 方法，捕获这次请求响应的错误并做后续处理，语法如下：

axios({
  // 请求选项
}).then(res => {
  // 处理数据
}).catch(err => {
  // 处理错误
})

对应代码

  document.querySelector('.btn').addEventListener('click', function () {
      // console.log('点了')
      // 通过axios提交用户数据，完成用户注册
      axios({
        url: 'http://hmajax.itheima.net/api/register',
        method: 'post',
        data: {
          username: 'itheima008',
          password: '123456'
        }
      }).then(res => {
        console.log(res.data)
      }).catch(err => {
        // 重复注册，通过弹框提示用户
        // console.log(err)
        // console.log(err.response.data)
        alert(err.response.data.message)
      })
    })

小结

axios 如何拿到请求响应失败的信息？
答案
- 通过 axios 函数调用后，在后面接着调用 .catch 方法捕获

07.HTTP 协议-请求报文

目标

了解 HTTP 协议中，请求报文的组成和作用

讲解

首先，HTTP 协议规定了浏览器和服务器返回内容的格式
请求报文：是浏览器按照协议规定发送给服务器的内容，例如刚刚注册用户时，发起的请求报文：

![[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-NVgKaUTr-1681821589457)(assets/image-20230301161659353.png)](https://img-blog.csdnimg.cn/55ef584a1a9143c39d5326e1cfd76520.png)
这里的格式包含：
- 请求行：请求方法，URL，协议
- 请求头：以键值对的格式携带的附加信息，比如：Content-Type（指定了本次传递的内容类型）
- 空行：分割请求头，空行之后的是发送给服务器的资源
- 请求体：发送的资源
我们切换到浏览器中，来看看刚才注册用户发送的这个请求报文以及内容去哪里查看呢

小结

浏览器发送给服务器的内容叫做，请求报文
请求报文的组成是：
答案
- 请求行，请求头，空行，请求体
通过 Chrome 的网络面板如何查看请求体？

08.请求报文-错误排查

目标

了解学习了查看请求报文之后的作用，可以用来辅助错误排查

讲解

学习了查看请求报文有什么用呢？
- 可以用来确认我们代码发送的请求数据是否真的正确
这里是我同桌的代码，它把登录也写完了，但是无法登录，我们来到模板代码中，找到运行后，在不逐行查看代码的情况下，帮他找找问题出现的原因
发现请求体数据有问题，往代码中定位，找到类名写错误了

小结

学会了查看请求报文，对实际开发有什么帮助呢？
答案
- 可以快速确认我们发送的内容是否正确

09.HTTP 协议-响应报文

目标

了解响应报文的组成

讲解

响应报文：是服务器按照协议固定的格式，返回给浏览器的内容
响应报文的组成：
- 响应行（状态行）：协议，HTTP响应状态码，状态信息
- 响应头：以键值对的格式携带的附加信息，比如：Content-Type（告诉浏览器，本次返回的内容类型）
- 空行：分割响应头，控制之后的是服务器返回的资源
- 响应体：返回的资源
HTTP 响应状态码：
- 用来表明请求是否成功完成
- 例如：404（服务器找不到资源）

小结

响应报文的组成？
答案
- 响应行，响应头，空行，响应体
HTTP 响应状态码是做什么的？
答案
- 表明请求是否成功完成，2xx都是成功的

10.接口文档

目标

掌握接口文档的使用，配合 axios 与服务器进行数据交互

讲解

接口文档：描述接口的文章（一般是后端工程师，编写和提供）
接口：使用 AJAX 和服务器通讯时，使用的 URL，请求方法，以及参数，例如：AJAX阶段接口文档
查看登录接口，并编写代码，完成一次登录的效果吧

小结

接口文档是什么？
答案
- 由后端提供的描述接口的文章
接口文档里包含什么？
答案
- 请求的 URL 网址，请求方法，请求参数和说明

11.案例-用户登录-主要业务

目标

尝试通过页面获取用户名和密码，进行登录

讲解

先来到备课代码中，运行完成的页面，查看要完成的效果
分析实现的步骤
1. 点击登录，获取并判断用户名和长度
2. 提交数据和服务器通信
3. 提示信息，反馈给用户
本视频先来完成前2步
编写代码，查看接口文档，填写相关信息，完成登录业务
代码细节：
1. 登录按钮-绑定点击事件
2. 从页面输入框里，获取用户名和密码
3. 判断长度是否符合要求
4. 基于 axios 提交用户名和密码

小结

总结下用户登录案例，本视频做的思路
答案
- 1. 登录按钮-绑定点击事件 2. 从页面输入框里，获取用户名和密码 3. 判断长度是否符合要求 4. 基于 axios 提交用户名和密码

12.案例-用户登录-提示信息

目标

根据准备好的提示标签和样式，给用户反馈提示

讲解

先来到备课代码中，运行完成的页面，查看要完成的效果
使用提示框，反馈提示消息，因为有4处地方需要提示框，所以封装成函数
1. 获取提示框
2. 封装提示框函数，重复调用，满足提示需求
  
  功能：
  1. 显示提示框
  2. 不同提示文字msg，和成功绿色失败红色isSuccess参数（true成功，false失败）
  3. 过2秒后，让提示框自动消失

对应提示框核心代码：

// 4. 封装提示框函数
function myAlert(msg, flag) {
  // 获取弹框的dom元素
  const alertDom = document.querySelector('.my-alert')
  // 显示弹框 添加 show类名
  alertDom.classList.add('show')
  // 更改弹框的内容-使用msg的内容
  alertDom.innerText = msg
  // 根据flag 控制外观 成功true- alert-success / 失败false- alert-danger
  alertDom.classList.add(flag ? 'alert-success' : 'alert-danger')
  // 过一会，隐藏弹框
  setTimeout(() => {
    alertDom.classList.remove('show')
    alertDom.classList.remove(flag ? 'alert-success' : 'alert-danger')
  }, 1000);
}

小结

我们什么时候需要封装函数？
答案
- 遇到相同逻辑，重复代码要复用的时候
如何封装一个函数呢？
答案
- 先明确要完成的需求，以及需要的参数，再来实现其中的细节，然后在需要的地方调用
我们的提示框是如何控制出现/隐藏的？
答案
- 添加或移除显示的类名即可

13.form-serialize 插件

目标

使用 form-serialize 插件，快速收集目标表单范围内表单元素的值

讲解

我们前面收集表单元素的值，是一个个标签获取的
如果一套表单里有很多很多表单元素，如何一次性快速收集出来呢？
使用 form-serialize 插件提供的 serialize 函数就可以办到
form-serialize 插件语法：
- 引入 form-serialize 插件到自己网页中
- 使用 serialize 函数
  - 参数1：要获取的 form 表单标签对象（要求表单元素需要有 name 属性-用来作为收集的数据中属性名）
  - 参数2：配置对象
    - hash：
      - true - 收集出来的是一个 JS 对象结构
      - false - 收集出来的是一个查询字符串格式
    - empty：
      - true - 收集空值
      - false - 不收集空值

需求：收集登录表单里用户名和密码

<!DOCTYPE html>
<html lang="zh-CN">

<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>form-serialize</title>
</head>

<body>
  <form action="javascript:;" class="example-form">
    <input type="text" name="uname" />
    <br>
    <input type="text" name="pword" />
    <br>
    <input type="submit" class="submit" value="提交" />
  </form>
  <!-- 1. 导包 -->
  <script src="./lib/form-serialize.js"></script>
  <script>
    /*
      form-serialize 快速收集表单的值
      1. 表单元素需要设置name属性，会成为对象的属性名
      2. name属性设置的值和接口文档一致即可
      3. hash 设置生成的数据格式
        - true：js对象（常用）
        - false：查询字符串
      4. empty 是否收集空数据
        - true：收集空数据，保证格式和表单一致（推荐用法）
        - false：不收集空数据，格式和表单不一定一致（不推荐）
    */
    document.querySelector('.submit').addEventListener('click', () => {
      // console.log('点了按钮')
      const form = document.querySelector('.example-form')
      // 参数1 form表单，要取值的表单元素需要在form表单中
      // 参数2 插件的设置，{}
      const data = serialize(form, { hash: true, empty: true })
      // const data = serialize(form, { hash: false, empty: true })
      // const data = serialize(form, { hash: true, empty: false })
      console.log(data)
    })
  </script>
</body>

</html>

小结

我们什么时候使用 form-serialize 插件？
答案
- 快速收集表单元素的值
如何使用 form-serialize 插件？
答案
- 1. 先引入插件到自己的网页中，2. 准备form和表单元素的name属性，3.使用serialize函数，传入form表单和配置对象
配置对象中 hash 和 empty 有什么用？
答案
- hash 决定是收集为 JS 对象还是查询参数字符串，empty 决定是否收集空值