Spec-Zone.ru › OpenJDK 8

Интерфейс AttributeList

Все известные реализующие классы:
AttributeListImpl

Устаревший.

Этот интерфейс был заменен интерфейсом SAX2 Attributes, который включает поддержку пространства имён.

public interface AttributeList

Интерфейс для указания атрибутов элемента.

Этот модуль, как исходный код, так и документация, находится в общественном достоянии и не имеет ГАРАНТИЙ. См. http://www.saxproject.org для получения дополнительной информации.

Это оригинальный интерфейс SAX1 для отчёта об атрибутах элемента. В отличие от нового интерфейса Attributes, он не поддерживает информацию, связанную с пространствами имён.

Когда список атрибутов предоставляется в качестве части события startElement, список вернёт корректные результаты только в течение действия события; после того как обработчик событий вернёт управление парсеру, список атрибутов будет недействительным. Чтобы сохранить постоянную копию списка атрибутов, используйте вспомогательный класс SAX1 AttributeListImpl.

Список атрибутов включает только атрибуты, которые были заданы или заданы по умолчанию: атрибуты #IMPLIED не будут включены.

Существует два способа, которыми приложение SAX может получить информацию из AttributeList. Во-первых, оно может итерировать по всему списку:

public void startElement (String name, AttributeList atts) {
   for (int i = 0; i < atts.getLength(); i++) {
     String name = atts.getName(i);
     String type = atts.getType(i);
     String value = atts.getValue(i);
     [...]
   }
 }

(Обратите внимание, что результат getLength() будет равен нулю, если атрибутов нет.)

В качестве альтернативы, приложение может запросить значение или тип определённых атрибутов:

public void startElement (String name, AttributeList atts) {
   String identifier = atts.getValue("id");
   String label = atts.getValue("label");
   [...]
 }
С:
SAX 1.0
См. также:
startElement, AttributeListImpl

Методы

Модификатор и тип Метод и описание
int getLength()

Устаревший.

Возвращает количество атрибутов в этом списке.

String getName(int i)

Устаревший.

Возвращает имя атрибута в этом списке (по позиции).

String getType(int i)

Устаревший.

Возвращает тип атрибута в списке (по позиции).

String getType(String name)

Устаревший.

Возвращает тип атрибута в списке (по имени).

String getValue(int i)

Устаревший.

Возвращает значение атрибута в списке (по позиции).

String getValue(String name)

Устаревший.

Возвращает значение атрибута в списке (по имени).

Методы

getLength

int getLength()

Устаревший.

Возвращает количество атрибутов в этом списке.

Парсер SAX может предоставлять атрибуты в произвольном порядке, независимо от порядка их объявления или задания. Количество атрибутов может быть нулевым.

Возвращает:
Количество атрибутов в списке.

getName

String getName(int i)

Устаревший.

Возвращает имя атрибута в этом списке (по позиции).

Имена должны быть уникальными: парсер SAX не должен включать один и тот же атрибут дважды. Атрибуты без значений (те, которые объявлены #IMPLIED без указанного значения в открывающем теге) будут исключены из списка.

Если имя атрибута имеет префикс пространства имён, префикс по-прежнему будет присоединён.

Параметры:
i - Индекс атрибута в списке (начиная с 0).
Возвращает:
Имя индексированного атрибута или null, если индекс вне диапазона.
См. также:
getLength()

getType

String getType(int i)

Устаревший.

Возвращает тип атрибута в списке (по позиции).

Тип атрибута — одна из строк "CDATA", "ID", "IDREF", "IDREFS", "NMTOKEN", "NMTOKENS", "ENTITY", "ENTITIES" или "NOTATION" (всегда заглавными буквами).

Если парсер не прочитал объявление для атрибута или не сообщает о типах атрибутов, он должен вернуть значение "CDATA", как указано в рекомендациях XML 1.0 (пункт 3.3.3, "Нормализация значений атрибутов").

Для атрибута перечисления, который не является обозначением, парсер сообщит тип как "NMTOKEN".

Параметры:
i - Индекс атрибута в списке (начиная с 0).
Возвращает:
Тип атрибута в виде строки или null, если индекс вне диапазона.
См. также:
getLength(), getType(java.lang.String)

getValue

String getValue(int i)

Устаревший.

Возвращает значение атрибута в списке (по позиции).

Если значение атрибута является списком токенов (IDREFS, ENTITIES или NMTOKENS), токены будут конкатенированы в одну строку, разделённую пробелами.

Параметры:
i - Индекс атрибута в списке (начиная с 0).
Возвращает:
Значение атрибута в виде строки или null, если индекс вне диапазона.
См. также:
getLength(), getValue(java.lang.String)

getType

String getType(String name)

Устаревший.

Возвращает тип атрибута в списке (по имени).

Возвращаемое значение такое же, как возвращаемое значение для getType(int).

Если имя атрибута имеет префикс пространства имён в документе, приложение должно включить его сюда.

Параметры:
name - Имя атрибута.
Возвращает:
Тип атрибута в виде строки или null, если такого атрибута нет.
См. также:
getType(int)

getValue

String getValue(String name)

Устаревший.

Возвращает значение атрибута в списке (по имени).

Возвращаемое значение такое же, как возвращаемое значение для getValue(int).

Если имя атрибута имеет префикс пространства имён в документе, приложение должно включить его сюда.

Параметры:
name - имя атрибута, для которого нужно получить значение
Возвращает:
Значение атрибута в виде строки или null, если такого атрибута нет.
См. также:
getValue(int)

© 1993, 2020, 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.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API