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。