HTTP 使用详解

在你浏览互联网的时候，绝大多数的数据都是通过 HTTP 协议获取到的，也就是说如果你想要实现一个能上网的 App，那么就一定会和 HTTP 打上交道。当然 Android 发展到现在这么多年，已经有很多非常好用，功能非常完善的网络框架了，比如 Volley、OkHttp、retrofit等，但是底层逻辑都是一样的。本节我们来学习 Android 原声支持的 HTTP 接口，相比那些第三方框架，它的封装更好，也更适合我们了解底层原理。

1. Http 协议

Http 底层基于 TCP 协议，分为请求和响应。请求和响应分别有各自的 Header 和 Body 组成。Header 里面通常是本次请求 / 响应的描述信息，比如版本号、长度、UA、Content-Type 等等，而 Body 里面通常就是我们要传递的业务数据了，下面分别浏览一下请求和响应的内容。

1.1 Http 请求

请求头的内容有很多，这里给大家做一个记录当做资料，不需要都记住，在实际使用中用到可以过来查阅即可。

1.2 Http 响应

响应就是服务器收到我们的 request 之后给我们返回的数据，同样记录一下响应头：

2. HttpUrlConnection 接口

Android 系统为我们提供了 HttpUrlConnection 接口用于实现 Http 请求。自从 Android API
9 开始，HttpUrlConnection 就成为了 Android App 推荐使用的内置 Http 库。使用它无需添加任何依赖，打开网络权限：

<uses-permission android:name="android.permission.INTERNET" />

就可以访问 Http 资源了，可以说相比第三方框架

3. HttpUrlConnection 的使用步骤

首先还是引用一下 Google 官方的使用文档：

A URLConnection with support for HTTP-specific features. See the spec for details.
Uses of this class follow a pattern:

