Класс JarFile

java.lang.Object
- java.util.zip.ZipFile
- - java.util.jar.JarFile

Все реализованные интерфейсы:: Closeable, AutoCloseable

public class JarFile
extends ZipFile

Класс JarFile используется для чтения содержимого файла jar из любого файла, который можно открыть с помощью java.io.RandomAccessFile. Он расширяет класс java.util.zip.ZipFile с поддержкой чтения необязательной записи Manifest. Manifest может быть использован для указания метаинформации о файле jar и его записях.

Если не указано иное, передача аргумента null конструктору или методу в этом классе вызовет исключение NullPointerException. Если флаг проверки включен при открытии подписанного файла jar, содержимое файла проверяется по его цифровой подписи, встроенной в файл. Обратите внимание, что процесс проверки не включает проверку сертификата подписавшего лица. Вызывающий код должен проверить возвращаемое значение метода JarEntry.getCodeSigners(), чтобы дополнительно определить, можно ли доверять подписи.

С тех пор как:: 1.2
См. также:: Manifest, ZipFile, JarEntry

Поля

Модификатор и тип	Поле и описание
`static int`	`CENATT`
`static int`	`CENATX`
`static int`	`CENCOM`
`static int`	`CENCRC`
`static int`	`CENDSK`
`static int`	`CENEXT`
`static int`	`CENFLG`
`static int`	`CENHDR`
`static int`	`CENHOW`
`static int`	`CENLEN`
`static int`	`CENNAM`
`static int`	`CENOFF`
`static long`	`CENSIG`
`static int`	`CENSIZ`
`static int`	`CENTIM`
`static int`	`CENVEM`
`static int`	`CENVER`
`static int`	`ENDCOM`
`static int`	`ENDHDR`
`static int`	`ENDOFF`
`static long`	`ENDSIG`
`static int`	`ENDSIZ`
`static int`	`ENDSUB`
`static int`	`ENDTOT`
`static int`	`EXTCRC`
`static int`	`EXTHDR`
`static int`	`EXTLEN`
`static long`	`EXTSIG`
`static int`	`EXTSIZ`
`static int`	`LOCCRC`
`static int`	`LOCEXT`
`static int`	`LOCFLG`
`static int`	`LOCHDR`
`static int`	`LOCHOW`
`static int`	`LOCLEN`
`static int`	`LOCNAM`
`static long`	`LOCSIG`
`static int`	`LOCSIZ`
`static int`	`LOCTIM`
`static int`	`LOCVER`
`static String`	`MANIFEST_NAME` Имя файла манифеста JAR.

Поля, унаследованные от класса java.util.zip.ZipFile

OPEN_DELETE, OPEN_READ

Конструкторы

Конструктор и описание
`JarFile(File file)` Создаёт новый `JarFile` для чтения из указанного объекта `File`.
`JarFile(File file, boolean verify)` Создаёт новый `JarFile` для чтения из указанного объекта `File`.
`JarFile(File file, boolean verify, int mode)` Создаёт новый `JarFile` для чтения из указанного объекта `File` в указанном режиме.
`JarFile(String name)` Создаёт новый `JarFile` для чтения из указанного файла `name`.
`JarFile(String name, boolean verify)` Создаёт новый `JarFile` для чтения из указанного файла `name`.

Методы

Модификатор и тип	Метод и описание
`Enumeration<JarEntry>`	`entries()` Возвращает перечисление записей файла zip.
`ZipEntry`	`getEntry(String name)` Возвращает `ZipEntry` для данного имени записи или `null` если не найдено.
`InputStream`	`getInputStream(ZipEntry ze)` Возвращает поток ввода для чтения содержимого указанной записи файла zip.
`JarEntry`	`getJarEntry(String name)` Возвращает `JarEntry` для данного имени записи или `null` если не найдено.
`Manifest`	`getManifest()` Возвращает манифест файла jar или `null` если его нет.
`Stream<JarEntry>`	`stream()` Возвращает упорядоченный `Stream` по записям файла ZIP.

