Интерфейс NamedNodeMap

public interface NamedNodeMap

Объекты, реализующие интерфейс NamedNodeMap, используются для представления наборов узлов, к которым можно получить доступ по имени. Обратите внимание, что NamedNodeMap не наследуется от NodeList; NamedNodeMaps не сохраняются в определенном порядке. Объекты, содержащиеся в объекте, реализующем NamedNodeMap, также могут быть доступны по порядковому индексу, но это просто для удобной перечисления содержимого NamedNodeMap, и это не подразумевает, что DOM определяет порядок этих узлов.

NamedNodeMap объекты в DOM являются динамическими.

См. также Спецификацию Document Object Model (DOM) Level 3 Core.

Краткое описание методов

Модификатор и тип	Метод	Описание
`int`	`getLength()`	Количество узлов в этом отображении.
`Node`	`getNamedItem(String name)`	Извлекает узел, заданный именем.
`Node`	`getNamedItemNS(String namespaceURI, String localName)`	Извлекает узел, заданный локальным именем и URI пространства имен.
`Node`	`item(int index)`	Возвращает `index`-й элемент в отображении.
`Node`	`removeNamedItem(String name)`	Удаляет узел, заданный именем.
`Node`	`removeNamedItemNS(String namespaceURI, String localName)`	Удаляет узел, заданный локальным именем и URI пространства имен.
`Node`	`setNamedItem(Node arg)`	Добавляет узел, используя его атрибут `nodeName`.
`Node`	`setNamedItemNS(Node arg)`	Добавляет узел, используя его атрибуты `namespaceURI` и `localName`.

Подробное описание методов

getNamedItem

Node getNamedItem(String name)

Извлекает узел, заданный именем.

Параметры:: name - Имя узла для извлечения.
Возвращает:: Узел (любого типа) с указанным именем, или null, если он не идентифицирует ни одного узла в этом отображении.

setNamedItem

Node setNamedItem(Node arg) throws DOMException

Добавляет узел, используя его атрибут nodeName. Если узел с таким именем уже существует в этом отображении, он заменяется новым. Замена узла самим собой не имеет эффекта.
Поскольку атрибут nodeName используется для получения имени, под которым должен храниться узел, несколько узлов определенных типов (тех, которые имеют "специальное" строковое значение) не могут быть сохранены, так как имена будут конфликтовать. Это считается предпочтительным, чем разрешение алиасов узлов.

Параметры:: arg - Узел для хранения в этом отображении. Узел будет доступен позже с помощью значения его атрибута nodeName.
Возвращает:: Если новый узел заменяет существующий, возвращается замененный узел, иначе возвращается null.
Исключения:: DOMException - WRONG_DOCUMENT_ERR: Возникает, если arg был создан из другого документа, чем тот, который создал это отображение.
NO_MODIFICATION_ALLOWED_ERR: Возникает, если это отображение является только для чтения.
INUSE_ATTRIBUTE_ERR: Возникает, если arg является атрибутом, который уже является атрибутом другого объекта Element. Пользователь DOM должен явно клонировать Attr узлы для повторного использования в других элементах.
HIERARCHY_REQUEST_ERR: Возникает, если попытка добавить узел не соответствует этому NamedNodeMap. Примеры включают попытку вставить что-то кроме узла Attr в отображение атрибутов элемента или узел, не являющийся Entity, в отображение Entity DocumentType.

removeNamedItem

Node removeNamedItem(String name) throws DOMException

Удаляет узел, заданный именем. Когда это отображение содержит атрибуты, прикрепленные к элементу, если удаленный атрибут известен как имеющий значение по умолчанию, сразу появляется атрибут, содержащий значение по умолчанию, а также соответствующий URI пространства имен, локальное имя и префикс, когда это применимо.

Параметры:: name - Имя узла для удаления.
Возвращает:: Узел, удаленный из этого отображения, если узел с таким именем существует.
Исключения:: DOMException - NOT_FOUND_ERR: Возникает, если в этом отображении нет узла с именем name.
NO_MODIFICATION_ALLOWED_ERR: Возникает, если это отображение является только для чтения.

item

