Документ (Платформа Java SE 7)

Все Суперинтерфейсы:

Узел

Все Известные Классы с реализацией:

SOAPPart
```
public interface Document
extends Node
```
Document интерфейс представляет весь HTML или XML-документ. Концептуально, это - корень дерева документов, и обеспечивает основной доступ к данным документа.
Так как элементы, текстовые узлы, комментарии, обрабатывая инструкции, и т.д. не могут существовать вне контекста a Document, Document интерфейс также содержит методы фабрики, должен был создать эти объекты. Node у создаваемых объектов есть a ownerDocument атрибут, который связывает их с Document в пределах чьего контекста они создавались.
См. также Объектную модель документа (ДОМ) Спецификация Ядра Уровня 3.

Полевая Сводка
- Поля, наследованные от интерфейса org.w3c.dom. Узел
  ATTRIBUTE_NODE, CDATA_SECTION_NODE, COMMENT_NODE, DOCUMENT_FRAGMENT_NODE, DOCUMENT_NODE, DOCUMENT_POSITION_CONTAINED_BY, DOCUMENT_POSITION_CONTAINS, DOCUMENT_POSITION_DISCONNECTED, DOCUMENT_POSITION_FOLLOWING, DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC, DOCUMENT_POSITION_PRECEDING, DOCUMENT_TYPE_NODE, ELEMENT_NODE, ENTITY_NODE, ENTITY_REFERENCE_NODE, NOTATION_NODE, PROCESSING_INSTRUCTION_NODE, TEXT_NODE

Сводка метода

Методы
Модификатор и Тип	Метод и Описание
`Узел`	`adoptNode(Node source)` Попытки принять узел от другого документа до этого документа.
`Attr`	`createAttribute(String name)` Создает `Attr` из имени.
`Attr`	`createAttributeNS(String namespaceURI, String qualifiedName)` Создает атрибут данного полностью определенного имени и URI пространства имен.
`CDATASection`	`createCDATASection(String data)` Создает a `CDATASection` узел, значение которого является указанной строкой.
`Комментарий`	`createComment(String data)` Создает a `Comment` узел, данный указанную строку.
`DocumentFragment`	`createDocumentFragment()` Создает пустое `DocumentFragment` объект.
`Элемент`	`createElement(String tagName)` Создает элемент определенного типа.
`Элемент`	`createElementNS(String namespaceURI, String qualifiedName)` Создает элемент данного полностью определенного имени и URI пространства имен.
`EntityReference`	`createEntityReference(String name)` Создает `EntityReference` объект.
`ProcessingInstruction`	`createProcessingInstruction(String target, String data)` Создает a `ProcessingInstruction` узел, данный указанное имя и строки данных.
`Текст`	`createTextNode(String data)` Создает a `Text` узел, данный указанную строку.
`DocumentType`	`getDoctype()` Объявление Типа документа (см. `DocumentType`) связанный с этим документом.
`Элемент`	`getDocumentElement()` Это - атрибут удобства, который предоставляет прямой доступ к дочернему узлу, который является элементом документа документа.
`Строка`	`getDocumentURI()` Расположение документа или `null` если неопределенный или если `Document` создавался, используя `DOMImplementation.createDocument`.
`DOMConfiguration`	`getDomConfig()` Конфигурация, используемая, когда `Document.normalizeDocument()` вызывается.
`Элемент`	`getElementById(String elementId)` Возвраты `Element` у этого есть атрибут ID с данным значением.
`NodeList`	`getElementsByTagName(String tagname)` Возвраты a `NodeList` из весь `Elements` в документе упорядочивают с данным именем тега и содержатся в документе.
`NodeList`	`getElementsByTagNameNS(String namespaceURI, String localName)` Возвраты a `NodeList` из весь `Elements` с данным локальным именем и URI пространства имен в порядке документа.
`DOMImplementation`	`getImplementation()` `DOMImplementation` возразите, что обрабатывает этот документ.
`Строка`	`getInputEncoding()` Атрибут, определяющий кодирование, используется для этого документа во время парсинга.
`boolean`	`getStrictErrorChecking()` Атрибут, определяющий, осуществляется ли проверка на ошибки или нет.
`Строка`	`getXmlEncoding()` Определение атрибута, как часть объявления XML, кодирование этого документа.
`boolean`	`getXmlStandalone()` Определение атрибута, как часть объявления XML, автономен ли этот документ.
`Строка`	`getXmlVersion()` Определение атрибута, как часть объявления XML, номер версии этого документа.
`Узел`	`importNode(Node importedNode, boolean deep)` Импортирует узел от другого документа до этого документа, не изменяясь или удаляя исходный узел из оригинала документа; этот метод создает новую копию исходного узла.
`void`	`normalizeDocument()` Этот метод действует, как будто документ проходил через сохранение и цикл загрузки, помещая документ в "нормальную" форму.
`Узел`	`renameNode(Node n, String namespaceURI, String qualifiedName)` Переименуйте существующий узел типа `ELEMENT_NODE` или `ATTRIBUTE_NODE`.
`void`	`setDocumentURI(String documentURI)` Расположение документа или `null` если неопределенный или если `Document` создавался, используя `DOMImplementation.createDocument`.
`void`	`setStrictErrorChecking(boolean strictErrorChecking)` Атрибут, определяющий, осуществляется ли проверка на ошибки или нет.
`void`	`setXmlStandalone(boolean xmlStandalone)` Определение атрибута, как часть объявления XML, автономен ли этот документ.
`void`	`setXmlVersion(String xmlVersion)` Определение атрибута, как часть объявления XML, номер версии этого документа.

