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 - 如果 vendorNamenull
IllegalArgumentException - 如果 versionnull

IIOServiceProvider

public IIOServiceProvider()
构造一个空的 IIOServiceProvider。为确保 getVendorNamegetVersion 方法返回非 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 实例变量的值。

返回:
包含供应商名称的一个非 nullString

getVersion

public String getVersion()
返回描述此服务提供程序版本号及其相关实现的字符串。版本可能由代码转换程序用来标识它们所理解的服务提供程序,因此不对此方法本地化。

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

返回:
包含此服务提供程序的版本的一个非 nullString

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. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策