梦飞环报

Ajax 与 Axios 异步请求

2024-03-28 16:44 由 CSMrDong 发表于 #前端开发

Ajax 与 Axios 异步请求

一、服务器对外提供了哪些资源

1. 网页中如何请求数据

	数据，也是服务器对外提供的一种资源。只要是资源，必然要通过 请求 – 处理 – 响应 的方式进行获取。如果要在网页中请求服务器上的数据资源，则需要用到 XMLHttpRequest 对象。XMLHttpRequest（简称 xhr）是浏览器提供的 js 成员，通过它，可以请求服务器上的数据资源。最简单的用法 var xhrObj = new XMLHttpRequest()

2. 资源的请求方式

客户端请求服务器时，请求的方式有很多种，最常见的两种请求方式分别为 get 和 post 请求。

  • get 请求通常用于获取服务端资源（向服务器要资源）

    例如：根据 URL 地址，从服务器获取 HTML 文件、css 文件、js文件、图片文件、数据资源等

  • post 请求通常用于向服务器提交数据（往服务器发送资源）

    例如：登录时向服务器提交的登录信息、注册时向服务器提交的注册信息、添加用户时向服务器提交的用户信息等各种数据提交操作

二、Ajax 异步请求

1. 什么是Ajax

	Ajax 的全称是 Asynchronous Javascript And XML（异步 JavaScript 和 XML）。通俗的理解：在网页中利用 XMLHttpRequest 对象和服务器进行数据交互的方式，就是Ajax。
	浏览器中提供的 XMLHttpRequest 用法比较复杂，所以 jQuery 对 XMLHttpRequest 进行了封装，提供了一系列 Ajax 相关的函数，极大地降低了 Ajax 的使用难度

2. 为什么要学Ajax

	之前所学的技术，只能把网页做的更美观漂亮，或添加一些动画效果，但是，Ajax能让我们轻松实现网页与服务器之间的数据交互。

3. Ajax的典型应用场景

  • 用户名检测：注册用户时，通过 ajax 的形式，动态检测用户名是否被占用
  • 搜索提示：当输入搜索关键字时，通过 ajax 的形式，动态加载搜索提示列表
  • 数据分页显示：当点击页码值的时候，通过 ajax 的形式，根据页码值动态刷新表格的数据
  • 数据的增删改查：数据的添加、删除、修改、查询操作，都需要通过 ajax 的形式，来实现数据的交互

4. Ajax 的应用

  • jQuery 中发起 Ajax 请求最常用的三个方法
    // get请求
$.get()
// post请求
$.post()
// 通用请求
$.ajax()
  • $.get()函数的语法
    jQuery 中 $.get() 函数的功能单一，专门用来发起 get 请求，从而将服务器上的资源请求到客户端来进行使用。$.get() 函数的语法如下：

    • $.get() 函数的语法如下：

      $.get(url, [data], [callback])

    • 其中，三个参数各自代表的含义如下：

      参数名 参数类型 是否必选 说明
      url string 是 要请求的资源地址
      data object 否 请求资源期间要携带的参数
      callback function 否 请求成功时的回调函数

    • $.get()发起不带参数的请求

      // 使用 $.get() 函数发起不带参数的请求时，直接提供请求的 URL 地址和请求成功之后的回调函数即可：
$.get("http://ajax-base-api-t.itheima.net/api/getbooks", function(res) {
    console.log(res) // 这里的 res 是服务器返回的数据
})

    • $.get()发起带参数的请求

      // 使用 $.get() 函数发起带参数的请求时，示例代码如下：
$.get("http://ajax-base-api-t.itheima.net/api/getbooks", { id: 1 }, function(res) {
  console.log(res)
})
  • $.post()函数的语法
    jQuery 中 $.post() 函数的功能单一，专门用来发起 post 请求，从而向服务器提交数据。

    • $.post() 函数的语法如下：

      $.post(url, [data], [callback])

    • 其中，三个参数各自代表的含义如下：

      参数名 参数类型 是否必选 说明
      url string 是 提交数据的地址
      data object 否 要提交的数据
      callback function 否 数据提交成功时的回调函数

    • $.post()向服务器提交数据

      // 使用 $post() 向服务器提交数据的示例代码如下：
