后端工程师快速使用axios

文章目录

- 01.AJAX 概念和 axios 使用
- - 模板
  - 目标
  - 讲解
  - 代码解析
  - 案例
  - - 前端
    - 后端
    - 结果截图
- 02.URL 查询参数
- - 模板
  - 目标
  - 讲解
  - 案例
  - - 前端
    - 后端
    - 结果截图
- 03.常用请求方法和数据提交
- - 模板
  - 目标
  - 讲解
  - 案例
  - - 前端
    - 后端
    - 结果截图
- 04.axios 错误处理
- - 模板
  - 目标
  - 讲解
  - 案例
  - - 前端
    - 后端
    - 结果截图

01.AJAX 概念和 axios 使用

模板

axios({url: '目标资源地址'
}).then((result) => {// 对服务器返回的数据做后续处理
})

注：url中的地址可以直接使用相对路径，不必写完整的IP或域名

例如：

url: ‘localhost:8080/test3’ 可以写成 url: ‘/test3’

目标

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

讲解

什么是 AJAX ? mdn
- 使用浏览器的 XMLHttpRequest 对象与服务器通信
- 浏览器网页中，使用 AJAX技术（XHR对象）发起获取省份列表数据的请求，服务器代码响应准备好的省份列表数据给前端，前端拿到数据数组以后，展示到网页
什么是服务器？
- 可以暂时理解为提供数据的一台电脑
为何学 AJAX ?
- 以前我们的数据都是写在代码里固定的, 无法随时变化
- 现在我们的数据可以从服务器上进行获取，让数据变活
怎么学 AJAX ?
- 这里使用一个第三方库叫 axios, 后续在学习 XMLHttpRequest 对象了解 AJAX 底层原理
- 因为 axios 库语法简单，让我们有更多精力关注在与服务器通信上，而且后续 Vue，React 学习中，也使用 axios 库与服务器通信
需求：从服务器获取省份列表数据，展示到页面上（体验 axios 语法的使用）

获取省份列表数据 - 目标资源地址：http://hmajax.itheima.net/api/province
- 完成效果：
接下来讲解 axios 语法，步骤：
引入 axios.js 文件到自己的网页中

axios.js文件链接: https://cdn.jsdelivr.net/npm/axios/dist/axios.min.js
明确axios函数的使用语法

注意：请求的 url 地址, 就是标记资源的网址

注意：then 方法这里先体验使用，由来后续会讲到
对应代码

<!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>AJAX概念和axios使用</title>
</head><body><!--axios库地址：https://cdn.jsdelivr.net/npm/axios/dist/axios.min.js省份数据地址：http://hmajax.itheima.net/api/province目标: 使用axios库, 获取省份列表数据, 展示到页面上1. 引入axios库--><p class="my-p"></p><script src="https://cdn.jsdelivr.net/npm/axios/dist/axios.min.js"></script><script>// 2. 使用axios函数axios({url: 'http://hmajax.itheima.net/api/province'}).then(result => {console.log(result)// 好习惯：多打印，确认属性名console.log(result.data.list)console.log(result.data.list.join('<br>'))// 把准备好省份列表，插入到页面document.querySelector('.my-p').innerHTML = result.data.list.join('<br>') })</script>
</body></html>

代码解析

document.querySelector('.my-p'): 这一部分使用了 querySelector 方法来获取文档中具有 class 为 my-p 的第一个元素。querySelector 方法返回匹配到的第一个元素，如果没有找到匹配的元素，则返回 null。
.innerHTML: 这是一个 DOM 元素的属性，用于获取或设置元素的 HTML 内容。在这里，它被用于设置元素的 HTML 内容。
result.data.list.join('<br>'): 这部分使用了 join 方法，将 result.data.list 数组中的每个元素用 <br> 连接起来成为一个字符串。join 方法会将数组的元素以指定的分隔符连接起来。在这里，分隔符是 <br>，表示换行。

案例

前端

