模块 java.desktop
包 javax.imageio.spi

类 IIOServiceProvider

java.lang.Object
javax.imageio.spi.IIOServiceProvider
所有已实现的接口：
RegisterableService
已知子类：
ImageInputStreamSpi , ImageOutputStreamSpi , ImageReaderWriterSpi , ImageTranscoderSpi
public abstract class IIOServiceProvider extends Object implements RegisterableService
所有图像 I/O 服务提供程序接口 (SPI) 通用功能的超级接口。有关服务提供者类的更多信息，请参阅 IIORegistry 类的类注解。
参见：

  • 字段详细信息

    • vendorName

      protected String  vendorName
      从 getVendorName 返回的 String，最初是 null。构造函数应将其设置为非 null 值。

    • version

      protected String  version
      从 getVersion 返回的 String，最初为空。构造函数应将其设置为非 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 中注册后将调用一次的回调。这可用于验证环境是否适合此服务，例如是否可以加载本机库。如果该服务无法在它所处的环境中运行，它应该从注册表中注销自己。

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

      默认实现什么都不做。

      指定者：
      onRegistration 在接口 RegisterableService 中
      参数：
      registry - 已注册此对象的 ServiceRegistry。
      category - 一个 Class 对象，指示该对象已注册的注册表类别。
      参见：

    • onDeregistration

      public void onDeregistration(ServiceRegistry  registry, Class <?> category)
      每当 Spi 类从 ServiceRegistry 中注销时都会发生的回调。

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

      默认实现什么都不做。

      指定者：
      onDeregistration 在接口 RegisterableService 中
      参数：
      registry - 一个 ServiceRegistry，该对象正在从中（全部或部分）注销。
      category - 一个 Class 对象，指示要从中注销此对象的注册表类别。
      参见：

    • getVendorName

      public String  getVendorName()
      返回负责创建此服务提供者及其关联实现的供应商的名称。因为供应商名称可能用于选择服务提供者，所以它没有本地化。

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

      返回：
      包含供应商名称的非null String。

    • getVersion

      public String  getVersion()
      返回描述此服务提供者及其相关实现的版本号的字符串。因为版本可能被转码器用来识别他们理解的服务提供者，所以这个方法没有本地化。

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

      返回：
      包含此服务提供商版本的非null String。

    • getDescription

      public abstract String  getDescription(Locale  locale)
      返回此服务提供者及其相关实现的简短的、人类可读的描述。如果可能，应将生成的字符串本地化为提供的 Locale。
      参数：
      locale - 一个 Locale，返回值应该被本地化。
      返回：
      a String 包含此服务提供商的描述。