Java OkHttp的使用详解

OkHttp是一个开源的HTTP客户端，由Square公司开发。它支持HTTP/2协议，具有简单易用的API和高效性能。本攻略将介绍Java OkHttp的使用详解，包括依赖导入、基本使用、异步请求、文件上传和下载等。

依赖导入

在使用Java OkHttp之前，需要将其依赖导入到项目中。可以通过Maven或Gradle来导入依赖。以下是一个Gradle的依赖示例：

implementation 'com.squareup.okhttp3:okhttp:4.9.1'

基本使用

以下是一个基本的Java OkHttp GET请求示例：

OkHttpClient client = new OkHttpClient();

String url = "https://jsonplaceholder.typicode.com/posts/1";

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

try (Response response = client.newCall(request).execute()) {
    String responseBody = response.body().string();
    System.out.println(responseBody);
} catch (IOException e) {
    e.printStackTrace();
}

在上述代码中，我们首先创建了一个OkHttpClient对象。然后，我们定义了一个URL和一个GET请求。我们使用client.newCall(request).execute()方法来请求，并使用.body().string()方法获取响应体的字符串表示。

以下是一个基本的Java OkHttp POST请求示例：

OkHttpClient client = new OkHttpClient();

String url = "https://jsonplaceholder.typicode.com/posts";

RequestBody requestBody = new FormBody.Builder()
        .add("title", "foo")
        .add("body", "bar")
        .add("userId", "1")
        .build();

Request request = new Request.Builder()
        .url(url)
        .post(requestBody)
        .build();

try (Response response = client.newCall(request).execute()) {
    String responseBody = response.body().string();
    System.out.println(responseBody);
} catch (IOException e) {
    e.printStackTrace();
}

在上述代码中，我们定义了一个URL和一个POST请求。我们使用FormBody.Builder()方法来构建请求体，并使用request.post(requestBody)方法将请求体添加到请求中。

异步请求

Java OkHttp还支持异步请求。以下是一个异步GET请求示例：

OkHttpClient client = new OkHttpClient();

String url = "https://jsonplaceholder.typicode.com/posts/1";

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 {
        String responseBody = response.body().string();
        System.out.println(responseBody);
    }
});

在上述代码中，我们使用client.newCall(request).enqueue()方法来执行异步请求。我们实现了一个Callback接口，用于处理请求的响应。

文件上传

Java OkHttp还支持文件上传。以下是一个文件上传示例：

OkHttpClient client = new OkHttpClient();

String url = "https://jsonplaceholder.typicode.com/posts";

File file = new File("path/to/file");

RequestBody requestBody = new MultipartBody.Builder()
        .setType(MultipartBody.FORM)
        .addFormDataPart("file", file.getName(),
                RequestBody.create(MediaType.parse("application/octet-stream"), file))
        .build();

Request request = new Request.Builder()
        .url(url)
        .post(requestBody)
        .build();

try (Response response = client.newCall(request).execute()) {
    String responseBody = response.body().string();
    System.out.println(responseBody);
} catch (IOException e) {
    e.printStackTrace();
}

在上述代码中，我们定义了一个URL和一个POST请求。我们使用MultipartBody.Builder()方法来构建请求体，并使用request.post(requestBody)方法将请求体添加到请求中。我们使用RequestBody.create()方法将文件转换为请求体。

文件下载

Java OkHttp还支持文件下载。以下是一个文件下载示例：

OkHttpClient client = new OkHttpClient();

String url = "https://jsonplaceholder.typicode.com/posts/1/comments";

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

try (Response response = client.newCall(request).execute()) {
    InputStream inputStream = response.body().byteStream();
    FileOutputStream outputStream = new FileOutputStream("path/to/file");

    byte[] buffer = new byte[4096];
    int bytesRead;
    while ((bytesRead = inputStream.read(buffer)) != -1) {
        outputStream.write(buffer, 0, bytesRead);
    }

    outputStream.flush();
    outputStream.close();
} catch (IOException e) {
    e.printStackTrace();
}

在上述代码中，我们定义了一个URL和一个GET请求。我们使用response.body().byteStream()方法获取响应体的输入流，并使用FileOutputStream将输入流写入文件中。

总结

本攻略介绍了Java OkHttp使用详解，包括依赖导入、基本使用、异步请求、文件上传和下载等。我们提供了多个示例代码，分别演示了GET请求、POST请求、文件上传和下载的实现。通过本攻略，我们可以了解如何使用 OkHttp来进行HTTP通信。