public class

Attributes

extends Object
implements Cloneable Map<K, V>

java.lang.Object
↳	java.util.jar.Attributes

Class Overview

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.

Summary

Nested Classes
class	Attributes.Name	The Attributes.Name class represents an attribute name stored in this Map.

Fields
protected Map<Object, Object>	map	The attribute name-value mappings.

Public Constructors
	Attributes() Constructs 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.

Public Methods
void	clear() Removes all attributes from this Map.
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.
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.
Set<Entry<Object, Object>>	entrySet() Returns a Collection view of the attribute name-value mappings contained in this Map.
boolean	equals(Object o) Compares the specified Attributes object with this Map for equality.
Object	get(Object name) Returns the value of the specified attribute name, or null if the attribute name was not found.
String	getValue(String name) Returns the value of the specified attribute name, specified as a string, or null if the attribute was not found.
String	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.
Set<Object>	keySet() Returns a Set view of the attribute names (keys) contained in this Map.
Object	put(Object name, Object value) Associates the specified value with the specified attribute name (key) in this Map.
void	putAll(Map<?, ?> attr) Copies all of the attribute name-value mappings from the specified Attributes to this Map.
String	putValue(String name, String value) Associates the specified value with the specified attribute name, specified as a String.
Object	remove(Object name) Removes the attribute with the specified name (key) from this Map.
int	size() Returns the number of attributes in this Map.
Collection<Object>	values() Returns a Collection view of the attribute values contained in this Map.

[Expand]

Inherited Methods

From class java.lang.Object

Object	clone() Creates and returns a copy of this object.
boolean	equals(Object obj) Indicates whether some other object is "equal to" this one.
void	finalize() Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.
final Class<?>	getClass() Returns the runtime class of this `Object`.
int	hashCode() Returns a hash code value for the object.
final void	notify() Wakes up a single thread that is waiting on this object's monitor.
final void	notifyAll() Wakes up all threads that are waiting on this object's monitor.
String	toString() Returns a string representation of the object.
final void	wait() Causes the current thread to wait until another thread invokes the `notify()` method or the `notifyAll()` method for this object.
final void	wait(long timeout, int nanos) Causes the current thread to wait until another thread invokes the `notify()` method or the `notifyAll()` method for this object, or some other thread interrupts the current thread, or a certain amount of real time has elapsed.
final void	wait(long timeout) Causes the current thread to wait until either another thread invokes the `notify()` method or the `notifyAll()` method for this object, or a specified amount of time has elapsed.

From interface java.util.Map

abstract void	clear() Removes all of the mappings from this map (optional operation).
abstract boolean	containsKey(Object key) Returns `true` if this map contains a mapping for the specified key.
abstract boolean	containsValue(Object value) Returns `true` if this map maps one or more keys to the specified value.
abstract Set<Entry<K, V>>	entrySet() Returns a `Set` view of the mappings contained in this map.
abstract boolean	equals(Object o) Compares the specified object with this map for equality.
abstract V	get(Object key) Returns the value to which the specified key is mapped, or `null` if this map contains no mapping for the key.
abstract int	hashCode() Returns the hash code value for this map.
abstract boolean	isEmpty() Returns `true` if this map contains no key-value mappings.
abstract Set<K>	keySet() Returns a `Set` view of the keys contained in this map.
abstract V	put(K key, V value) Associates the specified value with the specified key in this map (optional operation).
abstract void	putAll(Map<? extends K, ? extends V> m) Copies all of the mappings from the specified map to this map (optional operation).
abstract V	remove(Object key) Removes the mapping for a key from this map if it is present (optional operation).
abstract int	size() Returns the number of key-value mappings in this map.
abstract Collection<V>	values() Returns a `Collection` view of the values contained in this map.

Fields

protected Map<Object, Object> map

The attribute name-value mappings.

Public Constructors

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.

Parameters

size	the initial number of attributes

public Attributes (Attributes attr)

Constructs a new Attributes object with the same attribute name-value mappings as in the specified Attributes.

Parameters

attr	the specified Attributes

Public Methods

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.

Returns

a clone of this instance.

public boolean containsKey (Object name)

Returns true if this Map contains the specified attribute name (key).

Parameters

name	the attribute name

Returns

true if this Map contains the specified attribute name

public boolean containsValue (Object value)

Returns true if this Map maps one or more attribute names (keys) to the specified value.

Parameters

value	the attribute value

Returns

true if this Map maps one or more attribute names to the specified value

public Set<Entry<Object, Object>> entrySet ()

Returns a Collection view of the attribute name-value mappings contained in this Map.

Returns

a set view of the mappings contained in this map

public boolean equals (Object o)

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

Returns

true if the specified Object is equal to this Map

public Object get (Object name)

Returns the value of the specified attribute name, or null if the attribute name was not found.

Parameters

name	the attribute name

Returns

the value of the specified attribute name, or null if 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. 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

public String getValue (Attributes.Name name)

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.

public int hashCode ()

Returns the hash code value for this Map.

Returns

a hash code value for this object.

public boolean isEmpty ()

Returns true if this Map contains no attributes.

Returns

true if this map contains no key-value mappings

public Set<Object> keySet ()

Returns a Set view of the attribute names (keys) contained in this Map.

Returns

a set view of the 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. If the Map previously contained a mapping for the attribute name, the old value is replaced.

Parameters

name	the attribute name
value	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

public void putAll (Map<?, ?> attr)

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

Throws

ClassCastException	if attr is not an Attributes

public String putValue (String name, String value)

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
value	the attribute value

Returns

the previous value of the attribute, or null if none

Throws

IllegalArgumentException	if the attribute name is invalid

public Object remove (Object name)

Removes the attribute with the specified name (key) from this Map. Returns the previous attribute value, or null if none.

Parameters

name	attribute name

Returns

the previous value of the attribute, or null if none

public int size ()

Returns the number of attributes in this Map.

Returns

the number of key-value mappings in this map

public Collection<Object> values ()

Returns a Collection view of the attribute values contained in this Map.

Returns

a collection view of the values contained in this map

Interfaces

Classes

Exceptions

Attributes

Class Overview

See Also

Summary

Fields

protected Map<Object, Object> map

Public Constructors

public Attributes ()

public Attributes (int size)

Parameters

public Attributes (Attributes attr)

Parameters

Public Methods

public void clear ()

public Object clone ()

Returns

public boolean containsKey (Object name)

Parameters

Returns

public boolean containsValue (Object value)

Parameters

Returns

public Set<Entry<Object, Object>> entrySet ()

Returns

public boolean equals (Object o)

Parameters

Returns

public Object get (Object name)

Parameters

Returns

public String getValue (String name)

Parameters

Returns

Throws

public String getValue (Attributes.Name name)

Parameters

Returns

public int hashCode ()

Returns

public boolean isEmpty ()

Returns

public Set<Object> keySet ()

Returns

public Object put (Object name, Object value)

Parameters

Returns

Throws

public void putAll (Map<?, ?> attr)

Parameters

Throws

public String putValue (String name, String value)

Parameters

Returns

Throws

public Object remove (Object name)

Parameters

Returns

public int size ()

Returns

public Collection<Object> values ()

Returns