Интерфейс Attributes2

public interface Attributes2
extends Attributes

Расширение SAX2 для дополнения информации об атрибуте, предоставленной через Attributes. Если реализация поддерживает это расширение, атрибуты, предоставленные в ContentHandler.startElement() , будут реализовывать этот интерфейс, а флаг функции http://xml.org/sax/features/use-attributes2 будет иметь значение true.

Этот модуль, как исходный код, так и документация, находится в общественном достоянии и не несет никакой ГАРАНТИИ.

Реализации XMLReader не обязаны поддерживать эту информацию, и она не является частью только ядра распределений SAX2.

Обратите внимание, что если значение атрибута было установлено по умолчанию (!isSpecified()), то оно обязательно было объявлено (isDeclared()) в DTD. Точно так же, если тип атрибута отличается от CDATA, то он должен быть объявлен.

Методы

isDeclared

boolean isDeclared(int index)

Возвращает false, если атрибут не был объявлен в DTD. Это помогает различать два вида атрибутов, которые SAX сообщает как CDATA: те, которые были объявлены (и поэтому обычно допустимы), и те, которые не были (и которые никогда не допустимы).

Параметры:

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

Возвращает:

true, если атрибут был объявлен в DTD, иначе false.

Исключения:

ArrayIndexOutOfBoundsException - Если переданный индекс не соответствует атрибуту.

isDeclared

boolean isDeclared(String qName)

Возвращает false, если атрибут не был объявлен в DTD. Это помогает различать два вида атрибутов, которые SAX сообщает как CDATA: те, которые были объявлены (и поэтому обычно допустимы), и те, которые не были (и которые никогда не допустимы).

Параметры:

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

Возвращает:

true, если атрибут был объявлен в DTD, иначе false.

Исключения:

IllegalArgumentException - Если переданное имя не соответствует атрибуту.

isDeclared

boolean isDeclared(String uri,
                   String localName)

Параметры:

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

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

Возвращает:

true, если атрибут был объявлен в DTD, иначе false.

Исключения:

IllegalArgumentException - Если переданные имена не соответствуют атрибуту.

isSpecified

boolean isSpecified(int index)

Возвращает true, если значение атрибута не было предоставлено по умолчанию из DTD.

Параметры:

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

Возвращает:

true, если значение было найдено в тексте XML, иначе false, если значение было предоставлено по умолчанию из DTD.

Исключения:

ArrayIndexOutOfBoundsException - Если переданный индекс не соответствует атрибуту.

isSpecified

boolean isSpecified(String uri,
                    String localName)

Параметры:

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

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

Возвращает:

true, если значение было найдено в тексте XML, иначе false, если значение было предоставлено по умолчанию из DTD.

Исключения:

IllegalArgumentException - Если переданные имена не соответствуют атрибуту.

isSpecified

boolean isSpecified(String qName)

Возвращает true, если значение атрибута не было предоставлено по умолчанию из DTD.

Параметры:

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

Возвращает:

true, если значение было найдено в тексте XML, иначе false, если значение было предоставлено по умолчанию из DTD.

Исключения:

IllegalArgumentException - Если переданное имя не соответствует атрибуту.