Класс AttributesImpl
- java.lang.Object
-
- org.xml.sax.helpers.AttributesImpl
- Все реализованные интерфейсы:
- Attributes
- Прямые известные подклассы:
- Attributes2Impl
public class AttributesImpl extends Object implements Attributes
Базовое исполнение интерфейса Attributes.
Этот модуль, как исходный код, так и документация, находится в общественном достоянии и не несёт ГАРАНТИЙ. См. http://www.saxproject.org для получения дополнительной информации.
Этот класс предоставляет базовое исполнение интерфейса SAX2 Attributes, с добавлением манипуляторов, позволяющих изменять или повторно использовать список.
Этот класс имеет два типичных применения:
- создать постоянную копию объекта Attributes в событии
startElement; или - создать или изменить объект Attributes в драйвере или фильтре SAX2.
Этот класс заменяет устаревший класс SAX1 AttributeListImpl; помимо поддержки обновленного интерфейса Attributes вместо устаревшего интерфейса AttributeList, он также включает в себя более эффективную реализацию, использующую один массив вместо набора векторов.
- С тех пор:
- 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.