All Packages  Class Hierarchy  This Package  Previous  Next  Index

Class java.util.jar.JarInputStream 

java.lang.Object
    |
    +----java.io.InputStream
            |
            +----java.io.FilterInputStream
                    |
                    +----java.util.zip.InflaterInputStream
                            |
                            +----java.util.zip.ZipInputStream
                                    |
                                    +----java.util.jar.JarInputStream
public class JarInputStream
extends ZipInputStream
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.

Since:
JDK1.2
See Also:
Manifest, ZipInputStream

Constructor Index

o JarInputStream(InputStream)
Creates a new JarInputStream and reads the optional manifest.
o JarInputStream(InputStream, boolean)
Creates a new JarInputStream and reads the optional manifest.

Method Index

o createZipEntry(String)
Creates a new JarEntry (ZipEntry) for the specified JAR file entry name.
o getManifest()
Returns the Manifest for this JAR file, or null if none.
o getNextEntry()
Reads the next ZIP file entry and positions stream at the beginning of the entry data.
o getNextJarEntry()
Reads the next JAR file entry and positions the stream at the beginning of the entry data.
o read(byte[], int, int)
Reads from the current JAR file entry into an array of bytes.

Constructors

o JarInputStream 
public JarInputStream(InputStream in) throws IOException
Creates a new JarInputStream and reads the optional manifest. If a manifest is present, also attempts to verify the signatures if the JarInputStream is signed.

Parameters:
in - the actual input stream
Throws: IOException
if an I/O error has occurred
o JarInputStream 
public JarInputStream(InputStream in,
                      boolean verify) throws IOException
Creates a new JarInputStream and reads the optional manifest. If a manifest is present and verify is true, also attempts to verify the signatures if the JarInputStream is signed.

Parameters:
in - the actual input stream
verify - whether or not to verify the JarInputStream if it is signed.
Throws: IOException
if an I/O error has occurred

Methods

o getManifest 
public Manifest getManifest()
Returns the Manifest for this JAR file, or null if none.

o getNextEntry 
public ZipEntry getNextEntry() throws IOException
Reads the next ZIP file entry and positions stream at the beginning of the entry data.

Throws: ZipException
if a ZIP file error has occurred
Throws: IOException
if an I/O error has occurred
Overrides:
getNextEntry in class ZipInputStream
o getNextJarEntry 
public JarEntry getNextJarEntry() throws IOException
Reads the next JAR file entry and positions the stream at the beginning of the entry data.

Throws: ZipException
if a ZIP file error has occurred
Throws: IOException
if an I/O error has occurred
o read 
public int read(byte[] b,
                int off,
                int len) throws IOException
Reads from the current JAR file entry into an array of bytes. Blocks until some input is available.

Parameters:
b - the buffer into which the data is read
off - the start offset of the data
len - the maximum number of bytes to read
Returns:
the actual number of bytes read, or -1 if the end of the entry is reached
Throws: ZipException
if a ZIP file error has occurred
Throws: IOException
if an I/O error has occurred
Overrides:
read in class ZipInputStream
o createZipEntry 
protected ZipEntry createZipEntry(String name)
Creates a new JarEntry (ZipEntry) for the specified JAR file entry name.

Parameters:
name - the name of the JAR/ZIP file entry
Overrides:
createZipEntry in class ZipInputStream
All Packages  Class Hierarchy  This Package  Previous  Next  Index
Submit a bug or feature