Класс AttributesImpl

java.lang.Object

org.xml.sax.helpers.AttributesImpl

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

Прямые известные подклассы:: Attributes2Impl

public class AttributesImpl extends Object implements Attributes

Реализация интерфейса Attributes по умолчанию.

Этот класс предоставляет реализацию интерфейса SAX2 Attributes по умолчанию, дополняя её средствами управления, позволяющими изменять список или использовать его повторно.

Этот класс обычно используют двумя способами:

для создания постоянного снимка объекта Attributes в событии startElement; либо
для создания или изменения объекта Attributes в драйвере или фильтре SAX2.

Этот класс заменяет ныне устаревший класс SAX1 AttributeListImpl; помимо поддержки обновлённого интерфейса Attributes вместо устаревшего интерфейса AttributeList, он также содержит гораздо более эффективную реализацию, использующую один массив вместо набора объектов Vector.

Начиная с версии:: 1.4, SAX 2.0

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

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

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

Модификатор и тип	Метод	Описание
`void`	`addAttribute(String uri, String localName, String qName, String type, String value)`	Добавляет атрибут в конец списка.
`void`	`clear()`	Очищает список атрибутов для повторного использования.
`int`	`getIndex(String qName)`	Находит индекс атрибута по его квалифицированному (с префиксом) имени.
`int`	`getIndex(String uri, String localName)`	Находит индекс атрибута по имени пространства имён.
`int`	`getLength()`	Возвращает количество атрибутов в списке.
`String`	`getLocalName(int index)`	Возвращает локальное имя атрибута.
`String`	`getQName(int index)`	Возвращает квалифицированное (с префиксом) имя атрибута.
`String`	`getType(int index)`	Возвращает тип атрибута по индексу.
`String`	`getType(String qName)`	Находит тип атрибута по его квалифицированному (с префиксом) имени.
`String`	`getType(String uri, String localName)`	Находит тип атрибута по имени, квалифицированному пространством имён.
`String`	`getURI(int index)`	Возвращает URI пространства имён атрибута.
`String`	`getValue(int index)`	Возвращает значение атрибута по индексу.
`String`	`getValue(String qName)`	Находит значение атрибута по его квалифицированному (с префиксом) имени.
`String`	`getValue(String uri, String localName)`	Находит значение атрибута по имени, квалифицированному пространством имён.
`void`	`removeAttribute(int index)`	Удаляет атрибут из списка.
`void`	`setAttribute(int index, String uri, String localName, String qName, String type, String value)`	Задаёт атрибут в списке.
`void`	`setAttributes(Attributes atts)`	Копирует объект Attributes целиком.
`void`	`setLocalName(int index, String localName)`	Задаёт локальное имя указанного атрибута.
`void`	`setQName(int index, String qName)`	Задаёт квалифицированное имя указанного атрибута.
`void`	`setType(int index, String type)`	Задаёт тип указанного атрибута.
`void`	`setURI(int index, String uri)`	Задаёт URI пространства имён указанного атрибута.
`void`	`setValue(int index, String value)`	Задаёт значение указанного атрибута.

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

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

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

AttributesImpl

public AttributesImpl()

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

AttributesImpl

public AttributesImpl(Attributes atts)

Копирует существующий объект Attributes.

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

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

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

getLength

public int getLength()

Возвращает количество атрибутов в списке.

Определено в:

getLength в интерфейсе Attributes

Возвращает:

Количество атрибутов в списке.

См. также:

getURI

public String getURI(int index)

Возвращает URI пространства имен атрибута.

Определено в:

getURI в интерфейсе Attributes

Параметры:

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

Возвращает:

URI пространства имен, пустую строку, если он недоступен, или null, если индекс выходит за допустимые границы.

См. также:

getLocalName

public String getLocalName(int index)

Возвращает локальное имя атрибута.

Определено в:

getLocalName в интерфейсе Attributes

Параметры:

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

Возвращает:

Локальное имя атрибута, пустую строку, если оно недоступно, или null, если индекс выходит за допустимые границы.

См. также:

getQName

public String getQName(int index)

Возвращает квалифицированное (с префиксом) имя атрибута.

Определено в:

getQName в интерфейсе Attributes

Параметры:

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

Возвращает:

Квалифицированное имя атрибута, пустую строку, если оно недоступно, или null, если индекс выходит за допустимые границы.

См. также:

getType

public String getType(int index)

Возвращает тип атрибута по индексу.

Определено в:

getType в интерфейсе Attributes

Параметры:

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

Возвращает:

Тип атрибута, «CDATA», если тип неизвестен, или null, если индекс выходит за допустимые границы.

См. также:

getValue

public String getValue(int index)

Возвращает значение атрибута по индексу.

Определено в:

getValue в интерфейсе Attributes

Параметры:

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

Возвращает:

Значение атрибута или null, если индекс выходит за допустимые границы.

См. также:

getIndex

public int getIndex(String uri, String localName)

Ищет индекс атрибута по имени в пространстве имен.

Во многих случаях эффективнее один раз найти имя и затем использовать методы поиска по индексу, а не многократно использовать методы поиска по имени.

Определено в:

getIndex в интерфейсе Attributes

Параметры:

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

localName — локальное имя атрибута.

Возвращает:

Индекс атрибута или -1, если соответствующий атрибут не найден.

См. также:

getIndex

public int getIndex(String qName)

Ищет индекс атрибута по квалифицированному (с префиксом) имени.

Определено в:

getIndex в интерфейсе Attributes

Параметры:

qName — квалифицированное имя.

Возвращает:

Индекс атрибута или -1, если соответствующий атрибут не найден.

См. также:

getType

public String getType(String uri, String localName)

Ищет тип атрибута по имени, квалифицированному пространством имен.

Определено в:

getType в интерфейсе Attributes

Параметры:

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

localName — локальное имя.

Возвращает:

Тип атрибута или null, если соответствующий атрибут не найден.

См. также:

getType

public String getType(String qName)

Ищет тип атрибута по квалифицированному (с префиксом) имени.

Определено в:

getType в интерфейсе Attributes

Параметры:

qName — квалифицированное имя.

Возвращает:

Тип атрибута или null, если соответствующий атрибут не найден.

См. также:

getValue

public String getValue(String uri, String localName)

Ищет значение атрибута по имени, квалифицированному пространством имен.

Определено в:

getValue в интерфейсе Attributes

Параметры:

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

localName — локальное имя.

Возвращает:

Значение атрибута или null, если соответствующий атрибут не найден.

См. также:

getValue

public String getValue(String qName)

Ищет значение атрибута по квалифицированному (с префиксом) имени.

Определено в:

getValue в интерфейсе Attributes

Параметры:

qName — квалифицированное имя.

Возвращает:

Значение атрибута или null, если соответствующий атрибут не найден.

См. также:

clear

public void clear()

Очищает список атрибутов для повторного использования.

Обратите внимание, что этот вызов освобождает лишь небольшой объем памяти: текущий массив сохраняется для повторного использования.

setAttributes

public void setAttributes(Attributes atts)

Копирует объект Attributes целиком.

Повторное использование существующего объекта может быть эффективнее, чем постоянное создание новых объектов.

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

addAttribute

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

Добавляет атрибут в конец списка.

Для повышения скорости этот метод не проверяет, есть ли атрибут уже в списке: такая проверка является обязанностью приложения.

Параметры:: uri — URI пространства имен или пустая строка, если он недоступен либо обработка пространств имен не выполняется.; localName — локальное имя или пустая строка, если обработка пространств имен не выполняется.; qName — квалифицированное (с префиксом) имя или пустая строка, если квалифицированные имена недоступны.; type — тип атрибута в виде строки.; value — значение атрибута.

setAttribute

public void setAttribute(int index, String uri, String localName, String qName, String type, String value)

Задает атрибут в списке.

Для повышения скорости этот метод не проверяет конфликты имен или корректность формата: такие проверки являются обязанностью приложения.

Параметры:: index — индекс атрибута (начиная с нуля).; uri — URI пространства имен или пустая строка, если он недоступен либо обработка пространств имен не выполняется.; localName — локальное имя или пустая строка, если обработка пространств имен не выполняется.; qName — квалифицированное имя или пустая строка, если квалифицированные имена недоступны.; type — тип атрибута в виде строки.; value — значение атрибута.
Исключения:: ArrayIndexOutOfBoundsException — если указанный индекс не соответствует атрибуту в списке.

removeAttribute

public void removeAttribute(int index)

Удаляет атрибут из списка.

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

setURI

public void setURI(int index, String uri)

Задает URI пространства имен для указанного атрибута.

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

setLocalName

public void setLocalName(int index, String localName)

Задает локальное имя указанного атрибута.

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

setQName

public void setQName(int index, String qName)

Задает квалифицированное имя указанного атрибута.

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

setType

public void setType(int index, String type)

Задает тип указанного атрибута.

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

setValue

public void setValue(int index, String value)

Задает значение указанного атрибута.

Параметры:: 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/helpers/AttributesImpl.html