javax.imageio.ImageIO 文件格式常量

Question

在javax.imageio.ImageIO有一个方法#write(RenderedImage im, String formatName, OutputStream output)，接受一个“stringly类型的”格式开发者想要的图像被写入。

CanEncodeImageAndFormatFilter在该文件内部有一个名为deep的内部类，用于检查是否存在支持上述格式的 SPI（无论它是什么）。例如，BMPImageWriterSpi声明

    private static String[] formatNames = {"bmp", "BMP"};

但是在所有这些 SPI 类中，这些格式名称被声明为私有或默认包，因此我无法在我的应用程序中访问它们。但是我想在我现在正在处理的 API 中公开该格式参数，但我不想重新发明轮子。

? 是否有枚举或我可以安全地用作格式名称参数的东西#write方法？

_{是的，这更像是编码风格的基于意见的问题标签的。:D}

---

更新： 我所拥有的：

ImageIO.write(image, "jpg", outStream);

我想要的是：

ImageIO.write(image, ImageTypes.JPEG, outStream);

Answer 1

在默认 Java API 中没有您要查找的此类 Enum。

原因是 Java Image I/O API 使用服务提供者接口 (SPI)。这允许创建可扩展的应用程序。在您的问题范围内，可以将其他图像读取器/写入器类（实现相应接口）添加到类路径中，并将在运行时自动发现。应用程序甚至可以在编译时不知道它们存在的情况下使用它们。因此这样的 Enum 不存在。

您可以ImageWriter使用以下代码段发现所有当前已知的实现。

import javax.imageio.spi.IIORegistry;
import javax.imageio.spi.ImageWriterSpi;
import java.util.Arrays;
import java.util.Iterator;
import java.util.Locale;

public class Main {
    public static void main(String[] args) {
        IIORegistry registry = IIORegistry.getDefaultInstance();
        Iterator<ImageWriterSpi> serviceProviders = registry.getServiceProviders(ImageWriterSpi.class, false);
        while(serviceProviders.hasNext()) {
            ImageWriterSpi next = serviceProviders.next();
            System.out.printf("description: %-27s   format names: %s%n",
                    next.getDescription(Locale.ENGLISH),
                    Arrays.toString(next.getFormatNames())
            );
        }
    }
}

Java 13 的输出

description: Standard BMP Image Writer     format names: [bmp, BMP]
description: Standard JPEG Image Writer    format names: [JPEG, jpeg, JPG, jpg]
description: Standard WBMP Image Writer    format names: [wbmp, WBMP]
description: Standard PNG image writer     format names: [png, PNG]
description: Standard GIF image writer     format names: [gif, GIF]
description: Standard TIFF image writer    format names: [tif, TIF, tiff, TIFF]

以下是如何使用 SPI 的简化示例。

假设当前目录中有以下文件

Main.class                  - the one from above source
ExampleImageWriterSpi.java  - an example implementation of the ImageWriterSpi

ExampleImageWriterSpi.java

package sub.optimal;

import javax.imageio.ImageTypeSpecifier;
import javax.imageio.ImageWriter;
import javax.imageio.spi.ImageWriterSpi;
import java.io.IOException;
import java.util.Locale;

public class ExampleImageWriterSpi extends ImageWriterSpi {

    private static final String[] formatNames = { "xyz", "XYZ"};

    public String getDescription(Locale locale) {
        return "Example XYZ image writer";
    }

    @Override
    public String[] getFormatNames() {
        return formatNames;
    }

    // following is without implementation in this example
    public boolean canEncodeImage(ImageTypeSpecifier type) {
        return false;
    }

    public ImageWriter createWriterInstance(Object extension) throws IOException {
        return null;
    }
}

编译类

javac ExampleImageWriterSpi.java

创建提供者配置文件
（文件名指定实现的接口，行指定实现类）

mkdir -p META-INF/services/
echo sub.optimal.ExampleImageWriterSpi > META-INF/services/javax.imageio.spi.ImageWriterSpi

为服务提供者创建档案

jar cf example-image-writer.jar META-INF/ sub/

运行简单的示例代码

java Main

输出（作为 Java 运行时一部分的所有服务提供者）

description: Standard BMP Image Writer     format names: [bmp, BMP]
description: Standard JPEG Image Writer    format names: [JPEG, jpeg, JPG, jpg]
description: Standard WBMP Image Writer    format names: [wbmp, WBMP]
description: Standard PNG image writer     format names: [png, PNG]
description: Standard GIF image writer     format names: [gif, GIF]
description: Standard TIFF image writer    format names: [tif, TIF, tiff, TIFF]

使用附加服务提供程序运行示例

java -cp example-image-writer.jar:. Main

输出

description: Example XYZ image writer      format names: [xyz, XYZ]
description: Standard JPEG Image Writer    format names: [JPEG, jpeg, JPG, jpg]
description: Standard WBMP Image Writer    format names: [wbmp, WBMP]
description: Standard PNG image writer     format names: [png, PNG]
description: Standard GIF image writer     format names: [gif, GIF]
description: Standard BMP Image Writer     format names: [bmp, BMP]
description: Standard TIFF image writer    format names: [tif, TIF, tiff, TIFF]

您可以自己创建枚举。但是您应该在运行时检查是否有可用于此图像类型的提供程序。例如 TIFF 在 Java 9 之前的 Java 运行时中不可用。