统一接口输入输出

Image 创建接口说明

本章节介绍如何通过多种方式创建 Image 对象，涵盖了常用的接口方法，包括 fromBufferedImage、fromBase64、fromBytes、fromFile、fromInputStream、fromUrl(URL url) 等。

Image 对象是系统中统一的图像数据载体，支持多种形式的创建方式，方便不同场景下的图像输入。 所有创建接口均由 SmartImageFactory 提供，示例代码均基于该工厂类。

---

创建接口列表

接口名称	说明	输入类型	示例代码
fromBufferedImage	从 BufferedImage 创建	java.awt.image.BufferedImage	Image img = factory.fromBufferedImage(bufferedImage);
fromBase64	从 Base64 编码字符串创建	String	Image img = factory.fromBase64(base64String);
fromBytes	从字节数组创建	byte[]	Image img = factory.fromBytes(byteArray);
fromFile	从文件路径创建	java.nio.file.Path	Image img = factory.fromFile(Paths.get("path/to/file.png"));
fromInputStream	从输入流创建	java.io.InputStream	Image img = factory.fromInputStream(inputStream);
fromUrl(URL url)	从 URL 对象创建	java.net.URL	Image img = factory.fromUrl(new URL("http://example.com/image.png"));

---

详细示例

fromFile

Image image = SmartImageFactory.getInstance().fromFile(Paths.get("src/main/resources/person/person.png"));

fromBufferedImage

BufferedImage bufferedImage = ImageIO.read(new File("src/main/resources/person/person.png"));
Image image = SmartImageFactory.getInstance().fromBufferedImage(bufferedImage);

fromBase64

String base64String = "iVBORw0KGgoAAAANSUhEUgAA...";
Image image = SmartImageFactory.getInstance().fromBase64(base64String);

fromBytes

byte[] bytes = Files.readAllBytes(Paths.get("src/main/resources/person/person.png"));
Image image = SmartImageFactory.getInstance().fromBytes(bytes);

fromInputStream

try (InputStream inputStream = new FileInputStream("src/main/resources/person/person.png")) {
    Image image = SmartImageFactory.getInstance().fromInputStream(inputStream);
}

---

返回结果说明：R<T>

R<T> 是一个统一的返回结果封装类（Response Wrapper），用于标准化接口返回结构，便于前端或调用方统一处理。

包含以下字段：

字段名	类型	说明
code	Integer	状态码，通常 0 表示成功，非 0 表示失败
message	String	提示信息，例如 "ok"、"image not found"
data	T	实际返回的数据内容