Методы, унаследованные от класса java.util.zip.ZipFile

close, finalize, getComment, getName, size

Методы, унаследованные от класса java.lang.Object

clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Поля

MANIFEST_NAME

public static final String MANIFEST_NAME

Имя файла манифеста JAR.

См. также:: Значения константных полей

LOCSIG

public static final long LOCSIG

См. также:: Значения константных полей

EXTSIG

public static final long EXTSIG

См. также:: Значения константных полей

CENSIG

public static final long CENSIG

См. также:: Значения константных полей

ENDSIG

public static final long ENDSIG

См. также:: Значения константных полей

LOCHDR

public static final int LOCHDR

См. также:: Значения константных полей

EXTHDR

public static final int EXTHDR

См. также:: Значения константных полей

CENHDR

public static final int CENHDR

См. также:: Значения константных полей

ENDHDR

public static final int ENDHDR

См. также:: Значения константных полей

LOCVER

public static final int LOCVER

См. также:: Значения константных полей

LOCFLG

public static final int LOCFLG

См. также:: Значения константных полей

LOCHOW

public static final int LOCHOW

См. также:: Значения константных полей

LOCTIM

public static final int LOCTIM

См. также:: Значения константных полей

LOCCRC

public static final int LOCCRC

См. также:: Значения константных полей

LOCSIZ

public static final int LOCSIZ

См. также:: Значения константных полей

LOCLEN

public static final int LOCLEN

См. также:: Значения константных полей

LOCNAM

public static final int LOCNAM

См. также:: Значения константных полей

LOCEXT

public static final int LOCEXT

См. также:: Значения константных полей

EXTCRC

public static final int EXTCRC

См. также:: Значения константных полей

EXTSIZ

public static final int EXTSIZ

См. также:: Значения константных полей

EXTLEN

public static final int EXTLEN

См. также:: Значения константных полей

CENVEM

public static final int CENVEM

См. также:: Значения константных полей

CENVER

public static final int CENVER

См. также:: Значения константных полей

CENFLG

public static final int CENFLG

См. также:: Значения константных полей

CENHOW

public static final int CENHOW

См. также:: Значения константных полей

CENTIM

public static final int CENTIM

См. также:: Значения константных полей

CENCRC

public static final int CENCRC

См. также:: Значения константных полей

CENSIZ

public static final int CENSIZ

См. также:: Значения константных полей

CENLEN

public static final int CENLEN

См. также:: Значения константных полей

CENNAM

public static final int CENNAM

См. также:: Значения константных полей

CENEXT

public static final int CENEXT

См. также:: Значения константных полей

CENCOM

public static final int CENCOM

См. также:: Значения константных полей

CENDSK

public static final int CENDSK

См. также:: Значения константных полей

CENATT

public static final int CENATT

См. также:: Значения константных полей

CENATX

public static final int CENATX

См. также:: Значения константных полей

CENOFF

public static final int CENOFF

См. также:: Значения константных полей

ENDSUB

public static final int ENDSUB

См. также:: Значения константных полей

ENDTOT

public static final int ENDTOT

См. также:: Значения константных полей

ENDSIZ

public static final int ENDSIZ

См. также:: Значения константных полей

ENDOFF

public static final int ENDOFF

См. также:: Значения константных полей

ENDCOM

public static final int ENDCOM

См. также:: Значения константных полей

Конструкторы

JarFile

public JarFile(String name)
        throws IOException

Создает новый JarFile для чтения из указанного файла name. JarFile будет проверен, если он подписан.

Параметры:: name - имя файла jar, который нужно открыть для чтения
Исключения:: IOException - если произошла ошибка ввода-вывода; SecurityException - если доступ к файлу запрещен SecurityManager

JarFile

public JarFile(String name,
               boolean verify)
        throws IOException

Создает новый JarFile для чтения из указанного файла name.