Методы, наследованные от интерфейса org.w3c.dom. Узел
appendChild, cloneNode, compareDocumentPosition, getAttributes, getBaseURI, getChildNodes, getFeature, getFirstChild, getLastChild, getLocalName, getNamespaceURI, getNextSibling, getNodeName, getNodeType, getNodeValue, getOwnerDocument, getParentNode, getPrefix, getPreviousSibling, getTextContent, getUserData, hasAttributes, hasChildNodes, insertBefore, isDefaultNamespace, isEqualNode, isSameNode, isSupported, lookupNamespaceURI, lookupPrefix, normalize, removeChild, replaceChild, setNodeValue, setPrefix, setTextContent, setUserData

Деталь метода

getDoctype
```
DocumentType getDoctype()
```
Объявление Типа документа (см. DocumentType) связанный с этим документом. Для XML-документов без объявления типа документа это возвращается null. Для документов HTML, a DocumentType объект может быть возвращен, независимо от присутствия или отсутствия объявления типа документа в документе HTML.
Это обеспечивает прямой доступ к DocumentType узел, дочерний узел этого Document. Этот узел может быть установлен во время создания документа и позже изменен с помощью дочерних методов манипулирования узлами, такой как Node.insertBefore, или Node.replaceChild. Отметьте, однако, это, в то время как некоторые реализации могут инстанцировать различных типов Document объекты, поддерживающие дополнительные функции чем "Ядро", такие как "HTML" [ДОМ Левель 2 HTML], основанный на DocumentType определенный во время создания, изменяя это впоследствии очень вряд ли приведет к изменению поддерживавших функций.

С тех пор:

ДОМ Левель 3

getImplementation
```
DOMImplementation getImplementation()
```
DOMImplementation возразите, что обрабатывает этот документ. Приложение ДОМА может использовать объекты от многократных реализаций.

getDocumentElement
```
Element getDocumentElement()
```
Это - атрибут удобства, который предоставляет прямой доступ к дочернему узлу, который является элементом документа документа.

createElement
```
Element createElement(String tagName)
                      throws DOMException
```
Создает элемент определенного типа. Отметьте что экземпляр возвращенные реализации Element интерфейс, таким образом, атрибуты могут быть определены непосредственно на возвращенном объекте.
Кроме того, если там известны атрибуты со значениями по умолчанию, Attr узлы, представляющие их, автоматически создаются и присоединяются к элементу.
Чтобы создать элемент с полностью определенным именем и URI пространства имен, используйте createElementNS метод.

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

