当前页面: 在线文档首页 > JavaTM 2 Platform Standard Edition 5.0 API 规范中文版

IIOServiceProvider (Java 2 Platform SE 5.0) - JavaTM 2 Platform Standard Edition 5.0 API 规范中文版

概述  软件包   类  使用  树  已过时  索引  帮助		JavaTM 2 Platform Standard Ed. 5.0
上一个类   下一个类	框架    无框架
摘要： 嵌套 | 字段 | 构造方法 | 方法	详细信息： 字段 | 构造方法 | 方法

---

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。

---

概述  软件包   类  使用  树  已过时  索引  帮助		JavaTM 2 Platform Standard Ed. 5.0
上一个类   下一个类	框架    无框架
摘要： 嵌套 | 字段 | 构造方法 | 方法	详细信息： 字段 | 构造方法 | 方法

---

提交错误或意见
有关更多的 API 参考资料和开发人员文档，请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述，以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。