Unirest for Java 技术文档

1. 安装指南

Unirest 4 是基于现代 Java 标准构建的，因此至少需要 Java 11。

Unirest 4 的依赖项是完全模块化的，并且已经迁移到新的 Maven 坐标，以避免与旧版本的冲突。您可以使用 Maven BOM 来管理模块：

使用 Maven 安装

<dependencyManagement>
  <dependencies>
      <dependency>
          <groupId>com.konghq</groupId>
          <artifactId>unirest-java-bom</artifactId>
          <version>4.4.0</version>
          <type>pom</type>
          <scope>import</scope>
      </dependency>
  </dependencies>
</dependencyManagement>

<dependencies>
    <dependency>
        <groupId>com.konghq</groupId>
        <artifactId>unirest-java-core</artifactId>
    </dependency>
    
    <!-- 选择一个 JSON 模块，如果您需要解析 JSON，请包含以下之一： -->
    <!-- Google GSON -->
    <dependency>
        <groupId>com.konghq</groupId>
        <artifactId>unirest-modules-gson</artifactId>
    </dependency>

    <!-- 或者您可能更喜欢 Jackson？ -->
    <dependency>
        <groupId>com.konghq</groupId>
        <artifactId>unirest-modules-jackson</artifactId>
    </dependency>
</dependencies>

注意 JSON 用户

在 Unirest 4 中，核心不再包含任何瞬态依赖项，由于 Java 本身缺少 JSON 解析器，如果您希望进行对象映射或使用 JSON 对象，则必须声明一个 JSON 实现。

2. 项目的使用说明

Unirest for Java 是一个简化 HTTP 客户端操作的库。您可以通过简单的 API 调用发送 HTTP 请求并获取响应。

以下是一个简单的示例，演示如何使用 Unirest 发送 GET 请求：

import com.konghq.unirest.Unirest;

public class UnirestExample {
    public static void main(String[] args) {
        try {
            String response = Unirest.get("https://jsonplaceholder.typicode.com/todos/1")
                                    .asJson()
                                    .getBody()
                                    .getObject()
                                    .toString();
            System.out.println(response);
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

3. 项目API使用文档

Unirest for Java 提供了一系列的方法，用于简化 HTTP 请求的发送和响应的处理。以下是一些常用的 API 方法：

• get(String url): 发送 GET 请求。
• post(String url): 发送 POST 请求。
• put(String url): 发送 PUT 请求。
• delete(String url): 发送 DELETE 请求。
• asJson(): 将响应解析为 JSON。
• getBody(): 获取响应体。

更多 API 文档请参考官方文档。

4. 项目安装方式

如前所述，您可以通过 Maven 来安装 Unirest for Java。在 Maven 的 pom.xml 文件中添加依赖项，然后使用 Maven 命令安装项目。

mvn install

这将下载并安装所有必要的依赖项，并将它们包含在您的项目中。