Возвраты:
Новое Element объект с nodeName припишите набор tagName, и localName, prefix, и namespaceURI набор к null.

Броски:

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

createDocumentFragment
```
DocumentFragment createDocumentFragment()
```
Создает пустое DocumentFragment объект.

Возвраты:
Новое DocumentFragment.

createTextNode
```
Text createTextNode(String data)
```
Создает a Text узел, данный указанную строку.

Параметры:
data - Данные для узла.

Возвраты:
Новое Text объект.

createComment
```
Comment createComment(String data)
```
Создает a Comment узел, данный указанную строку.

Параметры:
data - Данные для узла.

Возвраты:
Новое Comment объект.

createCDATASection
```
CDATASection createCDATASection(String data)
                                throws DOMException
```
Создает a CDATASection узел, значение которого является указанной строкой.

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

Возвраты:
Новое CDATASection объект.

Броски:

DOMException - NOT_SUPPORTED_ERR: Повышенный, если этот документ является документом HTML.

createProcessingInstruction
```
ProcessingInstruction createProcessingInstruction(String target,
                                                String data)
                                                  throws DOMException
```
Создает a ProcessingInstruction узел, данный указанное имя и строки данных.

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

Возвраты:
Новое ProcessingInstruction объект.

Броски:

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

createAttribute
```
Attr createAttribute(String name)
                     throws DOMException
```
Создает Attr из имени. Отметьте что Attr экземпляр может тогда быть установлен на Element использование setAttributeNode метод.
Чтобы создать атрибут с полностью определенным именем и URI пространства имен, используйте createAttributeNS метод.

Параметры:
name - Имя атрибута.

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

Броски:

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

createEntityReference
```
EntityReference createEntityReference(String name)
                                      throws DOMException
```
Создает EntityReference объект. Кроме того, если объект, на который ссылаются, известен, дочерний список EntityReference узел делается тем же самым как тем из соответствия Entity узел.
Отметьте: Если любой потомок Entity у узла есть несвязанный префикс пространства имен, соответствующий потомок создаваемого EntityReference узел является также несвязанным; ( namespaceURI null). ДОМ Левель 2 и 3 не поддерживает механизма, чтобы разрешить префиксы пространства имен в этом случае.

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

Возвраты:
Новое EntityReference объект.

Броски:

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

getElementsByTagName
```
NodeList getElementsByTagName(String tagname)
```
Возвраты a NodeList из весь Elements в документе упорядочивают с данным именем тега и содержатся в документе.

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

Возвраты:
Новое NodeList объект, содержащий все соответствующее Elements.

importNode
```
Node importNode(Node importedNode,
              boolean deep)
                throws DOMException
```
Импортирует узел от другого документа до этого документа, не изменяясь или удаляя исходный узел из оригинала документа; этот метод создает новую копию исходного узла. У возвращенного узла нет никакого родителя; (parentNode null).
Для всех узлов, импортируя узел создает объект узла, принадлежавший документу импорта, со значениями атрибута, идентичными исходному узлу nodeName и nodeType, плюс атрибуты, связанные с пространствами имен (prefix, localName, и namespaceURI). Как в cloneNode работа, исходный узел не изменяется. Пользовательские данные, связанные с импортированным узлом, не переносятся. Однако, если любой UserDataHandlers был определен наряду со связанными данными, эти обработчики вызовут с соответствующими параметрами перед этим методом возвраты.
Дополнительная информация копируется как соответствующая nodeType, попытка зеркально отразить поведение, ожидаемое, если фрагмент XML или источника HTML был скопирован от одного документа до другого, распознавая, что у этих двух документов могут быть различные DTD в случае XML. Следующий список описывает специфические особенности для каждого типа узла.

ATTRIBUTE_NODE

ownerElement атрибут устанавливается в null и specified флаг устанавливается в true на сгенерированном Attr. Потомки источника Attr рекурсивно импортируются и получающиеся узлы, повторно собранные, чтобы сформировать соответствующее поддерево. Отметьте что deep параметр не имеет никакого эффекта на Attr узлы; они всегда переносят свои дочерние элементы с ними когда импортировано.

