Класс Attributes

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>

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

Модификатор и тип	Поле	Описание
`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)`	Связывает указанное значение с указанным именем атрибута, заданным в виде String.
`Object`	`remove(Object name)`	Удаляет из этой карты атрибут с указанным именем (ключом).
`int`	`size()`	Возвращает количество атрибутов в этой карте.
`Collection<Object>`	`values()`	Возвращает представление типа Collection значений атрибутов, содержащихся в этой карте.

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

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

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

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

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

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 — имя атрибута в виде строки
Возвращает:: значение String для указанного имени атрибута или null, если оно не найдено.
Выбрасывает:: IllegalArgumentException — если имя атрибута недопустимо

getValue

public String getValue(Attributes.Name name)

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

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

    return (String)get(name);

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

put

public Object put(Object name, Object value)

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

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

putValue

public String putValue(String name, String value)

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

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

     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>
Возвращает:: представление в виде набора ключей, содержащихся в этой карте

values

public Collection<Object> values()

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

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

entrySet

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

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

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

equals

public boolean equals(Object o)

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

Определено в:

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.
https://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/util/jar/Attributes.html