Класс 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)

Сравнивает указанный объект Attributes с этой картой на равенство.
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)

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

Унаследован от:
equals в интерфейсе Map<Object,​Object>
Переопределяет:
equals в классе Object
Параметры:
o - объект для сравнения
Возвращает:
true, если указанный объект равен этой карте
См. также:
Object.hashCode(), HashMap

hashCode

public int hashCode()

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

Унаследован от:
hashCode в интерфейсе Map<Object,​Object>
Переопределяет:
hashCode в классе Object
Возвращает:
значение хэш-кода для этого объекта.
См. также:
Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)

clone

public Object clone()

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

public Object clone() { return new Attributes(this); }
Поскольку имена и значения атрибутов сами по себе неизменяемы, возвращаемые Attributes могут быть безопасно изменены без влияния на исходные.

Переопределяет:
clone в классе Object
Возвращает:
клонированный экземпляр.
См. также:
Cloneable

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

Spec-Zone .ru
спецификации, руководства, описания, API