DOCUMENT_FRAGMENT_NODE

Если deep опция была установлена в true, потомки источника DocumentFragment рекурсивно импортируются и получающиеся узлы, повторно собранные под импортированным DocumentFragment сформировать соответствующее поддерево. Иначе, это просто генерирует пустое DocumentFragment.

DOCUMENT_NODE

Document узлы не могут быть импортированы.

DOCUMENT_TYPE_NODE

DocumentType узлы не могут быть импортированы.

ELEMENT_NODE

Указанные узлы атрибута исходного элемента импортируются, и сгенерированный Attr узлы присоединены к сгенерированному Element. Атрибуты по умолчанию не копируются, хотя, если документ, импортируемый в, определяет атрибуты по умолчанию для этого имени элемента, те присваиваются. Если importNode deep параметры были установлены к true, потомки исходного элемента рекурсивно импортируются и получающиеся узлы, повторно собранные, чтобы сформировать соответствующее поддерево.

ENTITY_NODE

Entity узлы могут быть импортированы, однако в текущем выпуске ДОМА DocumentType только для чтения. Возможность добавить эти импортированные узлы к a DocumentType будет рассмотрен для дополнения к будущему выпуску импорта DOM.On, publicId, systemId, и notationName атрибуты копируются. Если a deep импорт требуют, потомки источник Entity рекурсивно импортируются и получающиеся узлы, повторно собранные, чтобы сформировать соответствующее поддерево.

ENTITY_REFERENCE_NODE

Только EntityReference непосредственно копируется, даже если a deep импорт требуют, так как источник и целевые документы, возможно, определили объект по-другому. Если документ, импортируемый в, обеспечивает определение для этого имени объекта, его значение присваивается.

NOTATION_NODE

Notation узлы могут быть импортированы, однако в текущем выпуске ДОМА DocumentType только для чтения. Возможность добавить эти импортированные узлы к a DocumentType будет рассмотрен для дополнения к будущему выпуску импорта DOM.On, publicId и systemId атрибуты копируются. Отметьте что deep параметр не имеет никакого эффекта на этот тип узлов, так как у них не может быть никаких дочерних элементов.

PROCESSING_INSTRUCTION_NODE

Импортированный узел копирует target и data значения от таковых из исходного узла. Отметьте что deep параметр не имеет никакого эффекта на этот тип узлов, так как у них не может быть никаких дочерних элементов.

TEXT_NODE, CDATA_SECTION_NODE, COMMENT_NODE

Эти три типа узлов, наследовавшихся от CharacterData скопируйте их data и length атрибуты от таковых из исходного узла. Отметьте что deep параметр не имеет никакого эффекта на эти типы узлов, так как у них не может быть никаких дочерних элементов.

Параметры:
importedNode - Узел, чтобы импортировать.
deep - Если true, рекурсивно импортируйте поддерево под указанным узлом; если false, импортируйте только узел непосредственно, как объяснено выше. Это не имеет никакого эффекта на узлы, у которых не может быть никаких дочерних элементов, и на Attr, и EntityReference узлы.

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

Броски:

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

ДОМ Левель 2

createElementNS

Element createElementNS(String namespaceURI,
                      String qualifiedName)
                        throws DOMException

Создает элемент данного полностью определенного имени и URI пространства имен.
На [XML Пространства имен], приложения должны использовать значение null как namespaceURI параметр для методов, если они хотят не иметь никакого пространства имен.

Параметры:

namespaceURI - URI пространства имен элемента, чтобы создать.

qualifiedName - Полностью определенное имя элемента вводит, чтобы инстанцировать.

Возвраты:

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

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

Броски:

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 Пространства имен], или если qualifiedName или его префикс является "xmlns" и namespaceURI отличается от "http://www.w3.org/2000/xmlns/", или если namespaceURI "http://www.w3.org/2000/xmlns/" и ни один qualifiedName ни его префикс является "xmlns".
NOT_SUPPORTED_ERR: Всегда бросаемый, если действующий документ не поддерживает "XML" функция, так как пространства имен были определены XML.

