java.util.jar

Class Manifest

java.lang.Object

java.util.jar.Manifest

All Implemented Interfaces:

Cloneable

public class Manifest
extends Object
implements Cloneable

The Manifest class is used to obtain attribute information for a JarFile and its entries.

Constructor Summary

Constructors

Constructor and Description
Manifest() Creates a new Manifest instance.
Manifest(InputStream is) Creates a new Manifest instance using the attributes obtained from the input stream.
Manifest(Manifest man) Creates a new Manifest instance.

Method Summary

Modifier and Type	Method and Description
void	clear() Resets the both the main attributes as well as the entry attributes associated with this Manifest.
Object	clone() Creates a copy of this Manifest.
boolean	equals(Object o) Determines if the receiver is equal to the parameter object.
Attributes	getAttributes(String name) Returns the Attributes associated with the parameter entry name.
Map<String,Attributes>	getEntries() Returns a map containing the Attributes for each entry in the Manifest.
Attributes	getMainAttributes() Returns the main Attributes of the JarFile.
int	hashCode() Returns the hash code for this instance.
void	read(InputStream is) Merges name/attribute pairs read from the input stream is into this manifest.
void	write(OutputStream os) Writes this Manifest's name/attributes pairs to the given OutputStream.

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Manifest

public Manifest()

Creates a new Manifest instance.

Manifest

public Manifest(InputStream is)
         throws IOException

Creates a new Manifest instance using the attributes obtained from the input stream.

Parameters:

is - InputStream to parse for attributes.

Throws:

IOException - if an IO error occurs while creating this Manifest

Manifest

public Manifest(Manifest man)

Creates a new Manifest instance. The new instance will have the same attributes as those found in the parameter Manifest.

Parameters:

man - Manifest instance to obtain attributes from.

Method Detail

clear

public void clear()

Resets the both the main attributes as well as the entry attributes associated with this Manifest.

getAttributes

public Attributes getAttributes(String name)

Returns the Attributes associated with the parameter entry name.

Parameters:

name - the name of the entry to obtain Attributes from.

Returns:

the Attributes for the entry or null if the entry does not exist.

getEntries

public Map<String,Attributes> getEntries()

Returns a map containing the Attributes for each entry in the Manifest.

Returns:

the map of entry attributes.

getMainAttributes

public Attributes getMainAttributes()

Returns the main Attributes of the JarFile.

Returns:

main Attributes associated with the source JarFile.

clone

public Object clone()

Creates a copy of this Manifest. The returned Manifest will equal the Manifest from which it was cloned.

Overrides:

clone in class Object

Returns:

a copy of this instance.

write

public void write(OutputStream os)
           throws IOException

Writes this Manifest's name/attributes pairs to the given OutputStream. The MANIFEST_VERSION or SIGNATURE_VERSION attribute must be set before calling this method, or no attributes will be written.

Throws:

IOException - If an error occurs writing the Manifest.

read

public void read(InputStream is)
          throws IOException

Merges name/attribute pairs read from the input stream is into this manifest.

Parameters:

is - The InputStream to read from.

Throws:

IOException - If an error occurs reading the manifest.

hashCode

public int hashCode()

Returns the hash code for this instance.

Overrides:

hashCode in class Object

Returns:

this Manifest's hashCode.

See Also:

Object.equals(java.lang.Object)

equals

public boolean equals(Object o)

Determines if the receiver is equal to the parameter object. Two Manifests are equal if they have identical main attributes as well as identical entry attributes.

Overrides:

equals in class Object

Parameters:

o - the object to compare against.

Returns:

true if the manifests are equal, false otherwise

See Also:

Object.hashCode()