Android Network Access with OkHttp

In the previous chapter, we discussed how to parse JSON data in Android development. In network programming, the method used to retrieve data is critical. In this chapter, we’ll introduce how to perform network requests using the OkHttp library—a powerful tool for fetching JSON data.

Introduction to OkHttp

OkHttp is a high-performance HTTP client that simplifies making network requests and handling responses. Compared with other networking libraries, OkHttp delivers superior performance and broader functionality—including support for asynchronous requests, connection pooling, GZIP compression, and more.

Adding the OkHttp Dependency

Add the OkHttp dependency to your project’s build.gradle file. Open app/build.gradle, and add the following line inside the dependencies block:

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

Make sure to sync your project after adding the dependency.

Making Network Requests

Let’s demonstrate how to use OkHttp to make a GET request—specifically, to fetch JSON data. Suppose we want to call a public API at https://jsonplaceholder.typicode.com/posts. Here's a simple example:

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();

        // Asynchronous request
        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();
                    // Parse JSON data here
                    parseJson(responseData);
                }
            }
        });
    }

    private void parseJson(String jsonData) {
        // Parse JSON data
        // We’ll cover this in detail in the next chapter
        System.out.println(jsonData);
    }
}

In the code above, we first instantiate an OkHttpClient. Then we construct a GET request and dispatch it asynchronously using enqueue. Upon success, the parseJson() method is invoked to process the returned data.

Setting Request Headers

Sometimes you need to include custom headers in your requests—for example, setting a User-Agent or authentication tokens. Here’s how to add headers:

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

The addHeader() method makes it straightforward to attach headers to your request.

Handling HTTPS Requests

OkHttp handles HTTPS requests seamlessly—no extra configuration is required; simply use an https:// URL. However, if you have special SSL certificate requirements (e.g., self-signed certificates), OkHttp provides APIs to customize SSL configuration.

Handling Exceptions and Errors

Network requests may fail for various reasons—such as connection timeouts or DNS resolution failures. You can handle these gracefully in the onFailure callback to maintain app stability. For example:

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

Summary

In this chapter, we learned how to use OkHttp to perform network requests—closely integrated with JSON data retrieval. This lays the groundwork for the next chapter, where we’ll dive deeper into parsing JSON responses.

In the upcoming chapter, we’ll explore how to parse JSON data retrieved over the network—providing foundational knowledge for multimedia processing. Before proceeding, ensure you’ve successfully implemented and tested the network request functionality covered here.

The next chapter will cover: Multimedia Processing — Audio and Video Playback.