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

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)

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

Унаследован от:: 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()

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

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

values

public Collection<Object> values()

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

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

entrySet

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

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

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

equals

public boolean equals(Object o)

Сравнивает указанный объект с внутренней картой map на равенство. Возвращает 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, 2023, 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/21/docs/api/java.base/java/util/jar/Attributes.html