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

Все известные подинтерфейсы:: 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(int)
getLocalName(int)
getQName(int)
getType(int)
getValue(int)

getURI

String getURI(int index)

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

Параметры:

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

Возвращает:

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

См. также:

getLength()

getLocalName

String getLocalName(int index)

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

Параметры:

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

Возвращает:

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

См. также:

getLength()

getQName

String getQName(int index)

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

Параметры:

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

Возвращает:

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

См. также:

getLength()

getType

String getType(int index)

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

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

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

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

Параметры:

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

Возвращает:

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

См. также:

getLength()

getValue

String getValue(int index)

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

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

Параметры:

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

Возвращает:

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

См. также:

getLength()

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, 2021, 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://docs.oracle.com/en/java/javase/17/docs/api/java.xml/org/xml/sax/Attributes.html