418. 现代 Java IO 最佳实践 - 网络数据获取：从 HttpClient 到图片下载

418. 现代 Java IO 最佳实践 - 网络数据获取：从 HttpClient 到图片下载

在实际开发中，尤其是 Web 应用 或 微服务 场景下，我们经常需要从网络上获取数据，例如：

• 下载网页 HTML
• 获取 JSON API 数据
• 下载图片或其他二进制文件

Java 提供了多种方式来完成这些操作。

---

1. 🔑 使用 HttpClient（现代方式，Java 11+）

如果你需要设置 请求头 或读取 响应头，推荐用 HttpClient：

HttpClient client = HttpClient.newBuilder().build();

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://horstmann.com/index.html"))
    .GET()
    .build();

HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());

String result = response.body();
System.out.println(result);

✅ 特点：

• 支持异步（sendAsync）
• 可以方便地添加 Header（如 Authorization）
• 对 REST API 特别适合

---

2. 🏃 快速获取网页内容（只要数据）

如果只想获取数据，而不关心 HTTP 细节，可以直接用 输入流：

try (InputStream in = new URI("https://horstmann.com/index.html").toURL().openStream()) {
    byte[] bytes = in.readAllBytes();
    String result = new String(bytes);
    System.out.println(result);
}

👉 好处：

• 简洁，一行代码搞定。
• 适合只下载资源，不需要复杂 HTTP 配置的场景。

---

3. 📥 下载文件（直接写入磁盘）

想把网络资源保存为文件，可以用 transferTo：

try (InputStream in = new URI("https://horstmann.com/index.html").toURL().openStream();
     OutputStream out = Files.newOutputStream(Path.of("index.html"))) {
    in.transferTo(out);
}

✅ 特点：

• 不需要写循环（传统方式需要 while ((read = in.read(buffer)) != -1)）。
• 简洁高效。

---

4. 🐶 读取 JSON（以 Jackson 为例）

很多 JSON 库（如 Jackson、Gson）都支持直接从 URL 读取数据：

URL url = new URI("https://dog.ceo/api/breeds/image/random").toURL();
Map<String, Object> result = com.fasterxml.jackson.jr.ob.JSON.std.mapFrom(url);

System.out.println(result);
// {message=https://images.dog.ceo/breeds/...jpg, status=success}

---

5. 🖼 下载并读取图片

假设我们刚从 API 获取到一张狗狗的图片 URL：

URL imgUrl = new URI(result.get("message").toString()).toURL();
BufferedImage img = javax.imageio.ImageIO.read(imgUrl);

// 输出图片宽高
System.out.println("Width: " + img.getWidth());
System.out.println("Height: " + img.getHeight());

👉 这里 直接传 URL 给 ImageIO.read 更好， 因为库可以根据 URL 提供的附加信息（如 MIME 类型）来判断图片格式，而不是仅仅依赖字节流。

---

6. 🎓 总结对比

方式	适用场景	示例
HttpClient	REST API，复杂请求	添加 headers、处理 JSON
InputStream + readAllBytes()	快速获取网页/文件内容	new URI(...).toURL().openStream()
transferTo	下载文件	in.transferTo(Files.newOutputStream(path))
JSON 库（Jackson/Gson）	直接解析 API	JSON.std.mapFrom(url)
ImageIO.read(URL)	下载图片	自动识别图片格式

---

🔥 课堂练习建议

1. 写一个程序，下载 https://www.example.com 的网页内容并保存到 example.html。
2. 调用 https://dog.ceo/api/breeds/image/random，解析 JSON，获取狗狗图片 URL，然后下载到本地。
3. 用 HttpClient 向一个 REST API 发送请求，带上自定义 Header（比如 User-Agent），打印返回的 JSON。