Интерфейс NamedNodeMap

public interface NamedNodeMap

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

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

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

Since:: 1.4, DOM Level 2

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

Модификатор и тип	Метод	Описание
`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)`	Добавляет узел, используя его локальное имя и URI пространства имён.

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

getNamedItem

Node getNamedItem(String name)

Возвращает узел, заданный именем.

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

setNamedItem

Node setNamedItem(Node arg) throws DOMException

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

Параметры:: arg - Узел для хранения в этой карте. Узел впоследствии будет доступен по значению его атрибута имени.
Возвращает:: Если новый узел заменяет существующий, возвращается заменённый узел, иначе возвращается null.
Исключения:: DOMException - WRONG_DOCUMENT_ERR: Выбрасывается, если arg был создан из другого документа, чем тот, который создал эту карту.
NO_MODIFICATION_ALLOWED_ERR: Выбрасывается, если эта карта является только для чтения.
INUSE_ATTRIBUTE_ERR: Выбрасывается, если arg является атрибутом, который уже является атрибутом другого объекта Element. Пользователь DOM должен явно клонировать Attr узлы, чтобы повторно использовать их в других элементах.
HIERARCHY_REQUEST_ERR: Выбрасывается, если попытка добавить узел не соответствует структуре этой карты. Примеры включают попытку вставки чего-либо, кроме узла Attr, в карту атрибутов элемента или узла, не являющегося 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 больше или равно количеству узлов в этой карте, возвращается 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 - Узел для хранения в этой карте. Узел впоследствии будет доступен по значению его атрибутов URI пространства имён и локального имени.
Возвращает:: Если новый узел заменяет существующий, возвращается заменённый узел, иначе возвращается null.
Исключения:: DOMException - WRONG_DOCUMENT_ERR: Выбрасывается, если arg был создан из другого документа, чем тот, который создал эту карту.
NO_MODIFICATION_ALLOWED_ERR: Выбрасывается, если эта карта является только для чтения.
INUSE_ATTRIBUTE_ERR: Выбрасывается, если arg является атрибутом, который уже является атрибутом другого объекта Element. Пользователь DOM должен явно клонировать Attr узлы, чтобы повторно использовать их в других элементах.
HIERARCHY_REQUEST_ERR: Выбрасывается, если попытка добавить узел не соответствует структуре этой карты. Примеры включают попытку вставки чего-либо, кроме узла Attr, в карту атрибутов элемента или узла, не являющегося 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, 2025, 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://download.java.net/java/early_access/jdk24/docs/api/java.xml/org/w3c/dom/NamedNodeMap.html