gcc/libjava/doc/java-util-jar.texi

@deftypemethod Attributes {public String} getValue (java.lang.String@w{ }@var{name}) 
Gets the value of an attribute name given as a String.
@end deftypemethod
@deftypemethod Attributes {public String} getValue (java.util.jar.Attributes.Name@w{ }@var{name}) 
Gets the value of the given attribute name.
@end deftypemethod
@deftypemethod Attributes {public String} putValue (java.lang.String@w{ }@var{name}, java.lang.String@w{ }@var{value}) 
Stores an attribute name (represented by a String) and value in this
 Attributes map.
 When the (case insensitive string) name already exists the value is
 replaced and the old value is returned.
@end deftypemethod
@deftypemethod Attributes {public Object} clone () 
Return a clone of this attribute map.
@end deftypemethod
@deftypemethod Attributes {public void} clear () 
Removes all attributes.
@end deftypemethod
@deftypemethod Attributes {public boolean} containsKey (java.lang.Object@w{ }@var{attrName}) 
Checks to see if there is an attribute with the specified name.
 XXX - what if the object is a String?
@end deftypemethod
@deftypemethod Attributes {public boolean} containsValue (java.lang.Object@w{ }@var{attrValue}) 
Checks to see if there is an attribute name with the specified value.
@end deftypemethod
@deftypemethod Attributes {public Set} entrySet () 
Gives a Set of attribute name and values pairs as MapEntries.
@end deftypemethod
@deftypemethod Attributes {public boolean} equals (java.lang.Object@w{ }@var{o}) 
Checks to see if two Attributes are equal. The supplied object must be
 a real instance of Attributes and contain the same attribute name/value
 pairs.
@end deftypemethod
@deftypemethod Attributes {public Object} get (java.lang.Object@w{ }@var{attrName}) 
Gets the value of a specified attribute name.
 XXX - what if the object is a String?
@end deftypemethod
@deftypemethod Attributes {public int} hashCode () 
Returns the hashcode of the attribute name/value map.
@end deftypemethod
@deftypemethod Attributes {public boolean} isEmpty () 
Returns true if there are no attributes set, false otherwise.
@end deftypemethod
@deftypemethod Attributes {public Set} keySet () 
Gives a Set of all the values of defined attribute names.
@end deftypemethod
@deftypemethod Attributes {public Object} put (java.lang.Object@w{ }@var{name}, java.lang.Object@w{ }@var{value}) 
Adds or replaces a attribute name/value pair.
 XXX - What if the name is a string? What if the name is neither a Name
 nor a String? What if the value is not a string?
@end deftypemethod
@deftypemethod Attributes {public void} putAll (java.util.Map@w{ }@var{attr}) 
Adds or replaces all attribute name/value pairs from another
 Attributes object to this one. The supplied Map must be an instance of
 Attributes.
@end deftypemethod
@deftypemethod Attributes {public Object} remove (java.lang.Object@w{ }@var{name}) 
Remove a attribute name/value pair.
 XXX - What if the name is a String?
@end deftypemethod
@deftypemethod Attributes {public int} size () 
Returns the number of defined attribute name/value pairs.
@end deftypemethod
@deftypemethod Attributes {public Collection} values () 
Returns all the values of the defined attribute name/value pairs as a
 Collection.
@end deftypemethod
@deftypemethod Attributes.Name {public int} hashCode () 
Returns the hash code of the (lowercase) String representation of
 this Name.
@end deftypemethod
@deftypemethod Attributes.Name {public boolean} equals (java.lang.Object@w{ }@var{o}) 
Checks if another object is equal to this Name object.
 Another object is equal to this Name object if it is an instance of
 Name and the (lowercase) string representation of the name is equal.
@end deftypemethod
@deftypemethod Attributes.Name {public String} toString () 
Returns the string representation of this Name as given to the
 constructor (not neccesarily the lower case representation).
@end deftypemethod
@deftypemethod JarEntry {public Attributes} getAttributes () @*throws IOException
Returns a copy of the Attributes set for this entry.
 When no Attributes are set in the manifest null is returned.
@end deftypemethod
@deftypemethod JarEntry {public Certificate} getCertificates () 
Returns a copy of the certificates set for this entry.
 When no certificates are set or when not all data of this entry has
 been read null is returned.
 


 To make sure that this call returns a valid value you must read all
 data from the JarInputStream for this entry.
 When you don't need the data for an entry but want to know the
 certificates that are set for the entry then you can skip all data by
 calling @code{skip(entry.getSize())} on the JarInputStream for
 the entry.
