Класс AttributesImpl

Все реализованные интерфейсы:
Attributes
Прямые известные подклассы:
Attributes2Impl
public class AttributesImpl
extends Object
implements Attributes

Базовая реализация интерфейса Attributes.

Этот модуль, как исходный код, так и документация, находится в общественном достоянии и не имеет ГАРАНТИЙ. Подробнее см. http://www.saxproject.org.

Этот класс предоставляет базовую реализацию интерфейса 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 пространства имён, пустая строка, если 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 пространства имён атрибута или пустая строка, если 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 пространства имён или пустая строка, если URI отсутствует или обработка пространств имён не выполняется.
localName - Локальное имя или пустая строка, если обработка пространств имён не выполняется.
qName - Квалифицированное (с префиксом) имя или пустая строка, если квалифицированные имена недоступны.
type - Тип атрибута в виде строки.
value - Значение атрибута.

setAttribute

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

Устанавливает атрибут в списке.

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

Параметры:
index - Индекс атрибута (начиная с нуля).
uri - 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, 2020, 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/11/docs/api/java.xml/org/xml/sax/helpers/AttributesImpl.html

Spec-Zone .ru
спецификации, руководства, описания, API