Атрибуты класса

java.lang.Object

java.util.jar.Attributes

Все реализуемые интерфейсы:: Cloneable, Map<Object,Object>

public class Attributes extends Object implements Map<Object,Object>, Cloneable

Класс Attributes сопоставляет имена атрибутов манифеста с соответствующими строковыми значениями. Допустимые имена атрибутов не чувствительны к регистру, могут содержать только символы ASCII из набора [0-9a-zA-Z_-] и не могут превышать 70 символов. После имени должны следовать двоеточие и ПРОБЕЛ; общая длина не должна превышать 72 символа. Значения атрибутов могут содержать любые символы и при записи в выходной поток кодируются в UTF8. Дополнительные сведения о допустимых именах и значениях атрибутов см. в спецификации файлов JAR.

Эта карта и ее представления имеют предсказуемый порядок итерации — порядок добавления ключей в карту, как и в LinkedHashMap.

Начиная с:

1.2

Внешние спецификации

См. также:

Краткое описание вложенных классов

Модификатор и тип	Класс	Описание
`static class`	`Attributes.Name`	Класс Attributes.Name представляет имя атрибута, хранящееся в этой карте.

Вложенные классы/интерфейсы, объявленные в интерфейсе Map

Map.Entry<K,V>

Модификатор и тип	Интерфейс	Описание
`static interface`	`Map.Entry<K,V>`	Запись карты (пара ключ-значение).

Краткое описание полей

Модификатор и тип	Поле	Описание
`protected Map<Object,Object>`	`map`	Сопоставления имен атрибутов и значений.

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

Конструктор	Описание
`Attributes()`	Создает новый пустой объект Attributes с размером по умолчанию.
`Attributes(int size)`	Создает новый пустой объект Attributes с указанным начальным размером.
`Attributes(Attributes attr)`	Создает новый объект Attributes с теми же сопоставлениями имен атрибутов и значений, что и в указанном объекте Attributes.

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

Модификатор и тип	Метод	Описание
`void`	`clear()`	Удаляет все атрибуты из этой карты.
`Object`	`clone()`	Возвращает копию Attributes, реализованную следующим образом:
`boolean`	`containsKey(Object name)`	Возвращает true, если эта карта содержит указанное имя атрибута (ключ).
`boolean`	`containsValue(Object value)`	Возвращает true, если эта карта сопоставляет одно или несколько имен атрибутов (ключей) с указанным значением.
`Set<Map.Entry<Object,Object>>`	`entrySet()`	Возвращает представление типа Collection сопоставлений имен атрибутов и значений, содержащихся в этой карте.
`boolean`	`equals(Object o)`	Сравнивает указанный объект с базовой картой на равенство.
`Object`	`get(Object name)`	Возвращает значение указанного имени атрибута или null, если имя атрибута не найдено.
`String`	`getValue(String name)`	Возвращает значение указанного имени атрибута, заданного в виде строки, или null, если атрибут не найден.
`String`	`getValue(Attributes.Name name)`	Возвращает значение указанного Attributes.Name или null, если атрибут не найден.
`int`	`hashCode()`	Возвращает хеш-код этой карты.
`boolean`	`isEmpty()`	Возвращает true, если эта карта не содержит атрибутов.
`Set<Object>`	`keySet()`	Возвращает представление типа Set имен атрибутов (ключей), содержащихся в этой карте.
`Object`	`put(Object name, Object value)`	Связывает указанное значение с указанным именем атрибута (ключом) в этой карте.
`void`	`putAll(Map<?,?> attr)`	Копирует все сопоставления имен атрибутов и значений из указанного объекта Attributes в эту карту.
`String`	`putValue(String name, String value)`	Связывает указанное значение с указанным именем атрибута, заданным в виде строки.
`Object`	`remove(Object name)`	Удаляет из этой карты атрибут с указанным именем (ключом).
`int`	`size()`	Возвращает количество атрибутов в этой карте.
`Collection<Object>`	`values()`	Возвращает представление типа Collection значений атрибутов, содержащихся в этой карте.

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

finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Модификатор и тип	Метод	Описание
`protected void`	`finalize()`	Устарел и подлежит удалению: этот элемент API может быть удален в будущей версии. Метод finalize устарел и может быть удален в одном из будущих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`String`	`toString()`	Возвращает строковое представление объекта.
`final void`	`wait()`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо истечения определенного промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо истечения определенного промежутка реального времени.

Методы, объявленные в интерфейсе Map

