javax.imageio.spi
类 IIOServiceProvider

java.lang.Object
  javax.imageio.spi.IIOServiceProvider

所有已实现的接口：

RegisterableService

直接已知子类：

ImageInputStreamSpi, ImageOutputStreamSpi, ImageReaderWriterSpi, ImageTranscoderSpi

public abstract class IIOServiceProvider
extends Object
implements RegisterableService

一个常用于所有 Image I/O 服务提供者接口 (SPI) 的功能性超接口。有关服务提供者类的更多信息，请参见 IIORegistry 类的注释。

另请参见：

IIORegistry, ImageReaderSpi, ImageWriterSpi, ImageTranscoderSpi, ImageInputStreamSpi

字段摘要

protected String	vendorName 将从 getVendorName 返回的一个 String，初始值为 null。
protected String	version 将从 getVersion 返回的一个 String，初始值为 null。

构造方法摘要

IIOServiceProvider()
构造一个空的 IIOServiceProvider。

IIOServiceProvider(String vendorName, String version)
构造一个具有给定供应商名称和版本标识符的 IIOServiceProvider。

方法摘要

abstract String	getDescription(Locale locale) 返回此服务提供者及其相关实现的一个简明的可读描述。
String	getVendorName() 返回负责创建此服务提供者及其相关实现的供应商名称。
String	getVersion() 返回描述此服务提供者版本号及其相关实现的字符串。
void	onDeregistration(ServiceRegistry registry, Class<?> category) Spi 类一从 ServiceRegistry 中注销即执行的回调。
void	onRegistration(ServiceRegistry registry, Class<?> category) 在 ServiceRegistry 中实例化和注册 Spi 类后即执行的回调。

从类 java.lang.Object 继承的方法

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

字段详细信息

vendorName

protected String vendorName

将从 getVendorName 返回的一个 String，初始值为 null。构造方法应将此字符串设置为一个非 null 的值。

version

protected String version

将从 getVersion 返回的一个 String，初始值为 null。构造方法应将此字符串设置为一个非 null 的值。

构造方法详细信息

IIOServiceProvider

public IIOServiceProvider(String vendorName,
                          String version)

构造一个具有给定供应商名称和版本标识符的 IIOServiceProvider。

参数：

vendorName - 供应商名称。

version - 版本标识符。

抛出：

IllegalArgumentException - 如果 vendorName 为 null。

IllegalArgumentException - 如果 version 为 null。

IIOServiceProvider

public IIOServiceProvider()

构造一个空的 IIOServiceProvider。为确保 getVendorName 和 getVersion 方法返回非 null 值，子类需负责初始化实例变量和/或重写方法实现。

方法详细信息

onRegistration

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

在 ServiceRegistry 中实例化和注册 Spi 类后即执行的回调。可用它来验证环境是否适合此服务，例如验证本地库是否可加载。如果服务无法在找到其自身的环境中正常工作，则它将从注册表中取消其自身的注册。

此方法只应由注册表调用。

默认实现不执行任何操作。

指定者：

接口 RegisterableService 中的 onRegistration

参数：

registry - 此对象已注册的 ServiceRegistry 位置。

category - 指示此对象注册所在的注册表类别的 Class 对象。

另请参见：

ServiceRegistry.registerServiceProvider(Object provider)

onDeregistration

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

Spi 类一从 ServiceRegistry 中注销即执行的回调。

此方法只应由注册表调用。

默认实现不执行任何操作。

指定者：

接口 RegisterableService 中的 onDeregistration

参数：

registry - 从其（部分或完全）注销此对象的 ServiceRegistry。

category - 指示此对象从其注销的注册表类别的 Class 对象。

另请参见：

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。