Атрибуты интерфейса

Все известные подинтерфейсы:: Attributes2

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

public interface Attributes

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

Этот интерфейс позволяет получить доступ к списку атрибутов тремя различными способами:

по индексу атрибута;
по имени с указанием пространства имён; или
по квалифицированному (с префиксом) имени.

Список не будет содержать атрибуты, объявленные как #IMPLIED, но не указанные в начальном теге. Также он не будет содержать атрибуты, используемые для объявления пространства имён (xmlns*), если функция http://xml.org/sax/features/namespace-prefixes не установлена в true (по умолчанию она false). Поскольку SAX2 соответствует первоначальной рекомендации «Пространства имён в XML», он обычно не присваивает URI пространства имён атрибутам объявлений пространства имён.

Некоторые парсеры SAX2 могут поддерживать необязательный флаг функции (http://xml.org/sax/features/xmlns-uris), чтобы запросить присвоение URI этим атрибутам, соответствуя более поздней несовместимой с обратной совместимостью редакции этой рекомендации. (Локальное имя атрибута будет префиксом или «xmlns», при определении пространства имён элемента по умолчанию.) Для обеспечения переносимости код обработчика всегда должен разрешать этот конфликт, а не требовать парсеров, которые могут изменить значение этого флага.

Если функция пространства имён (см. выше) установлена в false, доступ по квалифицированному имени может быть недоступен; если функция http://xml.org/sax/features/namespaces установлена в false, доступ по имени с указанием пространства имён может быть недоступен.

Этот интерфейс заменяет устаревший интерфейс SAX1 AttributeList, который не поддерживает пространства имён. В дополнение к поддержке пространств имён он добавляет методы getIndex (ниже).

Порядок атрибутов в списке не определён и будет варьироваться в разных реализациях.

С:

1.4, SAX 2.0

См. также:

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

Модификатор и тип	Метод	Описание
`int`	`getIndex(String qName)`	Поиск индекса атрибута по квалифицированному (с префиксом) имени XML.
`int`	`getIndex(String uri, String localName)`	Поиск индекса атрибута по имени пространства имён.
`int`	`getLength()`	Возвращает количество атрибутов в списке.
`String`	`getLocalName(int index)`	Поиск локального имени атрибута по индексу.
`String`	`getQName(int index)`	Поиск квалифицированного (с префиксом) имени XML атрибута по индексу.
`String`	`getType(int index)`	Поиск типа атрибута по индексу.
`String`	`getType(String qName)`	Поиск типа атрибута по квалифицированному (с префиксом) имени XML.
`String`	`getType(String uri, String localName)`	Поиск типа атрибута по имени пространства имён.
`String`	`getURI(int index)`	Поиск URI пространства имён атрибута по индексу.
`String`	`getValue(int index)`	Поиск значения атрибута по индексу.
`String`	`getValue(String qName)`	Поиск значения атрибута по квалифицированному (с префиксом) имени XML.
`String`	`getValue(String uri, String localName)`	Поиск значения атрибута по имени пространства имён.

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

getLength

int getLength()

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

После определения количества атрибутов вы можете перебрать список.

Возвращает:

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

См. также:

getURI

String getURI(int index)

Получение URI пространства имён атрибута по индексу.

Параметры:

index - Индекс атрибута (нумерация с нуля).

Возвращает:

URI пространства имён, или пустая строка, если URI отсутствует, или null, если индекс вне диапазона.

См. также:

getLocalName

String getLocalName(int index)

Получение локального имени атрибута по индексу.

Параметры:

index - Индекс атрибута (нумерация с нуля).

Возвращает:

Локальное имя, или пустая строка, если обработка пространства имён не выполняется, или null, если индекс вне диапазона.

См. также:

getQName

String getQName(int index)

Получение полному имени (с префиксом) атрибута по индексу.

Параметры:

index - Индекс атрибута (нумерация с нуля).

Возвращает:

Полное имя, или пустая строка, если имя отсутствует, или null, если индекс вне диапазона.

См. также:

getType

String getType(int index)

Получение типа атрибута по индексу.

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

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

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

Параметры:

index - Индекс атрибута (нумерация с нуля).

Возвращает:

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

См. также:

getValue

String getValue(int index)

Получение значения атрибута по индексу.

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

Параметры:

index - Индекс атрибута (нумерация с нуля).

Возвращает:

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

См. также:

getIndex

int getIndex(String uri, String localName)

Поиск индекса атрибута по имени пространства имён.

Параметры:: uri - URI пространства имён, или пустая строка, если у имени нет URI пространства имён.; localName - Локальное имя атрибута.
Возвращает:: Индекс атрибута, или -1, если он отсутствует в списке.

getIndex

int getIndex(String qName)

Поиск индекса атрибута по полному имени (с префиксом).

Параметры:: qName - Полное (с префиксом) имя.
Возвращает:: Индекс атрибута, или -1, если он отсутствует в списке.

getType

String getType(String uri, String localName)

Поиск типа атрибута по имени пространства имён.

См. getType(int) для описания возможных типов.

Параметры:: uri - URI пространства имён, или пустая строка, если у имени нет URI пространства имён.; localName - Локальное имя атрибута.
Возвращает:: Тип атрибута в виде строки, или null, если атрибута нет в списке или если обработка пространств имён не выполняется.

getType

String getType(String qName)

Поиск типа атрибута по полному имени (с префиксом).

См. getType(int) для описания возможных типов.

Параметры:: qName - Полное имя.
Возвращает:: Тип атрибута в виде строки, или null, если атрибута нет в списке или обработка полных имён недоступна.

getValue

String getValue(String uri, String localName)

Поиск значения атрибута по имени пространства имён.

См. getValue(int) для описания возможных значений.

Параметры:: uri - URI пространства имён, или пустая строка, если у имени нет URI пространства имён.; localName - Локальное имя атрибута.
Возвращает:: Значение атрибута в виде строки, или null, если атрибута нет в списке.

getValue

String getValue(String qName)

Поиск значения атрибута по полному имени (с префиксом).

См. getValue(int) для описания возможных значений.

Параметры:: qName - Полное имя.
Возвращает:: Значение атрибута в виде строки, или 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/Attributes.html