Интерфейс 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

Модификатор и тип	Метод	Описание
`int`	`getIndex(String qName)`	Ищет индекс атрибута по его квалифицированному имени XML (с префиксом).
`int`	`getIndex(String uri, String localName)`	Ищет индекс атрибута по имени в пространстве имен.
`int`	`getLength()`	Возвращает количество атрибутов в списке.
`String`	`getLocalName(int index)`	Ищет локальное имя атрибута по индексу.
`String`	`getQName(int index)`	Ищет квалифицированное имя XML атрибута (с префиксом) по индексу.
`String`	`getType(int index)`	Ищет тип атрибута по индексу.
`String`	`getType(String qName)`	Ищет тип атрибута по его квалифицированному имени XML (с префиксом).
`String`	`getType(String uri, String localName)`	Ищет тип атрибута по имени в пространстве имен.
`String`	`getURI(int index)`	Ищет URI пространства имен атрибута по индексу.
`String`	`getValue(int index)`	Ищет значение атрибута по индексу.
`String`	`getValue(String qName)`	Ищет значение атрибута по его квалифицированному имени XML (с префиксом).
`String`	`getValue(String uri, String localName)`	Ищет значение атрибута по имени в пространстве имен.

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

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.