Интерфейс атрибутов

public interface Attributes

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

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

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

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

Список не будет содержать атрибуты, которые были объявлены #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 (ниже).

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

Методы

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)

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

Параметры:

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

Возвращает:

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

См. также:

getLength()

getType

String getType(int index)

Параметры:

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

Возвращает:

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

См. также:

getLength()

getValue

String getValue(int index)

Параметры:

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

Возвращает:

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

См. также:

getLength()

getIndex

int getIndex(String uri,
             String localName)

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

Параметры:

uri - URI пространства имён, или пустая строка, если у имени нет URI пространства имён.

localName - Локальное имя атрибута.

Возвращает:

Индекс атрибута, или -1, если он отсутствует в списке.

getIndex

int getIndex(String qName)

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

Параметры:

qName - Квалифицированное (с префиксом) имя.

Возвращает:

Индекс атрибута, или -1, если он отсутствует в списке.

getType

String getType(String uri,
               String localName)

Параметры:

uri - URI пространства имён, или пустая строка, если у имени нет URI пространства имён.

localName - Локальное имя атрибута.

Возвращает:

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

getType

String getType(String qName)

Параметры:

qName - Квалифицированное имя XML.

Возвращает:

Тип атрибута в виде строки, или null, если атрибут отсутствует в списке или квалифицированные имена недоступны.

getValue

String getValue(String uri,
                String localName)

Параметры:

uri - URI пространства имён, или пустая строка, если у имени нет URI пространства имён.

localName - Локальное имя атрибута.

Возвращает:

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

getValue

String getValue(String qName)

Параметры:

qName - Квалифицированное имя XML.

Возвращает:

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