javax.imageio.spi
類別 ImageReaderWriterSpi

java.lang.Object
  javax.imageio.spi.IIOServiceProvider
      javax.imageio.spi.ImageReaderWriterSpi

所有已實作的介面：

RegisterableService

直接已知子類別：

ImageReaderSpi, ImageWriterSpi

public abstract class ImageReaderWriterSpi
extends IIOServiceProvider

包含 ImageReaderSpi 和 ImageWriterSpi 常用實例變數和方法的一個父級類別。

另請參見：

IIORegistry, ImageReaderSpi, ImageWriterSpi

欄位摘要

protected String[]	extraImageMetadataFormatClassNames 包含此外掛程式支持的其他任何圖像元資料格式的類別名稱的 String 陣列，該陣列最初為 null。
protected String[]	extraImageMetadataFormatNames 包含此外掛程式支持的其他任何圖像元資料格式的名稱的 String 陣列，該陣列最初為 null。
protected String[]	extraStreamMetadataFormatClassNames 包含此外掛程式支持的其他任何串流元資料格式的類別名稱的 String 陣列，該陣列最初為 null。
protected String[]	extraStreamMetadataFormatNames 包含此外掛程式支持的其他任何串流元資料格式的名稱的 String 陣列，該字元串最初為 null。
protected String[]	MIMETypes 從 getMIMETypes 返回的字元串陣列，該陣列最初為 null。
protected String[]	names 從 getFormatNames 返回的字元串陣列，該陣列最初為 null。
protected String	nativeImageMetadataFormatClassName 包含此外掛程式支持的本地串流元資料格式的類別名稱的 String，該字元串最初為 null。
protected String	nativeImageMetadataFormatName 包含此外掛程式支持的本地串流元資料格式名稱的 String，該字元串最初為 null。
protected String	nativeStreamMetadataFormatClassName 包含此外掛程式支持的本地串流元資料格式的類別名稱的 String，初始為 null。
protected String	nativeStreamMetadataFormatName 包含此外掛程式支持的本地串流元資料格式名稱的 String，該字元串最初為 null。
protected String	pluginClassName 包含關聯的外掛程式類別名稱的 String，該字元串最初為 null。
protected String[]	suffixes 從 getFileSuffixes 返回的字元串陣列，該陣列最初為 null。
protected boolean	supportsStandardImageMetadataFormat 指示此外掛程式是否支持圖像元資料的標準元資料格式的 boolean 值，該值最初為 false。
protected boolean	supportsStandardStreamMetadataFormat 指示此外掛程式是否支持串流元資料的標準元資料格式的 boolean 值，該值最初為 false。

從類別 javax.imageio.spi.IIOServiceProvider 繼承的欄位

vendorName, version

建構子摘要

ImageReaderWriterSpi()
建構一個空的 ImageReaderWriterSpi。

ImageReaderWriterSpi(String vendorName, String version, String[] names, String[] suffixes, String[] MIMETypes, String pluginClassName, boolean supportsStandardStreamMetadataFormat, String nativeStreamMetadataFormatName, String nativeStreamMetadataFormatClassName, String[] extraStreamMetadataFormatNames, String[] extraStreamMetadataFormatClassNames, boolean supportsStandardImageMetadataFormat, String nativeImageMetadataFormatName, String nativeImageMetadataFormatClassName, String[] extraImageMetadataFormatNames, String[] extraImageMetadataFormatClassNames)
用給定的一組值建構 ImageReaderWriterSpi。

方法摘要

