org.w3c.dom
インタフェース DOMImplementation

public interface DOMImplementation

DOMImplementation インタフェースは、文書オブジェクトモデルの特定のインスタンスに依存しない操作を実行するためのメソッドを多数提供します。

『Document Object Model (DOM) Level 2 Core Specification』を参照してください。

メソッドの概要

Document	createDocument(String namespaceURI, String qualifiedName, DocumentType doctype) 指定された型の DOM Document オブジェクトとｓの文書要素を作成します。
DocumentType	createDocumentType(String qualifiedName, String publicId, String systemId) 空の DocumentType ノードを作成します。
boolean	hasFeature(String feature, String version) DOM 実装が特定の機能を実装しているかどうかをテストします。

メソッドの詳細

hasFeature

public boolean hasFeature(String feature,
                          String version)

DOM 実装が特定の機能を実装しているかどうかをテストします。

パラメータ:

feature - その機能の名前 (アルファベットの大文字と小文字は区別される)。DOM 機能によって使用される値は DOM レベル 2 仕様の随所で定義されており、そのセクションに一覧表示されている。機能の名前は XML 名で指定する。競合を避けるため、慣例として、DOM 仕様に定義されていない機能を参照する名前は一意でなければならない

version - その機能のバージョン番号。レベル 2 では "2.0" または "1.0"。バージョンを指定しないと任意のバージョンの機能がサポートされ、メソッドの戻り値は true になる

戻り値:

指定されたバージョンの機能が実装されている場合は true、そうでない場合は false

createDocumentType

public DocumentType createDocumentType(String qualifiedName,
                                       String publicId,
                                       String systemId)
                                throws DOMException

空の DocumentType ノードを作成します。エンティティ宣言およびエンティティ指定 (表記法指定) は使用できません。エンティティ参照の拡張およびデフォルト属性の追加は行われません。DocumentType を生成する方法は、将来のバージョンの DOM で提供される予定です。

パラメータ:

qualifiedName - 作成する文書型の修飾名

publicId - 外部サブセットの公開識別子

systemId - 外部サブセットのシステム識別子

戻り値:

Node.ownerDocument が null に設定されている新しい DocumentType ノード

例外:

DOMException - INVALID_CHARACTER_ERR: 指定された修飾名に不正な文字が含まれている場合
NAMESPACE_ERR: qualifiedName が不正な場合
NOT_SUPPORTED_ERR: "XML" 機能をサポートしない DOM 実装で、このメソッドをサポートしない設定にした場合。今後、DOM WG から公開されたり、DOM WG 以外のグループが定義した拡張に含められるその他の機能も、このメソッドのサポートを必要とする可能性がある。このメソッドが必要かどうかは、その機能の定義を参照のこと

導入されたバージョン:

DOM Level 2

createDocument

public Document createDocument(String namespaceURI,
                               String qualifiedName,
                               DocumentType doctype)
                        throws DOMException

指定された型の DOM Document オブジェクトとｓの文書要素を作成します。

パラメータ:

namespaceURI - 作成する文書要素のネームスペース URI

qualifiedName - 作成される文書要素の修飾名

doctype - 作成される文書の型または null。doctype が null でない場合、作成される文書にはその Node.ownerDocument 属性が設定される

戻り値:

新しい Document オブジェクト

例外:

DOMException - INVALID_CHARACTER_ERR: 指定された修飾名に不正な文字が含まれている場合
NAMESPACE_ERR: qualifiedName が不正な場合。qualifiedName が前置修飾子を持ち、namespaceURI が null の場合。qualifiedName が前置修飾子 "xml" を持ち、namespaceURI が http://www.w3.org/XML/1998/namespace 以外である場合。DOM 実装が "XML" 機能をサポートしていないにもかかわらず null 以外のネームスペース URI が定義された場合 (ネームスペースは XML によって定義される)
WRONG_DOCUMENT_ERR: doctype がすでに別の文書で使用されている場合、または別の実装で作成されたものである場合
NOT_SUPPORTED_ERR: "XML" 機能をサポートしない DOM 実装で、このメソッドをサポートしない設定にした場合。今後、DOM WG から公開されたり、DOM WG 以外のグループが定義した拡張に含められるその他の機能も、このメソッドのサポートを必要とする可能性がある。このメソッドが必要かどうかは、その機能の定義を参照のこと

導入されたバージョン:

DOM Level 2