Интерфейс DOMImplementation
- Все известные подинтерфейсы:
-
DOMImplementationCSS,HTMLDOMImplementation
public interface DOMImplementation
Интерфейс
DOMImplementation предоставляет ряд методов для выполнения операций, которые независимы от любого конкретного экземпляра модели объекта документа. См. также Спецификацию Модели объекта документа (DOM) Level 3 Core.
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
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 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пустые, возвращаемыйDocumentпуст без элемента документа. - Исключения:
-
DOMException- INVALID_CHARACTER_ERR: Вызывается, если указанное квалифицированное имя не является именем XML в соответствии с [XML 1.0].
NAMESPACE_ERR: Вызывается, еслиqualifiedNameимеет неправильный формат, если уqualifiedNameесть префикс иnamespaceURIпуст, или еслиqualifiedNameпуст, а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. Специализированный объект также может быть получен с использованием методов преобразования, специфичных для связывания, но не обязательно ожидается, как обсуждалось в . Этот метод также позволяет реализации предоставлять специализированные объекты, которые не поддерживают интерфейс
DOMImplementation.- Параметры:
-
feature- Имя запрашиваемого функционального раздела. Обратите внимание, что любой знак «плюс» «+», добавленный в начало имени функционального раздела, будет проигнорирован, так как он не имеет значения в контексте этого метода. -
version- Номер версии функционального раздела для проверки. - Возвращает:
- Возвращает объект, реализующий специализированные API указанного функционального раздела и версии, если таковой имеется, или
null, если нет объекта, реализующего интерфейсы, связанные с этим функциональным разделом. ЕслиDOMObject, возвращённый этим методом, реализует интерфейсDOMImplementation, он должен делегировать первичному ядруDOMImplementationи не возвращать результаты, несовместимые с первичным ядромDOMImplementation, такие какhasFeature,getFeatureи т. д. - С:
- 1.5, DOM Level 3
© 1993, 2023, 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/21/docs/api/java.xml/org/w3c/dom/DOMImplementation.html