javax.imageio.spi

Class ImageReaderWriterSpi

java.lang.Object

javax.imageio.spi.IIOServiceProvider

javax.imageio.spi.ImageReaderWriterSpi

All Implemented Interfaces:

RegisterableService

已知直接子类：

ImageReaderSpi， ImageWriterSpi

public abstract class ImageReaderWriterSpi
extends IIOServiceProvider

一个父类的实例变量和方法包含 ImageReaderSpi和 ImageWriterSpi常见。

另请参见：

IIORegistry， ImageReaderSpi， ImageWriterSpi

Field Summary

Fields

Modifier and Type	Field and Description
protected String[]	extraImageMetadataFormatClassNames 包含任何额外的图像元数据格式，此插件支持的类的名称 Strings数组，最初 null。
protected String[]	extraImageMetadataFormatNames 包含任何额外的图像元数据格式的插件支持的名字 Strings数组，最初 null。
protected String[]	extraStreamMetadataFormatClassNames 包含任何额外的数据流格式，此插件支持的类的名称 Strings数组，最初 null。
protected String[]	extraStreamMetadataFormatNames 含有任何附加数据流格式的插件支持的名字 Strings数组，最初 null。
protected String[]	MIMETypes 字符串数组返回 getMIMETypes，最初 null。
protected String[]	names 字符串数组返回 getFormatNames，最初 null。
protected String	nativeImageMetadataFormatClassName 一个 String包含本地数据流格式，此插件支持的类的名称，最初 null。
protected String	nativeImageMetadataFormatName 一个 String包含本地数据流格式的插件支持的名字，最初 null。
protected String	nativeStreamMetadataFormatClassName 一个 String包含本地数据流格式，此插件支持的类的名称，最初 null。
protected String	nativeStreamMetadataFormatName 一个 String包含本地数据流格式的插件支持的名字，最初 null。
protected String	pluginClassName 一个 String包含关联插件类的名字，最初 null。
protected String[]	suffixes 字符串数组返回 getFileSuffixes，最初 null。
protected boolean	supportsStandardImageMetadataFormat 一个布尔值，指示是否该插件支持的图像元数据标准元数据格式，最初 false。
protected boolean	supportsStandardStreamMetadataFormat 一个布尔值，指示是否该插件支持流元数据标准元数据格式，最初 false。

Fields inherited from class javax.imageio.spi.IIOServiceProvider

vendorName, version

构造方法摘要

构造方法

Constructor and Description
ImageReaderWriterSpi() 建立一个空白 ImageReaderWriterSpi。
ImageReaderWriterSpi(String vendorName, String version, String[] names, String[] suffixes, String[] MIMETypes, String pluginClassName, boolean supportsStandardStreamMetadataFormat, String nativeStreamMetadataFormatName, String nativeStreamMetadataFormatClassName, String[] extraStreamMetadataFormatNames, String[] extraStreamMetadataFormatClassNames, boolean supportsStandardImageMetadataFormat, String nativeImageMetadataFormatName, String nativeImageMetadataFormatClassName, String[] extraImageMetadataFormatNames, String[] extraImageMetadataFormatClassNames) 构建了一个 ImageReaderWriterSpi与一组给定的值。

方法摘要

