Документация интерфейса

DocumentType getDoctype()

С:

1.4, DOM Level 3

DOMImplementation getImplementation()

Element getDocumentElement()

Element createElement(String tagName) throws DOMException

Параметры:

tagName - Имя типа элемента для создания. Для XML оно чувствительно к регистру, в противном случае это зависит от чувствительности к регистру используемого языка разметки. В этом случае имя отображается в каноническую форму этой разметки реализацией DOM.

Возвращает:

Новый объект Element с атрибутом nodeName, установленным в значение tagName, а localName, prefix и namespaceURI установлены в значение null.

Выбрасывает:

DOMException - INVALID_CHARACTER_ERR: Выбрасывается, если указанное имя не является именем XML в соответствии с используемой версией XML, заданной в атрибуте Document.xmlVersion.

DocumentFragment createDocumentFragment()

Возвращает:

Новый DocumentFragment.

Text createTextNode(String data)

Параметры:

data - Данные для узла.

Возвращает:

Новый объект Text.

Comment createComment(String data)

Параметры:

data - Данные для узла.

Возвращает:

Новый объект Comment.

CDATASection createCDATASection(String data) throws DOMException

Параметры:

data - Данные для содержимого CDATASection.

Возвращает:

Новый объект CDATASection.

Выбрасывает:

DOMException - NOT_SUPPORTED_ERR: Выбрасывается, если этот документ является HTML-документом.

ProcessingInstruction createProcessingInstruction(String target, String data) throws DOMException

Параметры:

target - Целевая часть инструкции обработки. В отличие от Document.createElementNS или Document.createAttributeNS, проверка корректности имени в пространстве имён на целевое имя не выполняется. Приложения должны вызывать Document.normalizeDocument() с параметром " namespaces" установленным в true, чтобы гарантировать корректность имени целевого пространства имён.

data - Данные для узла.

Возвращает:

Новый объект ProcessingInstruction.

Выбрасывает:

DOMException - INVALID_CHARACTER_ERR: Выбрасывается, если указанная цель не является именем XML в соответствии с используемой версией XML, заданной в атрибуте Document.xmlVersion.
NOT_SUPPORTED_ERR: Выбрасывается, если этот документ является HTML-документом.

Attr createAttribute(String name) throws DOMException

Параметры:

name - Имя атрибута.

Возвращает:

Новый объект Attr с атрибутом nodeName, установленным в name, а localName, prefix и namespaceURI установлены в null. Значение атрибута — пустая строка.

Выбрасывает:

DOMException - INVALID_CHARACTER_ERR: Выбрасывается, если указанное имя не является именем XML в соответствии с используемой версией XML, заданной в атрибуте Document.xmlVersion.

EntityReference createEntityReference(String name) throws DOMException

Параметры:

name - Имя сущности для ссылки. В отличие от Document.createElementNS или Document.createAttributeNS, проверка корректности имени сущности в пространстве имён не выполняется. Приложения должны вызывать Document.normalizeDocument() с параметром " namespaces" установленным в true, чтобы гарантировать корректность имени сущности в пространстве имён.

Возвращает:

Новый объект EntityReference.

Выбрасывает:

DOMException - INVALID_CHARACTER_ERR: Выбрасывается, если указанное имя не является именем XML в соответствии с используемой версией XML, заданной в атрибуте Document.xmlVersion.
NOT_SUPPORTED_ERR: Выбрасывается, если этот документ является HTML-документом.

NodeList getElementsByTagName(String tagname)

Параметры:

tagname - Имя тега для сопоставления. Специальное значение "*" соответствует всем тегам. Для XML параметр tagname чувствителен к регистру, в противном случае это зависит от чувствительности к регистру используемого языка разметки.

Возвращает:

Новый объект NodeList, содержащий все соответствующие элементы Elements.

Node importNode(Node importedNode, boolean deep) throws DOMException

Parameters:

importedNode - Узел для импорта.

