Класс 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 символов в длину. Значения атрибутов могут содержать любые символы и будут закодированы в UTF8 при записи в поток вывода. См. Спецификацию файла JAR для получения дополнительной информации о допустимых именах и значениях атрибутов.
- С момента:
- 1.2
- См. также:
Manifest
Вложенные классы
| Модификатор и тип | Класс и описание |
|---|---|
static class |
Attributes.Name Класс Attributes.Name представляет имя атрибута, хранящегося в этой Map. |
Вложенные классы/интерфейсы, унаследованные от интерфейса java.util.Map
Map.Entry<K,V> Поля
| Модификатор и тип | Поле и описание |
|---|---|
protected Map<Object,Object> |
map Сопоставления имен атрибутов и их значений. |
Конструкторы
| Конструктор и описание |
|---|
Attributes() Создаёт новый пустой объект Attributes с размером по умолчанию. |
Attributes(Attributes attr) Создаёт новый объект Attributes с теми же сопоставлениями имен атрибутов и значений, что и в указанном Attributes. |
Attributes(int size) Создаёт новый пустой объект Attributes с указанным начальным размером. |
Методы
| Модификатор и тип | Метод и описание |
|---|---|
void |
clear() Удаляет все атрибуты из этой Map. |
Object |
clone() Возвращает копию Attributes, реализованную следующим образом: |
boolean |
containsKey(Object name) Возвращает true, если эта Map содержит указанное имя атрибута (ключ). |
boolean |
containsValue(Object value) Возвращает true, если эта Map сопоставляет одно или несколько имён атрибутов (ключей) со значением. |
Set<Map.Entry<Object,Object>> |
entrySet() Возвращает представление коллекции сопоставлений имен атрибутов и значений, содержащихся в этой Map. |
boolean |
equals(Object o) Сравнивает указанный объект Attributes с этой Map на равенство. |
Object |
get(Object name) Возвращает значение указанного имени атрибута или null, если атрибут не найден. |
String |
getValue(Attributes.Name name) Возвращает значение указанного Attributes.Name или null, если атрибут не найден. |
String |
getValue(String name) Возвращает значение указанного имени атрибута, заданного как строка, или null, если атрибут не найден. |
int |
hashCode() Возвращает хэш-код для этой Map. |
boolean |
isEmpty() Возвращает true, если эта Map не содержит атрибутов. |
Set<Object> |
keySet() Возвращает представление множества имён атрибутов (ключей), содержащихся в этой Map. |
Object |
put(Object name,
Object value) Связывает указанное значение с указанным именем атрибута (ключом) в этой Map. |
void |
putAll(Map<?,?> attr) Копирует все сопоставления имён атрибутов и значений из указанного Attributes в эту Map. |
String |
putValue(String name,
String value) Связывает указанное значение с указанным именем атрибута, заданным как строка. |
Object |
remove(Object name) Удаляет атрибут с указанным именем (ключом) из этой Map. |
int |
size() Возвращает количество атрибутов в этой Map. |
Collection<Object> |
values() Возвращает представление коллекции значений атрибутов, содержащихся в этой Map. |
Методы, унаследованные от класса 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
отображение имени-значения атрибутов.
Конструкторы
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- имя атрибута как строка - Возвращает:
- строковое значение указанного имени атрибута, или 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()
Удаляет все атрибуты из этого отображения.
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 можно безопасно изменять, не влияя на исходный.
© 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.