String[]	getExtraImageMetadataFormatNames() 返回包含其他文檔格式名稱，而不是此外掛程式產生或使用的圖像元資料物件的 getAsTree 和 setFromTree 方法可識別的本地和標準格式的 String 陣列。
String[]	getExtraStreamMetadataFormatNames() 返回包含其他文檔格式名稱，而不是此外掛程式產生或使用的串流元資料物件的 getAsTree 和 setFromTree 方法可識別的本地和標準格式的 String 陣列。
String[]	getFileSuffixes() 返回一個套件含通常可由與此服務提供者關聯的 ImageReader 或 ImageWriter 實作所用格式所關聯檔案後綴列表的 String 陣列。
String[]	getFormatNames() 返回一個 String 陣列，該陣列包含通常由與此服務提供者關聯的 ImageReader 或 ImageWriter 實作使用的那些格式的可讀名稱。
IIOMetadataFormat	getImageMetadataFormat(String formatName) 返回描述給定的圖像元資料格式的 IIOMetadataFormat 物件，如果沒有可用的描述，則返回 null。
String[]	getMIMETypes() 返回一個 String 陣列，該陣列包含與通常由與此服務提供者關聯的 ImageReader 或 ImageWriter 實作使用的格式有關的 MIME 型別的列表。
String	getNativeImageMetadataFormatName() 返回此外掛程式的“本地”圖像元資料格式的名稱，它通常允許無損失地編碼或傳輸按照由此外掛程式處理的格式存儲的圖像元資料。
String	getNativeStreamMetadataFormatName() 返回此外掛程式的“本地”串流元資料格式的名稱，它通常允許無損失地編碼和傳輸按照由此外掛程式處理的格式存儲的串流元資料。
String	getPluginClassName() 返回與此服務提供者關聯的 ImageReader 或 ImageWriter 外掛程式的完全限定類別名稱。
IIOMetadataFormat	getStreamMetadataFormat(String formatName) 返回描述給定的串流元資料格式的 IIOMetadataFormat 物件，如果沒有可用的描述，則返回 null。
boolean	isStandardImageMetadataFormatSupported() 如果標準元資料格式為此外掛程式產生或使用的圖像元資料物件的 getAsTree 和 setFromTree 方法可識別的文檔格式之一，則返回 true。
boolean	isStandardStreamMetadataFormatSupported() 如果標準元資料格式是此外掛程式產生或使用的串流元資料物件的 getAsTree 和 setFromTree 方法能夠識別的文檔格式之一，則返回 true。

從類別 javax.imageio.spi.IIOServiceProvider 繼承的方法

getDescription, getVendorName, getVersion, onDeregistration, onRegistration

從類別 java.lang.Object 繼承的方法

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

欄位詳細資訊

names

protected String[] names

從 getFormatNames 返回的字元串陣列，該陣列最初為 null。建構子應將此字元串設置為一個非 null 值。

suffixes

protected String[] suffixes

從 getFileSuffixes 返回的字元串陣列，該陣列最初為 null。

MIMETypes

protected String[] MIMETypes

從 getMIMETypes 返回的字元串陣列，該陣列最初為 null。

pluginClassName

protected String pluginClassName

包含關聯的外掛程式類別名稱的 String，該字元串最初為 null。

supportsStandardStreamMetadataFormat

protected boolean supportsStandardStreamMetadataFormat

指示此外掛程式是否支持串流元資料的標準元資料格式的 boolean 值，該值最初為 false。

nativeStreamMetadataFormatName

protected String nativeStreamMetadataFormatName

包含此外掛程式支持的本地串流元資料格式名稱的 String，該字元串最初為 null。

nativeStreamMetadataFormatClassName

protected String nativeStreamMetadataFormatClassName

包含此外掛程式支持的本地串流元資料格式的類別名稱的 String，初始為 null。

extraStreamMetadataFormatNames

protected String[] extraStreamMetadataFormatNames

包含此外掛程式支持的其他任何串流元資料格式的名稱的 String 陣列，該字元串最初為 null。

extraStreamMetadataFormatClassNames

protected String[] extraStreamMetadataFormatClassNames

包含此外掛程式支持的其他任何串流元資料格式的類別名稱的 String 陣列，該陣列最初為 null。

