java.lang.Object
java.util.jar.Attributes
The Attributes class maps Manifest attribute names to associated string
values. Valid attribute names are case-insensitive, are restricted to
the ASCII characters in the set [0-9a-zA-Z_-], and cannot exceed 70
characters in length. There must be a colon and a SPACE after the name;
the combined length will not exceed 72 characters.
Attribute values can contain any characters and
will be UTF8-encoded when written to the output stream. See the
JAR File Specification
for more information about valid attribute names and values.
This map and its views have a predictable iteration order, namely the
order that keys were inserted into the map, as with LinkedHashMap
.
- Since:
- 1.2
- See Also:
-
Nested Class Summary
Modifier and TypeClassDescriptionstatic class
The Attributes.Name class represents an attribute name stored in this Map. -
Field Summary
-
Constructor Summary
ConstructorDescriptionConstructs a new, empty Attributes object with default size.Attributes
(int size) Constructs a new, empty Attributes object with the specified initial size.Attributes
(Attributes attr) Constructs a new Attributes object with the same attribute name-value mappings as in the specified Attributes. -
Method Summary
Modifier and TypeMethodDescriptionvoid
clear()
Removes all attributes from this Map.clone()
Returns a copy of the Attributes, implemented as follows:boolean
containsKey
(Object name) Returns true if this Map contains the specified attribute name (key).boolean
containsValue
(Object value) Returns true if this Map maps one or more attribute names (keys) to the specified value.entrySet()
Returns a Collection view of the attribute name-value mappings contained in this Map.boolean
Compares the specified object to the underlying map for equality.Returns the value of the specified attribute name, or null if the attribute name was not found.Returns the value of the specified attribute name, specified as a string, or null if the attribute was not found.getValue
(Attributes.Name name) Returns the value of the specified Attributes.Name, or null if the attribute was not found.int
hashCode()
Returns the hash code value for this Map.boolean
isEmpty()
Returns true if this Map contains no attributes.keySet()
Returns a Set view of the attribute names (keys) contained in this Map.Associates the specified value with the specified attribute name (key) in this Map.void
Copies all of the attribute name-value mappings from the specified Attributes to this Map.Associates the specified value with the specified attribute name, specified as a String.Removes the attribute with the specified name (key) from this Map.int
size()
Returns the number of attributes in this Map.values()
Returns a Collection view of the attribute values contained in this Map.Methods declared in class java.lang.Object
finalize, getClass, notify, notifyAll, toString, wait, wait, wait
Methods declared in interface java.util.Map
compute, computeIfAbsent, computeIfPresent, forEach, getOrDefault, merge, putIfAbsent, remove, replace, replace, replaceAll
-
Field Details
-
map
The attribute name-value mappings.
-
-
Constructor Details
-
Attributes
public Attributes()Constructs a new, empty Attributes object with default size. -
Attributes
public Attributes(int size) Constructs a new, empty Attributes object with the specified initial size.- Parameters:
size
- the initial number of attributes
-
Attributes
Constructs a new Attributes object with the same attribute name-value mappings as in the specified Attributes.- Parameters:
attr
- the specified Attributes
-
-
Method Details
-
get
Returns the value of the specified attribute name, or null if the attribute name was not found. -
getValue
Returns the value of the specified attribute name, specified as a string, or null if the attribute was not found. The attribute name is case-insensitive.This method is defined as:
return (String)get(new Attributes.Name((String)name));
- Parameters:
name
- the attribute name as a string- Returns:
- the String value of the specified attribute name, or null if not found.
- Throws:
IllegalArgumentException
- if the attribute name is invalid
-
getValue
Returns the value of the specified Attributes.Name, or null if the attribute was not found.This method is defined as:
return (String)get(name);
- Parameters:
name
- the Attributes.Name object- Returns:
- the String value of the specified Attribute.Name, or null if not found.
-
put
Associates the specified value with the specified attribute name (key) in this Map. If the Map previously contained a mapping for the attribute name, the old value is replaced.- Specified by:
put
in interfaceMap<Object,
Object> - Parameters:
name
- the attribute namevalue
- the attribute value- Returns:
- the previous value of the attribute, or null if none
- Throws:
ClassCastException
- if the name is not a Attributes.Name or the value is not a String
-
putValue
Associates the specified value with the specified attribute name, specified as a String. The attributes name is case-insensitive. If the Map previously contained a mapping for the attribute name, the old value is replaced.This method is defined as:
return (String)put(new Attributes.Name(name), value);
- Parameters:
name
- the attribute name as a stringvalue
- the attribute value- Returns:
- the previous value of the attribute, or null if none
- Throws:
IllegalArgumentException
- if the attribute name is invalid
-
remove
Removes the attribute with the specified name (key) from this Map. Returns the previous attribute value, or null if none. -
containsValue
Returns true if this Map maps one or more attribute names (keys) to the specified value.- Specified by:
containsValue
in interfaceMap<Object,
Object> - Parameters:
value
- the attribute value- Returns:
- true if this Map maps one or more attribute names to the specified value
-
containsKey
Returns true if this Map contains the specified attribute name (key).- Specified by:
containsKey
in interfaceMap<Object,
Object> - Parameters:
name
- the attribute name- Returns:
- true if this Map contains the specified attribute name
-
putAll
Copies all of the attribute name-value mappings from the specified Attributes to this Map. Duplicate mappings will be replaced.- Specified by:
putAll
in interfaceMap<Object,
Object> - Parameters:
attr
- the Attributes to be stored in this map- Throws:
ClassCastException
- if attr is not an Attributes
-
clear
public void clear()Removes all attributes from this Map. -
size
public int size()Returns the number of attributes in this Map. -
isEmpty
public boolean isEmpty()Returns true if this Map contains no attributes. -
keySet
Returns a Set view of the attribute names (keys) contained in this Map. -
values
Returns a Collection view of the attribute values contained in this Map. -
entrySet
Returns a Collection view of the attribute name-value mappings contained in this Map. -
equals
Compares the specified object to the underlying map for equality. Returns true if the given object is also a Map and the two maps represent the same mappings. -
hashCode
public int hashCode()Returns the hash code value for this Map. -
clone
Returns a copy of the Attributes, implemented as follows:public Object clone() { return new Attributes(this); }
Since the attribute names and values are themselves immutable, the Attributes returned can be safely modified without affecting the original.
-