NamedNodeMap (Платформа Java SE 7)

```
public interface NamedNodeMap
```
Объекты реализовывая NamedNodeMap интерфейс используется, чтобы представить наборы узлов, к которым можно получить доступ по имени. Отметьте это NamedNodeMap не наследовался от NodeList; NamedNodeMaps не сохраняются ни в каком определенном порядке. Объекты содержатся в объектной реализации NamedNodeMap май также быть полученным доступ порядковым индексом, но это должно просто позволить удобное перечисление содержания a NamedNodeMap, и не подразумевает, что ДОМ определяет порядок к этим Узлам.
NamedNodeMap объекты в ДОМЕ живы.
См. также Объектную модель документа (ДОМ) Спецификация Ядра Уровня 3.

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

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

- Деталь метода
  - getNamedItem
```
Node getNamedItem(String name)
```
    Получает узел, определенный по имени.
    
    Параметры:
    name - nodeName из узла, чтобы получить.
    
    Возвраты:
    A Node (любого типа) с указанным nodeName, или null если это не идентифицирует узла в этой карте.
  - setNamedItem
```
Node setNamedItem(Node arg)
                  throws DOMException
```
    Добавляет узел, используя nodeName атрибут. Если узел с тем именем уже присутствует в этой карте, это заменяется новым. Замена узла отдельно не имеет никакого эффекта.
    Как nodeName атрибут используется, чтобы получить имя, которое узел должен быть сохранен под, многократные узлы определенных типов (те, у которых есть "специальное" строковое значение), не может быть сохранен, поскольку имена столкнулись бы. Это замечается как предпочтительное для разрешения узлов быть искаженным.
    
    Параметры:
    arg - Узел, чтобы сохранить в этой карте. Узел позже будет доступным использованием значения nodeName атрибут.
    
    Возвраты:
    Если новое Node заменяет существующий узел замененный Node возвращается, иначе null возвращается.
    
    Броски:
    
    DOMException - WRONG_DOCUMENT_ERR: Повышенный, если arg создавался из различного документа чем тот, который создал эту карту.
    NO_MODIFICATION_ALLOWED_ERR: Повышенный, если эта карта только для чтения.
    INUSE_ATTRIBUTE_ERR: Повышенный, если arg Attr это уже - атрибут другого Element объект. Пользователь ДОМА должен явно клонироваться Attr узлы, чтобы снова использовать их в других элементах.
    HIERARCHY_REQUEST_ERR: Повышенный, если попытка предпринимается, чтобы добавить узел, не принадлежит в этом NamedNodeMap. Примеры включали бы попытку вставить что-то другое чем узел Attr в карту Элемента атрибутов, или узел небытия в карту DocumentType Объектов.
  - removeNamedItem
```
Node removeNamedItem(String name)
                     throws DOMException
```
    Удаляет узел, определенный по имени. Когда эта карта содержит атрибуты, присоединенные к элементу, если у удаленного атрибута, как известно, есть значение по умолчанию, атрибут сразу появляется содержащий значение по умолчанию так же как соответствующий URI пространства имен, локальное имя, и префикс когда применимый.
    
    Параметры:
    name - nodeName из узла, чтобы удалить.
    
    Возвраты:
    Узел, удаленный из этой карты, если узел с таким именем существует.
    
    Броски:
    
    DOMException - NOT_FOUND_ERR: Повышенный, если нет никакого названного узла name в этой карте.
    NO_MODIFICATION_ALLOWED_ERR: Повышенный, если эта карта только для чтения.
  - элемент
```
Node item(int index)
```
    Возвраты indexэлемент th в карте. Если index больше чем или равен числу узлов в этой карте, это возвращается null.
    
    Параметры:
    index - Индекс в эту карту.
    
    Возвраты:
    Узел в indexпозиция th в карте, или null если это не допустимый индекс.
  - getLength
```
int getLength()
```
    Число узлов в этой карте. Диапазон допустимых дочерних индексов узла 0 к length-1 включительно.
  - getNamedItemNS
