Интерфейс Attributes2

Все суперинтерфейсы:: Attributes

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

public interface Attributes2 extends Attributes

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

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

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

Начиная с версии:: 1.5, SAX 2.0 (расширения 1.1 alpha)

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

Модификатор и тип	Метод	Описание
`boolean`	`isDeclared(int index)`	Возвращает false, если атрибут не был объявлен в DTD.
`boolean`	`isDeclared(String qName)`	Возвращает false, если атрибут не был объявлен в DTD.
`boolean`	`isDeclared(String uri, String localName)`	Возвращает false, если атрибут не был объявлен в DTD.
`boolean`	`isSpecified(int index)`	Возвращает true, если значение атрибута не было задано по умолчанию в DTD.
`boolean`	`isSpecified(String qName)`	Возвращает true, если значение атрибута не было задано по умолчанию в DTD.
`boolean`	`isSpecified(String uri, String localName)`	Возвращает true, если значение атрибута не было задано по умолчанию в DTD.

Методы, объявленные в интерфейсе Attributes

getIndex, getIndex, getLength, getLocalName, getQName, getType, getType, getType, getURI, getValue, getValue, getValue

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

isDeclared

boolean isDeclared(int index)

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

Параметры:: index — Индекс атрибута (начиная с нуля).
Возвращает:: true, если атрибут был объявлен в DTD; в противном случае false.
Выбрасывает:: ArrayIndexOutOfBoundsException — Если указанный индекс не соответствует атрибуту.

isDeclared

boolean isDeclared(String qName)

Параметры:: qName — Составное имя XML (с префиксом).
Возвращает:: true, если атрибут был объявлен в DTD; в противном случае false.
Выбрасывает:: IllegalArgumentException — Если указанное имя не соответствует атрибуту.

isDeclared

boolean isDeclared(String uri, String localName)

Помните, что DTD не «понимают» пространства имен, поэтому URI пространства имен, связанный с атрибутом, мог быть получен не из DTD. Объявление будет применяться к атрибуту qName.

Параметры:: 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)

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

Параметры:: uri — URI пространства имен или пустая строка, если имя не имеет URI пространства имен.; localName — Локальное имя атрибута.
Возвращает:: true, если значение найдено в тексте XML; false, если значение было задано по умолчанию в DTD.
Выбрасывает:: IllegalArgumentException — Если указанные имена не соответствуют атрибуту.

isSpecified

boolean isSpecified(String qName)

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

Параметры:: qName — Составное имя XML (с префиксом).
Возвращает:: true, если значение найдено в тексте XML; false, если значение было задано по умолчанию в DTD.
Выбрасывает:: IllegalArgumentException — Если указанное имя не соответствует атрибуту.

© 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://docs.oracle.com/en/java/javase/25/docs/api/java.xml/org/xml/sax/ext/Attributes2.html