util/jar/JarFile.java

59  * The {@code JarFile} class is used to read the contents of a jar file
77  * <p>By default, a {@code JarFile} for a multi-release jar file is configured
80  * The {@code JarFile} may be configured to process a multi-release jar file by
81  * creating the {@code JarFile} with the
82  * {@link JarFile#JarFile(File, boolean, int, Runtime.Version)} constructor.  The
90  * <p>Class loaders that utilize {@code JarFile} to load classes from the
91  * contents of {@code JarFile} entries should construct the {@code JarFile}
92  * by invoking the {@link JarFile#JarFile(File, boolean, int, Runtime.Version)}
110  * If the API can not be used to configure a {@code JarFile} (e.g. to override
120  * is the version that the {@link JarFile#JarFile(File, boolean, int, Runtime.Version)}
122  * {@code JarFile.runtimeVersion()}.
131  * the method {@link JarFile#isMultiRelease()} returns <em>false</em>. The value
132  * <em>force</em> causes the {@code JarFile} to be initialized to runtime
134  * {@code (new JarFile(File, boolean, int, JarFile.runtimeVersion())}.
146 class JarFile extends ZipFile {
240      * Creates a new {@code JarFile} to read from the specified
241      * file {@code name}. The {@code JarFile} will be verified if
248     public JarFile(String name) throws IOException {
253      * Creates a new {@code JarFile} to read from the specified
262     public JarFile(String name, boolean verify) throws IOException {
267      * Creates a new {@code JarFile} to read from the specified
268      * {@code File} object. The {@code JarFile} will be verified if
275     public JarFile(File file) throws IOException {
280      * Creates a new {@code JarFile} to read from the specified
289     public JarFile(File file, boolean verify) throws IOException {
294      * Creates a new {@code JarFile} to read from the specified
309     public JarFile(File file, boolean verify, int mode) throws IOException {
314      * Creates a new {@code JarFile} to read from the specified
318      * used to configure the {@code JarFile} for processing
323      * {@code Math.max(version.major(), JarFile.baseVersion().major())}.
338     public JarFile(File file, boolean verify, int mode, Runtime.Version version) throws IOException {
343             // This deals with the common case where the value from JarFile.runtimeVersion() is passed
346             // This also deals with the common case where the value from JarFile.baseVersion() is passed
358      * If this {@code JarFile} is not a multi-release jar file or is not
372      * @return true if this JarFile is a multi-release jar file
435      * <p>If this {@code JarFile} is a multi-release jar file and is configured
445      * {@link JarFile#getVersion()}.
458      * This implementation invokes {@link JarFile#getEntry(String)}.
469      * <p>If this {@code JarFile} is a multi-release jar file and is configured
479      * {@link JarFile#getVersion()}.
519         final Enumeration<? extends ZipEntry> e = JarFile.super.entries();
594      * Returns the real name of a {@code JarEntry}.  If this {@code JarFile} is
600      * jar file is not a multi-release jar file or {@code JarFile} is not
627             Manifest man = JarFile.this.getManifest();
641                 certs = jv.getCerts(JarFile.this, realEntry());
652                 signers = jv.getCodeSigners(JarFile.this, realEntry());