Node item(int index)

Возвращает index-й элемент в отображении. Если index больше или равно количеству узлов в этом отображении, возвращается null.

Параметры:: index - Индекс в этом отображении.
Возвращает:: Узел в index-й позиции в отображении, или null если это не является допустимым индексом.

getLength

int getLength()

Количество узлов в этом отображении. Диапазон допустимых индексов узлов-потомков от 0 до length-1 включительно.

getNamedItemNS

Node getNamedItemNS(String namespaceURI, String localName) throws DOMException

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

Параметры:: namespaceURI - URI пространства имен узла для извлечения.; localName - Локальное имя узла для извлечения.
Возвращает:: Узел (любого типа) с заданным локальным именем и URI пространства имен, или null если они не идентифицируют ни одного узла в этом отображении.
Исключения:: DOMException - NOT_SUPPORTED_ERR: Может быть вызван, если реализация не поддерживает функцию "XML" и язык, доступный через Document, не поддерживает XML пространства имен (такие как [HTML 4.01]).
С:: 1.4, DOM Level 2

setNamedItemNS

Node setNamedItemNS(Node arg) throws DOMException

Добавляет узел, используя его URI пространства имен и локальное имя. Если узел с таким URI пространства имен и локальным именем уже существует в этом отображении, он заменяется новым. Замена узла самим собой не имеет эффекта.
Согласно [XML Namespaces] , приложения должны использовать значение null в качестве параметра namespaceURI для методов, если они не хотят использовать пространство имен.

Параметры:: arg - Узел для хранения в этом отображении. Узел будет доступен позже с помощью значения его атрибутов namespaceURI и localName.
Возвращает:: Если новый узел заменяет существующий, возвращается замененный узел, иначе возвращается null.
Исключения:: DOMException - WRONG_DOCUMENT_ERR: Возникает, если arg был создан из другого документа, чем тот, который создал это отображение.
NO_MODIFICATION_ALLOWED_ERR: Возникает, если это отображение является только для чтения.
INUSE_ATTRIBUTE_ERR: Возникает, если arg является атрибутом, который уже является атрибутом другого объекта Element. Пользователь DOM должен явно клонировать Attr узлы для повторного использования в других элементах.
HIERARCHY_REQUEST_ERR: Возникает, если попытка добавить узел не соответствует этому NamedNodeMap. Примеры включают попытку вставить что-то кроме узла Attr в отображение атрибутов элемента или узел, не являющийся Entity, в отображение Entity DocumentType.
NOT_SUPPORTED_ERR: Может быть вызван, если реализация не поддерживает функцию "XML" и язык, доступный через Document, не поддерживает XML пространства имен (такие как [HTML 4.01]).
С:: 1.4, DOM Level 2

removeNamedItemNS

Node removeNamedItemNS(String namespaceURI, String localName) throws DOMException

Удаляет узел, заданный локальным именем и URI пространства имен. Удаленный атрибут может быть известен как имеющий значение по умолчанию, когда это отображение содержит атрибуты, прикрепленные к элементу, как возвращается атрибутом attributes интерфейса Node. Если это так, то сразу появляется атрибут, содержащий значение по умолчанию, а также соответствующий URI пространства имен, локальное имя и префикс, когда это применимо.
Согласно [XML Namespaces] , приложения должны использовать значение null в качестве параметра namespaceURI для методов, если они не хотят использовать пространство имен.

Параметры:: namespaceURI - URI пространства имен узла для удаления.; localName - Локальное имя узла для удаления.
Возвращает:: Узел, удаленный из этого отображения, если узел с таким локальным именем и URI пространства имен существует.
Исключения:: DOMException - NOT_FOUND_ERR: Возникает, если нет узла со указанным namespaceURI и localName в этом отображении.
NO_MODIFICATION_ALLOWED_ERR: Возникает, если это отображение является только для чтения.
NOT_SUPPORTED_ERR: Может быть вызван, если реализация не поддерживает функцию "XML" и язык, доступный через Document, не поддерживает XML пространства имен (такие как [HTML 4.01]).
С:: 1.4, DOM Level 2

© 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/NamedNodeMap.html