Интерфейс AttributeList

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

@Deprecated(since="1.5") public interface AttributeList

Устарело.

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

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

Это исходный интерфейс 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");
   [...]
 }

С:

1.4, SAX 1.0

См. также:

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

Модификатор и тип	Метод	Описание
`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, если индекс находится вне диапазона.

См. также:

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, если индекс находится вне диапазона.

См. также:

getValue

String getValue(int i)

Устарело.

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

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

Параметры:

i - Индекс атрибута в списке (начиная с 0).

Возвращает:

Значение атрибута в виде строки или null, если индекс находится вне диапазона.

См. также:

getType

String getType(String name)

Устарело.

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

Возвращаемое значение совпадает с возвращаемым значением для getType(int).

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

Параметры:

name - Имя атрибута.

Возвращает:

Тип атрибута в виде строки или null, если такого атрибута не существует.

См. также:

getValue

String getValue(String name)

Устарело.

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

Возвращаемое значение совпадает с возвращаемым значением для getValue(int).

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

Параметры:

name - имя возвращаемого атрибута

Возвращает:

Значение атрибута в виде строки или null, если такого атрибута не существует.

См. также:

© 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/xml/sax/AttributeList.html