Modifier and Type	Method and Description
String[]	getExtraImageMetadataFormatNames() 返回包含附加的文件格式的名称 Strings数组，除了本地和标准格式，通过对生产或通过这个插件消耗的图像元数据对象的 getAsTree和 setFromTree方法确认。
String[]	getExtraStreamMetadataFormatNames() 返回包含附加的文件格式的名称 Strings数组，除了本地和标准格式，通过这个插件产生或消耗数据流对象的 getAsTree和 setFromTree方法确认。
String[]	getFileSuffixes() 返回包含列表文件后缀，通常可用的 ImageReader或 ImageWriter实现这个服务提供商相关的格式关联 Strings数组。
String[]	getFormatNames() 返回包含可读的名字，一般都是可用的 ImageReader或 ImageWriter实现这个服务提供商相关的格式 Strings数组。
IIOMetadataFormat	getImageMetadataFormat(String formatName) 返回一个 IIOMetadataFormat对象描述给定图像的元数据格式，或 null如果没有合适的描述。
String[]	getMIMETypes() 返回包含一个MIME类型的列表，通常可用的 ImageReader或 ImageWriter实现这个服务提供商相关的格式关联 Strings数组。
String	getNativeImageMetadataFormatName() 返回此插件的“本地”图像元数据格式的名称，通常允许存储在由该插件处理的格式的图像元数据的无损编码和传输。
String	getNativeStreamMetadataFormatName() 返回此插件的“本地”流元数据格式的名称，它通常允许存储在由该插件处理的格式中的流元数据的无损编码和传输。
String	getPluginClassName() 返回完全限定类名的 ImageReader或 ImageWriter插件与该服务提供商的相关。
IIOMetadataFormat	getStreamMetadataFormat(String formatName) 返回一个 IIOMetadataFormat对象描述给定的数据流格式，或 null如果没有合适的描述。
boolean	isStandardImageMetadataFormatSupported() 返回 true如果标准元数据格式的文件格式，通过对生产或通过这个插件消耗的图像元数据对象和方法之间的 getAsTree setFromTree认可。
boolean	isStandardStreamMetadataFormatSupported() 返回 true如果标准元数据格式的文件格式，通过这个插件产生或消耗流元数据对象和方法之间的 getAsTree setFromTree认可。

Methods inherited from class javax.imageio.spi.IIOServiceProvider

getDescription, getVendorName, getVersion, onDeregistration, onRegistration

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

names

protected String[] names

字符串数组返回 getFormatNames，最初 null。构造函数应该设置为一个非 null价值。

suffixes

protected String[] suffixes

字符串数组返回 getFileSuffixes，最初 null。

MIMETypes

protected String[] MIMETypes

字符串数组返回 getMIMETypes，最初 null。

pluginClassName

protected String pluginClassName

一个 String包含关联插件类的名字，最初 null。

supportsStandardStreamMetadataFormat

protected boolean supportsStandardStreamMetadataFormat

一个布尔值，指示是否该插件支持流元数据标准元数据格式，最初 false。

nativeStreamMetadataFormatName

protected String nativeStreamMetadataFormatName

一个 String包含本地数据流格式的插件支持的名字，最初 null。

nativeStreamMetadataFormatClassName

protected String nativeStreamMetadataFormatClassName

一个 String包含本地数据流格式，此插件支持的类的名称，最初 null。

extraStreamMetadataFormatNames

protected String[] extraStreamMetadataFormatNames

含有任何附加数据流格式的插件支持的名字 Strings数组，最初 null。

extraStreamMetadataFormatClassNames

protected String[] extraStreamMetadataFormatClassNames

包含任何额外的数据流格式，此插件支持的类的名称 Strings数组，最初 null。

supportsStandardImageMetadataFormat

protected boolean supportsStandardImageMetadataFormat

一个布尔值，指示是否该插件支持的图像元数据标准元数据格式，最初 false。

nativeImageMetadataFormatName

protected String nativeImageMetadataFormatName

一个 String包含本地数据流格式的插件支持的名字，最初 null。

nativeImageMetadataFormatClassName

protected String nativeImageMetadataFormatClassName

一个 String包含本地数据流格式，此插件支持的类的名称，最初 null。

extraImageMetadataFormatNames

protected String[] extraImageMetadataFormatNames

包含任何额外的图像元数据格式的插件支持的名字 Strings数组，最初 null。

extraImageMetadataFormatClassNames

protected String[] extraImageMetadataFormatClassNames

包含任何额外的图像元数据格式，此插件支持的类的名称 Strings数组，最初 null。

Constructor Detail

ImageReaderWriterSpi

public ImageReaderWriterSpi(String vendorName,
                            String version,
                            String[] names,
                            String[] suffixes,
                            String[] MIMETypes,
                            String pluginClassName,
                            boolean supportsStandardStreamMetadataFormat,
                            String nativeStreamMetadataFormatName,
                            String nativeStreamMetadataFormatClassName,
                            String[] extraStreamMetadataFormatNames,
                            String[] extraStreamMetadataFormatClassNames,
                            boolean supportsStandardImageMetadataFormat,
                            String nativeImageMetadataFormatName,
                            String nativeImageMetadataFormatClassName,
                            String[] extraImageMetadataFormatNames,
                            String[] extraImageMetadataFormatClassNames)

构建一个给定的值的 ImageReaderWriterSpi。

参数