compute, computeIfAbsent, computeIfPresent, forEach, getOrDefault, merge, putIfAbsent, remove, replace, replace, replaceAll

Модификатор и тип	Метод	Описание
`default Object`	`compute(Object key, BiFunction<? super Object, ? super Object, ? extends Object> remappingFunction)`	Пытается вычислить сопоставление для указанного ключа и текущего сопоставленного с ним значения либо `null`, если текущее сопоставление отсутствует (необязательная операция).
`default Object`	`computeIfAbsent(Object key, Function<? super Object, ? extends Object> mappingFunction)`	Если указанному ключу еще не сопоставлено значение (или ему сопоставлено `null`), пытается вычислить его значение с помощью заданной функции сопоставления и добавить его в эту карту, если результат не равен `null` (необязательная операция).
`default Object`	`computeIfPresent(Object key, BiFunction<? super Object, ? super Object, ? extends Object> remappingFunction)`	Если значение для указанного ключа присутствует и не равно null, пытается вычислить новое сопоставление на основе ключа и текущего сопоставленного с ним значения (необязательная операция).
`default void`	`forEach(BiConsumer<? super Object, ? super Object> action)`	Выполняет указанное действие для каждой записи этой карты, пока не будут обработаны все записи или действие не вызовет исключение.
`default Object`	`getOrDefault(Object key, Object defaultValue)`	Возвращает значение, сопоставленное с указанным ключом, или `defaultValue`, если в этой карте нет сопоставления для данного ключа.
`default Object`	`merge(Object key, Object value, BiFunction<? super Object, ? super Object, ? extends Object> remappingFunction)`	Если указанному ключу еще не сопоставлено значение или ему сопоставлено значение null, связывает его с указанным ненулевым значением (необязательная операция).
`default Object`	`putIfAbsent(Object key, Object value)`	Если указанному ключу еще не сопоставлено значение (или ему сопоставлено `null`), связывает его с указанным значением и возвращает `null`; в противном случае возвращает текущее значение (необязательная операция).
`default boolean`	`remove(Object key, Object value)`	Удаляет запись для указанного ключа, только если ему в данный момент сопоставлено указанное значение (необязательная операция).
`default Object`	`replace(Object key, Object value)`	Заменяет запись для указанного ключа, только если ему в данный момент сопоставлено какое-либо значение (необязательная операция).
`default boolean`	`replace(Object key, Object oldValue, Object newValue)`	Заменяет запись для указанного ключа, только если ему в данный момент сопоставлено указанное значение (необязательная операция).
`default void`	`replaceAll(BiFunction<? super Object, ? super Object, ? extends Object> function)`	Заменяет значение каждой записи результатом вызова указанной функции для этой записи, пока не будут обработаны все записи или функция не вызовет исключение (необязательная операция).

Подробное описание полей

map

protected Map<Object,Object> map

Сопоставления имен атрибутов и значений.

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

Attributes

public Attributes()

Создает новый пустой объект Attributes с размером по умолчанию.

Attributes

public Attributes(int size)

Создает новый пустой объект Attributes с указанным начальным размером.

Параметры:: size — начальное количество атрибутов

Attributes

public Attributes(Attributes attr)

Создает новый объект Attributes с теми же сопоставлениями имен атрибутов и значений, что и в указанном объекте Attributes.

Параметры:: attr — указанный объект Attributes

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

get

public Object get(Object name)

Возвращает значение указанного имени атрибута или null, если имя атрибута не найдено.

Определен в:: get в интерфейсе Map<Object,Object>
Параметры:: name — имя атрибута
Возвращает:: значение указанного имени атрибута или null, если оно не найдено.

getValue

public String getValue(String name)

Возвращает значение указанного имени атрибута, заданного в виде строки, или null, если атрибут не найден. Имя атрибута не чувствительно к регистру.

Этот метод определен следующим образом:

     return (String)get(new Attributes.Name((String)name));

Параметры:: name — имя атрибута в виде строки
Возвращает:: строковое значение указанного имени атрибута или null, если оно не найдено.
Вызывает:: IllegalArgumentException — если имя атрибута недопустимо

getValue

public String getValue(Attributes.Name name)

Возвращает значение указанного Attributes.Name или null, если атрибут не найден.

Этот метод определен следующим образом:

    return (String)get(name);

Параметры:: name — объект Attributes.Name
Возвращает:: строковое значение указанного Attribute.Name или null, если оно не найдено.

put

public Object put(Object name, Object value)

Связывает указанное значение с указанным именем атрибута (ключом) в этой карте. Если в карте уже было сопоставление для этого имени атрибута, старое значение заменяется.

