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 maintain Manifest entry names and their associated Attributes. There are main Manifest Attributes as well as per-entry Attributes. For information on the Manifest format, please see the Manifest format specification.

Since:

1.2

Author:

David Connelly

See Also:

Attributes

Nested Class Summary

(package private) static class

Manifest.FastInputStream

Field Summary

private Attributes	attr
private Map	entries

Constructor Summary

Manifest()
Constructs a new, empty Manifest.

Manifest(InputStream is)
Constructs a new Manifest from the specified input stream.

Manifest(Manifest man)
Constructs a new Manifest that is a copy of the specified Manifest.

Method Summary

void	clear() Clears the main Attributes as well as the entries in this Manifest.
Object	clone() Returns a shallow copy of this Manifest.
boolean	equals(Object o) Returns true if the specified Object is also a Manifest and has the same main Attributes and entries.
Attributes	getAttributes(String name) Returns the Attributes for the specified entry name.
Map	getEntries() Returns a Map of the entries contained in this Manifest.
Attributes	getMainAttributes() Returns the main Attributes for the Manifest.
int	hashCode() Returns the hash code for this Manifest.
(package private) static void	make72Safe(StringBuffer line) Adds line breaks to enforce a maximum 72 bytes per line.
private String	parseName(byte[] lbuf, int len)
void	read(InputStream is) Reads the Manifest from the specified InputStream.
private int	toLower(int c)
void	write(OutputStream out) Writes the Manifest to the specified OutputStream.

Methods inherited from class java.lang.Object

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

Field Detail

attr

private Attributes attr

entries

private Map entries

Constructor Detail

Manifest

public Manifest()

Constructs a new, empty Manifest.

Manifest

public Manifest(InputStream is)
         throws IOException

Constructs a new Manifest from the specified input stream.

Parameters:

is - the input stream containing manifest data

Throws:

IOException - if an I/O error has occured

Manifest

public Manifest(Manifest man)

Constructs a new Manifest that is a copy of the specified Manifest.

Parameters:

man - the Manifest to copy

Method Detail

getMainAttributes

public Attributes getMainAttributes()

Returns the main Attributes for the Manifest.

Returns:

the main Attributes for the Manifest

getEntries

public Map getEntries()

Returns a Map of the entries contained in this Manifest. Each entry is represented by a String name (key) and associated Attributes (value).

Returns:

a Map of the entries contained in this Manifest

getAttributes

public Attributes getAttributes(String name)

Returns the Attributes for the specified entry name. This method is defined as:

	    return (Attributes)getEntries().get(name)
 

Parameters:

name - entry name

Returns:

the Attributes for the specified entry name

clear

public void clear()

Clears the main Attributes as well as the entries in this Manifest.

write

public void write(OutputStream out)
           throws IOException

Writes the Manifest to the specified OutputStream. Attributes.Name.MANIFEST_VERSION must be set in MainAttributes prior to invoking this method.

Parameters:

out - the output stream

Throws:

IOException - if an I/O error has occurred

See Also:

getMainAttributes()

make72Safe

static void make72Safe(StringBuffer line)

Adds line breaks to enforce a maximum 72 bytes per line.

read

public void read(InputStream is)
          throws IOException

Reads the Manifest from the specified InputStream. The entry names and attributes read will be merged in with the current manifest entries.

Parameters:

is - the input stream

Throws:

IOException - if an I/O error has occurred

parseName

private String parseName(byte[] lbuf,
                         int len)

toLower

private int toLower(int c)

equals

public boolean equals(Object o)

Returns true if the specified Object is also a Manifest and has the same main Attributes and entries.

Overrides:

equals in class Object

Parameters:

o - the object to be compared

Returns:

true if the specified Object is also a Manifest and has the same main Attributes and entries

See Also:

Object.hashCode(), Hashtable

hashCode

public int hashCode()

Returns the hash code for this Manifest.

Overrides:

hashCode in class Object

Returns:

a hash code value for this object.

See Also:

Object.equals(java.lang.Object), Hashtable

clone

public Object clone()

Returns a shallow copy of this Manifest. The shallow copy is implemented as follows:

     public Object clone() { return new Manifest(this); }
 

Overrides:

clone in class Object

Returns:

a shallow copy of this Manifest

See Also:

Cloneable