java.lang.Object
java.util.jar.Manifest
- All Implemented Interfaces:
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
- External Specifications
- See Also:
-
Constructor Summary
ConstructorDescriptionManifest()
Constructs a new, empty Manifest.Manifest
(InputStream is) Constructs a new Manifest from the specified input stream.Constructs a new Manifest that is a copy of the specified Manifest. -
Method Summary
Modifier and TypeMethodDescriptionvoid
clear()
Clears the main Attributes as well as the entries in this Manifest.clone()
Returns a shallow copy of this Manifest.boolean
Returns true if the specified Object is also a Manifest and has the same main Attributes and entries.getAttributes
(String name) Returns the Attributes for the specified entry name.Returns a Map of the entries contained in this Manifest.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.
-
Constructor Details
-
Manifest
public Manifest()Constructs a new, empty Manifest. -
Manifest
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 occurred
-
Manifest
Constructs a new Manifest that is a copy of the specified Manifest.- Parameters:
man
- the Manifest to copy
-
-
Method Details
-
getMainAttributes
Returns the main Attributes for the Manifest.- Returns:
- the main Attributes for the Manifest
-
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 thenull
key, but no entry with a null key is created byread(java.io.InputStream)
, nor is such an entry written by usingwrite(java.io.OutputStream)
.- Returns:
- a Map of the entries contained in this Manifest
-
getAttributes
Returns the Attributes for the specified entry name. This method is defined as:return (Attributes)getEntries().get(name)
Thoughnull
is a validname
, whengetAttributes(null)
is invoked on aManifest
obtained from a jar file,null
will be returned. While jar files themselves do not allownull
-named attributes, it is possible to invokegetEntries()
on aManifest
, and on that result, invokeput
with a null key and an arbitrary value. Subsequent invocations ofgetAttributes(null)
will return the just-put
value.Note that this method does not return the manifest's main attributes; see
getMainAttributes()
.- 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
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:
-
read
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
-
equals
Returns true if the specified Object is also a Manifest and has the same main Attributes and entries. -
hashCode
public int hashCode()Returns the hash code for this Manifest. -
clone
Returns a shallow copy of this Manifest. The shallow copy is implemented as follows:public Object clone() { return new Manifest(this); }
-