Параметры:: name - имя файла jar, который нужно открыть для чтения; verify - нужно ли проверять файл jar, если он подписан.
Исключения:: IOException - если произошла ошибка ввода-вывода; SecurityException - если доступ к файлу запрещен SecurityManager

JarFile

public JarFile(File file)
        throws IOException

Создает новый JarFile для чтения из указанного объекта File. JarFile будет проверен, если он подписан.

Параметры:: file - файл jar, который нужно открыть для чтения
Исключения:: IOException - если произошла ошибка ввода-вывода; SecurityException - если доступ к файлу запрещен SecurityManager

JarFile

public JarFile(File file,
               boolean verify)
        throws IOException

Создает новый JarFile для чтения из указанного объекта File.

Параметры:: file - файл jar, который нужно открыть для чтения; verify - нужно ли проверять файл jar, если он подписан.
Исключения:: IOException - если произошла ошибка ввода-вывода; SecurityException - если доступ к файлу запрещен SecurityManager.

JarFile

public JarFile(File file,
               boolean verify,
               int mode)
        throws IOException

Создает новый JarFile для чтения из указанного объекта File в указанном режиме. Аргумент режима должен быть либо OPEN_READ либо OPEN_READ | OPEN_DELETE.

Параметры:: file - архив JAR, который нужно открыть для чтения; verify - требуется ли проверка подписи архива JAR.; mode - режим открытия файла
Исключения:: IOException - если произошла ошибка ввода-вывода; IllegalArgumentException - если аргумент mode некорректен; SecurityException - если доступ к файлу запрещён SecurityManager
С тех пор:: 1.3

Методы

getManifest

public Manifest getManifest()
                     throws IOException

Возвращает манифест архива JAR или null, если его нет.

Возвращает:: манифест архива JAR или null, если его нет
Исключения:: IllegalStateException - может быть выброшено, если архив JAR был закрыт; IOException - если произошла ошибка ввода-вывода

getJarEntry

public JarEntry getJarEntry(String name)

Возвращает JarEntry для заданного имени записи или null, если не найдено.

Параметры:: name - имя записи в архиве JAR
Возвращает:: запись JarEntry для данного имени записи или null, если не найдено.
Исключения:: IllegalStateException - может быть выброшено, если архив JAR был закрыт
См. также:: JarEntry

getEntry

public ZipEntry getEntry(String name)

Возвращает ZipEntry для заданного имени записи или null, если не найдено.

Переопределяет:: getEntry в классе ZipFile
Параметры:: name - имя записи в архиве JAR
Возвращает:: запись ZipEntry для заданного имени записи или null, если не найдено
Исключения:: IllegalStateException - может быть выброшено, если архив JAR был закрыт
См. также:: ZipEntry

entries

public Enumeration<JarEntry> entries()

Возвращает перечисление записей ZIP-архива.

Переопределяет:: entries в классе ZipFile
Возвращает:: перечисление записей ZIP-файла

stream

public Stream<JarEntry> stream()

Описание скопировано из класса: ZipFile

Возвращает упорядоченный Stream по записям ZIP-файла. Записи появляются в Stream порядке их появления в центральном каталоге ZIP-файла.

Переопределяет:: stream в классе ZipFile
Возвращает:: упорядоченный Stream записей в этом ZIP-архиве

getInputStream

public InputStream getInputStream(ZipEntry ze)
                           throws IOException

Возвращает поток ввода для чтения содержимого указанной записи zip-файла.

Переопределяет:: getInputStream в классе ZipFile
Параметры:: ze - запись zip-файла
Возвращает:: поток ввода для чтения содержимого указанной записи zip-файла
Исключения:: ZipException - если произошла ошибка формата zip-файла; IOException - если произошла ошибка ввода-вывода; SecurityException - если какая-либо из записей архива JAR имеет неверную подпись.; IllegalStateException - может быть выброшено, если архив JAR был закрыт

© 1993, 2020, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.