Spec-Zone.ru › OpenJDK 21

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

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, 2023, 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/21/docs/api/java.xml/org/xml/sax/helpers/AttributesImpl.html

Spec-Zone.ru

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