С тех пор:

ДОМ Левель 2

createAttributeNS

Attr createAttributeNS(String namespaceURI,
                     String qualifiedName)
                       throws DOMException

Создает атрибут данного полностью определенного имени и URI пространства имен.
На [XML Пространства имен], приложения должны использовать значение null как namespaceURI параметр для методов, если они хотят не иметь никакого пространства имен.

Параметры:

namespaceURI - URI пространства имен атрибута, чтобы создать.

qualifiedName - Полностью определенное имя атрибута, чтобы инстанцировать.

Возвраты:

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

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

Броски:

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.

С тех пор:

ДОМ Левель 2

getElementsByTagNameNS
```
NodeList getElementsByTagNameNS(String namespaceURI,
                              String localName)
```
Возвраты a NodeList из весь Elements с данным локальным именем и URI пространства имен в порядке документа.

Параметры:
namespaceURI - URI пространства имен элементов, чтобы соответствовать на. Специальное значение "*" соответствия все пространства имен.
localName - Локальное имя элементов, чтобы соответствовать на. Специальное значение "*" соответствует все локальные имена.

Возвраты:
Новое NodeList объект, содержащий все соответствующее Elements.
С тех пор:

ДОМ Левель 2

getElementById
```
Element getElementById(String elementId)
```
Возвраты Element у этого есть атрибут ID с данным значением. Если никакой такой элемент не существует, это возвращается null . Если больше чем у одного элемента есть атрибут ID с тем значением, что возвращается, неопределено.
Реализация ДОМА, как ожидают, будет использовать атрибут Attr.isId определить, имеет ли атрибут идентификатор типа.
Отметьте: Атрибуты с именем "ID" или "идентификатор" не имеют идентификатора типа если столь не определено.

Параметры:
elementId - Уникальное id значение для элемента.

Возвраты:
Соответствующий элемент или null если нет ни одного.
С тех пор:

ДОМ Левель 2

getInputEncoding
```
String getInputEncoding()
```
Атрибут, определяющий кодирование, используется для этого документа во время парсинга. Это null когда это не известно, такой как тогда, когда Document создавался в памяти.

С тех пор:

ДОМ Левель 3

getXmlEncoding
```
String getXmlEncoding()
```
Определение атрибута, как часть объявления XML, кодирование этого документа. Это null когда неуказанный или когда это не известно, такой как тогда, когда Document создавался в памяти.

С тех пор:

ДОМ Левель 3

getXmlStandalone
```
boolean getXmlStandalone()
```
Определение атрибута, как часть объявления XML, автономен ли этот документ. Это false когда неуказанный.
Отметьте: Никакая проверка не делается на значении, устанавливая этот атрибут. Приложения должны использовать Document.normalizeDocument() с "проверить" параметром, чтобы проверить, соответствует ли значение ограничение законности для автономного объявления документа как определено в [XML 1.0].

С тех пор:

ДОМ Левель 3

setXmlStandalone
```
void setXmlStandalone(boolean xmlStandalone)
                      throws DOMException
```
Определение атрибута, как часть объявления XML, автономен ли этот документ. Это false когда неуказанный.
Отметьте: Никакая проверка не делается на значении, устанавливая этот атрибут. Приложения должны использовать Document.normalizeDocument() с "проверить" параметром, чтобы проверить, соответствует ли значение ограничение законности для автономного объявления документа как определено в [XML 1.0].

Броски:

DOMException - NOT_SUPPORTED_ERR: Повышенный, если этот документ не поддерживает функцию "XML".
С тех пор:

ДОМ Левель 3

