java.util.jar.JarFile Maven / Gradle / Ivy

This work corresponds to the API signatures of JSR 219: Foundation Profile 1.1. In the event of a discrepency between this work and the JSR 219 specification, which is available at http://www.jcp.org/en/jsr/detail?id=219, the latter takes precedence. */ package java.util.jar; import java.io.*; import java.util.*; import java.util.zip.*; import java.security.cert.Certificate; /** * 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.38, 02/02/00 * @see Manifest * @see java.util.zip.ZipFile * @see java.util.jar.JarEntry * @since 1.2 */ public class JarFile extends ZipFile { /** * The JAR manifest file name. */ public static final String MANIFEST_NAME = "META-INF/MANIFEST.MF"; /** * Creates a new JarFile to read from the specified * file name. The JarFile will be verified if * it is signed. * @param name the name of the JAR file to be opened for reading * @exception IOException if an I/O error has occurred * @exception SecurityException if access to the file is denied * by the SecurityManager */ public JarFile(String name) throws IOException { this(new File(name), true, ZipFile.OPEN_READ); } /** * Creates a new JarFile to read from the specified * file name. * @param name the name of the JAR file to be opened for reading * @param verify whether or not to verify the JarFile if * it is signed. * @exception IOException if an I/O error has occurred * @exception SecurityException if access to the file is denied * by the SecurityManager */ public JarFile(String name, boolean verify) throws IOException { this(new File(name), verify, ZipFile.OPEN_READ); } /** * Creates a new JarFile to read from the specified * File object. The JarFile will be verified if * it is signed. * @param file the JAR file to be opened for reading * @exception IOException if an I/O error has occurred * @exception SecurityException if access to the file is denied * by the SecurityManager */ public JarFile(File file) throws IOException { this(file, true, ZipFile.OPEN_READ); } /** * Creates a new JarFile to read from the specified * File object. * @param file the JAR file to be opened for reading * @param verify whether or not to verify the JarFile if * it is signed. * @exception IOException if an I/O error has occurred * @exception SecurityException if access to the file is denied * by the SecurityManager. */ public JarFile(File file, boolean verify) throws IOException { this(file, verify, ZipFile.OPEN_READ); } /** * Creates a new JarFile to read from the specified * File object in the specified mode. The mode argument * must be either OPEN_READ or OPEN_READ | OPEN_DELETE. * * @param file the JAR file to be opened for reading * @param verify whether or not to verify the JarFile if * it is signed. * @param mode the mode in which the file is to be opened * @exception IOException if an I/O error has occurred * @exception IllegalArgumentException * If the mode argument is invalid * @exception SecurityException if access to the file is denied * by the SecurityManager */ public JarFile(File file, boolean verify, int mode) throws IOException { super(file, mode); } /** * Returns the JAR file manifest, or null if none. * * @return the JAR file manifest, or null if none */ public Manifest getManifest() throws IOException { return null; } /** * 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 */ public JarEntry getJarEntry(String name) { return null; } /** * Returns the ZipEntry for the given entry name or * null if not found. * * @param name the JAR file entry name * @return the ZipEntry for the given entry name or * null if not found * @see java.util.zip.ZipEntry */ public ZipEntry getEntry(String name) { return null; } /** * Returns an enumeration of the ZIP file entries. */ public Enumeration entries() { return null; } /** * 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. */ public synchronized InputStream getInputStream(ZipEntry ze) throws IOException { return null; } }