org.w3c.dom.bootstrap

クラス DOMImplementationRegistry

java.lang.Object

org.w3c.dom.bootstrap.DOMImplementationRegistry

public final class DOMImplementationRegistry
extends Object

アプリケーションが DOMImplementation のインスタンスを取得できるようにするためのファクトリ。

例:

  // get an instance of the DOMImplementation registry
  DOMImplementationRegistry registry =
       DOMImplementationRegistry.newInstance();
  // get a DOM implementation the Level 3 XML module
  DOMImplementation domImpl =
       registry.getDOMImplementation("XML 3.0");
 

これにより、実装に依存しない始点を持つアプリケーションが提供されます。DOM 実装は、このクラスを変更して新しいセキュリティー基準に合わせたり、DOMImplementationSource のリストにフォールバックを追加したりできます。

導入されたバージョン:

DOM Level 3

関連項目:

DOMImplementation, DOMImplementationSource

フィールドのサマリー

フィールド

修飾子と型	フィールドと説明
static String	PROPERTY DOMImplementationSource クラス名を指定するシステムプロパティーです。

メソッドのサマリー

メソッド

修飾子と型	メソッドと説明
void	addSource(DOMImplementationSource s) 実装を登録します。
DOMImplementation	getDOMImplementation(String features) 必要な機能を持つ最初の実装を返します。見つからない場合は null になります。
DOMImplementationList	getDOMImplementationList(String features) 必要な機能をサポートする実装のリストを返します。
static DOMImplementationRegistry	newInstance() DOMImplementationRegistry の新しいインスタンスを取得します。

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

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

フィールドの詳細

PROPERTY

public static final String PROPERTY

DOMImplementationSource クラス名を指定するシステムプロパティーです。

関連項目:

定数フィールド値

メソッドの詳細

newInstance

public static DOMImplementationRegistry newInstance()
                                             throws ClassNotFoundException,
                                                    InstantiationException,
                                                    IllegalAccessException,
                                                    ClassCastException

DOMImplementationRegistry の新しいインスタンスを取得します。 DOMImplementationRegistry は、最初に Java システムプロパティー org.w3c.dom.DOMImplementationSourceList の値と、コンテンツが「META_INF/services/org.w3c.dom.DOMImplementationSourceList」にあるサービスプロバイダをチェックすることによって、アプリケーションまたは実装 (コンテキストによる) によって初期化されます。このプロパティーの値は、DOMImplementationSource インタフェースを実装している使用可能なクラスの名前の空白文字で区切られたリストです。このクラス名に記載されている各クラスはインスタンス化されており、検出されたすべての例外はアプリケーションにスローされます。

戻り値:

DOMImplementationRegistry の初期化されたインスタンス

例外:

ClassNotFoundException - 指定されたどのクラスも見つからない場合

InstantiationException - 指定されたいずれかのクラスがインタフェースまたは abstract クラスの場合

IllegalAccessException - 指定されたクラスのデフォルトのコンストラクタにアクセスできない場合

ClassCastException - 指定されたどのクラスも次を実装していない場合: DOMImplementationSource

getDOMImplementation

public DOMImplementation getDOMImplementation(String features)

必要な機能を持つ最初の実装を返します。見つからない場合は null になります。

パラメータ:

features - 必要な機能を指定する文字列。この文字列は空白文字区切りのリストで、各機能はオプションとして空白とバージョン番号に続く名前によって指定。例: XML 1.0 Traversal +Events 2.0

戻り値:

必要な機能を持つ実装。見つからない場合は null。

getDOMImplementationList

public DOMImplementationList getDOMImplementationList(String features)

必要な機能をサポートする実装のリストを返します。

パラメータ:

features - 必要な機能を指定する文字列。この文字列は空白文字区切りのリストで、各機能はオプションとして空白とバージョン番号に続く名前によって指定。例: XML 1.0 Traversal +Events 2.0

戻り値:

必要な機能をサポートしている DOMImplementation のリスト。

addSource

public void addSource(DOMImplementationSource s)

実装を登録します。

パラメータ:

s - 登録されるソース。null は不可