$.post(
   "http://ajax-base-api-t.itheima.net/api/addbook", // 请求的URL地址
   { bookname: '水浒传', author: '施耐庵', publisher: '上海图书出版社' }, // 提交的数据
   function(res) { // 回调函数
      console.log(res)
   }
)
  • $.ajax()函数的语法
    相比于 $.get() 和 $.post() 函数，jQuery 中提供的 $.ajax() 函数，是一个功能比较综合的函数，它允许我们对 Ajax 请求进行更详细的配置。

    • $.ajax() 函数的基本语法如下：

      $.ajax({
   type: '', // 请求的方式，例如 GET 或 POST
   url: '',  // 请求的 URL 地址
   data: { },// 这次请求要携带的数据
   success: function(res) { } // 请求成功之后的回调函数
})

    • 使用$.ajax()发起GET请求

      // 使用 $.ajax() 发起 GET 请求时，只需要将 type 属性的值设置为 'GET' 即可：
$.ajax({
   type: 'GET', // 请求的方式
   url: "http://ajax-base-api-t.itheima.net/api/getbooks",  // 请求的 URL 地址
   data: { id: 1 },// 这次请求要携带的数据
   success: function(res) { // 请求成功之后的回调函数
       console.log(res)
   }
})

      • GET请求实战案例前后端交互

        • 前端代码

          <!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>加法运算</title>
    <script src="https://code.jquery.com/jquery-3.6.4.min.js"></script>
</head>
<body>
    <div>
        <h3>ajax GET请求页面</h3>
        <input type="text"> +
        <input type="text"> =
        <input type="text">
        <input type="button" value="计算">
    </div>
    <script>
        let nums = $("input[type='text']");
        let btn = $("input[type='button']");

        btn.click(function (){
            // 发起get请求: http://127.0.0.1:8888/calc?num1=1.3&num2=3.6
            $.ajax({
                url:"/calc",
                type:"get",
                dataType:"json",
                data:{
                    "num1": Number(nums.eq(0).val()),
                    "num2": Number(nums.eq(1).val())
                },
                success:function (response) {
                    console.log("响应数据:",response);
                    console.log("响应数据类型:",typeof(response));
                    nums.eq(2).val(response["result"]);
                },
                error:function (error) {
                    console.log(error.readyState);
                    console.log(error.status);
                    console.log(error.statusText);
                    console.log(error.responseText);
                }
            })
        })
    </script>
</body>
</html>

        • 后端代码

          import tornado.web
import tornado.ioloop


class MainHandler(tornado.web.RequestHandler):

    def get(self):
        self.render("calc_get.html")


class ReferHandler(tornado.web.RequestHandler):
    def get(self):
        # print("请求头信息\n:", self.request.headers)
        print("请求url: ", self.request.full_url())
        # 获取原始查询参数和请求体参数
        print("查询参数:", self.request.arguments)
        print("请求体参数:", self.request.body)

        # 框架解析之后的数据, 如果原始查询参数无数据则报错
        num1 = self.get_argument("num1")
        num2 = self.get_argument("num2")
        # 通过url以键值对形式传参解析出来的数据均为字符串格式
        print("接收的查询参数num1类型为", type(num1))
        print("接收的查询参数num1, num2值为", num1, num2)
        result = round(float(num1) + float(num2), 4)

        # .write会检测参数，将字典转为json数据以后返回
        self.write({"result": result})


if __name__ == '__main__':
    app = tornado.web.Application([
        ("/", MainHandler),
        ("/calc", ReferHandler),
    ])

    app.listen(8888)
    tornado.ioloop.IOLoop.current().start()

    • 使用$.ajax()发起POST请求

      // 使用 $.ajax() 发起 POST 请求时，只需要将 type 属性的值设置为 'POST' 即可：
$.ajax({
   type: 'POST', // 请求的方式
   url: "http://ajax-base-api-t.itheima.net/api/addbook",  // 请求的 URL 地址
   data: { // 要提交给服务器的数据
      bookname: '水浒传',
      author: '施耐庵',
      publisher: '上海图书出版社'
    },
   success: function(res) { // 请求成功之后的回调函数
       console.log(res)
   }
})

      • POST请求实战案例前后端交互

        • 前端代码

          <!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>加法运算</title>
    <script src="https://code.jquery.com/jquery-3.6.4.min.js"></script>
