网络请求

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 实例

<template>
    <view>
        <button @click="sendGet">发送请求</button>
    </view>
</template>

<script>
	export default {
	    methods: {
	        sendGet () {
	            uni.request({
					//示例地址，非真实地址
	                url: 'http://localhost:8080/api/getData',
					//必须为大写，默认值为GET，GET请求可以不写此参数
					method:'GET',
					data:{
					   openId:"4a96efrtgyt56Q89jiyth"
					},
	                success(res) {
	                  console.log(res)
	                }
	            })
	        }
	    }
	}
</script>

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。
实例：

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 参数中打印了返回的数据。

success(res) {
  console.log('服务器返回的信息：',res)
}

打印信息格式如下：

{
  "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 返回参数的格式，以及每个参数代表的含义。