java.util.jar

Class JarInputStream

Implemented Interfaces:
Closeable, java.util.zip.ZipConstants

public class JarInputStream
extends ZipInputStream

InputStream for reading jar files. XXX - verification of the signatures in the Manifest file is not yet implemented.
Since:
1.2

Field Summary

Fields inherited from class java.util.zip.InflaterInputStream

buf, inf, len

Fields inherited from class java.io.FilterInputStream

in

Fields inherited from interface java.util.zip.ZipConstants

CENATT, CENATX, CENCOM, CENCRC, CENDSK, CENEXT, CENFLG, CENHDR, CENHOW, CENLEN, CENNAM, CENOFF, CENSIG, CENSIZ, CENTIM, CENVEM, CENVER, ENDCOM, ENDHDR, ENDOFF, ENDSIG, ENDSIZ, ENDSUB, ENDTOT, EXTCRC, EXTHDR, EXTLEN, EXTSIG, EXTSIZ, LOCCRC, LOCEXT, LOCFLG, LOCHDR, LOCHOW, LOCLEN, LOCNAM, LOCSIG, LOCSIZ, LOCTIM, LOCVER

Constructor Summary

JarInputStream(InputStream in)
Creates a new JarInputStream and tries to read the manifest.
JarInputStream(InputStream in, boolean verify)
Creates a new JarInputStream and tries to read the manifest.

Method Summary

protected ZipEntry
createZipEntry(String name)
Creates a JarEntry for a particular name and consults the manifest for the Attributes of the entry.
Manifest
getManifest()
Returns the Manifest for the jar file or null if there was no Manifest.
ZipEntry
getNextEntry()
Returns the next entry or null when there are no more entries.
JarEntry
getNextJarEntry()
Returns the next jar entry or null when there are no more entries.
int
read(byte[] buf, int off, int len)
XXX

Methods inherited from class java.util.zip.ZipInputStream

available, close, closeEntry, createZipEntry, getNextEntry, read, read

Methods inherited from class java.util.zip.InflaterInputStream

available, close, fill, mark, markSupported, read, read, reset, skip

Methods inherited from class java.io.FilterInputStream

available, close, mark, markSupported, read, read, read, reset, skip

Methods inherited from class java.io.InputStream

available, close, mark, markSupported, read, read, read, reset, skip

Methods inherited from class java.lang.Object

clone, equals, extends Object> getClass, finalize, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

JarInputStream

public JarInputStream(InputStream in)
            throws IOException
Creates a new JarInputStream and tries to read the manifest. If such a manifest is present the JarInputStream tries to verify all the entry signatures while reading.
Parameters:
in - InputStream to read the jar from
Throws:
IOException - when an error occurs when opening or reading

JarInputStream

public JarInputStream(InputStream in,
                      boolean verify)
            throws IOException
Creates a new JarInputStream and tries to read the manifest. If such a manifest is present and verify is true, the JarInputStream tries to verify all the entry signatures while reading.
Parameters:
in - InputStream to read the jar from
verify - whether or not to verify the manifest entries
Throws:
IOException - when an error occurs when opening or reading

Method Details

createZipEntry

protected ZipEntry createZipEntry(String name)
Creates a JarEntry for a particular name and consults the manifest for the Attributes of the entry. Used by ZipEntry.getNextEntry()
Overrides:
createZipEntry in interface ZipInputStream
Parameters:
name - the name of the new entry

getManifest

public Manifest getManifest()
Returns the Manifest for the jar file or null if there was no Manifest.

getNextEntry

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 getNextJarEntry(). Does not return any entries found at the beginning of the ZipFile that are special (those that start with "META-INF/").
Overrides:
getNextEntry in interface ZipInputStream
Throws:
IOException - if an IO error occurs when reading the entry

getNextJarEntry

public JarEntry getNextJarEntry()
            throws IOException
Returns the next jar entry or null when there are no more entries.
Throws:
IOException - if an IO error occurs when reading the entry

read

public int read(byte[] buf,
                int off,
                int len)
            throws IOException
XXX
Overrides:
read in interface ZipInputStream
Parameters:
buf - XXX
off - XXX
len - XXX
Returns:
XXX
Throws:
IOException - XXX

JarInputStream.java - InputStream for reading jar files Copyright (C) 2000, 2004 Free Software Foundation, Inc. This file is part of GNU Classpath. GNU Classpath is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2, or (at your option) any later version. GNU Classpath is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with GNU Classpath; see the file COPYING. If not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. Linking this library statically or dynamically with other modules is making a combined work based on this library. Thus, the terms and conditions of the GNU General Public License cover the whole combination. As a special exception, the copyright holders of this library give you permission to link this library with independent modules to produce an executable, regardless of the license terms of these independent modules, and to copy and distribute the resulting executable under terms of your choice, provided that you also meet, for each linked independent module, the terms and conditions of the license of that module. An independent module is a module which is not derived from or based on this library. If you modify this library, you may extend this exception to your version of the library, but you are not obligated to do so. If you do not wish to do so, delete this exception statement from your version.