Manifest
public
class
Manifest
extends Object
implements
Cloneable
java.lang.Object | |
↳ | java.util.jar.Manifest |
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.
See also:
Summary
Public constructors | |
---|---|
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. |
Public methods | |
---|---|
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<String, Attributes>
|
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. |
void
|
read(InputStream is)
Reads the Manifest from the specified InputStream. |
void
|
write(OutputStream out)
Writes the Manifest to the specified OutputStream. |
Inherited methods | |
---|---|
Public constructors
Manifest
public Manifest (InputStream is)
Constructs a new Manifest from the specified input stream.
Parameters | |
---|---|
is |
InputStream : the input stream containing manifest data |
Throws | |
---|---|
IOException |
if an I/O error has occurred |
Manifest
public Manifest (Manifest man)
Constructs a new Manifest that is a copy of the specified Manifest.
Parameters | |
---|---|
man |
Manifest : the Manifest to copy |
Public methods
clear
public void clear ()
Clears the main Attributes as well as the entries in this Manifest.
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); }
Returns | |
---|---|
Object |
a shallow copy of this Manifest |
equals
public boolean equals (Object o)
Returns true if the specified Object is also a Manifest and has the same main Attributes and entries.
Parameters | |
---|---|
o |
Object : the object to be compared |
Returns | |
---|---|
boolean |
true if the specified Object is also a Manifest and has the same main Attributes and entries |
getAttributes
public Attributes getAttributes (String name)
Returns the Attributes for the specified entry name. This method is defined as:
return (Attributes)getEntries().get(name)Though
null
is a valid name
, when
getAttributes(null)
is invoked on a Manifest
obtained from a jar file, null
will be returned. While jar
files themselves do not allow null
-named attributes, it is
possible to invoke getEntries()
on a Manifest
, and
on that result, invoke put
with a null key and an
arbitrary value. Subsequent invocations of
getAttributes(null)
will return the just-put
value.
Note that this method does not return the manifest's main attributes;
see getMainAttributes()
.
Parameters | |
---|---|
name |
String : entry name |
Returns | |
---|---|
Attributes |
the Attributes for the specified entry name |
getEntries
public Map<String, Attributes> getEntries ()
Returns a Map of the entries contained in this Manifest. Each entry
is represented by a String name (key) and associated Attributes (value).
The Map permits the null
key, but no entry with a null key is
created by read(InputStream)
, nor is such an entry written by using write(OutputStream)
.
Returns | |
---|---|
Map<String, Attributes> |
a Map of the entries contained in this Manifest |
getMainAttributes
public Attributes getMainAttributes ()
Returns the main Attributes for the Manifest.
Returns | |
---|---|
Attributes |
the main Attributes for the Manifest |
hashCode
public int hashCode ()
Returns the hash code for this Manifest.
Returns | |
---|---|
int |
a hash code value for this object. |
read
public void read (InputStream is)
Reads the Manifest from the specified InputStream. The entry names and attributes read will be merged in with the current manifest entries.
Parameters | |
---|---|
is |
InputStream : the input stream |
Throws | |
---|---|
IOException |
if an I/O error has occurred |
write
public void write (OutputStream out)
Writes the Manifest to the specified OutputStream. Attributes.Name.MANIFEST_VERSION must be set in MainAttributes prior to invoking this method.
Parameters | |
---|---|
out |
OutputStream : the output stream |
Throws | |
---|---|
IOException |
if an I/O error has occurred |
See also: