将 Base64 图像转 Java 图片对象

本文旨在指导开发者如何使用 Java 或 Spring 将从 JSON 响应中获取的 Base64 编码的图像数据转换为实际的图像文件（如 JPG 或 PNG）。通过示例代码，我们将演示如何使用 javax.imageio 包来实现这一目标，并提供必要的注意事项。

正文

在实际开发中，我们经常会遇到从 API 接口获取 JSON 数据，其中包含 Base64 编码的图像信息。我们需要将这些 Base64 编码的数据解码并生成图像文件。以下将详细介绍如何使用 Java 实现这一过程。

步骤 1：解码 Base64 字符串

首先，你需要将 Base64 编码的字符串解码为字节数组。Java 提供了 java.util.Base64 类来完成这个任务。

import java.util.Base64;

public class Base64ImageConverter {

    public static void main(String[] args) {
        // 假设 imageBase64String 是从 JSON 中获取的 Base64 编码的图像数据
        String imageBase64String = "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...........................";

        // 解码 Base64 字符串
        byte[] imageBytes = Base64.getDecoder().decode(imageBase64String);

        // 后续步骤...
    }
}

步骤 2：将字节数组转换为 BufferedImage

接下来，你需要使用 ByteArrayInputStream 将字节数组转换为 BufferedImage 对象。BufferedImage 是 Java AWT (Abstract Window Toolkit) 中用于表示图像的类。

import javax.imageio.ImageIO;
import java.awt.image.BufferedImage;
import java.io.ByteArrayInputStream;
import java.io.IOException;

// ... (在上面的代码基础上继续)

        try {
            // 将字节数组转换为 ByteArrayInputStream
            ByteArrayInputStream bis = new ByteArrayInputStream(imageBytes);

            // 使用 ImageIO 读取 ByteArrayInputStream 并创建 BufferedImage
            BufferedImage image = ImageIO.read(bis);

            // 后续步骤...
        } catch (IOException e) {
            e.printStackTrace();
            // 处理 IO 异常
        }

步骤 3：将 BufferedImage 写入文件

最后，使用 ImageIO.write() 方法将 BufferedImage 对象写入文件。你需要指定图像格式（如 "jpg" 或 "png"）和输出文件。

import java.io.File;

// ... (在上面的代码基础上继续)

        try {
            // 将字节数组转换为 ByteArrayInputStream
            ByteArrayInputStream bis = new ByteArrayInputStream(imageBytes);

            // 使用 ImageIO 读取 ByteArrayInputStream 并创建 BufferedImage
            BufferedImage image = ImageIO.read(bis);

            // 写入图像文件
            File outputFile = new File("output.jpg"); // 指定输出文件名
            ImageIO.write(image, "jpg", outputFile);

            System.out.println("图像已成功保存到 " + outputFile.getAbsolutePath());

        } catch (IOException e) {
            e.printStackTrace();
            // 处理 IO 异常
        }

完整代码示例

将上述步骤整合，得到完整的代码示例：

import javax.imageio.ImageIO;
import java.awt.image.BufferedImage;
import java.io.ByteArrayInputStream;
import java.io.File;
import java.io.IOException;
import java.util.Base64;

public class Base64ImageConverter {

    public static void main(String[] args) {
        // 假设 imageBase64String 是从 JSON 中获取的 Base64 编码的图像数据
        String imageBase64String = "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...........................";

        try {
            // 解码 Base64 字符串
            byte[] imageBytes = Base64.getDecoder().decode(imageBase64String);

            // 将字节数组转换为 ByteArrayInputStream
            ByteArrayInputStream bis = new ByteArrayInputStream(imageBytes);

            // 使用 ImageIO 读取 ByteArrayInputStream 并创建 BufferedImage
            BufferedImage image = ImageIO.read(bis);

            // 写入图像文件
            File outputFile = new File("output.jpg"); // 指定输出文件名
            ImageIO.write(image, "jpg", outputFile);

            System.out.println("图像已成功保存到 " + outputFile.getAbsolutePath());

        } catch (IOException e) {
            e.printStackTrace();
            // 处理 IO 异常
        }
    }
}

注意事项

• 异常处理： 代码中包含了 try-catch 块来处理 IOException。在实际应用中，请根据具体情况完善异常处理逻辑。
• 图像格式： ImageIO.write() 方法的第二个参数指定了输出图像的格式。请确保选择正确的格式，例如 "jpg"、"png" 或 "gif"。
• Base64 编码格式： 有些 Base64 编码的字符串可能包含前缀，例如 data:image/png;base64,。在解码之前，需要先移除这些前缀。
• Spring 集成： 如果你正在使用 Spring 框架，可以将上述代码封装成一个 Service，并通过依赖注入在 Controller 中使用。

总结

本文详细介绍了如何使用 Java 将从 JSON 响应中获取的 Base64 编码的图像数据转换为实际的图像文件。通过示例代码，你现在应该能够轻松地在自己的项目中实现这一功能。记住，良好的异常处理和正确的图像格式选择是成功转换的关键。