</head>
<body>
    <div>
        <h3>ajax POST请求页面</h3>
        <input type="text"> +
        <input type="text"> =
        <input type="text">
        <input type="button" value="计算">
    </div>
    <script>
        let nums = $("input[type='text']");
        let btn = $("input[type='button']");

        btn.click(function (){
            // 发起post请求: http://127.0.0.1:8888
            $.ajax({
                url:"/",
                type:"post",
                // post请求一般会指定发送给服务器的数据格式
                contentType:"application/json",
                dataType:"json",
                // 将数据转换为json格式发送
                data:JSON.stringify({
                    "num1": Number(nums.eq(0).val()),
                    "num2": Number(nums.eq(1).val())
                }),
                success:function (response) {
                    console.log("响应数据:",response);
                    console.log("响应数据类型:",typeof(response));
                    nums.eq(2).val(response["result"]);
                },
                error:function (error) {
                    console.log(error.readyState);
                    console.log(error.status);
                    console.log(error.statusText);
                    console.log(error.responseText);
                }
            })
        })
    </script>
</body>
</html>

        • 后端代码

          import json

import tornado.web
import tornado.ioloop


class MainHandler(tornado.web.RequestHandler):

    def get(self):
        self.render("calc_post.html")

    def post(self):
        # print("请求头信息\n:", self.request.headers)
        print("请求url: ", self.request.full_url())
        # 获取原始查询参数和请求体参数
        print("查询参数:", self.request.arguments)
        print("请求体参数:", self.request.body)

        # 框架解析之后的数据
        data = json.loads(self.request.body)
        num1 = data["num1"]
        num2 = data["num2"]
        print("接收的请求体参数num1类型为", type(num1))
        print("接收的请求体参数num1, num2值为", num1, num2)
        result = round(num1 + num2, 4)

        # .write会检测参数，将字典转为json数据以后返回
        self.write({"result": result})


if __name__ == '__main__':
    app = tornado.web.Application([
        ("/", MainHandler),
    ])

    app.listen(8888)
    tornado.ioloop.IOLoop.current().start()

    • ajax异步请求参数说明

      【contentType】: 发送给服务器的数据格式; 可选4种格式:
    1> application/x-www-form-urlencoded: 默认方式,在请求发送过程中会对数据进行序列化处理，以键值对形式 ?key1=value1&key2=value的方式发送到服务器
    2> multipart/form-data: 需要在表单中进行文件上传时，就需要使用该格式
    3> application/json: 消息主体是序列化后的 JSON 字符串
    4> text/plain: 数据以纯文本形式(text/json/xml/html)进行编码，其中不含任何控件或格式字符

    eg:
        contentType:"application/json",

【dataType】: 用什么格式解析服务端响应的数据(并非是原生ajax的属性),有些框架(比如jquery)默认(未填写dataType或解析错误的情况下)读取服务端的响应头Content-Type
    1> text：默认值。预期数据为纯文本字符串。
    2> html：预期数据为html格式的字符串。
    3> json：预期数据为JSON格式的对象或数组。
    4> xml：预期数据为XML文档类型的数据。

    说明： 指定dataType参数后，如果返回的数据类型与预期不符合，则ajax请求会失败，并触发error回调函数。因此，正确指定dataType参数对于确保ajax请求的数据类型是非常重要的。

【jquery ajax 出错信息解读-error属性值】
    1> readyState :当前状态,0-未初始化，1-正在载入，2-已经载入，3-数据进行交互，4-完成。
    2> status ：返回的HTTP状态码，比如常见的404,500等错误代码。
    3> statusText ：对应状态码的错误信息，比如404错误信息是not found,500是Internal Server Error。
    4> responseText ：服务器响应返回的文本信息

三、 Axios 异步请求

1. 什么是axios

Axios 是基于Promise的HTTP客户端作用于浏览器和node.js,专注于网络数据请求的库。相比于原生的 XMLHttpRequest 对象，axios 简单易用。相比于 jQuery，axios 更加轻量化，只专注于网络数据请求。

