Интерфейс DOMImplementation

public interface DOMImplementation

Интерфейс DOMImplementation предоставляет множество методов для выполнения операций, независимых от конкретной реализации объекта модели документа.

См. также Спецификацию уровня 3 ядра объекта модели документа (DOM).

Методы

hasFeature

boolean hasFeature(String feature,
                   String version)

Проверяет, реализует ли реализация DOM определённый функциональный блок и версию, как указано в Функциональных блоках DOM.

Параметры:

feature - Имя проверяемого функционального блока.

version - Номер версии проверяемого функционального блока.

Возвращает:

true если функциональный блок реализован в указанной версии, false в противном случае.

createDocumentType

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

Создаёт пустой узел DocumentType. Объявления сущностей и обозначения недоступны. Расширения ссылок на сущности и добавление атрибутов по умолчанию не происходят.

Параметры:

qualifiedName - Квалифицированное имя создаваемого типа документа.

publicId - Открытый идентификатор внешнего подмножества.

systemId - Системный идентификатор внешнего подмножества.

Возвращает:

Новый узел DocumentType с Node.ownerDocument установлен на null.

Исключения:

DOMException - INVALID_CHARACTER_ERR: Возникает, если указанное квалифицированное имя не является именем XML в соответствии с [XML 1.0].
NAMESPACE_ERR: Возникает, если qualifiedName имеет неверный формат.
NOT_SUPPORTED_ERR: Может быть вызвано, если реализация не поддерживает функциональный блок «XML», а язык, представленный через Document, не поддерживает пространства имён XML (например, [HTML 4.01]).

С тех пор как:

Уровень 2 DOM

createDocument

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

Создаёт объект DOM Document указанного типа с его элементом документа.
Обратите внимание, что в зависимости от DocumentType, заданного для создания документа, реализация может создать специализированные объекты Document, которые поддерживают дополнительные функции, кроме «Core», такие как «HTML» [DOM Level 2 HTML] . С другой стороны, установка DocumentType после создания документа делает это маловероятным. В качестве альтернативы можно использовать специализированные методы создания Document, такие как createHTMLDocument [DOM Level 2 HTML], чтобы получить конкретные типы объектов Document.

Параметры:

namespaceURI - URI пространства имён элемента документа, который нужно создать, или null.

qualifiedName - Квалифицированное имя элемента документа, который нужно создать, или null.

doctype - Тип создаваемого документа или null. Когда doctype не является null, его атрибут Node.ownerDocument устанавливается в создаваемый документ.

Возвращает:

Новый объект Document с его элементом документа. Если NamespaceURI, qualifiedName, и doctype являются null, возвращаемый Document пустой без элемента документа.

Исключения:

DOMException - INVALID_CHARACTER_ERR: Возникает, если указанное квалифицированное имя не является именем XML в соответствии с [XML 1.0].
NAMESPACE_ERR: Возникает, если qualifiedName имеет неверный формат, если qualifiedName имеет префикс и namespaceURI является null, или если qualifiedName является null и namespaceURI отличается от null, или если qualifiedName имеет префикс «xml» и namespaceURI отличается от «http://www.w3.org/XML/1998/namespace» [Пространства имён XML], или если реализация DOM не поддерживает функциональный блок "XML", но был предоставлен ненулевой URI пространства имён, так как пространства имён определялись XML.
WRONG_DOCUMENT_ERR: Возникает, если doctype уже использовался с другим документом или был создан другой реализацией.
NOT_SUPPORTED_ERR: Может быть вызвано, если реализация не поддерживает функциональный блок «XML», а язык, представленный через Document, не поддерживает пространства имён XML (например, [HTML 4.01]).

С тех пор как:

Уровень 2 DOM

getFeature

Object getFeature(String feature,
                  String version)

Этот метод возвращает специализированный объект, который реализует специализированные API указанного функционального блока и версии, как указано в Функциональных блоках DOM. Специализированный объект также может быть получен с помощью методов преобразования, специфичных для связывания, но это не обязательно, как обсуждается в . Этот метод также позволяет реализации предоставлять специализированные объекты, которые не поддерживают интерфейс DOMImplementation.

Параметры:

feature - Имя запрашиваемого функционального блока. Обратите внимание, что любой знак «+» перед именем функционального блока будет проигнорирован, так как он не значим в контексте этого метода.

version - Номер версии проверяемого функционального блока.

Возвращает:

Возвращает объект, который реализует специализированные API указанного функционального блока и версии, если таковой имеется, или null если нет объекта, который реализует интерфейсы, связанные с этим функциональным блоком. Если возвращаемый DOMObject объект реализует интерфейс DOMImplementation , он должен делегировать первичному ядру DOMImplementation и не возвращать результаты, несовместимые с основным ядром DOMImplementation , такие как hasFeature, getFeature, и т.д.

С тех пор как:

Уровень 3 DOM