| java.lang.Object
 java.util.jar.Attributes
| Attributes | | public class Attributes implements Map,Cloneable(Code) | | 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. 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.
author:
David Connelly
version:
1.47, 06/24/03
See Also: Manifest
since:
1.2 |
| Inner Class :public static class Name | |
| Field Summary | |
| protected Map | map
The attribute name-value mappings. |
| Constructor Summary | |
| public | Attributes()
Constructs a new, empty Attributes object with default size. | | public | Attributes(int size)
Constructs a new, empty Attributes object with the specified
initial size. | | public | Attributes(Attributes attr)
Constructs a new Attributes object with the same attribute name-value
mappings as in the specified Attributes. |
| Method Summary | |
| public void | clear()
Removes all attributes from this Map. | | public Object | 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. | | public boolean | containsKey(Object name)
Returns true if this Map contains the specified attribute name (key). | | public boolean | containsValue(Object value)
Returns true if this Map maps one or more attribute names (keys)
to the specified value. | | public Set | entrySet()
Returns a Collection view of the attribute name-value mappings
contained in this Map. | | public boolean | equals(Object o)
Compares the specified Attributes object with this Map for equality. | | public Object | get(Object name)
Returns the value of the specified attribute name, or null if the
attribute name was not found. | | public String | getValue(String name)
Returns the value of the specified attribute name, specified as
a string, or null if the attribute was not found. | | public String | getValue(Name name)
Returns the value of the specified Attributes.Name, or null if the
attribute was not found. | | public int | hashCode()
Returns the hash code value for this Map. | | public boolean | isEmpty()
Returns true if this Map contains no attributes. | | public Set | keySet()
Returns a Set view of the attribute names (keys) contained in this Map. | | public Object | put(Object name, Object value)
Associates the specified value with the specified attribute name
(key) in this Map. | | public void | putAll(Map attr)
Copies all of the attribute name-value mappings from the specified
Attributes to this Map. | | public String | putValue(String name, String value)
Associates the specified value with the specified attribute name,
specified as a String. | | void | read(Manifest.FastInputStream is, byte[] lbuf)
| | public Object | remove(Object name)
Removes the attribute with the specified name (key) from this Map. | | public int | size()
Returns the number of attributes in this Map. | | public Collection | values()
Returns a Collection view of the attribute values contained in this Map. | | void | write(DataOutputStream os)
| | void | writeMain(DataOutputStream out)
|
| map | | protected Map map(Code) | | The attribute name-value mappings.
|
| Attributes | | public Attributes()(Code) | | Constructs a new, empty Attributes object with default size.
|
| Attributes | | public Attributes(int size)(Code) | | Constructs a new, empty Attributes object with the specified
initial size.
Parameters:
size - the initial number of attributes |
| Attributes | | public Attributes(Attributes attr)(Code) | | Constructs a new Attributes object with the same attribute name-value
mappings as in the specified Attributes.
Parameters:
attr - the specified Attributes |
| clear | | public void clear()(Code) | | Removes all attributes from this Map.
|
| clone | | public Object clone()(Code) | | 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.
|
| containsKey | | public boolean containsKey(Object name)(Code) | | Returns true if this Map contains the specified attribute name (key).
Parameters:
name - the attribute name true if this Map contains the specified attribute name |
| containsValue | | public boolean containsValue(Object value)(Code) | | Returns true if this Map maps one or more attribute names (keys)
to the specified value.
Parameters:
value - the attribute value true if this Map maps one or more attribute names tothe specified value |
| entrySet | | public Set entrySet()(Code) | | Returns a Collection view of the attribute name-value mappings
contained in this Map.
|
| equals | | public boolean equals(Object o)(Code) | | Compares the specified Attributes object with this Map for equality.
Returns true if the given object is also an instance of Attributes
and the two Attributes objects represent the same mappings.
Parameters:
o - the Object to be compared true if the specified Object is equal to this Map |
| get | | public Object get(Object name)(Code) | | Returns the value of the specified attribute name, or null if the
attribute name was not found.
Parameters:
name - the attribute name the value of the specified attribute name, or null ifnot found. |
| getValue | | public String getValue(String name)(Code) | | 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 the String value of the specified attribute name, or null ifnot found.
throws:
IllegalArgumentException - if the attribute name is invalid |
| getValue | | public String getValue(Name name)(Code) | | 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 the String value of the specified Attribute.Name, or null ifnot found. |
| hashCode | | public int hashCode()(Code) | | Returns the hash code value for this Map.
|
| isEmpty | | public boolean isEmpty()(Code) | | Returns true if this Map contains no attributes.
|
| keySet | | public Set keySet()(Code) | | Returns a Set view of the attribute names (keys) contained in this Map.
|
| put | | public Object put(Object name, Object value)(Code) | | 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.
Parameters:
name - the attribute name
Parameters:
value - the attribute value the previous value of the attribute, or null if none
exception:
ClassCastException - if the name is not a Attributes.Nameor the value is not a String |
| putAll | | public void putAll(Map attr)(Code) | | Copies all of the attribute name-value mappings from the specified
Attributes to this Map. Duplicate mappings will be replaced.
Parameters:
attr - the Attributes to be stored in this map
exception:
ClassCastException - if attr is not an Attributes |
| putValue | | public String putValue(String name, String value)(Code) | | 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 string
Parameters:
value - the attribute value the previous value of the attribute, or null if none
exception:
IllegalArgumentException - if the attribute name is invalid |
| remove | | public Object remove(Object name)(Code) | | Removes the attribute with the specified name (key) from this Map.
Returns the previous attribute value, or null if none.
Parameters:
name - attribute name the previous value of the attribute, or null if none |
| size | | public int size()(Code) | | Returns the number of attributes in this Map.
|
| values | | public Collection values()(Code) | | Returns a Collection view of the attribute values contained in this Map.
|
|
|