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

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 представляет имя атрибута, хранящегося в этой карте.

Вложенные классы/интерфейсы, объявленные в интерфейсе java.util.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()`	Возвращает представление коллекции сопоставлений имён и значений атрибутов, содержащихся в этой карте.
`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()`	Возвращает представление набора имён атрибутов (ключей), содержащихся в этой карте.
`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()`	Возвращает представление коллекции значений атрибутов, содержащихся в этой карте.

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

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

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

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

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

map

protected Map<Object,Object> map

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

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

Атрибуты

public Attributes()

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

Атрибуты

public Attributes(int size)

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

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

Атрибуты

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)

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

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

putValue

public String putValue(String name, String value)

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

Этот метод определен как:

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

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

remove

public Object remove(Object name)

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

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

containsValue

public boolean containsValue(Object value)

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

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

containsKey

public boolean containsKey(Object name)

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

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

putAll

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

Копирует все сопоставления имён-значений атрибутов из указанного Attributes в этот Map. Дублируемые сопоставления будут заменены.

Определено в:: putAll в интерфейсе Map<Object,Object>
Параметры:: attr - Attributes, которые нужно сохранить в этом map
Исключения:: ClassCastException - если attr не является Attributes

clear

public void clear()

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

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

size

public int size()

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

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

isEmpty

public boolean isEmpty()

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

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

keySet

public Set<Object> keySet()

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

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

values

public Collection<Object> values()

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

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

entrySet

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

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

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

equals

public boolean equals(Object o)

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

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

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

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

equals в классе Object

Параметры:

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

Возвращает:

true, если указанный Object равен этому Map

См. также:

hashCode

public int hashCode()

Возвращает значение хэш-кода для этого Map.

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

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

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

hashCode в классе Object

Возвращает:

значение хэш-кода для этого map

См. также:

clone

public Object clone()

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

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

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

Overrides:

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://download.java.net/java/early_access/jdk24/docs/api/java.base/java/util/jar/Attributes.html