Интерфейс DOMImplementation
- Все известные подинтерфейсы:
DOMImplementationCSS, HTMLDOMImplementation
public interface DOMImplementation
Интерфейс
DOMImplementation предоставляет ряд методов для выполнения операций, не зависящих от конкретного экземпляра объектной модели документа. См. также Спецификацию базовой модели объектов документа (DOM) уровня 3.
- Начиная с версии:
- 1.4, DOM уровня 2
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
Document |
createDocument |
Создает объект DOM Document указанного типа с его элементом документа. |
DocumentType |
createDocumentType |
Создает пустой узел DocumentType. |
Object |
getFeature |
Этот метод возвращает специализированный объект, реализующий специализированные API указанной функции и версии, как описано в разделе Функции DOM. |
boolean |
hasFeature |
Проверяет, реализует ли DOM-реализация определенную функцию и версию, как описано в разделе Функции 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]). - Начиная с версии:
- 1.4, DOM уровня 2
createDocument
Document createDocument(String namespaceURI, String qualifiedName, DocumentType doctype) throws DOMException
Создает объект DOM Document указанного типа с его элементом документа.
Обратите внимание, что в зависимости от
Обратите внимание, что в зависимости от
DocumentType, переданного для создания документа, реализация может создать специализированные объекты Document, поддерживающие дополнительные функции помимо "Core", например "HTML" [HTML DOM уровня 2]. С другой стороны, если задать DocumentType после создания документа, это крайне маловероятно. Кроме того, для получения объектов Document определенных типов можно использовать специализированные методы создания Document, например createHTMLDocument [HTML DOM уровня 2].- Параметры:
-
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]). - Начиная с версии:
- 1.4, DOM уровня 2
getFeature
Object getFeature(String feature, String version)
Этот метод возвращает специализированный объект, реализующий специализированные API указанной функции и версии, как описано в разделе Функции DOM. Специализированный объект также можно получить с помощью методов приведения типов, специфичных для привязки, однако это не обязательно, как обсуждается в . Этот метод также позволяет реализации предоставлять специализированные объекты, не поддерживающие интерфейс
DOMImplementation.- Параметры:
-
feature— имя запрашиваемой функции. Обратите внимание: любой знак плюса "+" в начале имени функции будет проигнорирован, поскольку в контексте этого метода он не имеет значения. -
version— номер версии проверяемой функции. - Возвращает:
- Возвращает объект, реализующий специализированные API указанной функции и версии, если такой объект существует, или
null, если нет объекта, реализующего интерфейсы, связанные с этой функцией. ЕслиDOMObject, возвращенный этим методом, реализует интерфейсDOMImplementation, он должен делегировать выполнение основному ядруDOMImplementationи не возвращать результаты, противоречащие результатам основного ядраDOMImplementation, напримерhasFeature,getFeatureи т. д. - Начиная с версии:
- 1.5, DOM уровня 3
© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/25/docs/api/java.xml/org/w3c/dom/DOMImplementation.html