supportsStandardImageMetadataFormat

protected boolean supportsStandardImageMetadataFormat

指示此外掛程式是否支持圖像元資料的標準元資料格式的 boolean 值，該值最初為 false。

nativeImageMetadataFormatName

protected String nativeImageMetadataFormatName

包含此外掛程式支持的本地串流元資料格式名稱的 String，該字元串最初為 null。

nativeImageMetadataFormatClassName

protected String nativeImageMetadataFormatClassName

包含此外掛程式支持的本地串流元資料格式的類別名稱的 String，該字元串最初為 null。

extraImageMetadataFormatNames

protected String[] extraImageMetadataFormatNames

包含此外掛程式支持的其他任何圖像元資料格式的名稱的 String 陣列，該陣列最初為 null。

extraImageMetadataFormatClassNames

protected String[] extraImageMetadataFormatClassNames

包含此外掛程式支持的其他任何圖像元資料格式的類別名稱的 String 陣列，該陣列最初為 null。

建構子詳細資訊

ImageReaderWriterSpi

public ImageReaderWriterSpi(String vendorName,
                            String version,
                            String[] names,
                            String[] suffixes,
                            String[] MIMETypes,
                            String pluginClassName,
                            boolean supportsStandardStreamMetadataFormat,
                            String nativeStreamMetadataFormatName,
                            String nativeStreamMetadataFormatClassName,
                            String[] extraStreamMetadataFormatNames,
                            String[] extraStreamMetadataFormatClassNames,
                            boolean supportsStandardImageMetadataFormat,
                            String nativeImageMetadataFormatName,
                            String nativeImageMetadataFormatClassName,
                            String[] extraImageMetadataFormatNames,
                            String[] extraImageMetadataFormatClassNames)

用給定的一組值建構 ImageReaderWriterSpi。

參數：

vendorName - 供應商名稱，它是一個非 null 的 String。

version - 版本標識符，它是一個非 null 的 String。

names - 指示格式名稱的一個非 null 的 String 陣列。必須至少有一個項。

suffixes - 指示常用檔案後綴的 String 陣列。如果未定義後綴，則應指定為 null。長度為 0 的陣列將被標準化為 null。

MIMETypes - 指示格式的 MIME 型別的 String 陣列。如果未定義 MIME 型別，則應指定為 null。長度為 0 的陣列將被標準化為 null。

pluginClassName - 所關聯的 ImageReader 或 ImageWriter 類別的完全限定名，它為一個非 null 的 String。

supportsStandardStreamMetadataFormat - 一個 boolean 值，指示串流元資料物件是否可使用由標準元資料格式描述的階層樹。

nativeStreamMetadataFormatName - 將從 getNativeStreamMetadataFormatName 返回的一個 String，或者為 null。

nativeStreamMetadataFormatClassName - 將用於實例化從 getNativeStreamMetadataFormat 返回的元資料格式物件的 String，或者為 null。

extraStreamMetadataFormatNames - 將從 getExtraStreamMetadataFormatNames 返回的 String 陣列，或者為 null。長度為 0 的陣列將被標準化為 null。

extraStreamMetadataFormatClassNames - 將用於實例化從 getStreamMetadataFormat 返回的元資料格式物件的 String 陣列，或者為 null。長度為 0 的陣列將被標準化為 null。

supportsStandardImageMetadataFormat - 一個 boolean 值，指示圖像元資料物件是否可使用由標準元資料格式描述的階層樹。

nativeImageMetadataFormatName - 將從 getNativeImageMetadataFormatName 返回的一個 String，或者為 null。

nativeImageMetadataFormatClassName - 將用於實例化從 getNativeImageMetadataFormat 返回的元資料格式物件的 String，或者為 null。

extraImageMetadataFormatNames - 將從 getExtraImageMetadataFormatNames 返回的 String 陣列。長度為 0 的陣列將被標準化為 null。