getXmlVersion
```
String getXmlVersion()
```
Определение атрибута, как часть объявления XML, номер версии этого документа. Если нет никакого объявления и если этот документ поддерживает функцию "XML", значение "1.0". Если этот документ не поддерживает функцию "XML", значение всегда null. Изменение этого атрибута будет влиять на методы, которые проверяют на недопустимые символы на имена XML. Приложение должно вызвать Document.normalizeDocument() чтобы проверить на недопустимые символы в Nodes, которые уже являются частью этого Document.
Приложения ДОМА могут использовать DOMImplementation.hasFeature(feature, version) метод с параметром оценивает "XMLVersion" и "1.0" (соответственно), чтобы определить, поддерживает ли реализация [XML 1.0]. Приложения ДОМА могут использовать тот же самый метод со значениями параметра "XMLVersion" и "1.1" (соответственно), чтобы определить, поддерживает ли реализация [XML 1.1]. В обоих случаях, чтобы поддерживать XML, реализация должна также поддерживать функцию "XML", определенную в этой спецификации. Document объекты, поддерживающие версию функции "XMLVersion", не должны повысить a NOT_SUPPORTED_ERR исключение для того же самого номера версии при использовании Document.xmlVersion.

С тех пор:

ДОМ Левель 3

setXmlVersion
```
void setXmlVersion(String xmlVersion)
                   throws DOMException
```
Определение атрибута, как часть объявления XML, номер версии этого документа. Если нет никакого объявления и если этот документ поддерживает функцию "XML", значение "1.0". Если этот документ не поддерживает функцию "XML", значение всегда null. Изменение этого атрибута будет влиять на методы, которые проверяют на недопустимые символы на имена XML. Приложение должно вызвать Document.normalizeDocument() чтобы проверить на недопустимые символы в Nodes, которые уже являются частью этого Document.
Приложения ДОМА могут использовать DOMImplementation.hasFeature(feature, version) метод с параметром оценивает "XMLVersion" и "1.0" (соответственно), чтобы определить, поддерживает ли реализация [XML 1.0]. Приложения ДОМА могут использовать тот же самый метод со значениями параметра "XMLVersion" и "1.1" (соответственно), чтобы определить, поддерживает ли реализация [XML 1.1]. В обоих случаях, чтобы поддерживать XML, реализация должна также поддерживать функцию "XML", определенную в этой спецификации. Document объекты, поддерживающие версию функции "XMLVersion", не должны повысить a NOT_SUPPORTED_ERR исключение для того же самого номера версии при использовании Document.xmlVersion.

Броски:

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

ДОМ Левель 3

getStrictErrorChecking
```
boolean getStrictErrorChecking()
```
Атрибут, определяющий, осуществляется ли проверка на ошибки или нет. Когда установлено в false, реализация свободна не протестировать каждый возможный ошибочный случай, обычно определяемый на операциях ДОМА, и не повысить любого DOMException на операциях ДОМА или ошибках отчета, используя Document.normalizeDocument(). В случае ошибки поведение неопределено. Этот атрибут true по умолчанию.

С тех пор:

ДОМ Левель 3

setStrictErrorChecking
```
void setStrictErrorChecking(boolean strictErrorChecking)
```
Атрибут, определяющий, осуществляется ли проверка на ошибки или нет. Когда установлено в false, реализация свободна не протестировать каждый возможный ошибочный случай, обычно определяемый на операциях ДОМА, и не повысить любого DOMException на операциях ДОМА или ошибках отчета, используя Document.normalizeDocument(). В случае ошибки поведение неопределено. Этот атрибут true по умолчанию.

С тех пор:

ДОМ Левель 3

getDocumentURI
```
String getDocumentURI()
```
Расположение документа или null если неопределенный или если Document создавался, используя DOMImplementation.createDocument. Никакая лексическая проверка не выполняется, устанавливая этот атрибут; это могло привести к a null значение, возвращенное при использовании Node.baseURI .
Остерегайтесь этого когда Document поддерживает функцию "HTML" [ДОМ Левель 2 HTML], href атрибут элемента ОСНОВЫ HTML имеет приоритет по этому атрибуту, вычисляя Node.baseURI.

С тех пор:

ДОМ Левель 3

