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

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

См. также:

Manifest

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

Модификатор и тип	Класс	Описание
`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
Возвращает:: строковое значение указанного атрибута Attributes.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, если указанный объект равен этому Map

См. также:

hashCode

public int hashCode()

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

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

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

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

hashCode в классе Object

Возвращает:

хэш-код для этого объекта.

См. также:

clone

public Object clone()

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

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

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

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

clone в классе Object

Возвращает:

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

См. также:

Cloneable

© 1993, 2021, 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/17/docs/api/java.base/java/util/jar/Attributes.html