J2SE1.3  Overview   Package   Class  Text Changes  Statistics  Help 
Generated by
JDiff
PREV PACKAGE    NEXT PACKAGE          FRAMES    NO FRAMES  

java.util.jar Documentation Differences

This file contains all the changes in documentation in the package java.util.jar as colored differences. Deletions are shown like this, and additions are shown like this.
If no deletions or additions are shown in an entry, the HTML tags will be what has changed. The new HTML tags are shown in the differences. If no documentation existed, and then some was added in a later version, this change is noted in the appropriate class pages of differences, but the change is not shown on this page. Only changes in existing text are shown here. Similarly, documentation which was inherited from another class or interface is not shown here.
Note that an HTML error in the new documentation may cause the display of other documentation changes to be presented incorrectly. For instance, failure to close a <code> tag will cause all subsequent paragraphs to be displayed differently.
Class Attributes

The Attributes class maps Manifest attribute names to associated string values. Attribute names are case-insensitive and restricted to the ASCII characters in the set [0-9a-zA-Z_-]. Attribute values can contain any characters and will be UTF8-encoded when written to the output stream. @author David Connelly @version 1.29 0437 02/2202/9900 @see Manifest @since JDK11.2
Class Attributes.Name, boolean equals(Object)

Compares this attribute name to another for equality. @param o the object to compare @return true if this attribute name is equal to the specified attribute object
Class Attributes, constructor Attributes(Attributes)

Constructs a new Attributes object with the same attribute name-value mappings as in the specified Attributes. @param attr the specified Attributes
Class Attributes, boolean containsKey(Object)

Returns true if this Map contains the specified attribute name (key). @param name the attribute name @return true if this Map contains the specified attribute name
Class Attributes, boolean containsValue(Object)

Returns true if this Map maps one or more attribute names (keys) to the specified value. @param value the attribute value @return true if this Map maps one or more attribute names to the specified value
Class Attributes, Object get(Object)

Returns the value of the specified attribute name or null if the attribute name was not found. @param name the attribute name @return the value of the specified attribute name or null if not found.
Class Attributes, String getValue(Name)

Returns the value of the specified Attributes.Name or null if the attribute was not found.

This method is defined as: 

 return (String)get(name);
@param name the Attributes.Name object @return the String value of the specified Attribute.Name or null if not found.
Class Attributes, String getValue(String)

Returns the value of the specified attribute name specified as a string or null if the attribute was not found. The attribute name is case-insensitive.

This method is defined as: 

 return (String)get(new Attributes.Name((String)name));
@param name the attribute name as a string @return the String value of the specified attribute name or null if not found.
Class Attributes, void putAll(Map)

Copies all of the attribute name-value mappings from the specified Attributes to this Map. Duplicate mappings will be replaced. @param attr the Attributes to be stored in this map @exception IllegalArgumentExceptionClassCastException if attr is not aan Attributes instance
Class Attributes, String putValue(String, String)

Associates the specified value with the specified attribute name specified as a String. The attributes name is case-insensitive. If the Map previously contained a mapping for the attribute name the old value is replaced.

This method is defined as: 

 return (String)put(new Attributes.Name(name) value);
@param name the attribute name as a string @param value the attribute value @return the previous value of the attribute or null if none @exception IllegalArgumentException if the attribute name is invalid
Class Attributes, Object remove(Object)

Removes the attribute with the specified name (key) from this Map. Returns the previous attribute value or null if none. @param name attribute name @return the previous value of the attribute or null if none
Class JarEntry, constructor JarEntry(String)

Creates a new JarEntry for the specified JAR file entry name. @param name the JAR file entry name @exception NullPointerException if the entry name is null @exception IllegalArgumentException if the entry name is longer than 0xFFFF bytes.
Class JarEntry, constructor JarEntry(ZipEntry)

Creates a new JarEntry with fields taken from the specified ZipEntry object. @param ze the ZipEntry object to create the JarEntry from
Class JarEntry, Attributes getAttributes()

Returns the Manifest Attributes for this entry or null if none. @return the Manifest Attributes for this entry or null if none
Class JarEntry, Certificate[] getCertificates()

Returns the Certificate objects for this entry or null if none. This method can only be called once the JarEntry has been completely verified by reading from the entry input stream until the end of the stream has been reached. Otherwise this method will return null.

