Интерфейс Attributes2

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

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

public interface Attributes2 extends Attributes

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

Реализации XMLReader не обязаны поддерживать эту информацию, и она не является частью только core-распределений 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.

Методы, объявленные в интерфейсе org.xml.sax.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://download.java.net/java/early_access/jdk24/docs/api/java.xml/org/xml/sax/ext/Attributes2.html