compact2, compact3

org.w3c.dom

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

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

Узел

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

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