Класс Attributes2Impl

java.lang.Object

org.xml.sax.helpers.AttributesImpl

org.xml.sax.ext.Attributes2Impl

Все реализуемые интерфейсы:: Attributes, Attributes2

public class Attributes2Impl extends AttributesImpl implements Attributes2

Вспомогательный класс расширения SAX2 для получения дополнительной информации об атрибутах, реализующий интерфейс Attributes2.

Этот класс не входит в дистрибутивы SAX2, содержащие только ядро.

Флаг specified для каждого атрибута всегда будет иметь значение true, если только ему не присвоено значение false в конструкторе копирования или с помощью setSpecified(int, boolean). Аналогично, флаг declared для каждого атрибута всегда будет иметь значение false, кроме атрибутов со значениями по умолчанию (specified имеет значение false), атрибутов, не относящихся к CDATA, или если ему присвоено значение true с помощью setDeclared(int, boolean). Если вы вручную измените тип атрибута, может потребоваться изменить его флаг declared соответствующим образом.

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

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

Конструктор	Описание
`Attributes2Impl()`	Создает новый пустой объект Attributes2Impl.
`Attributes2Impl(Attributes atts)`	Копирует существующий объект Attributes или Attributes2.

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

Модификатор и тип	Метод	Описание
`void`	`addAttribute(String uri, String localName, String qName, String type, String value)`	Добавляет атрибут в конец списка, устанавливая для его флага "specified" значение true.
`boolean`	`isDeclared(int index)`	Возвращает текущее значение флага "declared" атрибута.
`boolean`	`isDeclared(String qName)`	Возвращает текущее значение флага "declared" атрибута.
`boolean`	`isDeclared(String uri, String localName)`	Возвращает текущее значение флага "declared" атрибута.
`boolean`	`isSpecified(int index)`	Возвращает текущее значение флага "specified" атрибута.
`boolean`	`isSpecified(String qName)`	Возвращает текущее значение флага "specified" атрибута.
`boolean`	`isSpecified(String uri, String localName)`	Возвращает текущее значение флага "specified" атрибута.
`void`	`setAttributes(Attributes atts)`	Копирует объект Attributes целиком.
`void`	`setDeclared(int index, boolean value)`	Присваивает значение флагу "declared" указанного атрибута.
`void`	`setSpecified(int index, boolean value)`	Присваивает значение флагу "specified" указанного атрибута.

Методы, объявленные в классе AttributesImpl

clear, getIndex, getIndex, getLength, getLocalName, getQName, getType, getType, getType, getURI, getValue, getValue, getValue, removeAttribute, setAttribute, setLocalName, setQName, setType, setURI, setValue

Методы, объявленные в классе Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

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

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

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

Attributes2Impl

public Attributes2Impl()

Создает новый пустой объект Attributes2Impl.

Attributes2Impl

public Attributes2Impl(Attributes atts)

Копирует существующий объект Attributes или Attributes2. Если объект реализует Attributes2, копируются значения флагов specified и declared для каждого атрибута. В противном случае для флагов задаются значения по умолчанию, предполагающие, что DTD не использовался, если нет свидетельств обратного (например, атрибуты с типом, отличным от CDATA, должны быть объявлены).

Этот конструктор особенно полезен в обработчике события startElement.

Параметры:: atts — существующий объект Attributes.

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

isDeclared

public boolean isDeclared(int index)

Возвращает текущее значение флага "declared" атрибута.

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

isDeclared

public boolean isDeclared(String uri, String localName)

Возвращает текущее значение флага "declared" атрибута.

Определено в:: isDeclared в интерфейсе Attributes2
Параметры:: uri — URI пространства имен или пустая строка, если у имени нет URI пространства имен.; localName — локальное имя атрибута.
Возвращает:: true, если атрибут был объявлен в DTD, иначе false.

isDeclared

public boolean isDeclared(String qName)

Возвращает текущее значение флага "declared" атрибута.

Определено в:: isDeclared в интерфейсе Attributes2
Параметры:: qName — квалифицированное имя XML (с префиксом).
Возвращает:: true, если атрибут был объявлен в DTD, иначе false.

isSpecified

public boolean isSpecified(int index)

Возвращает текущее значение флага "specified" атрибута.

Определено в:: isSpecified в интерфейсе Attributes2
Параметры:: index — индекс атрибута (начиная с нуля).
Возвращает:: текущее значение флага
Исключения:: ArrayIndexOutOfBoundsException — если переданный индекс не соответствует атрибуту.

isSpecified

public boolean isSpecified(String uri, String localName)

Возвращает текущее значение флага "specified" атрибута.

Определено в:: isSpecified в интерфейсе Attributes2
Параметры:: uri — URI пространства имен или пустая строка, если у имени нет URI пространства имен.; localName — локальное имя атрибута.
Возвращает:: текущее значение флага
Исключения:: IllegalArgumentException — если переданные имена не соответствуют атрибуту.

isSpecified

public boolean isSpecified(String qName)

Возвращает текущее значение флага "specified" атрибута.

Определено в:: isSpecified в интерфейсе Attributes2
Параметры:: qName — квалифицированное имя XML (с префиксом).
Возвращает:: текущее значение флага
Исключения:: IllegalArgumentException — если переданное имя не соответствует атрибуту.

setAttributes

public void setAttributes(Attributes atts)

Копирует объект Attributes целиком. Для флагов "specified" задается значение true, а для флагов "declared" — false (за исключением атрибутов с типом, отличным от CDATA), если только объект не является объектом Attributes2. В этом случае копируются значения всех флагов.

Переопределяет:

setAttributes в классе AttributesImpl

Параметры:

atts — атрибуты для копирования.

См. также:

addAttribute

public void addAttribute(String uri, String localName, String qName, String type, String value)

Добавляет атрибут в конец списка, устанавливая для его флага "specified" значение true. Чтобы присвоить этому флагу значение false, используйте setSpecified(int, boolean).

Если тип атрибута не CDATA, этот атрибут помечается как объявленный в DTD. Чтобы присвоить этому флагу значение true для атрибутов CDATA, используйте setDeclared(int, boolean).

Переопределяет:

addAttribute в классе AttributesImpl

Параметры:

uri — URI пространства имен или пустая строка, если URI недоступен либо обработка пространств имен не выполняется.

localName — локальное имя или пустая строка, если обработка пространств имен не выполняется.

qName — квалифицированное имя (с префиксом) или пустая строка, если квалифицированные имена недоступны.

type — тип атрибута в виде строки.

value — значение атрибута.

См. также:

setDeclared

public void setDeclared(int index, boolean value)

Присваивает значение флагу "declared" указанного атрибута. Обычно это требуется только для атрибутов типа CDATA, включая атрибуты, тип которых изменяется на CDATA или с CDATA на другой.

Параметры:

index — индекс атрибута (начиная с нуля).

value — требуемое значение флага.

Исключения:

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

См. также:

setSpecified

public void setSpecified(int index, boolean value)

Присваивает значение флагу "specified" указанного атрибута. Это единственный способ сбросить этот флаг, кроме его сброса при инициализации с помощью конструктора копирования.

Параметры:: index — индекс атрибута (начиная с нуля).; value — требуемое значение флага.
Исключения:: ArrayIndexOutOfBoundsException — если переданный индекс не соответствует атрибуту.

© 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/Attributes2Impl.html