@end deftypemethod
@deftypemethod JarFile {public Enumeration} entries () @*throws IllegalStateException
Returns a enumeration of all the entries in the JarFile.
 Note that also the Jar META-INF entries are returned.
@end deftypemethod
@deftypemethod JarFile {public ZipEntry} getEntry (java.lang.String@w{ }@var{name}) 
XXX
 It actually returns a JarEntry not a zipEntry
@end deftypemethod
@deftypemethod JarFile {public synchronized InputStream} getInputStream (java.util.zip.ZipEntry@w{ }@var{entry}) @*throws ZipException, IOException
XXX should verify the inputstream
@end deftypemethod
@deftypemethod JarFile {public JarEntry} getJarEntry (java.lang.String@w{ }@var{name}) 
Returns the JarEntry that belongs to the name if such an entry
 exists in the JarFile. Returns null otherwise
 Convenience method that just casts the result from @code{getEntry}
 to a JarEntry.
@end deftypemethod
@deftypemethod JarFile {public Manifest} getManifest () 
Returns the manifest for this JarFile or null when the JarFile does not
 contain a manifest file.
@end deftypemethod
@deftypemethod JarInputStream {protected ZipEntry} createZipEntry (java.lang.String@w{ }@var{name}) 
Creates a JarEntry for a particular name and consults the manifest
 for the Attributes of the entry.
 Used by @code{ZipEntry.getNextEntry()}
@end deftypemethod
@deftypemethod JarInputStream {public Manifest} getManifest () 
Returns the Manifest for the jar file or null if there was no Manifest.
@end deftypemethod
@deftypemethod JarInputStream {public ZipEntry} getNextEntry () @*throws IOException
Returns the next entry or null when there are no more entries.
 Does actually return a JarEntry, if you don't want to cast it yourself
 use @code{getNextJarEntry()}. Does not return any entries found
 at the beginning of the ZipFile that are special
 (those that start with "META-INF/").
@end deftypemethod
@deftypemethod JarInputStream {public JarEntry} getNextJarEntry () @*throws IOException
Returns the next jar entry or null when there are no more entries.
@end deftypemethod
@deftypemethod JarInputStream {public int} read (byte[]@w{ }@var{buf}, int@w{ }@var{off}, int@w{ }@var{len}) @*throws IOException
XXX
@end deftypemethod
@deftypemethod JarOutputStream {public void} putNextEntry (java.util.zip.ZipEntry@w{ }@var{entry}) @*throws IOException
Prepares the JarOutputStream for writing the next entry. 
 This implementation just calls @code{super.putNextEntre()}.
@end deftypemethod
@deftypemethod Manifest {public Attributes} getMainAttributes () 
Gets the main attributes of this Manifest.
@end deftypemethod
@deftypemethod Manifest {public Map} getEntries () 
Gets a map of entry Strings to Attributes for all the entries described
 in this manifest. Adding, changing or removing from this entries map
 changes the entries of this manifest.
@end deftypemethod
@deftypemethod Manifest {public Attributes} getAttributes (java.lang.String@w{ }@var{entryName}) 
Returns the Attributes associated with the Entry.
 


 Implemented as:
 @code{return (Attributes)getEntries().get(entryName)}
@end deftypemethod
@deftypemethod Manifest {public void} clear () 
Clears the main attributes and removes all the entries from the
 manifest.
@end deftypemethod
@deftypemethod Manifest {public void} read (java.io.InputStream@w{ }@var{in}) @*throws IOException
XXX
@end deftypemethod
@deftypemethod Manifest {public void} write (java.io.OutputStream@w{ }@var{out}) @*throws IOException
XXX
@end deftypemethod
@deftypemethod Manifest {public Object} clone () 
Makes a deep copy of the main attributes, but a shallow copy of
 the other entries. This means that you can freely add, change or remove
 the main attributes or the entries of the new manifest without effecting
 the original manifest, but adding, changing or removing attributes from
 a particular entry also changes the attributes of that entry in the
 original manifest. Calls @code{new Manifest(this)}.
@end deftypemethod
@deftypemethod Manifest {public boolean} equals (java.lang.Object@w{ }@var{o}) 
Checks if another object is equal to this Manifest object.
 Another Object is equal to this Manifest object if it is an instance of
 Manifest and the main attributes and the entries of the other manifest
 are equal to this one.
@end deftypemethod
@deftypemethod Manifest {public int} hashCode () 
Calculates the hash code of the manifest. Implemented by a xor of the
 hash code of the main attributes with the hash code of the entries map.
@end deftypemethod