```
Node getNamedItemNS(String namespaceURI,
                  String localName)
                    throws DOMException
```
    Получает узел, определенный локальным именем и URI пространства имен.
    На [XML Пространства имен], приложения должны использовать нуль значения в качестве namespaceURI параметра для методов, если они хотят не иметь никакого пространства имен.
    
    Параметры:
    namespaceURI - URI пространства имен узла, чтобы получить.
    localName - Локальное имя узла, чтобы получить.
    
    Возвраты:
    A Node (любого типа) с указанным локальным именем и URI пространства имен, или null если они не идентифицируют узла в этой карте.
    
    Броски:
    
    DOMException - NOT_SUPPORTED_ERR: Может быть повышен, если реализация не поддерживает функцию "XML", и язык, представленный через Документ, не поддерживает XML Пространства имен (такие как [HTML 4.01]).
    С тех пор:
    
    ДОМ Левель 2
  - setNamedItemNS
```
Node setNamedItemNS(Node arg)
                    throws DOMException
```
    Добавляет узел, используя namespaceURI и localName. Если узел с тем URI пространства имен и что локальное имя уже присутствует в этой карте, оно заменяется новым. Замена узла отдельно не имеет никакого эффекта.
    На [XML Пространства имен], приложения должны использовать нуль значения в качестве namespaceURI параметра для методов, если они хотят не иметь никакого пространства имен.
    
    Параметры:
    arg - Узел, чтобы сохранить в этой карте. Узел позже будет доступным использованием значения namespaceURI и localName атрибуты.
    
    Возвраты:
    Если новое Node заменяет существующий узел замененный Node возвращается, иначе null возвращается.
    
    Броски:
    
    DOMException - WRONG_DOCUMENT_ERR: Повышенный, если arg создавался из различного документа чем тот, который создал эту карту.
    NO_MODIFICATION_ALLOWED_ERR: Повышенный, если эта карта только для чтения.
    INUSE_ATTRIBUTE_ERR: Повышенный, если arg Attr это уже - атрибут другого Element объект. Пользователь ДОМА должен явно клонироваться Attr узлы, чтобы снова использовать их в других элементах.
    HIERARCHY_REQUEST_ERR: Повышенный, если попытка предпринимается, чтобы добавить узел, не принадлежит в этом NamedNodeMap. Примеры включали бы попытку вставить что-то другое чем узел Attr в карту Элемента атрибутов, или узел небытия в карту DocumentType Объектов.
    NOT_SUPPORTED_ERR: Может быть повышен, если реализация не поддерживает функцию "XML", и язык, представленный через Документ, не поддерживает XML Пространства имен (такие как [HTML 4.01]).
    С тех пор:
    
    ДОМ Левель 2
  - removeNamedItemNS
```
Node removeNamedItemNS(String namespaceURI,
                     String localName)
                       throws DOMException
```
    Удаляет узел, определенный локальным именем и URI пространства имен. У удаленного атрибута, как может быть известно, есть значение по умолчанию, когда эта карта содержит атрибуты, присоединенные к элементу, как возвращено атрибутом атрибутов Node интерфейс. Если так, атрибут сразу появляется содержащий значение по умолчанию так же как соответствующий URI пространства имен, локальное имя, и префикс когда применимый.
    На [XML Пространства имен], приложения должны использовать нуль значения в качестве namespaceURI параметра для методов, если они хотят не иметь никакого пространства имен.
    
    Параметры:
    namespaceURI - URI пространства имен узла, чтобы удалить.
    localName - Локальное имя узла, чтобы удалить.
    
    Возвраты:
    Узел, удаленный из этой карты, если узел с таким локальным именем и URI пространства имен существует.
    
    Броски:
    
    DOMException - NOT_FOUND_ERR: Повышенный, если нет никакого узла с указанным namespaceURI и localName в этой карте.
    NO_MODIFICATION_ALLOWED_ERR: Повышенный, если эта карта только для чтения.
    NOT_SUPPORTED_ERR: Может быть повышен, если реализация не поддерживает функцию "XML", и язык, представленный через Документ, не поддерживает XML Пространства имен (такие как [HTML 4.01]).
    С тех пор:
    
    ДОМ Левель 2

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

Интерфейсный NamedNodeMap

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

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

getNamedItem

setNamedItem

removeNamedItem

элемент

getLength

getNamedItemNS

setNamedItemNS

removeNamedItemNS