The returned certificate array comprises all the signer certificates that were used to verify this entry. Each signer certificate is followed by its supporting certificate chain (which may be empty). Each signer certificate and its supporting certificate chain are ordered bottom-to-top (i.e. with the signer certificate first and the (root) certificate authority last). @return the Certificate objects for this entry or null if none.

Class JarException

Signals that an error of some sort has occurred while reading from or writing to a JAR file. @author David Connelly @version 1.5 099 02/2102/9800 @since JDK11.2
Class JarFile

The JarFile class is used to read the contents of a JAR file from any file that can be opened with java.io.RandomAccessFile. It extends the class java.util.zip.ZipFile with support for reading an optional Manifest entry. The Manifest can be used to specify meta-information about the JAR file and its entries. @author David Connelly @version 1.30 0538 02/1902/9800 @see Manifest @see java.util.zip.ZipFile @see java.util.jar.JarEntry @since JDK11.2
Class JarFile, InputStream getInputStream(ZipEntry)

Returns an input stream for reading the contents of the specified ZIP file entry. @param ze the zip file entry @return an input stream for reading the contents of the specified ZIP file entry @exception ZipException if a ZIP format error has occurred @exception IOException if an I/O error has occurred @exception SecurityException if any of the JarFile entries are incorrectly signed.
Class JarFile, JarEntry getJarEntry(String)

Returns the JarEntry for the given entry name or null if not found. @param name the JAR file entry name @return the JarEntry for the given entry name or null if not found. @see java.util.jar.JarEntry
Class JarFile, Manifest getManifest()

Returns the JAR file manifest or null if none. @return the JAR file manifest or null if none
Class JarInputStream

The JarInputStream class is used to read the contents of a JAR file from any input stream. It extends the class java.util.zip.ZipInputStream with support for reading an optional Manifest entry. The Manifest can be used to store meta-information about the JAR file and its entries. @author David Connelly @version 1.20 0825 02/1702/9800 @see Manifest @see java.util.zip.ZipInputStream @since JDK11.2
Class JarInputStream, ZipEntry createZipEntry(String)

Creates a new JarEntry (ZipEntry) for the specified JAR file entry name. @param name the name of the JAR/ZIP file entry @return the JarEntry object just created
Class JarInputStream, Manifest getManifest()

Returns the Manifest for this JAR file or null if none. @return the Manifest for this JAR file or null if none.
Class JarInputStream, JarEntry getNextJarEntry()

Reads the next JAR file entry and positions the stream at the beginning of the entry data. @return the next JAR file entry @exception ZipException if a ZIP file error has occurred @exception IOException if an I/O error has occurred
Class JarOutputStream

The JarOutputStream class is used to write the contents of a JAR file to any output stream. It extends the class java.util.zip.ZipOutputStream with support for writing an optional Manifest entry. The Manifest can be used to specify meta-information about the JAR file and its entries. @author David Connelly @version 1.14 0719 02/0702/9800 @see Manifest @see java.util.zip.ZipOutputStream @since JDK11.2
Class JarOutputStream, void putNextEntry(ZipEntry)

Begins writing a new JAR file entry and positions the stream to the start of the entry data. This method will also close any previous entry. The default compression method will be used if no compression method was specified for the entry. The current time will be used if the entry has no set modification time. @param eze the ZIP/JAR entry to be written @exception ZipException if a ZIP error has occurred @exception IOException if an I/O error has occurred
Class 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. Documentation on the Manifest format can be found at : 
 http://java.sun.com/products/jdk/1.2/docs/guide/jar/manifest.html
@author David Connelly @version 1.26 0432 02/2202/9900 @see Attributes @since JDK11.2
Class Manifest, constructor Manifest(InputStream)

Constructs a new Manifest from the specified input stream. @param is the input stream containing manifest data @throws IOException if an I/O error has occured
Class Manifest, Object clone()

Returns a shallow copy of this Manifest implemented as follows: 
 public Object clone() { return new Manifest(this); }
@return a shallow copy of this Manifest
Class Manifest, boolean equals(Object)

Returns true if the specified Object is also a Manifest and has the same main Attributes and entries. @param o the object to be compared @return true if the specified Object is also a Manifest and has the same main Attributes and entries
Class Manifest, Attributes getAttributes(String)

Returns the Attributes for the specified entry name. This method is defined as: 
 return (Attributes)getEntries().get(name)
@return the Attributes for the specified entry name
Class Manifest, 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). @return a Map of the entries contained in this Manifest
Class Manifest, Attributes getMainAttributes()

Returns the main Attributes for the Manifest. @return the main Attributes for the Manifest