网络请求-uniapp入门教程

当前位置:　首页>> 技术小册>> uniapp入门教程

### 1. 前言
当用户在浏览器的地址栏输入我们的项目网址，点击回车后，浏览器就会发送网络请求，经过一系列操作后，浏览器会显示出项目的页面。那这个网络请求过程中间经历了什么呢？这一小节我们就来详细剖析一下。

本小节我们将学习：网络请求的过程是怎样经历的、uniapp 发起网络请求的应用实例、网络请求返回数据的处理。

网络请求实例的内容最好在实际项目中去应用实践，网络请求在实际开发中很容易出现问题。比如有时明明请求发送成功了，却没有返回想要的页面数据，这些都需要我们在项目开发过程中多多练习积累经验。

### 2. 网络请求过程
在我们从发送网络情况到显示网页的这个过程中，系统主要进行了下面几步操作：
（1）进行域名解析：系统会根据域名找到服务器的IP地址；
（2）建立TCP连接：确保数据可以有效的传输；
（3）客户端发起 HTTP 请求：TCP建立连接后，客户端才会正式发起 HTTP 请求，带着请求数据发给服务器；
（4）服务器响应HTTP请求：服务器会接收并处理上一步从客户端发过来的数据，不管是否处理成功，都会返回一个响应消息给客户端，包括 HTML 文件或者其他格式的数据，还有响应状态码等，响应状态码是判断我们是否请求成功最直观的数据，我们最常见的有200 OK请求成功、404 Not Found 请求失败。
（5）浏览器解析 HTML 文件：浏览器拿到html文件后，就会开始解析并渲染其中的html代码，将相应的页面显示给用户。

### 3. uni.request API参数
uni-app 框架给我们提供了丰富的 API，我们可以直接调用来进行网络请求。最常用到的是 uni.request 方法，这一小节我们来看看 uni.request 的 API 参数。

大家要注意区分网络请求与路由跳转，网络请求是请求项目外部的地址，而路由跳转是跳转到项目内部的页面。

在日常开发中，我们经常用到的是 get 和 post 网络请求，在 uni-app 中都是调用 uni.request API实现的，下面我们来演示一下。

| 参数名          | 类型                        | 默认值                             | 说明                                                               |
|--------------|---------------------------|---------------------------------|------------------------------------------------------------------|
| url          | String                    | 要请求的服务器地址、域名                    |
| data         | Object/String/ArrayBuffer | 请求时要传递的参数                       |
| header       | Object                    | 请求的 header，header 中不能设置 Referer |
| method       | String                    | GET                             | 有效值：OPTIONS, GET, HEAD, POST, PUT, DELETE, TRACE, CONNECT（必须为大写） |
| timeout      | Number                    | 30000                           | 超时时间，单位 ms                                                       |
| dataType     | String                    | json                            | 如果值为 json，会尝试对返回的数据做一次 JSON.parse                                |
| responseType | String                    | text                            | 设置响应的数据类型。合法值：text、arraybuffer                                   |
| success      | Function                  | 请求服务器成功返回的回调数据                  |
| fail         | Function                  | 请求服务器失败返回的回调数据                  |
| complete     | Function                  | 请求服务器成功、失败都会返回回调数据              |

Tips：

上面的列出的参数只有 url 是必填项，其他都是选填项。
在小程序中网络相关的 API 在使用前需要配置域名白名单。
### 4. 发送网络请求
上面列出的参数有很多，但是大多数我们实际开发项目用不到，经常用到的大多是 url、data、method、success 这几个参数。

**4.1 实例**
```asp
<template>
    <view>
        <button @click="sendGet">发送请求</button>
    </view>
</template>

```
**4.2 data 参数说明**
data参数是支持对象 Object、字符串 String 类型的，但不管我们传入什么类型，最终都会被转换成 String 类型。转换规则如下：

get 方法：如果 data 参数是 { name: 'imooc', age: 18 } ，转换后的结果是 name=imooc&age=18。

post 方法：如果 header['content-type'] 为 application/json 的数据，会进行 JSON 序列化。
如果 header['content-type'] 为 application/x-www-form-urlencoded 的数据，会将数据转换为 query string。
实例：
```asp
uni.request({
	url: '请求地址',
	header: {
		//data 会 JSON 序列化
	    'Content-Type': 'application/json;charset=UTF-8',
		//data 会被转为 query string
	    'Content-Type': 'application/x-www-form-urlencoded',
	},
	data:{
	   openId:"4a96efrtgyt56Q89jiyth"
	},
    success(res) {
      console.log('服务器返回的信息：',res)
    }
})

```
**4.3 success 返回参数说明**

| 参数         | 类型                        | 说明                          |
|------------|---------------------------|-----------------------------|
| data       | Object/String/ArrayBuffer | 服务器返回的数据                    |
| statusCode | Number                    | 服务器返回的 HTTP 状态码             |
| header     | Object                    | 服务器返回的 HTTP Response Header |
| cookies    | Array.                    | 服务器返回的 cookies，格式为字符串数组     |

上面我们在 success 参数中打印了返回的数据。
```asp
success(res) {
  console.log('服务器返回的信息：',res)
}

```
打印信息格式如下：
```asp
{
  "data":"{"id":1,"name": "imooc"}",
  "header": {
    "Server": "nginx/1.14.0",
    "Date": "Thu, 10 Apr 2020 03:08:20 GMT",
    "Content-Type": "application/json;charset=utf-8;",
    "Transfer-Encoding": "chunked",
    "Connection": "keep-alive"
  },
  "statusCode": 200,
  "cookies": [],
  "errMsg": "request:ok"
}

```
statusCode 为 200，说明请求成功了，后面我们再处理从服务器传回来的 data 信息就可以了。

### 5. 小结
本节课程我们主要学习了 uni-app 的网络请求，直接调用 uni.request 这个 API 就可以实现我们经常用到的 get、post 请求。本节课程的重点如下：

掌握怎样发送 get 请求，经常用到的几个参数要熟练；
data 参数类型在 get 方法、post 方法请求情况下的不同转换；
success 返回参数的格式，以及每个参数代表的含义。

该分类下的相关小册推荐：

uni-app零基础入门