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.
Summary
Public methods |
Manifest
|
getManifest()
Returns the Manifest for this JAR file, or
null if none.
|
ZipEntry
|
getNextEntry()
Reads the next ZIP file entry and positions the stream at the
beginning of the entry data.
|
JarEntry
|
getNextJarEntry()
Reads the next JAR file entry and positions the stream at the
beginning of the entry data.
|
int
|
read(byte[] b, int off, int len)
Reads from the current JAR file entry into an array of bytes.
|
Inherited methods |
From
class
java.util.zip.ZipInputStream
|
From
class
java.util.zip.InflaterInputStream
|
From
class
java.io.FilterInputStream
|
From
class
java.io.InputStream
|
From
class
java.lang.Object
Object
|
clone()
Creates and returns a copy of this object.
|
boolean
|
equals(Object obj)
Indicates whether some other object is "equal to" this one.
|
void
|
finalize()
Called by the garbage collector on an object when garbage collection
determines that there are no more references to the object.
|
final
Class<?>
|
getClass()
Returns the runtime class of this Object .
|
int
|
hashCode()
Returns a hash code value for the object.
|
final
void
|
notify()
Wakes up a single thread that is waiting on this object's
monitor.
|
final
void
|
notifyAll()
Wakes up all threads that are waiting on this object's monitor.
|
String
|
toString()
Returns a string representation of the object.
|
final
void
|
wait(long millis, int nanos)
Causes the current thread to wait until another thread invokes the
notify() method or the
notifyAll() method for this object, or
some other thread interrupts the current thread, or a certain
amount of real time has elapsed.
|
final
void
|
wait(long millis)
Causes the current thread to wait until either another thread invokes the
notify() method or the
notifyAll() method for this object, or a
specified amount of time has elapsed.
|
final
void
|
wait()
Causes the current thread to wait until another thread invokes the
notify() method or the
notifyAll() method for this object.
|
|
From
interface
java.io.Closeable
abstract
void
|
close()
Closes this stream and releases any system resources associated
with it.
|
|
From
interface
java.lang.AutoCloseable
abstract
void
|
close()
Closes this resource, relinquishing any underlying resources.
|
|
Public constructors
JarInputStream
JarInputStream (InputStream in)
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 |
InputStream :
the actual input stream |
JarInputStream
JarInputStream (InputStream in,
boolean verify)
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 |
InputStream :
the actual input stream |
verify |
boolean :
whether or not to verify the JarInputStream if
it is signed. |
Public methods
getManifest
Manifest getManifest ()
Returns the Manifest
for this JAR file, or
null
if none.
Returns |
Manifest |
the Manifest for this JAR file, or
null if none.
|
getNextEntry
ZipEntry getNextEntry ()
Reads the next ZIP file entry and positions the stream at the
beginning of the entry data. If verification has been enabled,
any invalid signature detected while positioning the stream for
the next entry will result in an exception.
Returns |
ZipEntry |
the next ZIP file entry, or null if there are no more entries |
getNextJarEntry
JarEntry getNextJarEntry ()
Reads the next JAR file entry and positions the stream at the
beginning of the entry data. If verification has been enabled,
any invalid signature detected while positioning the stream for
the next entry will result in an exception.
Returns |
JarEntry |
the next JAR file entry, or null if there are no more entries |
read
int read (byte[] b,
int off,
int len)
Reads from the current JAR file entry into an array of bytes.
If len
is not zero, the method
blocks until some input is available; otherwise, no
bytes are read and 0
is returned.
If verification has been enabled, any invalid signature
on the current entry will be reported at some point before the
end of the entry is reached.
Parameters |
b |
byte :
the buffer into which the data is read |
off |
int :
the start offset in the destination array b |
len |
int :
the maximum number of bytes to read |
Returns |
int |
the actual number of bytes read, or -1 if the end of the
entry is reached |
Protected methods
createZipEntry
ZipEntry createZipEntry (String name)
Creates a new JarEntry
(ZipEntry
) for the
specified JAR file entry name. The manifest attributes of
the specified JAR file entry name will be copied to the new
JarEntry
.
Parameters |
name |
String :
the name of the JAR/ZIP file entry |
Returns |
ZipEntry |
the JarEntry object just created
|