Интерфейс DOMImplementation
- Все известные подинтерфейсы:
-
DOMImplementationCSS,HTMLDOMImplementation
public interface DOMImplementation
Интерфейс DOMImplementation предоставляет ряд методов для выполнения операций, которые не зависят от конкретной реализации модели объекта документа.
См. также Спецификацию Модели объекта документа (DOM) Level 3 Core.
Методы
| Модификатор и тип | Метод | Описание |
|---|---|---|
Document | createDocument(String namespaceURI,
String qualifiedName,
DocumentType doctype) | Создает объект DOM Document указанного типа с его элементом документа. |
DocumentType | createDocumentType(String qualifiedName,
String publicId,
String systemId) | Создает пустой узел |
Object | getFeature(String feature,
String version) | Этот метод возвращает специализированный объект, который реализует специализированные API указанного функционального модуля и версии, как указано в DOM Features. |
boolean | hasFeature(String feature,
String version) | Проверяет, реализует ли реализация 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 , которые поддерживают дополнительные функции, такие как "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, иdoctypenull, возвращаемыйDocumentпустой без элемента документа. - Исключения:
-
DOMException- INVALID_CHARACTER_ERR: Возникает, если указанное квалифицированное имя не является именем XML в соответствии с [XML 1.0].
NAMESPACE_ERR: Возникает, еслиqualifiedNameимеет неправильный формат, еслиqualifiedNameимеет префикс, иnamespaceURInull, или еслиqualifiedNamenullи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, 2020, 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/11/docs/api/java.xml/org/w3c/dom/DOMImplementation.html