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

Field Summary

Fields

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

构造方法摘要

构造方法

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中 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,
                           类<?> 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包含该服务提供商的描述。