Spec-Zone.ru › OpenJDK 24

Класс AttributesImpl

java.lang.Object
org.xml.sax.helpers.AttributesImpl
Все реализуемые интерфейсы:
Attributes
Прямые известные подклассы:
Attributes2Impl
public class AttributesImpl extends Object implements Attributes
Базовое реализация интерфейса Attributes.

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

Существует два типичных использования этого класса:

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

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

С момента:
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)
Устанавливает значение конкретного атрибута.

Методы, унаследованные от класса java.lang.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
Возвращает:
Количество атрибутов в списке.
См. также:
  • Attributes.getLength()

getURI

public String getURI(int index)
Возвращает URI пространства имён атрибута.
Определено в:
getURI в интерфейсе Attributes
Параметры:
index - Индекс атрибута (нумерация с нуля).
Возвращает:
URI пространства имён, пустую строку, если она отсутствует, или null, если индекс вне диапазона.
См. также:
  • Attributes.getURI(int)

getLocalName

public String getLocalName(int index)
Возвращает локальное имя атрибута.
Определено в:
getLocalName в интерфейсе Attributes
Параметры:
index - Индекс атрибута (нумерация с нуля).
Возвращает:
Локальное имя атрибута, пустую строку, если оно отсутствует, или null, если индекс вне диапазона.
См. также:
  • Attributes.getLocalName(int)

getQName

public String getQName(int index)
Возвращает полное (префиксное) имя атрибута.
Определено в:
getQName в интерфейсе Attributes
Параметры:
index - Индекс атрибута (нумерация с нуля).
Возвращает:
Полное имя атрибута, пустую строку, если оно отсутствует, или null, если индекс вне диапазона.
См. также:
  • Attributes.getQName(int)

getType

public String getType(int index)
Возвращает тип атрибута по индексу.
Определено в:
getType в интерфейсе Attributes
Параметры:
index - Индекс атрибута (нумерация с нуля).
Возвращает:
Тип атрибута, "CDATA", если тип неизвестен, или null, если индекс вне диапазона.
См. также:
  • Attributes.getType(int)

getValue

public String getValue(int index)
Возвращает значение атрибута по индексу.
Определено в:
getValue в интерфейсе Attributes
Параметры:
index - Индекс атрибута (нумерация с нуля).
Возвращает:
Значение атрибута или null, если индекс вне диапазона.
См. также:
  • Attributes.getValue(int)

getIndex

public int getIndex(String uri, String localName)
Находит индекс атрибута по имени в пространстве имён.

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

Определено в:
getIndex в интерфейсе Attributes
Параметры:
uri - URI пространства имён атрибута, или пустая строка, если она отсутствует.
localName - Локальное имя атрибута.
Возвращает:
Индекс атрибута, или -1, если не найдено.
См. также:
  • Attributes.getIndex(java.lang.String,java.lang.String)

getIndex

public int getIndex(String qName)
Находит индекс атрибута по полному (префиксном) имени.
Определено в:
getIndex в интерфейсе Attributes
Параметры:
qName - Полное имя.
Возвращает:
Индекс атрибута, или -1, если не найдено.
См. также:
  • Attributes.getIndex(java.lang.String)

getType

public String getType(String uri, String localName)
Находит тип атрибута по имени в пространстве имён.
Определено в:
getType в интерфейсе Attributes
Параметры:
uri - URI пространства имён, или пустая строка для имени без явного URI.
localName - Локальное имя.
Возвращает:
Тип атрибута, или null, если такого атрибута нет.
См. также:
  • Attributes.getType(java.lang.String,java.lang.String)

getType

public String getType(String qName)
Находит тип атрибута по полному имени.
Определено в:
getType в интерфейсе Attributes
Параметры:
qName - Полное имя.
Возвращает:
Тип атрибута, или null, если такого атрибута нет.
См. также:
  • Attributes.getType(java.lang.String)

getValue

public String getValue(String uri, String localName)
Находит значение атрибута по имени в пространстве имён.
Определено в:
getValue в интерфейсе Attributes
Параметры:
uri - URI пространства имён, или пустая строка для имени без явного URI.
localName - Локальное имя.
Возвращает:
Значение атрибута, или null, если такого атрибута нет.
См. также:
  • Attributes.getValue(java.lang.String,java.lang.String)

getValue

public String getValue(String qName)
Находит значение атрибута по полному имени.
Определено в:
getValue в интерфейсе Attributes
Параметры:
qName - Полное имя.
Возвращает:
Значение атрибута, или null, если такого атрибута нет.
См. также:
  • Attributes.getValue(java.lang.String)

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 - Значение атрибута.

Установить атрибут

public void setAttribute(int index, String uri, String localName, String qName, String type, String value)
Устанавливает атрибут в списке.

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

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

Удалить атрибут

public void removeAttribute(int index)
Удаляет атрибут из списка.
Параметры:
index - Индекс атрибута (нумерация с нуля).
Исключения:
ArrayIndexOutOfBoundsException - Если переданный индекс не указывает на атрибут в списке.

Установить URI

public void setURI(int index, String uri)
Устанавливает URI пространства имён для определенного атрибута.
Параметры:
index - Индекс атрибута (нумерация с нуля).
uri - URI пространства имён атрибута, или пустая строка для отсутствия.
Исключения:
ArrayIndexOutOfBoundsException - Если переданный индекс не указывает на атрибут в списке.

Установить локальное имя

public void setLocalName(int index, String localName)
Устанавливает локальное имя для определенного атрибута.
Параметры:
index - Индекс атрибута (нумерация с нуля).
localName - Локальное имя атрибута, или пустая строка для отсутствия.
Исключения:
ArrayIndexOutOfBoundsException - Если переданный индекс не указывает на атрибут в списке.

Установить полное имя

public void setQName(int index, String qName)
Устанавливает полное имя для определенного атрибута.
Параметры:
index - Индекс атрибута (нумерация с нуля).
qName - Полное имя атрибута, или пустая строка для отсутствия.
Исключения:
ArrayIndexOutOfBoundsException - Если переданный индекс не указывает на атрибут в списке.

Установить тип

public void setType(int index, String type)
Устанавливает тип для определенного атрибута.
Параметры:
index - Индекс атрибута (нумерация с нуля).
type - Тип атрибута.
Исключения:
ArrayIndexOutOfBoundsException - Если переданный индекс не указывает на атрибут в списке.

Установить значение

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://download.java.net/java/early_access/jdk24/docs/api/java.xml/org/xml/sax/helpers/AttributesImpl.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API