如何在Java中使用封装好的API接口？

1.选择合适的 HTTP 库

• 在 Java 中，可以使用多种库来进行 HTTP 请求。java.net.HttpURLConnection是 Java 标准库中的类，能够满足基本的 HTTP 请求需求，但使用起来相对复杂。另外，还有一些第三方库，如OkHttp和Apache HttpClient，它们提供了更简洁、高效的接口。
• 以OkHttp为例，首先需要在项目的pom.xml（如果是 Maven 项目）中添加OkHttp的依赖：

  <dependency>
      <groupId>com.squareup.okhttp3</groupId>
      <artifactId>okhttp3</artifactId>
      <version>4.9.3</version>
  </dependency>

  如果是 Gradle 项目，在build.gradle文件中添加依赖：

implementation 'com.squareup.okhttp3:okhttp3:4.9.3'

 

2.了解 API 接口文档

• 获取 API 接口的详细文档是关键的第一步。文档中应该包含接口的 URL、请求方法（如 GET、POST、PUT、DELETE）、请求参数的类型和格式（是在 URL 中传递的查询参数，还是在请求体中的 JSON 或表单数据），以及响应数据的格式（如 JSON、XML 等）。

3.使用 OkHttp 发送请求（以 GET 请求为例）

• 假设我们有一个简单的天气 API 接口，它通过 GET 请求返回指定城市的天气信息。接口 URL 是https://api.weather.com/current，请求参数是city（城市名称），响应数据是 JSON 格式，包含temperature（温度）和weather_condition（天气状况）等字段。

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

public class ApiClient {
    public static void main(String[] args) {
        OkHttpClient client = new OkHttpClient();
        String url = "https://api.weather.com/current";
        // 设置请求参数
        String city = "Shanghai";
        String fullUrl = url + "?city=" + city;
        Request request = new Request.Builder()
               .url(fullUrl)
               .build();
        try {
            Response response = client.newCall(request).execute();
            if (response.isSuccessful()) {
                String jsonData = response.body().string();
                // 在这里可以使用JSON解析库（如Gson或Jackson）来解析jsonData
                System.out.println(jsonData);
            } else {
                System.out.println("请求失败，状态码: " + response.code());
            }
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

 

• 在这个示例中：
• 首先创建了一个OkHttpClient对象，它是OkHttp库用于发送请求的主要入口。
• 构建了请求的 URL，将城市名称作为查询参数添加到接口 URL 后面。
• 使用Request.Builder构建了一个Request对象，指定了请求的 URL。
• 通过client.newCall(request).execute()发送请求并获取Response对象。
• 根据Response对象的isSuccessful()方法判断请求是否成功。如果成功，通过response.body().string()获取响应的字符串内容（假设是 JSON 数据），并可以后续使用 JSON 解析库进行解析。如果请求失败，打印出状态码。

4.使用 OkHttp 发送 POST 请求（示例）

• 假设 API 接口需要通过 POST 请求提交数据，并且数据格式是 JSON。例如，有一个用户注册接口，URL 是https://api.example.com/register，请求体中的 JSON 数据包含username和password字段。

  import okhttp3.*;
  import java.io.IOException;
  
  public class ApiClient {
      public static void main(String[] args) {
          OkHttpClient client = new OkHttpClient();
          String url = "https://api.example.com/register";
          String jsonData = "{\"username\": \"testuser\", \"password\": \"testpassword\"}";
          MediaType mediaType = MediaType.get("application/json; charset=utf-8");
          RequestBody body = RequestBody.create(jsonData, mediaType);
          Request request = new Request.Builder()
                 .url(url)
                 .post(body)
                 .build();
          try {
              Response response = client.newCall(request).execute();
              if (response.isSuccessful()) {
                  String responseData = response.body().string();
                  System.out.println(responseData);
              } else {
                  System.out.println("请求失败，状态码: " + response.code());
              }
          } catch (IOException e) {
              e.printStackTrace();
          }
      }
  }

这里的步骤与 GET 请求类似，但有以下不同点：

• 需要构建一个包含 JSON 数据的RequestBody对象，指定数据的类型为application/json。
• 在构建Request对象时，使用post方法而不是get方法，将RequestBody对象作为参数传递进去，以表示这是一个 POST 请求。

5.解析响应数据

• 如果响应数据是 JSON 格式，可以使用Gson或Jackson等 JSON 解析库。以Gson为例，首先需要在项目的依赖管理文件（pom.xml或build.gradle）中添加Gson的依赖。
• 对于 Maven 项目，在pom.xml中添加：

  <dependency>
      <groupId>com.google.code.gson</groupId>
      <artifactId>gson</artifactId>
      <version>2.8.9</version>
  </dependency>

  对于 Gradle 项目，在build.gradle中添加：

  implementation 'com.google.code.gson:gson:2.8.9'

  假设响应数据是一个包含天气信息的 JSON 对象，例如{"temperature": 25, "weather_condition": "Sunny"}，可以使用Gson来解析：

  import com.google.gson.Gson;
  import okhttp3.OkHttpClient;
  import okhttp3.Request;
  import okhttp3.Response;
  import java.io.IOException;
  
  public class ApiClient {
      public static void main(String[] args) {
          OkHttpClient client = new OkHttpClient();
          String url = "https://api.weather.com/current";
          // 设置请求参数
          String city = "Shanghai";
          String fullUrl = url + "?city=" + city;
          Request request = new Request.Builder()
                 .url(fullUrl)
                 .build();
          try {
              Response response = client.newCall(request).execute();
              if (response.isSuccessful()) {
                  String jsonData = response.body().string();
                  Gson gson = new Gson();
                  WeatherInfo weatherInfo = gson.fromJson(jsonData, WeatherInfo.class);
                  System.out.println("温度: " + weatherInfo.temperature);
                  System.out.println("天气状况: " + weatherInfo.weatherCondition);
              } else {
                  System.out.println("请求失败，状态码: " + response.code());
              }
          } catch (IOException e) {
              e.printStackTrace();
          }
      }
  }
  class WeatherInfo {
      public int temperature;
      public String weatherCondition;
  }

  在这个示例中，定义了一个WeatherInfo类来与 JSON 数据的结构相匹配。通过gson.fromJson方法，将 JSON 字符串解析为WeatherInfo对象，然后就可以方便地访问对象中的属性来获取天气信息。