使用OkHttp3在Android应用中进行网络请求

在开发Android应用过程中，很多时候需要使用网络请求获取数据以及实现网络交互。OkHttp3是一个专门针对 Android 平台设计的库，可以让我们轻松地发送 HTTP/HTTPS 请求，并且得到响应。本篇文章将从以下几个方面对OkHttp3进行详细的阐述。

一、添加OkHttp3依赖库

在使用OkHttp3之前，我们需要在Android应用中添加OkHttp3的依赖库。可以通过修改项目的build.gradle文件，将以下代码添加到dependencies中：

dependencies {
    implementation 'com.squareup.okhttp3:okhttp:4.9.0'
}

添加依赖后，需要进行一次Sync Project操作，等待Gradle同步完成后，就可以正常使用OkHttp3了。

二、使用OkHttp3发送GET请求

在使用OkHttp3发送请求时，可以通过OkHttpClient与Request两个类来实现。以下是一个发送GET请求的示例：

OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
        .url("http://www.example.com")
        .build();

Response response = client.newCall(request).execute();
String responseData = response.body().string();

首先创建一个OkHttpClient对象，然后通过Request.Builder构造一个Request对象，在Request对象中添加url、header等信息，最后使用client.newCall(request).execute()方法发送请求，得到Response对象，进而获取响应数据。

三、使用OkHttp3发送POST请求

通过OkHttp3发送POST请求时，可以将参数放在RequestBody对象中，然后将其放到Request对象中。以下是一个示例：

OkHttpClient client = new OkHttpClient();

RequestBody requestBody = new FormBody.Builder()
        .add("username", "admin")
        .add("password", "123456")
        .build();

Request request = new Request.Builder()
        .url("http://www.example.com")
        .post(requestBody)
        .build();

Response response = client.newCall(request).execute();
String responseData = response.body().string();

上述代码中，使用FormBody.Builder构造RequestBody对象，添加参数键值对，然后将其放到Request对象中，使用POST方式发送请求。

四、使用OkHttp3进行文件下载

通过OkHttp3进行文件下载可以使用其内置的DownloadManager，该管理器支持后台下载和断点续传。以下是一个示例：

OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
        .url(fileUrl)
        .build();

client.newCall(request).enqueue(new Callback() {
    public void onFailure(Call call, IOException e) {
        //下载失败
    }
    public void onResponse(Call call, Response response) throws IOException {
        InputStream input = null;
        byte[] buf = new byte[2048];
        int len;
        FileOutputStream output = null;
        String fileName = "example.jpg"; //需要指定文件名
        try {
            input = response.body().byteStream();
            output = new FileOutputStream(fileName);
            while ((len = input.read(buf)) != -1) {
                output.write(buf, 0, len);
            }
            output.flush();
            //TODO: 下载成功，进行相关操作
        } catch (IOException e) {
            //下载失败
        } finally {
            try {
                if (input != null) input.close();
                if (output != null) output.close();
            } catch (IOException e) {
                //关闭流失败
            }
        }
    }
});

在上述示例中，我们通过client.newCall(request).enqueue()方法异步下载文件，使用Callback对象处理下载结果。在onResponse方法中，我们获取响应流，读取并写入到指定文件中，进而实现文件下载。

五、使用OkHttp3进行文件上传

通过OkHttp3进行文件上传同样可以使用FormBody.Builder构造RequestBody对象，并将其放到Request对象中。以下是一个示例：

OkHttpClient client = new OkHttpClient();

File file = new File("example.jpg");

RequestBody requestBody = new MultipartBody.Builder()
        .setType(MultipartBody.FORM)
        .addFormDataPart("file", "example.jpg", RequestBody.create(MediaType.parse("image/*"), file))
        .build();

Request request = new Request.Builder()
        .url("http://www.example.com")
        .post(requestBody)
        .build();

Response response = client.newCall(request).execute();
String responseData = response.body().string();

上述示例中，我们通过MultipartBody.Builder构造RequestBody对象，调用addFormDataPart方法添加文件数据。在调用execute方法时，将RequestBody放到Request对象中，使用POST方式发送请求。

六、总结

本篇文章从添加OkHttp3依赖库、使用OkHttp3发送GET、POST请求以及文件下载与上传几个方面对OkHttp3进行了详细的阐述。通过OkHttp3，我们可以轻松地进行网络请求与交互，提高Android应用的交互性能。