javax.imageio.spi

クラスIIORegistry

java.lang.Object

javax.imageio.spi.ServiceRegistry

javax.imageio.spi.IIORegistry

public final class IIORegistry
extends ServiceRegistry

サービス・プロバイダ・インスタンスのレジストリです。サービス・プロバイダ・クラスは、実行時にこれらのクラスを含むJARファイル内のメタ情報を使用して検出できます。目的は、比較的少ない負荷で、使用可能なサービス・プロバイダ・クラスすべてのロードおよび検査を行うことです。その後、これらのクラスを使用して、実作業を実行する負荷の高いクラスの検出およびインスタンス化を実行します。この場合は、ImageReader、ImageWriter、ImageTranscoder、ImageInputStream、およびImageOutputStreamのインスタンスになります。

システムのクラス・パス(通常はJavaインストール・ディレクトリのlib/extディレクトリ)で検出されたサービス・プロバイダが、このクラスがインスタンス化されるとすぐに自動的にロードされます。

registerApplicationClasspathSpisメソッドが呼び出されると、アプリケーションのクラス・パスのJARファイルのメタ情報セクションで宣言されたサービス・プロバイダ・インスタンスがロードされます。サービス・プロバイダを宣言するために、servicesサブディレクトリが各JARファイルに存在するMETA-INFディレクトリ内に配置されます。このディレクトリには、JARファイルに1つまたは複数の実装クラスを保持する各サービス・プロバイダ・インタフェースに対して1つのファイルが含まれます。たとえば、JARファイルにImageReaderSpiインタフェースを実装するcom.mycompany.imageio.MyFormatReaderSpiというクラスが含まれる場合、JARには次の名前のファイルが含まれます。

 META-INF/services/javax.imageio.spi.ImageReaderSpi
 

また、次の行が含まれます。

 com.mycompany.imageio.MyFormatReaderSpi
 

サービス・プロバイダ・クラスの特性は、軽量で迅速なロードが可能であることです。これらのインタフェースの実装は、ほかのクラスやネイティブ・コードに複雑に依存しないようにする必要があります。

自動的に検出されないサービス・プロバイダを手動で追加することも、ServiceRegistryクラスのインタフェースを使用するサービス・プロバイダを削除することもできます。したがって、アプリケーションでレジストリの内容を必要に応じてカスタマイズできます。

サービス・プロバイダ宣言の詳細およびJAR形式全般については、「JARファイルの仕様」を参照してください。

ネストされたクラスのサマリー

クラス javax.imageio.spi.ServiceRegistryから継承されたネストされたクラス/インタフェース

ServiceRegistry.Filter

メソッドのサマリー

修飾子と型	メソッドと説明
static IIORegistry	getDefaultInstance() イメージ入出力APIで使用されるデフォルトのIIORegistryインスタンスを返します。
void	registerApplicationClasspathSpis() アプリケーションのクラス・パスで検出されたすべての使用可能サービス・プロバイダを、デフォルトのClassLoaderを使用して登録します。

クラス javax.imageio.spi.ServiceRegistryから継承されたメソッド

contains, deregisterAll, deregisterAll, deregisterServiceProvider, deregisterServiceProvider, finalize, getCategories, getServiceProviderByClass, getServiceProviders, getServiceProviders, lookupProviders, lookupProviders, registerServiceProvider, registerServiceProvider, registerServiceProviders, setOrdering, unsetOrdering

クラス java.lang.Objectから継承されたメソッド

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

メソッドの詳細

getDefaultInstance

public static IIORegistry getDefaultInstance()

イメージ入出力APIで使用されるデフォルトのIIORegistryインスタンスを返します。このインスタンスはすべてのレジストリ関数で使用されます。

各ThreadGroupは独自のインスタンスを受け取ります。これにより、たとえば同じブラウザの別のAppletがそれぞれ独自のレジストリを持つことができます。

戻り値:

現在のThreadGroupのデフォルト・レジストリ。

registerApplicationClasspathSpis

public void registerApplicationClasspathSpis()

アプリケーションのクラス・パスで検出されたすべての使用可能サービス・プロバイダを、デフォルトのClassLoaderを使用して登録します。このメソッドは通常ImageIO.scanForPluginsメソッドから呼び出されます。

関連項目:

ImageIO.scanForPlugins(), ClassLoader.getResources(java.lang.String)