vendorName -供应商的名称，作为一个非 null String。

version -一个版本标识，作为一种非 null String。

names -非- Strings指示格式名称 null阵列。至少有一个条目必须存在。

suffixes - Strings表示普通文件后缀数组。如果没有定义后缀， null应提供。长度为0的数组将被归到 null。

MIMETypes - Strings指示格式的MIME类型的数组。如果未定义的MIME类型， null应提供。长度为0的数组将被归到 null。

pluginClassName的完全限定名称相关的 ImageReader或 ImageWriter类，作为一个非 null String。

supportsStandardStreamMetadataFormat - boolean指示数据流对象可以使用标准的元数据格式描述的树。

nativeStreamMetadataFormatName - String，或 null，归还从 getNativeStreamMetadataFormatName。

nativeStreamMetadataFormatClassName - String，或 null，用来实例化一个元数据格式对象被返回 getNativeStreamMetadataFormat。

extraStreamMetadataFormatNames - Strings，数组或 null，归还从 getExtraStreamMetadataFormatNames。长度为0的数组是归一化 null。

extraStreamMetadataFormatClassNames - Strings，数组或 null，用来实例化一个元数据格式对象被返回 getStreamMetadataFormat。长度为0的数组是归一化 null。

supportsStandardImageMetadataFormat - boolean指示图像元数据对象可以使用标准的元数据格式描述的树。

nativeImageMetadataFormatName - String，或 null，归还从 getNativeImageMetadataFormatName。

nativeImageMetadataFormatClassName - String，或 null，用来实例化一个元数据格式对象被返回 getNativeImageMetadataFormat。

extraImageMetadataFormatNames - Strings归还从 getExtraImageMetadataFormatNames数组，数组长度为0的归一化 null。

extraImageMetadataFormatClassNames - Strings，数组或 null，用来实例化一个元数据格式对象被返回 getImageMetadataFormat。长度为0的数组是归一化 null。

异常

如果是 null vendorName IllegalArgumentException。

如果是 null version IllegalArgumentException。

IllegalArgumentException -如果 names是 null或长度为0。

如果是 null pluginClassName IllegalArgumentException。

ImageReaderWriterSpi

public ImageReaderWriterSpi()

建立一个空白 ImageReaderWriterSpi。它是由子类初始化实例变量和/或重写方法实现，以提供所有方法的工作版本。

方法详细信息

getFormatNames

public String[] getFormatNames()

返回包含可读的名字，一般都是可用的 ImageReader或 ImageWriter实现这个服务提供商相关的格式 Strings数组。例如，一个单一的 ImageReader能够处理PBM和PNM文件。

结果

非 null数组长度至少为1 Strings或含非正式格式的名称与此相关的读者或作家。

getFileSuffixes

public String[] getFileSuffixes()

返回包含列表文件后缀，通常可用的 ImageReader或 ImageWriter实现这个服务提供商相关的格式关联 Strings数组。例如，一个单一的 ImageReader可能无法处理文件，PBM '和'。PNM”后缀，或“。JPG和JPEG的后缀。如果没有已知文件的后缀， null将返回。

返回一个特定的后缀不保证，后缀的文件可以被处理，它只是表明，它可能是值得尝试解码或编码这样的文件，使用这个服务提供商。

结果

对 Strings或长度至少1含有常见的文件后缀与读者或作家关联数组，或 null。

getMIMETypes

public String[] getMIMETypes()

返回包含一个MIME类型的列表，通常可用的 ImageReader或 ImageWriter实现这个服务提供商相关的格式关联 Strings数组。

理想的情况是，只有一个单一的MIME类型将需要以描述一个特定的格式。然而，有几个原因，有必要将一个类型的列表与每个服务提供程序关联。首先，许多常见的图像文件格式不标准的MIME类型，那么一组常用的非官方名称是必需的，如image/x-pbm和image/x-portable-bitmap。一些文件格式的MIME类型，但有时可能是官方称使用他们以前的非官方名称，如不是官方image/png image/x-png。最后，一个单一的服务提供商能够解析多个不同类型的MIME点，例如image/x-xbitmap和image/x-xpixmap。

返回一个特定MIME类型并不能保证文件声称是该类型可以处理；它只是表明，它可能是值得尝试解码或编码的文件使用此服务提供商。

结果

