22 网络访问之使用OkHttp

在上一篇中，我们讨论了如何在 Android 开发中解析 JSON 数据。在网络编程中，获取数据的方式至关重要。在本章中，我们将介绍如何使用 OkHttp 库进行网络请求，这将在获取 JSON 数据时提供强大的支持。

OkHttp 简介

OkHttp 是一个高效的 HTTP 客户端，它能够轻松进行网络请求并处理响应。与其他网络库相比，OkHttp 提供了更高的性能和更广泛的功能，支持异步请求、连接池、GZIP 压缩等特性。

添加 OkHttp 依赖

在项目的 build.gradle 文件中添加 OkHttp 依赖。打开 app/build.gradle，在 dependencies 函数中加入如下行：

implementation 'com.squareup.okhttp3:okhttp:5.0.0-alpha.2'

确保你已同步项目。

发起网络请求

我们以获取 JSON 数据为例，演示如何使用 OkHttp 发起 GET 请求。假设我们要请求一个公开的 API，URL 为 https://jsonplaceholder.typicode.com/posts，以下是一个简单的使用案例：

import okhttp3.Call;
import okhttp3.Callback;
import okhttp3.OkHttpClient;
import okhttp3.Request;
import okhttp3.Response;
import java.io.IOException;

public class NetworkRequest {

    private OkHttpClient client;

    public NetworkRequest() {
        client = new OkHttpClient();
    }

    public void fetchPosts() {
        String url = "https://jsonplaceholder.typicode.com/posts";
        Request request = new Request.Builder()
                .url(url)
                .build();

        // 异步请求
        client.newCall(request).enqueue(new Callback() {
            @Override
            public void onFailure(Call call, IOException e) {
                e.printStackTrace();
            }

            @Override
            public void onResponse(Call call, Response response) throws IOException {
                if (response.isSuccessful()) {
                    final String responseData = response.body().string();
                    // 在此解析 JSON 数据
                    parseJson(responseData);
                }
            }
        });
    }

    private void parseJson(String jsonData) {
        // 解析 JSON 数据
        // 在下一章中我们会详细讨论这一部分
        System.out.println(jsonData);
    }
}

在上述代码中，我们首先创建了一个 OkHttpClient 的实例。然后定义了一个 GET 请求，使用 enqueue 方法以异步方式发起请求。请求成功后，调用 parseJson() 方法进行数据解析。

设置请求头

有时我们需要在请求中添加请求头，例如设置 User-Agent 或认证信息。以下是如何添加请求头的示例：

Request request = new Request.Builder()
        .url(url)
        .addHeader("User-Agent", "YourAppName/1.0")
        .build();

通过 addHeader 方法可以轻松设置请求头。

处理 HTTPS 请求

OkHttp 处理 HTTPS 请求非常方便，不需要额外配置，直接使用网址即可。不过，如果你有特殊的 SSL 证书需求，OkHttp 也提供了相关的 API 来自定义 SSL 配置。

处理异常及错误

当执行网络请求时，可能会发生各种异常，比如连接超时、无法解析地址等。我们可在 onFailure 方法中处理这些异常，保证应用的稳定性。可以使用简单的日志打印来表示：

@Override
public void onFailure(Call call, IOException e) {
    Log.e("NetworkRequest", "Request failed: " + e.getMessage());
}

小结

在本章中，我们学习了如何使用 OkHttp 进行网络请求，与获取 JSON 数据的过程紧密结合。这为我们下一章解析 JSON 数据提供了基础。

在接下来的章节中，我们将继续深入探讨如何解析从网络获取的 JSON 数据，为音视频处理奠定基础。在此之前，请确保你已成功实现本章内容，并测试网络请求功能。

下一章将介绍：多媒体处理之音视频播放。