All Packages  Class Hierarchy  This Package  Previous  Next  Index

Class java.util.jar.JarFile 

java.lang.Object
    |
    +----java.util.zip.ZipFile
            |
            +----java.util.jar.JarFile
public class JarFile
extends ZipFile
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.

Since:
JDK1.2
See Also:
Manifest, ZipFile, JarEntry

Variable Index

o MANIFEST_NAME

Constructor Index

o JarFile()
Creates a new, unnamed JarFile.
o JarFile(File)
Creates a new JarFile to read from the specified File object.
o JarFile(File, boolean)
Creates a new JarFile to read from the specified File object.
o JarFile(String)
Creates a new JarFile to read from the specified file name.
o JarFile(String, boolean)
Creates a new JarFile to read from the specified file name.

Method Index

o createZipEntry(String)
Creates a new JarEntry for the specified JAR file entry name.
o getInputStream(ZipEntry)
Returns an input stream for reading the contents of the specified ZIP file entry.
o getJarEntry(String)
Returns the JarEntry for the given entry name.
o getManifest()
Returns the JAR file manifest, or null if none.

Variables

o MANIFEST_NAME 
public static final String MANIFEST_NAME

Constructors

o JarFile 
protected JarFile()
Creates a new, unnamed JarFile.

o JarFile 
public JarFile(String name) throws IOException
Creates a new JarFile to read from the specified file name. The JarFile will be verified if it is signed.

Parameters:
name - the name of the JAR file to be opened for reading
Throws: FileNotFoundException
if the file could not be found
Throws: IOException
if an I/O error has occurred
o JarFile 
public JarFile(String name,
               boolean verify) throws IOException
Creates a new JarFile to read from the specified file name.

Parameters:
name - the name of the JAR file to be opened for reading
verify - whether or not to verify the JarFile if it is signed.
Throws: FileNotFoundException
if the file could not be found
Throws: IOException
if an I/O error has occurred
o JarFile 
public JarFile(File file) throws IOException
Creates a new JarFile to read from the specified File object. The JarFile will be verified if it is signed.

Parameters:
file - the JAR file to be opened for reading
Throws: FileNotFoundException
if the file could not be found
Throws: IOException
if an I/O error has occurred
o JarFile 
public JarFile(File file,
               boolean verify) throws IOException
Creates a new JarFile to read from the specified File object.

Parameters:
file - the JAR file to be opened for reading
verify - whether or not to verify the JarFile if it is signed.
Throws: FileNotFoundException
if the file could not be found
Throws: IOException
if an I/O error has occurred

Methods

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

o getJarEntry 
public JarEntry getJarEntry(String name)
Returns the JarEntry for the given entry name. Returns null if there is no entry corresponding to the given name.

Parameters:
name - the JAR file entry name
See Also:
JarEntry
o getInputStream 
public InputStream getInputStream(ZipEntry ze) throws IOException
Returns an input stream for reading the contents of the specified ZIP file entry.

Parameters:
ze - the zip file entry
Throws: ZipException
if a ZIP format error has occurred
Throws: IOException
if an I/O error has occurred
Overrides:
getInputStream in class ZipFile
o createZipEntry 
protected ZipEntry createZipEntry(String name)
Creates a new JarEntry for the specified JAR file entry name.

Overrides:
createZipEntry in class ZipFile
All Packages  Class Hierarchy  This Package  Previous  Next  Index
Submit a bug or feature