Интерфейс DOMImplementation
- Все известные подинтерфейсы:
-
DOMImplementationCSS,HTMLDOMImplementation
public interface DOMImplementation
Интерфейс
DOMImplementation предоставляет ряд методов для выполнения операций, независимых от конкретного экземпляра модели объекта документа. См. также Спецификацию модели объекта документа (DOM) уровня 3 Core.
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
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 Level 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являетсяnullиnamespaceURIотличается отnull, или еслиqualifiedNameимеет префикс "xml" иnamespaceURIотличается от " 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 Level 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 Level 3
© 1993, 2021, 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/17/docs/api/java.xml/org/w3c/dom/DOMImplementation.html