Module java.desktop
Package javax.imageio.spi

Class IIOServiceProvider

java.lang.Object
javax.imageio.spi.IIOServiceProvider
所有已实现的接口:
RegisterableService
直接已知的子类:
ImageInputStreamSpi, ImageOutputStreamSpi, ImageReaderWriterSpi, ImageTranscoderSpi
public abstract class IIOServiceProvider extends Object implements RegisterableService
一个超接口，包含所有Image I/O服务提供者接口（SPIs）共有的功能。有关服务提供者类的更多信息，请参阅IIORegistry类的类注释。
参见:

  • Field Details

    • vendorName

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

    • version

      protected String version
      一个String，将从getVersion返回，最初为null。构造函数应将其设置为非null值。

  • Constructor Details

    • IIOServiceProvider

      public IIOServiceProvider(String vendorName, String version)
      用给定的供应商名称和版本标识符构造一个IIOServiceProvider。
      参数:
      vendorName - 供应商名称。
      version - 版本标识符。
      抛出:
      IllegalArgumentException - 如果vendorName为null。
      IllegalArgumentException - 如果version为null。

    • IIOServiceProvider

      public IIOServiceProvider()
      构造一个空白的IIOServiceProvider。子类应初始化实例变量和/或覆盖方法实现，以确保getVendorName和getVersion方法将返回非null值。

  • Method Details

    • 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。
      返回:
      包含此服务提供者描述的String。