extraImageMetadataFormatClassNames - 將用於實例化從 getImageMetadataFormat 返回的元資料格式物件的 String 陣列，或者為 null。長度為 0 的陣列將被標準化為 null。

拋出：

IllegalArgumentException - 如果 vendorName 為 null。

IllegalArgumentException - 如果 version 為 null。

IllegalArgumentException - 如果 names 為 null 或長度為 0。

IllegalArgumentException - 如果 pluginClassName 為 null。

ImageReaderWriterSpi

public ImageReaderWriterSpi()

建構一個空的 ImageReaderWriterSpi。為提供所有方法的可用版本，由子類別負責初始化實例變數和/或覆寫方法實作。

方法詳細資訊

getFormatNames

public String[] getFormatNames()

返回一個 String 陣列，該陣列包含通常由與此服務提供者關聯的 ImageReader 或 ImageWriter 實作使用的那些格式的可讀名稱。例如，單獨一個 ImageReader 就可以處理 PBM 和 PNM 檔案。

返回：

非 null 的 String 陣列，或者返回一個長度至少為 1 的、包含與此 reader 或 writer 關聯的非正式格式名稱的陣列。

getFileSuffixes

public String[] getFileSuffixes()

返回一個套件含通常可由與此服務提供者關聯的 ImageReader 或 ImageWriter 實作所用格式所關聯檔案後綴列表的 String 陣列。例如，單獨一個 ImageReader 就可以處理帶 '.pbm' 和 '.pnm' 或 '.jpg' 和 '.jpeg' 後綴的檔案。如果沒有已知的檔案後綴，則返回 null。

返回一個特定的後綴並不保證能夠處理具有此後綴的檔案；它僅僅指示值得嘗試使用此服務提供者解碼或編碼這樣的檔案。

返回：

String 陣列，或者返回一個長度至少為 1 的、包含與此 reader 或 writer 關聯的常用檔案後綴的陣列，抑或返回 null。

getMIMETypes

public String[] getMIMETypes()

返回一個 String 陣列，該陣列包含與通常由與此服務提供者關聯的 ImageReader 或 ImageWriter 實作使用的格式有關的 MIME 型別的列表。

理想的情況下，描述一個特定的格式只需要單獨某一 MIME 型別。但是，由於種種原因，有必要為每個服務提供者關聯一個型別列表。首先，許多常見圖像檔案不具有標準的 MIME 型別，所以需要一個常用的非正式名稱列表，例如 image/x-pbm 和 image/x-portable-bitmap。有些檔案格式雖然具有正式的 MIME 型別，但有時被指示使用它們以前的非正式指定，例如使用 image/x-png 而不使用正式的 image/png。最後，從 MIME 的角度來講，單個服務提供者能夠分析多個不同的型別，例如 image/x-xbitmap 和 image/x-xpixmap。

返回一個特定的 MIME 型別並不保證能夠處理宣告為此型別的檔案；它僅僅指示值得嘗試使用此服務提供者解碼或編碼這樣的檔案。

返回：

String 陣列或長度至少為 1 的、包含與此 reader 或 writer 關聯的 MIME 型別的陣列，或者返回 null。

getPluginClassName

public String getPluginClassName()

返回與此服務提供者關聯的 ImageReader 或 ImageWriter 外掛程式的完全限定類別名稱。

返回：

類別名，它是一個非 null 的 String。

isStandardStreamMetadataFormatSupported

public boolean isStandardStreamMetadataFormatSupported()

如果標準元資料格式是此外掛程式產生或使用的串流元資料物件的 getAsTree 和 setFromTree 方法能夠識別的文檔格式之一，則返回 true。

返回：

如果標準格式是串流元資料支持的格式，則返回 true。

getNativeStreamMetadataFormatName

public String getNativeStreamMetadataFormatName()

