- java.lang.Object
-
- javax.imageio.spi.IIOServiceProvider
-
- All Implemented Interfaces:
-
RegisterableService
public abstract class IIOServiceProvider extends Object implements RegisterableService
所有Image I / O服务提供商接口(SPI)通用功能的超级界面。 有关服务提供程序类的更多信息,请参阅IIORegistry
类的类注释。
-
-
Field Summary
Fields Modifier and Type Field 描述 protected String
vendorName
AString
从getVendorName
返回,最初为null
。protected String
version
AString
从getVersion
返回,最初为null。
-
构造方法摘要
构造方法 Constructor 描述 IIOServiceProvider()
构造一个空白IIOServiceProvider
。IIOServiceProvider(String vendorName, String version)
构造具有给定供应商名称和版本标识符的IIOServiceProvider
。
-
方法摘要
所有方法 接口方法 抽象方法 具体的方法 Modifier and Type 方法 描述 abstract String
getDescription(Locale locale)
返回此服务提供商及其相关实现的简短可读的描述。String
getVendorName()
返回负责创建此服务提供商及其关联实施的供应商的名称。String
getVersion()
返回描述此服务提供商及其关联实现的版本号的字符串。void
onDeregistration(ServiceRegistry registry, Class<?> category)
每当Spi课程已从ServiceRegistry
注销时,将会回调。void
onRegistration(ServiceRegistry registry, Class<?> category)
在Spi类已被实例化并在ServiceRegistry
注册后,将被调用一次的ServiceRegistry
。
-
-
-
构造方法详细信息
-
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
注册后,将被调用一次的ServiceRegistry
。 这可以用于验证环境是否适合此服务,例如可以加载本机库。 如果服务在找到自己的环境中无法运行,则应该从注册表中注销自身。只有注册表应该调用这个方法。
默认实现什么都不做。
- Specified by:
-
onRegistration
在接口RegisterableService
- 参数
-
registry
- aServiceRegistry
其中该对象已注册。 -
category
- 一个Class
对象,指示已注册该对象的注册表类别。 - 另请参见:
-
ServiceRegistry.registerServiceProvider(Object provider)
-
onDeregistration
public void onDeregistration(ServiceRegistry registry, Class<?> category)
每当Spi课程从ServiceRegistry
注销时,这个ServiceRegistry
。只有注册表应该调用这个方法。
默认实现什么都不做。
- Specified by:
-
onDeregistration
在接口RegisterableService
- 参数
-
registry
- 一个ServiceRegistry
从该对象正在(全部或部分)注销。 -
category
- 一个Class
对象,指示此对象正在注销的注册表类别。 - 另请参见:
-
ServiceRegistry.deregisterServiceProvider(Object provider)
-
getVendorName
public String getVendorName()
返回负责创建此服务提供商及其关联实施的供应商的名称。 由于供应商名称可能用于选择服务提供商,因此它未被本地化。默认实现返回值为
vendorName
实例变量。- 结果
-
一个非
null String
包含供应商的名称。
-
getVersion
public String getVersion()
返回描述此服务提供商及其关联实现的版本号的字符串。 由于代码转换器可能会使用该版本来识别他们所理解的服务提供商,因此此方法不进行本地化。默认实现返回值为
version
实例变量。- 结果
-
一个非
null String
包含该服务提供商的版本。
-
-