javax.imageio.spi

Class IIOServiceProvider

java.lang.Object

javax.imageio.spi.IIOServiceProvider

All Implemented Interfaces:

RegisterableService

已知直接子类：

ImageInputStreamSpi， ImageOutputStreamSpi， ImageReaderWriterSpi， ImageTranscoderSpi

public abstract class IIOServiceProvider
extends Object
implements RegisterableService

一个对所有图像I/O服务提供者接口（SPI接口）通用功能超。对服务类的更多信息，见的 IIORegistry类类的评论。

另请参见：

IIORegistry， ImageReaderSpi， ImageWriterSpi， ImageTranscoderSpi， ImageInputStreamSpi

Field Summary

Fields

Modifier and Type	Field and Description
protected String	vendorName 一个 String归还从 getVendorName，最初 null。
protected String	version 一个 String归还从 getVersion，最初为空。

构造方法摘要

构造方法

Constructor and Description
IIOServiceProvider() 建立一个空白 IIOServiceProvider。
IIOServiceProvider(String vendorName, String version) 构建了一个 IIOServiceProvider与特定供应商的名称和版本标识符。

方法摘要

Modifier and Type	Method and Description
abstract String	getDescription(Locale locale) 返回此服务提供程序的简短、可读的描述及其相关实现。
String	getVendorName() 返回创建此服务提供程序的供应商的名称及其相关实现。
String	getVersion() 返回描述此服务提供程序的版本号和相关实现的字符串。
void	onDeregistration(ServiceRegistry registry, 类<?> category) 一个回调函数，将当SPI类已经从一个 ServiceRegistry注销。
void	onRegistration(ServiceRegistry registry, 类<?> category) 这将是一次回调后SPI类被实例化，在 ServiceRegistry注册地叫。

Methods inherited from class java.lang.Object

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

Field Detail

vendorName

protected String vendorName

一个 String归还从 getVendorName，最初 null。构造函数应该设置为一个非 null价值。

version

protected String version

一个 String归还从 getVersion，最初为空。构造函数应该设置为一个非 null价值。

Constructor Detail

IIOServiceProvider

public IIOServiceProvider(String vendorName,
                          String version)

构建了一个 IIOServiceProvider与特定供应商的名称和版本标识符。

参数

vendorName -供应商名称。

version -版本标识符。

异常

如果是 null vendorName IllegalArgumentException。

如果是 null version IllegalArgumentException。

IIOServiceProvider

public IIOServiceProvider()

建立一个空白 IIOServiceProvider。它的子类来初始化实例变量和/或重写方法的实现，以确保 getVendorName和 getVersion方法将返回非 null值。

方法详细信息

onRegistration

public void onRegistration(ServiceRegistry registry,
                           类<?> category)

这将是一次回调后SPI类被实例化，在 ServiceRegistry注册地叫。这可能是用来验证环境是适合于此服务的，例如，本地库可以加载。如果在环境中，它发现自己的服务无法运转，应注销本身从注册表。

只有注册表应该调用此方法。

默认实现不做任何事。

Specified by:

onRegistration 接口 RegisterableService

参数

registry - ServiceRegistry该对象已被注册。

category - 类指示下注册表类此对象已注册。

另请参见：

ServiceRegistry.registerServiceProvider(Object provider)

onDeregistration

public void onDeregistration(ServiceRegistry registry,
                             类<?> category)

一个回调函数，将当SPI类已经从一个 ServiceRegistry注销。

只有注册表应该调用此方法。

默认实现不做任何事。

Specified by:

onDeregistration 接口 RegisterableService

参数

registry - ServiceRegistry从该对象被（全部或部分）注销。

category - 类指示注册表类的对象被注销。

另请参见：

ServiceRegistry.deregisterServiceProvider(Object provider)

getVendorName

public String getVendorName()

返回创建此服务提供程序的供应商的名称及其相关实现。因为供应商名称可以用来选择服务提供程序，所以它不是本地化的。

默认实现将返回的vendorName实例变量的值。

结果

非 null String包含供应商名称。

getVersion

public String getVersion()

返回描述此服务提供程序的版本号和相关实现的字符串。因为版本可能被转码器识别服务提供商他们的理解，这种方法并不局限。

默认实现将返回的version实例变量的值。

结果

非 null String包含此服务提供程序的版本。

getDescription

public abstract String getDescription(Locale locale)

返回此服务提供程序的简短、可读的描述及其相关实现。结果字符串应为提供 Locale本地化，如果可能的话。

参数

locale - Locale，返回值应该是本地化。

结果

一个 String包含描述该服务提供商。