使用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應用的交互性能。