deep - Если true, рекурсивно импортировать поддерево под указанным узлом; если false, импортировать только сам узел, как описано выше. Это не влияет на узлы, которые не могут иметь потомков, и на узлы Attr и EntityReference.

Returns:

Импортированный узел, принадлежащий этому Document.

Throws:

DOMException - NOT_SUPPORTED_ERR: Возникает, если тип импортируемого узла не поддерживается.
INVALID_CHARACTER_ERR: Возникает, если одно из импортированных имён не является именем XML в соответствии с используемой версией XML, указанной в атрибуте Document.xmlVersion. Это может произойти, например, при импорте элемента XML 1.1 [XML 1.1] в документ XML 1.0.

Since:

1.4, DOM Level 2

Element createElementNS(String namespaceURI, String qualifiedName) throws DOMException

Parameters:

namespaceURI - URI именованного пространства создаваемого элемента.

qualifiedName - Полное имя типа элемента, подлежащего созданию.

Returns:

Новый объект Element со следующими атрибутами:

Атрибуты объекта Element

Атрибут	Значение
Node.nodeName	qualifiedName
Node.namespaceURI	namespaceURI
Node.prefix	префикс, извлечённый из qualifiedName, или null, если префикса нет
Node.localName	локальное имя, извлечённое из qualifiedName
Element.tagName	qualifiedName

Throws:

DOMException - INVALID_CHARACTER_ERR: Возникает, если указанное qualifiedName не является именем XML в соответствии с используемой версией XML, указанной в атрибуте Document.xmlVersion.
NAMESPACE_ERR: Возникает, если qualifiedName является неправильно сформированным полным именем, если qualifiedName имеет префикс и namespaceURI равно null, или если qualifiedName имеет префикс "xml" и namespaceURI отличается от " http://www.w3.org/XML/1998/namespace" [XML Namespaces], или если qualifiedName или его префикс равно "xmlns" и namespaceURI отличается от "http://www.w3.org/2000/xmlns/", или если namespaceURI равно "http://www.w3.org/2000/xmlns/" и ни qualifiedName, ни его префикс не равны "xmlns".
NOT_SUPPORTED_ERR: Всегда выбрасывается, если текущий документ не поддерживает функцию "XML", так как пространства имён были определены в XML.

Since:

1.4, DOM Level 2

Attr createAttributeNS(String namespaceURI, String qualifiedName) throws DOMException

Parameters:

namespaceURI - URI пространства имён создаваемого атрибута.

qualifiedName - Квалифицированное имя атрибута для создания.

Returns:

Новый объект Attr с указанными атрибутами:

Атрибуты объекта Attr

Атрибут	Значение
Node.nodeName	qualifiedName
Node.namespaceURI	namespaceURI
Node.prefix	префикс, извлечённый из qualifiedName, или null, если префикса нет
Node.localName	локальное имя, извлечённое из qualifiedName
Attr.name	qualifiedName
Node.nodeValue	пустая строка

Throws:

DOMException - INVALID_CHARACTER_ERR: Выбрасывается, если заданное qualifiedName не является именем XML в соответствии с версией XML, используемой в атрибуте Document.xmlVersion.
NAMESPACE_ERR: Выбрасывается, если qualifiedName является неправильно сформированным квалифицированным именем, если qualifiedName имеет префикс и namespaceURI равно null, если qualifiedName имеет префикс "xml" и namespaceURI отличается от " http://www.w3.org/XML/1998/namespace", если qualifiedName или его префикс равен "xmlns" и namespaceURI отличается от "http://www.w3.org/2000/xmlns/", или если namespaceURI равно "http://www.w3.org/2000/xmlns/" и ни qualifiedName, ни его префикс не равны "xmlns".
NOT_SUPPORTED_ERR: Всегда выбрасывается, если текущий документ не поддерживает функцию "XML", поскольку пространства имён определены в XML.

Since:

1.4, DOM Level 2

NodeList getElementsByTagNameNS(String namespaceURI, String localName)

Parameters:

