- java.lang.Object
-
- javax.imageio.spi.IIOServiceProvider
-
- javax.imageio.spi.ImageReaderWriterSpi
-
- 实现的所有接口
-
RegisterableService
- 已知直接子类:
-
ImageReaderSpi
,ImageWriterSpi
public abstract class ImageReaderWriterSpi extends IIOServiceProvider
包含ImageReaderSpi
和ImageWriterSpi
实例变量和方法的超类。- 另请参见:
-
IIORegistry
,ImageReaderSpi
,ImageWriterSpi
-
-
字段汇总
字段 变量和类型 字段 描述 protected String[]
extraImageMetadataFormatClassNames
一个String
的数组,包含此插件支持的任何其他图像元数据格式的类名,最初为null
。protected String[]
extraImageMetadataFormatNames
包含此插件支持的任何其他图像元数据格式名称的String
数组,最初为null
。protected String[]
extraStreamMetadataFormatClassNames
包含此插件支持的任何其他流元数据格式的类名的String
数组,最初为null
。protected String[]
extraStreamMetadataFormatNames
一个String
的数组,包含此插件支持的任何其他流元数据格式的名称,最初为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
。-
声明的属性在类 javax.imageio.spi.IIOServiceProvider
vendorName, version
-
-
构造方法摘要
构造方法 构造器 描述 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
。
-
方法摘要
所有方法 实例方法 具体的方法 变量和类型 方法 描述 String[]
getExtraImageMetadataFormatNames()
返回String
的数组,String
包含getAsTree
和setFromTree
方法在此插件生成或使用的图像元数据对象上识别的其他文档格式的名称(本机格式和标准格式getAsTree
。String[]
getExtraStreamMetadataFormatNames()
返回String
的数组,String
包含由此插件生成或使用的流元数据对象上的getAsTree
和setFromTree
方法识别的其他文档格式(本机格式和标准格式getAsTree
setFromTree
。String[]
getFileSuffixes()
返回一个String
的数组,String
包含与通常与此服务提供者关联的ImageReader
或ImageWriter
实现可使用的格式相关联的文件后缀列表。String[]
getFormatNames()
返回String
的数组,String
包含通常可由与此服务提供程序关联的ImageReader
或ImageWriter
实现使用的格式的可读名称。IIOMetadataFormat
getImageMetadataFormat(String formatName)
返回一个IIOMetadataFormat
对象描述给定的图像的元数据格式,或null
如果没有可用的描述。String[]
getMIMETypes()
返回一个String
的数组,String
包含与通常可与此服务提供者关联的ImageReader
或ImageWriter
实现使用的格式关联的MIME类型列表。String
getNativeImageMetadataFormatName()
返回此插件的“本机”图像元数据格式的名称,该格式通常允许无损编码和传输以此插件处理的格式存储的图像元数据。String
getNativeStreamMetadataFormatName()
返回此插件的“本机”流元数据格式的名称,该格式通常允许无损编码和传输以此插件处理的格式存储的流元数据。String
getPluginClassName()
返回与此服务提供者关联的ImageReader
或ImageWriter
插件的完全限定类名。IIOMetadataFormat
getStreamMetadataFormat(String formatName)
返回一个IIOMetadataFormat
对象描述给定的流元数据格式,或null
如果没有可用的描述。boolean
isStandardImageMetadataFormatSupported()
如果标准元数据格式是由此插件生成或使用的图像元数据对象上的getAsTree
和setFromTree
方法识别的文档格式之一,则返回true
。boolean
isStandardStreamMetadataFormatSupported()
如果标准元数据格式是由此插件生成或使用的流元数据对象上的getAsTree
和setFromTree
方法识别的文档格式之一,则返回true
。-
声明方法的类 javax.imageio.spi.IIOServiceProvider
getDescription, getVendorName, getVersion, onDeregistration, onRegistration
-
-
-
-
字段详细信息
-
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
一个String
的数组,包含此插件支持的任何其他流元数据格式的名称,最初为null
。
-
extraStreamMetadataFormatClassNames
protected String[] extraStreamMetadataFormatClassNames
一个String
的数组,包含此插件支持的任何其他流元数据格式的类名,最初为null
。
-
supportsStandardImageMetadataFormat
protected boolean supportsStandardImageMetadataFormat
一个布尔值,指示此插件是否支持图像元数据的标准元数据格式,最初为false
。
-
nativeImageMetadataFormatName
protected String nativeImageMetadataFormatName
甲String
包含此插件,最初支持的本地流元数据格式的名称null
。
-
nativeImageMetadataFormatClassName
protected String nativeImageMetadataFormatClassName
甲String
包含此插件,最初支持的本地流元数据格式的类名称null
。
-
extraImageMetadataFormatNames
protected String[] extraImageMetadataFormatNames
一个String
的数组,包含此插件支持的任何其他图像元数据格式的名称,最初为null
。
-
extraImageMetadataFormatClassNames
protected String[] extraImageMetadataFormatClassNames
一个String
的数组,包含此插件支持的任何其他图像元数据格式的类名,最初为null
。
-
-
构造方法详细信息
-
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
- 非null
数组,String
指示格式名称的String
。 必须至少有一个条目。 -
suffixes
-的阵列String
指示常用文件后缀。 如果未定义后缀,则应提供null
。 长度为0的数组将标准化为null
。 -
MIMETypes
- 指示格式的MIME类型的String
数组。 如果未定义MIME类型,则应提供null
。 长度为0的数组将标准化为null
。 -
pluginClassName
- 关联的ImageReader
或ImageWriter
类的完全限定名称,作为非null String
。 -
supportsStandardStreamMetadataFormat
-boolean
,指示流元数据对象是否可以使用标准元数据格式描述的树。 -
nativeStreamMetadataFormatName
-一个String
,或null
,从返回getNativeStreamMetadataFormatName
。 -
nativeStreamMetadataFormatClassName
-String
或null
,用于实例化要从getNativeStreamMetadataFormat
返回的元数据格式对象。 -
extraStreamMetadataFormatNames
-的阵列String
S或null
从返回,getExtraStreamMetadataFormatNames
。 长度为0的数组规范化为null
。 -
extraStreamMetadataFormatClassNames
- 一个String
s或null
的数组,用于实例化要从getStreamMetadataFormat
返回的元数据格式对象。 长度为0的数组规范化为null
。 -
supportsStandardImageMetadataFormat
-boolean
,指示图像元数据对象是否可以使用标准元数据格式描述的树。 -
nativeImageMetadataFormatName
-一个String
,或null
,从返回getNativeImageMetadataFormatName
。 -
nativeImageMetadataFormatClassName
-String
或null
,用于实例化从getNativeImageMetadataFormat
返回的元数据格式对象。 -
extraImageMetadataFormatNames
-的阵列String
从返回小号getExtraImageMetadataFormatNames
。 长度为0的数组规范化为null
。 -
extraImageMetadataFormatClassNames
- 一个String
s或null
的数组,用于实例化从getImageMetadataFormat
返回的元数据格式对象。 长度为0的数组规范化为null
。 - 异常
-
IllegalArgumentException
- 如果vendorName
是null
。 -
IllegalArgumentException
- 如果version
是null
。 -
IllegalArgumentException
- 如果names
是null
或者长度为0。 -
IllegalArgumentException
- 如果pluginClassName
是null
。
-
ImageReaderWriterSpi
public ImageReaderWriterSpi()
构造一个空白ImageReaderWriterSpi
。 由子类来初始化实例变量和/或覆盖方法实现,以便提供所有方法的工作版本。
-
-
方法详细信息
-
getFormatNames
public String[] getFormatNames()
返回String
的数组,String
包含通常可由与此服务提供程序关联的ImageReader
或ImageWriter
实现使用的格式的可读名称。 例如,单个ImageReader
可能能够处理PBM和PNM文件。- 结果
-
非
null
数组String
或长度至少为1,包含与此阅读器或String
器关联的非正式格式名称。
-
getFileSuffixes
public String[] getFileSuffixes()
返回一个String
的数组,String
包含与通常与此服务提供者关联的ImageReader
或ImageWriter
实现可用的格式相关联的文件后缀列表。 例如,单个ImageReader
可能能够处理带有'.pbm'和'.pnm'后缀,或者'.jpg'和'.jpeg'后缀的文件。 如果没有已知的文件后缀,则将返回null
。返回特定后缀并不能保证可以处理具有该后缀的文件; 它仅表示尝试使用此服务提供程序解码或编码此类文件可能是值得的。
- 结果
-
包含与此读取器或写入器关联的公共文件后缀的
String
或长度至少为1的数组,或null
。
-
getMIMETypes
public String[] getMIMETypes()
返回一个String
的数组,String
包含与通常可与此服务提供者关联的ImageReader
或ImageWriter
实现使用的格式关联的MIME类型列表。理想情况下,为了描述特定格式,只需要一种MIME类型。 但是,由于多种原因,有必要将类型列表与每个服务提供商相关联。 首先,许多常见的图像文件格式没有标准的MIME类型,因此需要使用常用的非官方名称列表,例如
image/x-pbm
和image/x-portable-bitmap
。 某些文件格式具有官方MIME类型,但有时可能会使用之前的非官方指定来引用,例如image/x-png
而不是官方image/png
。 最后,单个服务提供者可能能够从MIME的角度解析多个不同类型,例如image/x-xbitmap
和image/x-xpixmap
。返回特定的MIME类型并不能保证可以处理声称属于该类型的文件; 它仅表示尝试使用此服务提供程序解码或编码此类文件可能是值得的。
- 结果
-
包含与此读取器或写入程序关联的MIME类型的
String
s或长度至少为1的数组,或null
。
-
getPluginClassName
public String getPluginClassName()
返回与此服务提供者关联的ImageReader
或ImageWriter
插件的完全限定类名。- 结果
-
类名称,非
null
String
。
-
isStandardStreamMetadataFormatSupported
public boolean isStandardStreamMetadataFormatSupported()
如果标准元数据格式是由此插件生成或使用的流元数据对象上的getAsTree
和setFromTree
方法识别的文档格式之一,则返回true
。- 结果
-
true
如果流元数据支持标准格式。
-
getNativeStreamMetadataFormatName
public String getNativeStreamMetadataFormatName()
返回此插件的“本机”流元数据格式的名称,该格式通常允许无损编码和传输以此插件处理的格式存储的流元数据。 如果不支持此类格式,则将返回null
。默认实现返回
nativeStreamMetadataFormatName
实例变量,该变量通常由构造函数设置。- 结果
-
本地流元数据格式的名称,或
null
。
-
getExtraStreamMetadataFormatNames
public String[] getExtraStreamMetadataFormatNames()
返回String
的数组,String
包含由本插件生成或使用的流元数据对象上的getAsTree
和setFromTree
方法识别的除本机和标准格式之外的其他文档格式的名称。如果插件不处理元数据,则应返回null。
格式集可以根据读取或写入的特定图像而不同; 此方法应指示插件在任何情况下支持的所有其他格式。
默认实现返回
extraStreamMetadataFormatNames
实例变量的克隆,该变量通常由构造函数设置。- 结果
-
一个
String
s的数组,或null。 - 另请参见:
-
IIOMetadata.getMetadataFormatNames()
,getExtraImageMetadataFormatNames()
,getNativeStreamMetadataFormatName()
-
isStandardImageMetadataFormatSupported
public boolean isStandardImageMetadataFormatSupported()
如果标准元数据格式是由此插件生成或使用的图像元数据对象上的getAsTree
和setFromTree
方法识别的文档格式之一,则返回true
。- 结果
-
true
如果图像元数据支持标准格式。
-
getNativeImageMetadataFormatName
public String getNativeImageMetadataFormatName()
返回此插件的“本机”图像元数据格式的名称,该格式通常允许无损编码和传输以此插件处理的格式存储的图像元数据。 如果不支持此类格式,则将返回null
。默认实现返回
nativeImageMetadataFormatName
实例变量,该变量通常由构造函数设置。- 结果
-
本机映像元数据格式的名称,或
null
。 - 另请参见:
-
getExtraImageMetadataFormatNames()
-
getExtraImageMetadataFormatNames
public String[] getExtraImageMetadataFormatNames()
返回String
的数组,String
包含getAsTree
和setFromTree
方法在此插件生成或使用的图像元数据对象上识别的其他文档格式的名称(本机格式和标准格式getAsTree
。如果插件不处理图像元数据,则应返回null。
格式集可以根据读取或写入的特定图像而不同; 此方法应指示插件在任何情况下支持的所有其他格式。
默认实现返回
extraImageMetadataFormatNames
实例变量的克隆,该变量通常由构造函数设置。- 结果
-
一个
String
的数组,或null。 - 另请参见:
-
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
或者不是受支持的名称。
-
-