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

Все суперинтерфейсы:: 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.

Методы, объявленные в интерфейсе 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, 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/ext/Attributes2.html