Module java.desktop

软件包 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

所有Image I / O服务提供商接口（SPI）通用功能的超级界面。 有关服务提供程序类的更多信息，请参阅IIORegistry类的类注释。

另请参见：

IIORegistry ， ImageReaderSpi ， ImageWriterSpi ， ImageTranscoderSpi ， ImageInputStreamSpi ， ImageOutputStreamSpi

Field Summary

Fields

Modifier and Type	Field	描述
protected String	vendorName	A String从 getVendorName返回，最初为 null 。
protected String	version	A String从 getVersion返回，最初为null。

构造方法摘要

构造方法

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

方法摘要

Modifier and Type	方法	描述
abstract String	getDescription(Locale locale)	返回此服务提供商及其相关实现的简短可读的描述。
String	getVendorName()	返回负责创建此服务提供商及其关联实施的供应商的名称。
String	getVersion()	返回描述此服务提供商及其关联实现的版本号的字符串。
void	onDeregistration(ServiceRegistry registry, Class<?> category)	每当Spi课程已从 ServiceRegistry注销时，将会回调。
void	onRegistration(ServiceRegistry registry, Class<?> category)	在Spi类已被实例化并在 ServiceRegistry注册后，将被调用一次的 ServiceRegistry 。

Methods inherited from class java.lang.Object

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

字段详细信息

vendorName

protected String vendorName

A String从getVendorName返回，最初为null 。 构造函数应该将其设置为非null值。

version

protected String version

A String从getVersion返回，最初为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)

在Spi类被实例化并在ServiceRegistry注册后，将被调用一次的ServiceRegistry 。 这可以用于验证环境是否适合此服务，例如可以加载本机库。 如果服务在找到自己的环境中无法运行，则应该从注册表中注销自身。

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

默认实现什么都不做。

Specified by:

onRegistration在接口 RegisterableService

参数

registry - a ServiceRegistry其中该对象已注册。

category - 一个 Class对象，指示已注册该对象的注册表类别。

另请参见：

ServiceRegistry.registerServiceProvider(Object provider)

onDeregistration

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

每当Spi课程从ServiceRegistry注销时，这个ServiceRegistry 。

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

默认实现什么都不做。

Specified by:

onDeregistration在接口 RegisterableService

参数

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 - 一个 Locale ，返回值应该对其进行本地化。

结果

a String包含此服务提供商的描述。