1. Obtain a new HttpURLConnection by calling [URL#openConnection()](https://developer.android.com/reference/java/net/URL#openConnection()) and casting the result to HttpURLConnection.
2. Prepare the request. The primary property of a request is its URI. Request headers may also include metadata such as credentials, preferred content types, and session cookies.
3. Optionally upload a request body. Instances must be configured with [setDoOutput(true)](https://developer.android.com/reference/java/net/URLConnection#setDoOutput(boolean)) if they include a request body. Transmit data by writing to the stream returned by [URLConnection.getOutputStream()](https://developer.android.com/reference/java/net/URLConnection#getOutputStream()).
4. Read the response. Response headers typically include metadata such as the response body’s content type and length, modified dates and session cookies. The response body may be read from the stream returned by [URLConnection.getInputStream()](https://developer.android.com/reference/java/net/URLConnection#getInputStream()). If the response has no body, that method returns an empty stream.
5. Disconnect. Once the response body has been read, the HttpURLConnection should be closed by calling [disconnect()](https://developer.android.com/reference/java/net/HttpURLConnection#disconnect()). Disconnecting releases the resources held by a connection so they may be closed or reused.

官方文档没有对 Http 协议本身做什么解释（如果对 Http 协议不太了解的同学，可以参考慕课网上网络相关课程），主要是围绕 HttpUrlConnection 的用法展开了一步步的描述，结合官网的解释以及我个人的总结，大体上可以分为一下几步：

1. 通过openConnection()方法创建一个HttpURLConnection：

URL url = new URL(https://www.baidu.com);
HttpURLConnection conn = (HttpURLConnection) url.openConnection();

首先创建一个 URL 对象，参数就是我们要打开的地址，然后使用 url 对象的openConnection()来打开 Http 连接，拿到一个HttpURLConnection对象。
2. 设置 Http 请求类型
设置本次 Http 请求的方法类型，Http 有以下几种类型：

• GET
• POST
• HEAD
• CONNECT
• OPTIONS
• TRACE
• PATCH
• PUT
• **DELETE
  这里就不做详细的解释了，可自行百度。最常用的就是前两种：GET和POST：

conn.setRequestMethod("GET");

3. 设置 Http 相关参数
   这一步主要是设置请求头的参数，我们前面那张大表就可以派上用场了。此时可以设置 Cookie、Content-Type、超时时间等等参数。比如设置超时时间为 3 秒：

conn.setConnectTimeout(3*1000); 
conn.setWirteTimeout(3 * 1000);

4. 获取输入流
   通过getInputStream()方法获取网络输入流，此后可以通过此对象获取网络数据，如下：

InputStream in = conn.getInputStream();

5. 关闭流
   网络流比较消耗资源，在使用完毕之后一定要将 Http 连接关掉：

conn.disconnect();

4. HttpURLConnection使用示例

还记得前面将现场的时候提到过，Android 系统规定只能在主线程操作 UI，这里再加上一条：

Android 系统不能在 UI 线程访问网络

所以我们需要开启一个子线程处理 Http 请求，这一节我们使用 40 节学习的 AsyncTask 来执行网络请求，拉取慕课网 Android 教程的首页信息。

4.1 后台网络任务

首先开启一个 AsyncTask，在后台打开一个 HttpURLConnection，地址是https://www.imooc.com/wiki/androidlesson，接着设置相应参数，然后获取网络数据输入流，即可读到页面信息了。

package com.emercy.myapplication;

import android.os.AsyncTask;
import android.util.Log;

import java.io.BufferedReader;
import java.io.IOException;
import java.io.InputStreamReader;
import java.net.HttpURLConnection;
import java.net.URL;

public class HttpTask extends AsyncTask<Void, Void, Void> {
    @Override
    protected Void doInBackground(Void... params) {
        HttpURLConnection urlConnection = null;

        try {
            URL url = new URL("https://www.imooc.com/wiki/androidlesson");
            urlConnection = (HttpURLConnection) url.openConnection();

            int code = urlConnection.getResponseCode();
            if (code != 200) {
                throw new IOException("Invalid response from server: " + code);
            }

            BufferedReader rd = new BufferedReader(new InputStreamReader(
                    urlConnection.getInputStream()));
            String line;
            while ((line = rd.readLine()) != null) {
                Log.d("HttpTask", line);
            }
        } catch (Exception e) {
            e.printStackTrace();
        } finally {
            if (urlConnection != null) {
                urlConnection.disconnect();
            }
        }

        return null;
    }
}

4.2 首页布局

HTTPURLConnection 需要一个触发时机，所以在首页布局上我们放置一个 Button 用于触发 http 请求：

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical">

    <Button
        android:id="@+id/start_http"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_gravity="center"
        android:layout_marginTop="100dp"
        android:text="发起 Http 请求" />
</LinearLayout>

4.3 MainActivity编写

核心逻辑是在 HttpTask 里面，MainActivity 里面主要是设置触发按钮监听器，然后在点击事件中启动 HttpTask 即可：

package com.emercy.myapplication;

import android.app.Activity;
import android.os.Bundle;
import android.view.View;

public class MainActivity extends Activity {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        findViewById(R.id.start_http).setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                new HttpTask().execute();
            }
        });
    }
}

这里要记得，虽然在 HttpTask 中我们的代码是运行在doInBackground()方法中，但是启动 AsyncTask 的方法是调用eexecute()。

编译运行界面如下：

点击“发起 HTTP 请求”启动 AsyncTask 启动 http 连接，然后输入接收到的数据到 Logcat，过滤“HttpTask”字段，观察日志：

以上是日志的片段，可以看到 Logcat 中的内容就是https://www.imooc.com/wiki/androidlesson页面的源代码，到此就获取成功了。

5. 小结

本节讲述了如何在 Android 中发起 http 请求，HttpURLConnection 的使用方式非常简单，但是需要你对 http 协议本身有一定的了解，作为开发者这个是必备的知识点。当然对于大型项目而言，需要涉及到 DNS、缓存、安全校验等等高级操作，这时候 HttpURLConnection 会显得有点输出乏力，这就需要第三方的框架出场了，万变不离其宗，所有的框架到了底层其实都是一样的基本原理，所以还是希望大家能够熟悉 http 协议，并掌握 HttpURLConnection 的用法。