返回此外掛程式的“本地”串流元資料格式的名稱，它通常允許無損失地編碼和傳輸按照由此外掛程式處理的格式存儲的串流元資料。如果不支持這樣的格式，將返回 null。

預設實作返回 nativeStreamMetadataFormatName 實例變數，這通常由建構子設置。

返回：

本地串流元資料格式的名稱，或返回 null。

getExtraStreamMetadataFormatNames

public String[] getExtraStreamMetadataFormatNames()

返回包含其他文檔格式名稱，而不是此外掛程式產生或使用的串流元資料物件的 getAsTree 和 setFromTree 方法可識別的本地和標準格式的 String 陣列。

如果外掛程式不處理元資料，則應返回 null。

格式集可能因讀取或寫入的特定圖像而不同；此方法應指示外掛程式在任何情況下都支持的其他所有格式。

預設實作返回 extraStreamMetadataFormatNames 實例變數的副本，該變數通常由建構子設置。

返回：

String 陣列，或返回 null。

另請參見：

IIOMetadata.getMetadataFormatNames(), getExtraImageMetadataFormatNames(), getNativeStreamMetadataFormatName()

isStandardImageMetadataFormatSupported

public boolean isStandardImageMetadataFormatSupported()

如果標準元資料格式為此外掛程式產生或使用的圖像元資料物件的 getAsTree 和 setFromTree 方法可識別的文檔格式之一，則返回 true。

返回：

如果標準格式支持圖像元資料，則返回 true。

getNativeImageMetadataFormatName

public String getNativeImageMetadataFormatName()

返回此外掛程式的“本地”圖像元資料格式的名稱，它通常允許無損失地編碼或傳輸按照由此外掛程式處理的格式存儲的圖像元資料。如果不支持這樣的格式，將返回 null。

預設實作返回 nativeImageMetadataFormatName 實例變數，該變數通常由建構子設置。

返回：

本地圖像元資料格式的名稱，或返回 null。

另請參見：

getExtraImageMetadataFormatNames()

getExtraImageMetadataFormatNames

public String[] getExtraImageMetadataFormatNames()

返回包含其他文檔格式名稱，而不是此外掛程式產生或使用的圖像元資料物件的 getAsTree 和 setFromTree 方法可識別的本地和標準格式的 String 陣列。

如果外掛程式不處理圖像元資料，則應返回 null。

格式集可能因讀取或寫入的特定圖像而有所不同；此方法應指示外掛程式在任何情況下都支持的其他所有格式。

預設的實作返回 extraImageMetadataFormatNames 實例變數的副本，該變數通常由建構子設置。

返回：

String 陣列，或返回 null。

另請參見：

IIOMetadata.getMetadataFormatNames(), getExtraStreamMetadataFormatNames(), getNativeImageMetadataFormatName()

getStreamMetadataFormat

public IIOMetadataFormat getStreamMetadataFormat(String formatName)

返回描述給定的串流元資料格式的 IIOMetadataFormat 物件，如果沒有可用的描述，則返回 null。給定的名稱必須是本地串流元資料格式名稱、標準元資料格式名稱或由 getExtraStreamMetadataFormatNames 返回的格式名稱之一。

參數：

formatName - 需要的串流元資料格式。

返回：

IIOMetadataFormat 物件。

拋出：

IllegalArgumentException - 如果 formatName 為 null 或者是不受支持的名稱。

getImageMetadataFormat

public IIOMetadataFormat getImageMetadataFormat(String formatName)

返回描述給定的圖像元資料格式的 IIOMetadataFormat 物件，如果沒有可用的描述，則返回 null。給定的名稱必須是本地圖像元資料格式名稱、標準元資料格式名稱或由 getExtraImageMetadataFormatNames 返回的格式名稱之一。

參數：

formatName - 需要的圖像元資料格式。

返回：

IIOMetadataFormat 物件。

拋出：

IllegalArgumentException - 如果 formatName 為 null 或者是不受支持的名稱。