2. axios 的应用

  • axios 发起GET请求

    • axios 发起 get 请求的语法：

      axios.get('url', { params: { /*参数*/ } }).then(callback)

    • 具体的请求示例如下：

       // 请求的 URL 地址
 var url = 'http://ajax-base-api-t.itheima.net/api/get'
 // 请求的参数对象
 var paramsObj = { name: 'zs', age: 20 }
 // 调用 axios.get() 发起 GET 请求
 axios.get(url, { params: paramsObj }).then(function(res) {
     // res.data 是服务器返回的数据
     var result = res.data
     console.log(res)
 })
  • axios发起POST请求

    • axios 发起 post 请求的语法：

      axios.post('url', { /*参数*/ }).then(callback)

    • 具体的请求示例如下：

       // 请求的 URL 地址
 var url = 'http://ajax-base-api-t.itheima.net/api/post'
 // 要提交到服务器的数据
 var dataObj = { location: '北京', address: '顺义' }
 // 调用 axios.post() 发起 POST 请求
 axios.post(url, dataObj).then(function(res) {
     // res.data 是服务器返回的数据
     var result = res.data
     console.log(result)
 })
  • 直接使用axios发起请求

    • 直接使用axios发起请求 ,axios 也提供了类似于jQuery中 $.ajax() 的函数，语法如下：

       axios({
     method: '请求类型',
     url: '请求的URL地址',
     data: { /* POST数据 */ },
     params: { /* GET参数 */ }
 }) .then(callback)

    • 直接使用axios发起GET请求

         
 axios({
     method: 'GET',
     url: 'http://www.liulongbin.top:3006/api/get',
     params: { // GET 参数要通过 params 属性提供
         name: 'zs',
         age: 20
     }
 }).then(function(res) {
     console.log(res.data)
 })

    • 直接使用axios发起POST请求

      axios({
     method: 'POST',
     url: 'http://www.liulongbin.top:3006/api/post',
     data: { // POST 数据要通过 data 属性提供
         bookname: '程序员的自我修养',
         price: 666
     }
 }).then(function(res) {
     console.log(res.data)
 })

四、 接口

  • 接口的概念

    使用 Ajax 请求数据时，被请求的 URL 地址，就叫做数据接口（简称接口）。同时，每个接口必须有请求方式。

例如：
	http://ajax-base-api-t.itheima.net/api/getbooks  获取图书列表的接口(GET请求)
	http://ajax-base-api-t.itheima.net/api/addbook   添加图书的接口（POST请求）

  • 接口的请求过程

  • 接口文档

    • 什么是接口文档

      接口文档，顾名思义就是接口的说明文档，它是我们调用接口的依据。好的接口文档包含了对接口URL，参数以及输出内容的说明，我们参照接口文档就能方便的知道接口的作用，以及接口如何进行调用。

    • 接口文档的组成部分

      接口文档可以包含很多信息，也可以按需进行精简，不过，一个合格的接口文档，应该包含以下6项内容，从而为接口的调用提供依据：
      • 接口名称：用来标识各个接口的简单说明，如登录接口，获取图书列表接口等。
      • 接口URL：接口的调用地址
      • 调用方式：接口的调用方式，如 GET 或 POST
      • 参数格式：接口需要传递的参数，每个参数必须包含参数名称、参数类型、是否必选、参数说明这4项内容
      • 响应格式：接口的返回值的详细描述，一般包含数据名称、数据类型、说明3项内容。
      • 返回示例（可选）：通过对象的形式，例举服务器返回数据的结构。

    • 接口文档示例

      • 图书列表

        • 接口URL： /api/getbooks

        • 调用方式： GET

        • 参数格式 - PTND：

          参数名称(params) 参数类型（type） 是否必选（necessary） 参数说明（description）
          id Number 否 图书Id
          bookname String 否 图书名称
          author String 否 作者
          publisher String 否 出版社

        • 响应格式 - PTD：

          数据名称 数据类型 说明
          status Number 200 成功；500 失败；
          msg String 对 status 字段的详细说明
          data Array 图书列表
          +id Number 图书Id
          +bookname String 图书名称
          +author String 作者
          +publisher String 出版社

        • 返回示例：

          {
  "status": 200,
  "msg": "获取图书列表成功",
  "data": [
    { "id": 1, "bookname": "西游记", "author": "吴承恩", "publisher": "北京图书出版社" },
    { "id": 2, "bookname": "红楼梦", "author": "曹雪芹", "publisher": "上海图书出版社" },
    { "id": 3, "bookname": "三国演义", "author": "罗贯中", "publisher": "北京图书出版社" }
  ]
}

热门相关：都市之九天大帝   重生之大文豪   帝少宠妻有点甜   帝少宠妻有点甜   天龙邪尊