Интерфейс DOMImplementation
- Все известные подинтерфейсы:
-
DOMImplementationCSS,HTMLDOMImplementation
public interface DOMImplementation
Интерфейс
DOMImplementation предоставляет множество методов для выполнения операций, независимых от конкретной реализации модели объекта документа. См. также Спецификацию модели объекта документа (DOM) уровня 3 Core.
- С:
- 1.4, DOM уровень 2
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
Document |
createDocument |
Создаёт объект DOM Document указанного типа с его элементом документа. |
DocumentType |
createDocumentType |
Создаёт пустой узел DocumentType. |
Object |
getFeature |
Этот метод возвращает специализированный объект, который реализует специализированные API указанного функционала и версии, как указано в DOM Features. |
boolean |
hasFeature |
Проверяет, реализует ли реализация DOM определённый функционал и версию, как указано в DOM Features. |
Подробное описание методов
hasFeature
boolean hasFeature(String feature, String version)
Проверяет, реализует ли реализация DOM определённый функционал и версию, как указано в DOM Features.
- Параметры:
-
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" [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есть префикс "xml" иnullотличается от " http://www.w3.org/XML/1998/namespace" [XML Namespaces], или если реализация 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 Features. Специализированный объект также может быть получен с помощью методов приведения типов, специфичных для связывания, но это не обязательно, как обсуждалось в . Этот метод также позволяет реализации предоставлять специализированные объекты, которые не поддерживают интерфейс
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://download.java.net/java/early_access/jdk24/docs/api/java.xml/org/w3c/dom/DOMImplementation.html