setDocumentURI
```
void setDocumentURI(String documentURI)
```
Расположение документа или null если неопределенный или если Document создавался, используя DOMImplementation.createDocument. Никакая лексическая проверка не выполняется, устанавливая этот атрибут; это могло привести к a null значение, возвращенное при использовании Node.baseURI .
Остерегайтесь этого когда Document поддерживает функцию "HTML" [ДОМ Левель 2 HTML], href атрибут элемента ОСНОВЫ HTML имеет приоритет по этому атрибуту, вычисляя Node.baseURI.

С тех пор:

ДОМ Левель 3

adoptNode
```
Node adoptNode(Node source)
               throws DOMException
```
Попытки принять узел от другого документа до этого документа. Если поддерживающийся, это изменяется ownerDocument из исходного узла, его дочерних элементов, так же как присоединенных узлов атрибута, если есть кто-либо. Если у исходного узла есть родитель, он сначала удаляется из дочернего списка его родителя. Это эффективно позволяет перемещать поддерево от одного документа до другого (в отличие от этого importNode() которые создают копию исходного узла вместо того, чтобы переместить это). Когда это перестало работать, приложения должны использовать Document.importNode() вместо этого. Отметьте, что, если принятый узел уже является частью этого документа (то есть исходный и целевой документ то же самое), этот метод все еще имеет эффект удаления исходного узла от дочернего списка его родителя, если любой. Следующий список описывает специфические особенности для каждого типа узла.

ATTRIBUTE_NODE

ownerElement атрибут устанавливается в null и specified флаг устанавливается в true на принятом Attr. Потомки источника Attr рекурсивно принимаются.

DOCUMENT_FRAGMENT_NODE

Потомки исходного узла рекурсивно принимаются.

DOCUMENT_NODE

Document узлы не могут быть приняты.

DOCUMENT_TYPE_NODE

DocumentType узлы не могут быть приняты.

ELEMENT_NODE

Принимаются указанные узлы атрибута исходного элемента. Атрибуты по умолчанию отбрасываются, хотя, если документ, принимаемый в, определяет атрибуты по умолчанию для этого имени элемента, те присваиваются. Потомки исходного элемента рекурсивно принимаются.

ENTITY_NODE

Entity узлы не могут быть приняты.

ENTITY_REFERENCE_NODE

Только EntityReference сам узел принимается, потомки отбрасываются, так как источник и целевые документы, возможно, определили объект по-другому. Если документ, импортируемый в, обеспечивает определение для этого имени объекта, его значение присваивается.

NOTATION_NODE

Notation узлы не могут быть приняты.

PROCESSING_INSTRUCTION_NODE, TEXT_NODE, CDATA_SECTION_NODE, COMMENT_NODE

Эти узлы могут все быть приняты. Никакие специфические особенности.

Отметьте: Так как это не создает новые узлы в отличие от этого Document.importNode() метод, этот метод не повышает INVALID_CHARACTER_ERR исключение, и приложения должны использовать Document.normalizeDocument() метод, чтобы проверить, не является ли импортированное имя именем XML согласно версии XML в использовании.

Параметры:
source - Узел, чтобы переместиться в этот документ.

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

Броски:

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

ДОМ Левель 3

getDomConfig
```
DOMConfiguration getDomConfig()
```
Конфигурация, используемая, когда Document.normalizeDocument() вызывается.

С тех пор:

ДОМ Левель 3

normalizeDocument
```
void normalizeDocument()
```
Этот метод действует, как будто документ проходил через сохранение и цикл загрузки, помещая документ в "нормальную" форму. Как следствие этот метод обновляет заменяющее дерево EntityReference узлы и нормализуют Text узлы, как определено в методе Node.normalize().
Иначе, фактический результат зависит от функций, устанавливаемых на Document.domConfig объект и управление, какие операции фактически имеют место. Заметно этот метод мог также сделать пространство имен документа правильно построенным согласно алгоритму описанный в, проверить символьную нормализацию, удалить CDATASection узлы, и т.д. См. DOMConfiguration для деталей.
```
// 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();
```
События мутации, когда поддерживающийся, сгенерированы, чтобы отразить изменения, происходящие на документе.
Если ошибки происходят во время вызова этого метода, такого как попытка обновить узел только для чтения или a Node.nodeName содержит недопустимый символ согласно версии XML в использовании, ошибках или предупреждениях (DOMError.SEVERITY_ERROR или DOMError.SEVERITY_WARNING) будет сообщаться, используя DOMErrorHandler объект связался с параметром "обработчика ошибок". Отметьте, что этот метод мог бы также сообщить о фатальных ошибках ( DOMError.SEVERITY_FATAL_ERROR) если реализация не может восстановиться с ошибки.
С тех пор:

ДОМ Левель 3

renameNode
```
Node renameNode(Node n,
              String namespaceURI,
              String qualifiedName)
                throws DOMException
```
Переименуйте существующий узел типа ELEMENT_NODE или ATTRIBUTE_NODE.
Когда возможный это просто изменяет название данного узла, иначе это создает новый узел с указанным именем и заменяет существующий узел новым узлом как описано ниже.
Просто изменяя название данного узла не возможен, следующие операции выполняются: новый узел создается, любой зарегистрированный слушатель события регистрируется на новом узле, любые пользовательские данные, присоединенные к старому узлу, удаляются из того узла, старый узел удаляется из его родителя, если это имеет один, дочерние элементы перемещаются в новый узел, если переименованный узел Element его атрибуты перемещаются в новый узел, новый узел вставляется в позиции старый узел, используемый, чтобы иметь в дочернем списке узлов его родителя, если это имеет один, пользовательские данные, которые были присоединены к старому узлу, присоединены к новому узлу.
Когда переименовываемый узел Element только указанные атрибуты перемещаются, атрибуты по умолчанию, порожденные из DTD, обновляются согласно новому имени элемента. Кроме того, реализация может обновить атрибуты по умолчанию из других схем. Приложения должны использовать Document.normalizeDocument() чтобы гарантировать эти атрибуты актуальны.
Когда переименовываемый узел Attr это присоединено Element, узел сначала удаляется из Element карта атрибутов. Затем, когда-то переименованный, или изменяя существующий узел или создавая новый как описано выше, это откладывается.
Кроме того,
- пользовательское событие данных NODE_RENAMED запускается,
- когда реализация поддерживает функцию "MutationNameEvents", каждая работа мутации, включенная в этот метод, запускает соответствующее событие, и в конец событие { http://www.w3.org/2001/xml-events, DOMElementNameChanged} или { http://www.w3.org/2001/xml-events, DOMAttributeNameChanged} запускается.
Параметры:
n - Узел, чтобы переименовать.
namespaceURI - Новый URI пространства имен.
qualifiedName - Новое полностью определенное имя.

Возвраты:
Переименованный узел. Это - или указанный узел или новый узел, который создавался, чтобы заменить указанный узел.

Броски:

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 Пространства имен]. Также повышенный, когда переименовываемый узел является атрибутом, если qualifiedName, или его префикс, "xmlns" и namespaceURI отличается от "http://www.w3.org/2000/xmlns/".
С тех пор:

ДОМ Левель 3

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2011, Oracle и/или его филиалы. Все права защищены.

Интерфейсный Документ

Полевая Сводка

Поля, наследованные от интерфейса org.w3c.dom. Узел

Сводка метода

Методы, наследованные от интерфейса org.w3c.dom. Узел

Деталь метода

getDoctype

getImplementation

getDocumentElement

createElement

createDocumentFragment

createTextNode

createComment

createCDATASection

createProcessingInstruction

createAttribute

createEntityReference

getElementsByTagName

importNode

createElementNS

createAttributeNS

getElementsByTagNameNS

getElementById

getInputEncoding

getXmlEncoding

getXmlStandalone

setXmlStandalone

getXmlVersion

setXmlVersion

getStrictErrorChecking

setStrictErrorChecking

getDocumentURI

setDocumentURI

adoptNode

getDomConfig

normalizeDocument

renameNode