如何解析API返回的JSON数据？

原创于 2025-04-14 15:29:41 发布 · 1.1k 阅读

CC 4.0 BY-SA版权

文章标签：

解析 API 返回的 JSON 数据是开发中常见的任务。在 Java 中，可以使用 Jackson 或 Gson 等库来处理 JSON 数据。以下将详细介绍如何使用 Jackson 库解析 JSON 数据，并提取商品的详细信息。

一、使用 Jackson 解析 JSON 数据

1. 添加依赖

确保你的项目中已经添加了 Jackson 的依赖。如果你使用 Maven 进行项目管理，可以在 pom.xml 文件中添加以下依赖：

xml

<dependency>
    <groupId>com.fasterxml.jackson.core</groupId>
    <artifactId>jackson-databind</artifactId>
    <version>2.12.3</version>
</dependency>

2. 示例代码

以下是一个完整的 Java 示例代码，展示如何解析 API 返回的 JSON 数据：

java

import com.fasterxml.jackson.databind.JsonNode;
import com.fasterxml.jackson.databind.ObjectMapper;

import java.io.IOException;

public class ProductDetailCrawler {
    public static void main(String[] args) {
        String jsonResponse = "{\n" +
                "    \"code\": \"0\",\n" +
                "    \"errorMessage\": \"success\",\n" +
                "    \"item_detail_response\": {\n" +
                "        \"items\": [\n" +
                "            {\n" +
                "                \"title\": \"商品标题\",\n" +
                "                \"price\": \"120.00\",\n" +
                "                \"pic_url\": \"https://example.com/image.jpg\",\n" +
                "                \"description\": \"商品详细描述\"\n" +
                "            }\n" +
                "        ]\n" +
                "    }\n" +
                "}";
        parse_response(jsonResponse);
    }

    public static void parse_response(String jsonResponse) {
        try {
            ObjectMapper objectMapper = new ObjectMapper();
            JsonNode rootNode = objectMapper.readTree(jsonResponse);

            int code = rootNode.path("code").asInt();
            String errorMessage = rootNode.path("errorMessage").asText();

            if (code == 0) {
                JsonNode itemsNode = rootNode.path("item_detail_response").path("items");

                for (JsonNode itemNode : itemsNode) {
                    String title = itemNode.path("title").asText();
                    String price = itemNode.path("price").asText();
                    String picUrl = itemNode.path("pic_url").asText();
                    String description = itemNode.path("description").asText();

                    System.out.println("商品标题: " + title);
                    System.out.println("商品价格: " + price);
                    System.out.println("商品图片: " + picUrl);
                    System.out.println("商品描述: " + description);
                }
            } else {
                System.out.println("API 请求失败，错误信息: " + errorMessage);
            }
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

二、解析 JSON 数据的步骤

1. 使用 `ObjectMapper` 读取 JSON 数据

ObjectMapper 是 Jackson 库的核心类，用于读取和解析 JSON 数据。

java

ObjectMapper objectMapper = new ObjectMapper();
JsonNode rootNode = objectMapper.readTree(jsonResponse);

2. 提取根节点的字段

通过 path 方法提取 JSON 数据中的字段。如果字段不存在，path 方法会返回一个空的 JsonNode，而不会抛出异常。

java

int code = rootNode.path("code").asInt();
String errorMessage = rootNode.path("errorMessage").asText();

3. 提取嵌套节点的字段

如果 JSON 数据中包含嵌套的节点，可以通过连续调用 path 方法来提取嵌套字段。

java

JsonNode itemsNode = rootNode.path("item_detail_response").path("items");

4. 遍历数组节点

如果某个字段是一个数组，可以通过 for 循环遍历数组中的每个元素。

java

for (JsonNode itemNode : itemsNode) {
    String title = itemNode.path("title").asText();
    String price = itemNode.path("price").asText();
    String picUrl = itemNode.path("pic_url").asText();
    String description = itemNode.path("description").asText();

    System.out.println("商品标题: " + title);
    System.out.println("商品价格: " + price);
    System.out.println("商品图片: " + picUrl);
    System.out.println("商品描述: " + description);
}

5. 错误处理

在解析 JSON 数据时，可能会遇到各种错误，如 JSON 格式错误、字段缺失等。建议在代码中添加适当的错误处理逻辑。

java

try {
    ObjectMapper objectMapper = new ObjectMapper();
    JsonNode rootNode = objectMapper.readTree(jsonResponse);
    // 解析逻辑
} catch (IOException e) {
    e.printStackTrace();
}

三、注意事项

检查字段是否存在

在访问 JSON 字段之前，建议先检查字段是否存在，以避免 NullPointerException。

java

if (itemNode.has("title")) {
    String title = itemNode.path("title").asText();
} else {
    System.out.println("字段 'title' 不存在");
}

处理缺失字段
- 如果某些字段可能不存在，可以使用默认值或进行适当的处理。
java
```
String title = itemNode.has("title") ? itemNode.path("title").asText() : "未知";
```

数据类型转换

在将 JSON 字段转换为特定数据类型时，可能会抛出异常。建议在转换时添加错误处理逻辑。

java

try {
    double price = itemNode.path("price").asDouble();
} catch (Exception e) {
    System.out.println("字段 'price' 转换失败: " + e.getMessage());
}

日志记录

在解析过程中，建议记录详细的日志信息，以便在出现问题时能够快速定位和解决。

java

import java.util.logging.Logger;

public class ProductDetailCrawler {
    private static final Logger logger = Logger.getLogger(ProductDetailCrawler.class.getName());

    public static void main(String[] args) {
        String jsonResponse = "{...}"; // 替换为实际的 JSON 响应数据
        parse_response(jsonResponse);
    }

    public static void parse_response(String jsonResponse) {
        try {
            ObjectMapper objectMapper = new ObjectMapper();
            JsonNode rootNode = objectMapper.readTree(jsonResponse);

            int code = rootNode.path("code").asInt();
            String errorMessage = rootNode.path("errorMessage").asText();

            if (code == 0) {
                JsonNode itemsNode = rootNode.path("item_detail_response").path("items");

                for (JsonNode itemNode : itemsNode) {
                    String title = itemNode.path("title").asText();
                    String price = itemNode.path("price").asText();
                    String picUrl = itemNode.path("pic_url").asText();
                    String description = itemNode.path("description").asText();

                    logger.info("商品标题: " + title);
                    logger.info("商品价格: " + price);
                    logger.info("商品图片: " + picUrl);
                    logger.info("商品描述: " + description);
                }
            } else {
                logger.severe("API 请求失败，错误信息: " + errorMessage);
            }
        } catch (IOException e) {
            logger.severe("解析 JSON 数据时发生错误: " + e.getMessage());
        }
    }
}

四、总结

通过上述步骤和代码，你可以使用 Java 爬虫技术获取商品的详细信息，并解析返回的 JSON 数据。解析 JSON 数据时，建议检查字段是否存在、处理缺失字段、添加数据类型转换的错误处理逻辑，并记录详细的日志信息。这些步骤和注意事项将帮助你更安全、高效地处理 JSON 数据，确保程序的健壮性和可靠性。希望这个示例对你有所帮助！