对 Strings或长度至少1包含MIME类型与读者或作家关联数组，或 null。

getPluginClassName

public String getPluginClassName()

返回完全限定类名的 ImageReader或 ImageWriter插件与该服务提供商的相关。

结果

类的名称，作为一个非 null String。

isStandardStreamMetadataFormatSupported

public boolean isStandardStreamMetadataFormatSupported()

返回 true如果标准元数据格式的文件格式，通过这个插件产生或消耗流元数据对象和方法之间的 getAsTree setFromTree认可。

结果

true如果标准格式是数据流的支持。

getNativeStreamMetadataFormatName

public String getNativeStreamMetadataFormatName()

返回此插件的“本地”流元数据格式的名称，它通常允许存储在由该插件处理的格式中的流元数据的无损编码和传输。如果没有这种格式的支持， nullwill回来。

默认的实现返回nativeStreamMetadataFormatName实例变量，它通常是由构造函数设置。

结果

本机数据流格式的名称，或 null。

getExtraStreamMetadataFormatNames

public String[] getExtraStreamMetadataFormatNames()

返回包含附加的文件格式的名称 Strings数组，除了本地和标准格式，通过这个插件产生或消耗数据流对象的 getAsTree和 setFromTree方法确认。

如果插件不处理元数据，将返回空值。

根据读取或写入的特定图像，格式的集合可能会有所不同；此方法应在任何情况下都应显示插件所支持的所有附加格式。

默认实现将返回的extraStreamMetadataFormatNames实例变量的一个克隆，这通常是由构造函数设置。

结果

对 Strings数组，或空。

另请参见：

IIOMetadata.getMetadataFormatNames()， getExtraImageMetadataFormatNames()， getNativeStreamMetadataFormatName()

isStandardImageMetadataFormatSupported

public boolean isStandardImageMetadataFormatSupported()

返回 true如果标准元数据格式的文件格式，通过对生产或通过这个插件消耗的图像元数据对象和方法之间的 getAsTree setFromTree认可。

结果

true如果标准格式的图像元数据的支持。

getNativeImageMetadataFormatName

public String getNativeImageMetadataFormatName()

返回此插件的“本地”图像元数据格式的名称，通常允许存储在由该插件处理的格式的图像元数据的无损编码和传输。如果没有这种格式的支持， nullwill回来。

默认的实现返回nativeImageMetadataFormatName实例变量，它通常是由构造函数设置。

结果

本机映像元数据格式的名称，或 null。

另请参见：

getExtraImageMetadataFormatNames()

getExtraImageMetadataFormatNames

public String[] getExtraImageMetadataFormatNames()

返回包含附加的文件格式的名称 Strings数组，除了本地和标准格式，通过对生产或通过这个插件消耗的图像元数据对象的 getAsTree和 setFromTree方法确认。

如果插件不处理图像元数据，将返回空值。

根据读取或写入的特定图像，格式的集合可能会有所不同；此方法应在任何情况下都应显示插件所支持的所有附加格式。

默认实现将返回的extraImageMetadataFormatNames实例变量的一个克隆，这通常是由构造函数设置。

结果

对 Strings数组，或空。

另请参见：

IIOMetadata.getMetadataFormatNames()， getExtraStreamMetadataFormatNames()， getNativeImageMetadataFormatName()

getStreamMetadataFormat

public IIOMetadataFormat getStreamMetadataFormat(String formatName)

返回描述给定流元数据格式的 IIOMetadataFormat对象，或 null如果没有合适的描述。提供的名称必须是本地的数据流格式名称，标准的元数据格式名称，或者返回 getExtraStreamMetadataFormatNames。

参数

formatName -所需的数据流格式。

结果

一个 IIOMetadataFormat对象。

异常

IllegalArgumentException -如果 formatName是 null或不受支持的名称。

getImageMetadataFormat

public IIOMetadataFormat getImageMetadataFormat(String formatName)

返回一个 IIOMetadataFormat对象描述给定图像的元数据格式，或 null如果没有合适的描述。提供的名称必须是本地的图像元数据格式名称，标准的元数据格式名称，或者返回 getExtraImageMetadataFormatNames。

参数

formatName -所需的图像元数据格式。

结果

一个 IIOMetadataFormat对象。

异常

IllegalArgumentException -如果 formatName是 null或不受支持的名称。