<!DOCTYPE html>
<html lang="en">
<head><meta charset="UTF-8"><title>Title</title>
</head>
<body>
<script src="https://cdn.jsdelivr.net/npm/axios/dist/axios.min.js"></script>
<script>axios({url: 'http://localhost:8080/test'}).then(result => {console.log(result)console.log(result.data.data)console.log(result.data.data.join('<br>'))// document.querySelector('.my-p').innerHTML=result.data.list.join('<br>')var divs = document.getElementsByClassName('my-p');var div1=divs[0];div1.innerHTML=result.data.data.join('<br>')});
</script>
<p class="my-p"></p>
</body>
</html>

后端

package nuage.controller;import nuage.common.R;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;import java.util.ArrayList;
import java.util.List;@RestController
@RequestMapping
public class TestController {@GetMapping("/test")public R<List<String>> test() {List<String> list = new ArrayList<>();list.add("a");list.add("b");list.add("c");return R.success(list);}
}

结果截图

02.URL 查询参数

模板

axios({url: '目标资源地址',params: {参数名: 值}
}).then(result => {// 对服务器返回的数据做后续处理
})

目标

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

讲解

什么是查询参数 ?
- 携带给服务器额外信息，让服务器返回我想要的某一部分数据而不是全部数据
- 举例：查询河北省下属的城市列表，需要先把河北省传递给服务器
查询参数的语法？
- 在 url 网址后面用?拼接格式：http://xxxx.com/xxx/xxx?参数名1=值1&参数名2=值2
- 参数名一般是后端规定的，值前端看情况传递即可
axios 如何携带查询参数?
- 使用 params 选项即可
  
  查询城市列表的 url地址：http://hmajax.itheima.net/api/city
  
  参数名：pname （值要携带省份名字）

需求：获取“河北省”下属的城市列表，展示到页面，对应代码：

<!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><!-- 城市列表: http://hmajax.itheima.net/api/city参数名: pname值: 省份名字--><p></p><script src="https://cdn.jsdelivr.net/npm/axios/dist/axios.min.js"></script><script>axios({url: 'http://hmajax.itheima.net/api/city',// 查询参数params: {pname: '辽宁省'}}).then(result => {console.log(result.data.list)document.querySelector('p').innerHTML = result.data.list.join('<br>')})</script>
</body>
</html>

案例

前端

<!DOCTYPE html>
<html lang="en">
<head><meta charset="UTF-8"><title>Title</title>
</head>
<body>
<script src="https://cdn.jsdelivr.net/npm/axios/dist/axios.min.js"></script>
<script>axios({url: 'http://localhost:8080/test2',params: {name: '河北省'}}).then(result => {console.log(result);var list = document.getElementsByClassName("my-p");var list1 = list[0];list1.innerHTML=result.data.data.join('<br>')});</script>
<p class="my-p"></p>
</body>
</html>

后端

package nuage.controller;import nuage.common.R;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;import java.util.ArrayList;
import java.util.List;@RestController
@RequestMapping
public class TestController {@GetMapping("/test2")public R<List<String>> test2(String name) {List<String> list = new ArrayList<>();list.add(name);list.add("a");list.add("b");list.add("c");return R.success(list);}
}

结果截图

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

模板

axios({url: '目标资源地址',method: '请求方法',data: {参数名: 值}
}).then(result => {// 对服务器返回的数据做后续处理
})

目标

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

讲解

想要提交数据，先来了解什么是请求方法
- 请求方法是一些固定单词的英文，例如：GET，POST，PUT，DELETE，PATCH（这些都是http协议规定的），每个单词对应一种对服务器资源要执行的操作
- 前面我们获取数据其实用的就是GET请求方法，但是axios内部设置了默认请求方法就是GET，我们就没有写
- 但是提交数据需要使用POST请求方法
  
  请求方法操作
  GET 获取数据
  POST 数据提交
  PUT 修改数据（全部）
  DELETE 删除数据
  PATCH 修改数据（部分）
什么时候进行数据提交呢？
- 例如：多端要查看同一份订单数据，或者使用同一个账号进行登录，那订单/用户名+密码，就需要保存在服务器上，随时随地进行访问
3.需求：注册账号，提交用户名和密码到服务器保存

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

请求方法：POST

参数名：

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

password：密码（最少6位）

4.正确代码如下：
```
/*注册用户：http://hmajax.itheima.net/api/register请求方法：POST参数名：username：用户名（中英文和数字组成，最少8位）password：密码  （最少6位）目标：点击按钮，通过axios提交用户和密码，完成注册
*/
document.querySelector('.btn').addEventListener('click', () => {axios({url: 'http://hmajax.itheima.net/api/register',method: 'POST',data: {username: 'itheima007',password: '7654321'}})
})
```
注：PUT和DELETE与POST类似，只需要将method改为PUT或DELETE即可

实现路径参数，只需要在url后面拼接字符串即可,如：url: '/user/delet/' + row.id,row.id根据上下文查询

请求方法	操作
GET	获取数据
POST	数据提交
PUT	修改数据（全部）
DELETE	删除数据
PATCH	修改数据（部分）

案例

前端

<!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><script src="https://cdn.jsdelivr.net/npm/axios/dist/axios.min.js"></script><script>function dianji() {// console.log(123)var username = document.getElementsByClassName("username")[0].value;var password = document.getElementsByClassName("password")[0].value;console.log(username);axios({url: 'http://localhost:8080/test3',method: 'POST',data: {username: username,password: password}}).then(result=>{console.log(result.data);alert(result.data.data)})}</script>
用户名：<input class="username" type="text" ><br>
密码：<input class="password" type="password"><br>
<button class="bt" onclick="dianji()">注册</button>
</body></html>

后端

package nuage.controller;import nuage.common.R;
import nuage.entity.User;
import org.springframework.web.bind.annotation.*;import java.util.ArrayList;
import java.util.List;@RestController
@RequestMapping
public class TestController {@PostMapping("/test3")public R<String> test3(@RequestBody User user) {System.out.println(user);return R.success("注册成功");}
}

package nuage.entity;public class User {private String username;private String password;//get和set方法自己补充
}

结果截图

04.axios 错误处理

模板

axios({// ...请求选项
}).then(result => {// 处理成功数据
}).catch(error => {// 处理失败错误
})

目标

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

讲解

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

对应代码

document.querySelector('.btn').addEventListener('click', () => {axios({url: 'http://hmajax.itheima.net/api/register',method: 'post',data: {username: 'itheima007',password: '7654321'}}).then(result => {// 成功console.log(result)}).catch(error => {// 失败// 处理错误信息console.log(error)console.log(error.response.data.message)alert(error.response.data.message)})
})

案例

因为项目中我们的错误信息也是返回正确的状态码，所以不能写在.catch中，我们可以根据后端传过来的code来进行判断

前端

<!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><script src="https://cdn.jsdelivr.net/npm/axios/dist/axios.min.js"></script><script>function dianji() {// console.log(123)var username = document.getElementsByClassName("username")[0].value;var password = document.getElementsByClassName("password")[0].value;console.log(username);axios({url: 'http://localhost:8080/test3',method: 'POST',data: {username: username,password: password}}).then(result => {if (result.data.code === 1) {console.log(result);alert(result.data.data)}else if (result.data.code === 0) {console.log(result);alert(result.data.msg)}}).catch(error => {});}</script>
用户名：<input class="username" type="text" ><br>
密码：<input class="password" type="password"><br>
<button class="bt" onclick="dianji()">注册</button>
</body></html>

后端

package nuage.controller;import nuage.common.R;
import nuage.entity.User;
import org.springframework.web.bind.annotation.*;import java.util.ArrayList;
import java.util.List;@RestController
@RequestMapping
public class TestController {@PostMapping("/test3")public R<String> test3(@RequestBody User user) {if (user.getUsername().equals("nuage")) {return R.error("注册失败");}System.out.println(user);return R.success("注册成功");}
}