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()`	このサービス・プロバイダに関連する`ImageReader`または`ImageWriter`実装で一般的に使用できる形式の判読可能な名前を含む`String`配列を返します。
`IIOMetadataFormat`	`getImageMetadataFormat(String formatName)`	指定されたイメージ・メタデータ形式を説明する`IIOMetadataFormat`オブジェクト、または説明がない場合は`null`を返します。
`String[]`	`getMIMETypes()`	このサービス・プロバイダに関連する`ImageReader`または`ImageWriter`実装で一般的に使用可能な形式に関連付けられたMIMEタイプのリストを含む`String`配列を返します。
`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配列。 1つ以上のエントリが存在する必要がある。
  
  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()
  
  このサービス・プロバイダに関連するImageReaderまたはImageWriter実装で一般的に使用できる形式の判読可能な名前を含むString配列を返します。たとえば、1つのImageReaderでPBMファイルとPNMファイルの両方を処理できる場合があります。
  
  戻り値:
  
  このリーダーまたはライターに関連する非公式の形式名を含む、長さ1以上のString配列(null以外)。
- getFileSuffixes
  
  public String[] getFileSuffixes()
  
  このサービス・プロバイダに関連するImageReaderまたはImageWriter実装で一般的に使用可能な形式に関連付けられたファイル接尾辞のリストを含むString配列を返します。たとえば、1つのImageReaderで.pbmや.pnm、または.jpgや.jpegの接尾辞を持つファイルを処理することができる場合があります。既知のファイル接尾辞が存在しない場合は、nullを返します。
  特定の接尾辞が返されても、その接尾辞を持つファイルの処理は保証されません。このサービス・プロバイダを使用して、この種のファイルのエンコードまたはデコードを試みる価値があることを示しているにすぎません。
  
  戻り値:
  
  このリーダーまたはライターに関連する共通のファイル接尾辞を含む、長さ1以上のString配列、またはnull。
- getMIMETypes
  
  public String[] getMIMETypes()
  
  このサービス・プロバイダに関連するImageReaderまたはImageWriter実装で一般的に使用可能な形式に関連付けられたMIMEタイプのリストを含むString配列を返します。
  特定の形式を記述するのに必要なMIMEタイプは1つだけであるのが理想的です。しかし、いくつかの理由から、各サービス・プロバイダに複数のタイプを関連付ける必要があります。第一に、多くの共通イメージ・ファイル形式には標準のMIMEタイプがないので、image/x-pbmやimage/x-portable-bitmapなどの共通に使用される非公式の名前リストが必要です。一部のファイル形式には正式のMIMEタイプがありますが、正式のimage/pngではなく、image/x-pngのような以前の非公式な指定を利用して参照されるものがあります。最後に、1つのサービス・プロバイダが、MIMEの観点から複数の別個の形式(image/x-xbitmapやimage/x-xpixmapなど)を解析できる場合があります。
  特定のMIMEタイプが返されても、そのタイプのファイルの処理が保証されるわけではありません。このサービス・プロバイダを使用して、この種のファイルのエンコードまたはデコードを試みる価値があることを示しているにすぎません。
  
  戻り値:
  
  このリーダーまたはライターに関連するMIMEタイプを含む、長さ1以上のString配列、または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またはサポートされない名前の場合。

クラスImageReaderWriterSpi

フィールドのサマリー

クラス javax.imageio.spi.IIOServiceProviderで宣言されたフィールド

コンストラクタのサマリー

メソッドのサマリー

クラス javax.imageio.spi.IIOServiceProviderで宣言されたメソッド

クラス java.lang.Objectで宣言されたメソッド

フィールド詳細

コンストラクタの詳細

メソッドの詳細