Определен в:: put в интерфейсе Map<Object,Object>
Параметры:: name — имя атрибута; value — значение атрибута
Возвращает:: предыдущее значение атрибута или null, если его не было
Вызывает:: ClassCastException — если имя не является Attributes.Name или значение не является строкой

putValue

public String putValue(String name, String value)

Связывает указанное значение с указанным именем атрибута, заданным в виде строки. Имя атрибута не чувствительно к регистру. Если в карте уже было сопоставление для этого имени атрибута, старое значение заменяется.

Этот метод определен следующим образом:

     return (String)put(new Attributes.Name(name), value);

Параметры:: name — имя атрибута в виде строки; value — значение атрибута
Возвращает:: предыдущее значение атрибута или null, если его не было
Вызывает:: IllegalArgumentException — если имя атрибута недопустимо

remove

public Object remove(Object name)

Удаляет из этой карты атрибут с указанным именем (ключом). Возвращает предыдущее значение атрибута или null, если его не было.

Определен в:: remove в интерфейсе Map<Object,Object>
Параметры:: name — имя атрибута
Возвращает:: предыдущее значение атрибута или null, если его не было

containsValue

public boolean containsValue(Object value)

Возвращает true, если эта карта сопоставляет одно или несколько имен атрибутов (ключей) с указанным значением.

Определен в:: containsValue в интерфейсе Map<Object,Object>
Параметры:: value — значение атрибута
Возвращает:: true, если эта карта сопоставляет одно или несколько имен атрибутов с указанным значением

containsKey

public boolean containsKey(Object name)

Возвращает true, если эта карта содержит указанное имя атрибута (ключ).

Определен в:: containsKey в интерфейсе Map<Object,Object>
Параметры:: name — имя атрибута
Возвращает:: true, если эта карта содержит указанное имя атрибута

putAll

public void putAll(Map<?,?> attr)

Копирует все сопоставления имен атрибутов и значений из указанного объекта Attributes в эту карту. Повторяющиеся сопоставления заменяются.

Определен в:: putAll в интерфейсе Map<Object,Object>
Параметры:: attr — объект Attributes, который необходимо сохранить в этой карте
Вызывает:: ClassCastException — если attr не является объектом Attributes

clear

public void clear()

Удаляет все атрибуты из этой карты.

Определен в:: clear в интерфейсе Map<Object,Object>

size

public int size()

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

Определен в:: size в интерфейсе Map<Object,Object>
Возвращает:: количество сопоставлений ключ-значение в этой карте

isEmpty

public boolean isEmpty()

Возвращает true, если эта карта не содержит атрибутов.

Определен в:: isEmpty в интерфейсе Map<Object,Object>
Возвращает:: true, если эта карта не содержит сопоставлений ключ-значение

keySet

public Set<Object> keySet()

Возвращает представление типа Set имен атрибутов (ключей), содержащихся в этой карте.

Определен в:: keySet в интерфейсе Map<Object,Object>
Возвращает:: представление типа set ключей, содержащихся в этой карте

values

public Collection<Object> values()

Возвращает представление типа Collection значений атрибутов, содержащихся в этой карте.

Определен в:: values в интерфейсе Map<Object,Object>
Возвращает:: представление типа collection значений, содержащихся в этой карте

entrySet

public Set<Map.Entry<Object,Object>> entrySet()

Возвращает представление типа Collection сопоставлений имен атрибутов и значений, содержащихся в этой карте.

Определен в:: entrySet в интерфейсе Map<Object,Object>
Возвращает:: представление типа set сопоставлений, содержащихся в этой карте

equals

public boolean equals(Object o)

Сравнивает указанный объект с базовой картой на равенство. Возвращает true, если данный объект также является картой и обе карты представляют одинаковые сопоставления.

Определен в:

equals в интерфейсе Map<Object,Object>

Переопределяет:

equals в классе Object

Параметры:

o — объект для сравнения

Возвращает:

true, если указанный объект равен этой карте

См. также:

hashCode

public int hashCode()

Возвращает хеш-код этой карты.

Определен в:

hashCode в интерфейсе Map<Object,Object>

Переопределяет:

hashCode в классе Object

Возвращает:

хеш-код этой карты

См. также:

clone

public Object clone()

Возвращает копию Attributes, реализованную следующим образом:

    public Object clone() { return new Attributes(this); }

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

Переопределяет:

clone в классе Object

Возвращает:

копию этого экземпляра.

См. также:

© 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.