namespaceURI - URI пространства имён искомых элементов. Специальное значение "*" соответствует всем пространствам имён.

localName - Локальное имя искомых элементов. Специальное значение "*" соответствует всем локальным именам.

Returns:

Новый объект NodeList, содержащий все соответствующие элементы Elements.

Since:

1.4, DOM Level 2

Element getElementById(String elementId)

Parameters:

elementId - Уникальное значение id элемента.

Returns:

Соответствующий элемент или null, если он отсутствует.

Since:

1.4, DOM Level 2

String getInputEncoding()

Since:

1.5, DOM Level 3

String getXmlEncoding()

Since:

1.5, DOM Level 3

boolean getXmlStandalone()

Since:

1.5, DOM Level 3

void setXmlStandalone(boolean xmlStandalone) throws DOMException

Throws:

DOMException - NOT_SUPPORTED_ERR: Выбрасывается, если этот документ не поддерживает функцию "XML".

Since:

1.5, DOM Level 3

String getXmlVersion()

Since:

1.5, DOM Level 3

void setXmlVersion(String xmlVersion) throws DOMException

Throws:

DOMException - NOT_SUPPORTED_ERR: Выбрасывается, если версия установлена на значение, которое не поддерживается этим Document, или если этот документ не поддерживает функцию "XML".

Since:

1.5, DOM Level 3

boolean getStrictErrorChecking()

Since:

1.5, DOM Level 3

void setStrictErrorChecking(boolean strictErrorChecking)

Since:

1.5, DOM Level 3

String getDocumentURI()

Since:

1.5, DOM Level 3

void setDocumentURI(String documentURI)

Since:

1.5, DOM Level 3

Node adoptNode(Node source) throws DOMException

Parameters:

source - Узел для перемещения в этот документ.

Returns:

Принятый узел или null, если операция завершилась неудачно, например, когда исходный узел происходит из другой реализации.

Throws:

DOMException - NOT_SUPPORTED_ERR: Вызывается, если исходный узел является узлом типа DOCUMENT, DOCUMENT_TYPE.
NO_MODIFICATION_ALLOWED_ERR: Вызывается, когда исходный узел является только для чтения.

Since:

1.5, DOM Level 3

DOMConfiguration getDomConfig()

Since:

1.5, DOM Level 3

void normalizeDocument()

// Keep in the document
 the information defined // in the XML Information Set (Java example)
 DOMConfiguration docConfig = myDocument.getDomConfig();
 docConfig.setParameter("infoset", Boolean.TRUE);
 myDocument.normalizeDocument();

Since:

1.5, DOM Level 3

Node renameNode(Node n, String namespaceURI, String qualifiedName) throws DOMException

Parameters:

n - Узел для переименования.

namespaceURI - Новый URI пространства имён.

qualifiedName - Новое полное имя.

Returns:

Переименованный узел. Это либо указанный узел, либо новый узел, созданный для замены указанного узла.

Throws:

DOMException - NOT_SUPPORTED_ERR: Вызывается, когда тип указанного узла не является ни ELEMENT_NODE, ни ATTRIBUTE_NODE, или если реализация не поддерживает переименование элемента документа.
INVALID_CHARACTER_ERR: Вызывается, если новое полное имя не является именем XML в соответствии с используемой версией XML, указанной в атрибуте Document.xmlVersion.
WRONG_DOCUMENT_ERR: Вызывается, когда указанный узел был создан из другого документа, чем этот документ.
NAMESPACE_ERR: Вызывается, если qualifiedName является неправильно сформированным полным именем, если qualifiedName имеет префикс, и namespaceURI имеет значение null, или если qualifiedName имеет префикс "xml" и namespaceURI отличается от " http://www.w3.org/XML/1998/namespace" [XML Namespaces] . Также вызывается, когда переименовываемый узел является атрибутом, если qualifiedName или его префикс является "xmlns" и namespaceURI отличается от "http://www.w3.org/2000/xmlns/".

Since:

1.5, DOM Level 3