Класс JarEntry

java.lang.Object

java.util.zip.ZipEntry

java.util.jar.JarEntry

Все реализуемые интерфейсы:: Cloneable

public class JarEntry extends ZipEntry

Этот класс используется для представления записи JAR-файла.

Начиная с версии:: 1.2

Краткое описание полей

Модификатор и тип	Поле	Описание
`static final int`	`CENATT`	Смещение поля внутренних атрибутов файла заголовка центрального каталога (CEN).
`static final int`	`CENATX`	Смещение поля внешних атрибутов файла заголовка центрального каталога (CEN).
`static final int`	`CENCOM`	Смещение поля длины комментария заголовка центрального каталога (CEN).
`static final int`	`CENCRC`	Смещение поля значения CRC-32 несжатого файла заголовка центрального каталога (CEN).
`static final int`	`CENDSK`	Смещение поля начального номера диска заголовка центрального каталога (CEN).
`static final int`	`CENEXT`	Смещение поля длины дополнительных данных заголовка центрального каталога (CEN).
`static final int`	`CENFLG`	Смещение поля флагов шифрования и дешифрования заголовка центрального каталога (CEN).
`static final int`	`CENHDR`	Размер заголовка центрального каталога (CEN) в байтах (включая сигнатуру).
`static final int`	`CENHOW`	Смещение поля метода сжатия заголовка центрального каталога (CEN).
`static final int`	`CENLEN`	Смещение поля несжатого размера заголовка центрального каталога (CEN).
`static final int`	`CENNAM`	Смещение поля длины имени файла заголовка центрального каталога (CEN).
`static final int`	`CENOFF`	Смещение поля смещения заголовка LOC заголовка центрального каталога (CEN).
`static final long`	`CENSIG`	Сигнатура заголовка центрального каталога (CEN).
`static final int`	`CENSIZ`	Смещение поля сжатого размера заголовка центрального каталога (CEN).
`static final int`	`CENTIM`	Смещение поля времени изменения заголовка центрального каталога (CEN).
`static final int`	`CENVEM`	Смещение поля версии, создавшей заголовок центрального каталога (CEN).
`static final int`	`CENVER`	Смещение поля версии, необходимой для извлечения данных из заголовка центрального каталога (CEN).
`static final int`	`ENDCOM`	Смещение поля длины комментария ZIP-файла заголовка конца центрального каталога (END).
`static final int`	`ENDHDR`	Размер заголовка конца центрального каталога (END) в байтах (включая сигнатуру).
`static final int`	`ENDOFF`	Смещение поля смещения первого заголовка CEN в заголовке конца центрального каталога (END).
`static final long`	`ENDSIG`	Сигнатура заголовка конца центрального каталога (END).
`static final int`	`ENDSIZ`	Смещение поля размера центрального каталога в байтах в заголовке конца центрального каталога (END).
`static final int`	`ENDSUB`	Смещение поля количества записей на этом диске в заголовке конца центрального каталога (END).
`static final int`	`ENDTOT`	Смещение поля общего количества записей в заголовке конца центрального каталога (END).
`static final int`	`EXTCRC`	Смещение поля значения CRC-32 несжатого файла заголовка локальных дополнительных данных (EXT).
`static final int`	`EXTHDR`	Размер заголовка локальных дополнительных данных (EXT) в байтах (включая сигнатуру).
`static final int`	`EXTLEN`	Смещение поля несжатого размера заголовка локальных дополнительных данных (EXT).
`static final long`	`EXTSIG`	Сигнатура заголовка локальных дополнительных данных (EXT).
`static final int`	`EXTSIZ`	Смещение поля сжатого размера заголовка локальных дополнительных данных (EXT).
`static final int`	`LOCCRC`	Смещение поля значения CRC-32 несжатого файла заголовка локального файла (LOC).
`static final int`	`LOCEXT`	Смещение поля длины дополнительных данных заголовка локального файла (LOC).
`static final int`	`LOCFLG`	Смещение поля флага общего назначения заголовка локального файла (LOC).
`static final int`	`LOCHDR`	Размер заголовка локального файла (LOC) в байтах (включая сигнатуру).
`static final int`	`LOCHOW`	Смещение поля метода сжатия заголовка локального файла (LOC).
`static final int`	`LOCLEN`	Смещение поля несжатого размера заголовка локального файла (LOC).
`static final int`	`LOCNAM`	Смещение поля длины имени файла заголовка локального файла (LOC).
`static final long`	`LOCSIG`	Сигнатура заголовка локального файла (LOC).
`static final int`	`LOCSIZ`	Смещение поля сжатого размера заголовка локального файла (LOC).
`static final int`	`LOCTIM`	Смещение поля времени изменения заголовка локального файла (LOC).
`static final int`	`LOCVER`	Смещение поля версии, необходимой для извлечения данных из заголовка локального файла (LOC).

Поля, объявленные в классе ZipEntry

DEFLATED, STORED

Модификатор и тип	Поле	Описание
`static final int`	`DEFLATED`	Метод сжатия для сжатых (дефлированных) записей.
`static final int`	`STORED`	Метод сжатия для несжатых записей.

Краткое описание конструкторов

Конструктор	Описание
`JarEntry(String name)`	Создает новый `JarEntry` для указанного имени записи JAR-файла.
`JarEntry(JarEntry je)`	Создает новый `JarEntry` с полями, взятыми из указанного объекта `JarEntry`.
`JarEntry(ZipEntry ze)`	Создает новый `JarEntry` с полями, взятыми из указанного объекта `ZipEntry`.

Краткое описание методов

Модификатор и тип	Метод	Описание
`Attributes`	`getAttributes()`	Возвращает `Manifest` `Attributes` для этой записи или `null`, если его нет.
`Certificate[]`	`getCertificates()`	Возвращает объекты `Certificate` для этой записи или `null`, если их нет.
`CodeSigner[]`	`getCodeSigners()`	Возвращает объекты `CodeSigner` для этой записи или `null`, если их нет.
`String`	`getRealName()`	Возвращает настоящее имя этого `JarEntry`.

Методы, объявленные в классе ZipEntry

clone, getComment, getCompressedSize, getCrc, getCreationTime, getExtra, getLastAccessTime, getLastModifiedTime, getMethod, getName, getSize, getTime, getTimeLocal, hashCode, isDirectory, setComment, setCompressedSize, setCrc, setCreationTime, setExtra, setLastAccessTime, setLastModifiedTime, setMethod, setSize, setTime, setTimeLocal, toString

Модификатор и тип	Метод	Описание
`Object`	`clone()`	Возвращает копию этой записи.
`String`	`getComment()`	Возвращает строку комментария записи.
`long`	`getCompressedSize()`	Возвращает размер сжатых данных записи.
`long`	`getCrc()`	Возвращает контрольную сумму CRC-32 несжатых данных записи.
`FileTime`	`getCreationTime()`	Возвращает время создания записи.
`byte[]`	`getExtra()`	Возвращает дополнительные данные записи.
`FileTime`	`getLastAccessTime()`	Возвращает время последнего доступа к записи.
`FileTime`	`getLastModifiedTime()`	Возвращает время последнего изменения записи.
`int`	`getMethod()`	Возвращает метод сжатия записи.
`String`	`getName()`	Возвращает имя записи.
`long`	`getSize()`	Возвращает несжатый размер данных записи.
`long`	`getTime()`	Возвращает время последнего изменения записи.
`LocalDateTime`	`getTimeLocal()`	Возвращает время последнего изменения записи в виде местных даты и времени.
`int`	`hashCode()`	Возвращает хеш-код этой записи.
`boolean`	`isDirectory()`	Возвращает true, если это запись каталога.
`void`	`setComment(String comment)`	Задает необязательную строку комментария для записи.
`void`	`setCompressedSize(long csize)`	Задает размер сжатых данных записи.
`void`	`setCrc(long crc)`	Задает контрольную сумму CRC-32 несжатых данных записи.
`ZipEntry`	`setCreationTime(FileTime time)`	Задает время создания записи.
`void`	`setExtra(byte[] extra)`	Задает необязательные дополнительные данные записи.
`ZipEntry`	`setLastAccessTime(FileTime time)`	Задает время последнего доступа к записи.
`ZipEntry`	`setLastModifiedTime(FileTime time)`	Задает время последнего изменения записи.
`void`	`setMethod(int method)`	Задает метод сжатия записи.
`void`	`setSize(long size)`	Задает несжатый размер данных записи.
`void`	`setTime(long time)`	Задает время последнего изменения записи.
`void`	`setTimeLocal(LocalDateTime time)`	Задает время последнего изменения записи в виде местных даты и времени.
`String`	`toString()`	Возвращает строковое представление ZIP-записи.

Методы, объявленные в классе Object

equals, finalize, getClass, notify, notifyAll, wait, wait, wait

Модификатор и тип	Метод	Описание
`boolean`	`equals(Object obj)`	Указывает, равен ли этот объект какому-либо другому объекту.
`protected void`	`finalize()`	Устарело, планируется удаление: этот элемент API будет удален в будущей версии. Финализация устарела и будет удалена в одном из будущих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`final void`	`wait()`	Заставляет текущий поток ожидать пробуждения, обычно вследствие уведомления или прерывания.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно вследствие уведомления или прерывания, либо до истечения заданного промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно вследствие уведомления или прерывания, либо до истечения заданного промежутка реального времени.

Подробное описание полей

LOCSIG

static final long LOCSIG

Сигнатура заголовка локального файла (LOC).

См. также:

EXTSIG

static final long EXTSIG

Сигнатура заголовка дополнительного локального блока (EXT).

См. также:

CENSIG

static final long CENSIG

Сигнатура заголовка центрального каталога (CEN).

См. также:

ENDSIG

static final long ENDSIG

Сигнатура заголовка конца центрального каталога (END).

См. также:

LOCHDR

static final int LOCHDR

Размер заголовка локального файла (LOC) в байтах (включая сигнатуру).

См. также:

EXTHDR

static final int EXTHDR

Размер заголовка дополнительного локального блока (EXT) в байтах (включая сигнатуру).

См. также:

CENHDR

static final int CENHDR

Размер заголовка центрального каталога (CEN) в байтах (включая сигнатуру).

См. также:

ENDHDR

static final int ENDHDR

Размер заголовка конца центрального каталога (END) в байтах (включая сигнатуру).

См. также:

LOCVER

static final int LOCVER

Смещение поля версии, необходимой для извлечения данных из заголовка локального файла (LOC).

См. также:

LOCFLG

static final int LOCFLG

Смещение поля флагов общего назначения в заголовке локального файла (LOC).

См. также:

LOCHOW

static final int LOCHOW

Смещение поля метода сжатия в заголовке локального файла (LOC).

См. также:

LOCTIM

static final int LOCTIM

Смещение поля времени изменения в заголовке локального файла (LOC).

См. также:

LOCCRC

static final int LOCCRC

Смещение поля значения CRC-32 несжатого файла в заголовке локального файла (LOC).

См. также:

LOCSIZ

static final int LOCSIZ

Смещение поля размера сжатого файла в заголовке локального файла (LOC).

См. также:

LOCLEN

static final int LOCLEN

Смещение поля размера несжатого файла в заголовке локального файла (LOC).

См. также:

LOCNAM

static final int LOCNAM

Смещение поля длины имени файла в заголовке локального файла (LOC).

См. также:

LOCEXT

static final int LOCEXT

Смещение поля длины дополнительного поля в заголовке локального файла (LOC).

См. также:

EXTCRC

static final int EXTCRC

Смещение поля значения CRC-32 несжатого файла в заголовке дополнительного локального блока (EXT).

См. также:

EXTSIZ

static final int EXTSIZ

Смещение поля размера сжатого файла в заголовке дополнительного локального блока (EXT).

См. также:

EXTLEN

static final int EXTLEN

Смещение поля размера несжатого файла в заголовке дополнительного локального блока (EXT).

См. также:

CENVEM

static final int CENVEM

Смещение поля версии программы, создавшей заголовок центрального каталога (CEN).

См. также:

CENVER

static final int CENVER

Смещение поля версии, необходимой для извлечения данных из заголовка центрального каталога (CEN).

См. также:

CENFLG

static final int CENFLG

Смещение поля флагов шифрования и дешифрования в заголовке центрального каталога (CEN).

См. также:

CENHOW

static final int CENHOW

Смещение поля метода сжатия в заголовке центрального каталога (CEN).

См. также:

CENTIM

static final int CENTIM

Смещение поля времени изменения в заголовке центрального каталога (CEN).

См. также:

CENCRC

static final int CENCRC

Смещение поля значения CRC-32 несжатого файла в заголовке центрального каталога (CEN).

См. также:

CENSIZ

static final int CENSIZ

Смещение поля размера сжатого файла в заголовке центрального каталога (CEN).

См. также:

CENLEN

static final int CENLEN

Смещение поля размера несжатого файла в заголовке центрального каталога (CEN).

См. также:

CENNAM

static final int CENNAM

Смещение поля длины имени файла в заголовке центрального каталога (CEN).

См. также:

CENEXT

static final int CENEXT

Смещение поля длины дополнительного поля в заголовке центрального каталога (CEN).

См. также:

CENCOM

static final int CENCOM

Смещение поля длины комментария в заголовке центрального каталога (CEN).

См. также:

CENDSK

static final int CENDSK

Смещение поля номера диска, с которого начинается запись, в заголовке центрального каталога (CEN).

См. также:

CENATT

static final int CENATT

Смещение поля внутренних атрибутов файла в заголовке центрального каталога (CEN).

См. также:

CENATX

static final int CENATX

Смещение поля внешних атрибутов файла в заголовке центрального каталога (CEN).

См. также:

CENOFF

static final int CENOFF

Смещение поля смещения заголовка LOC в заголовке центрального каталога (CEN).

См. также:

ENDSUB

static final int ENDSUB

Смещение поля числа записей на этом диске в заголовке конца центрального каталога (END).

См. также:

ENDTOT

static final int ENDTOT

Смещение поля общего числа записей в заголовке конца центрального каталога (END).

См. также:

ENDSIZ

static final int ENDSIZ

Смещение поля размера центрального каталога в байтах в заголовке конца центрального каталога (END).

См. также:

ENDOFF

static final int ENDOFF

Смещение поля смещения первого заголовка CEN в заголовке конца центрального каталога (END).

См. также:

ENDCOM

static final int ENDCOM

Смещение поля длины комментария ZIP-файла в заголовке конца центрального каталога (END).

См. также:

Подробное описание конструкторов

JarEntry

public JarEntry(String name)

Создает новый JarEntry для указанного имени записи в JAR-файле.

Параметры:: name — имя записи в JAR-файле
Исключения:: NullPointerException — если имя записи является null; IllegalArgumentException — если длина имени записи превышает 0xFFFF байт.

JarEntry

public JarEntry(ZipEntry ze)

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

Параметры:: ze — объект ZipEntry, на основе которого создается JarEntry
Исключения:: NullPointerException — если ze равно null

JarEntry

public JarEntry(JarEntry je)

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

Параметры:: je — объект JarEntry для копирования
Исключения:: NullPointerException — если je равно null

Подробное описание методов

getAttributes

public Attributes getAttributes() throws IOException

Возвращает Manifest Attributes этой записи или null, если их нет.

Возвращает:: Manifest Attributes этой записи или null, если их нет
Исключения:: IOException — если произошла ошибка ввода-вывода

getCertificates

public Certificate[] getCertificates()

Возвращает объекты Certificate для этой записи или null, если их нет. Этот метод можно вызвать только после полной проверки JarEntry, которая выполняется чтением из входного потока записи до его конца. В противном случае этот метод вернет null.

Рекомендуется использовать метод getCodeSigners(), который возвращает массив объектов CodeSigner.

Возвращенный массив сертификатов содержит все сертификаты подписантов, использованные для проверки этой записи. За каждым сертификатом подписанта следует поддерживающая его цепочка сертификатов (которая может быть пустой). Сертификат каждого подписанта и поддерживающая его цепочка сертификатов упорядочены от нижнего к верхнему уровню (то есть сначала идет сертификат подписанта, а последним — сертификат центра сертификации (корневой сертификат)).

Примечание API:: Процесс проверки не включает проверку подлинности подписантов кода или установление доверия к ним. Вызывающий код должен выполнить дополнительные проверки, например использовать CertPathValidator для проверки цепочки сертификатов каждого подписанта и определить, следует ли доверять записи, подписанной этими подписантами.
Требования к реализации:: Если результат не равен null, эта реализация возвращает новый массив при каждом вызове метода.
Возвращает:: объекты Certificate для этой записи или null, если их нет.

getCodeSigners

public CodeSigner[] getCodeSigners()

Возвращает объекты CodeSigner для этой записи или null, если их нет. Этот метод можно вызвать только после полной проверки JarEntry, которая выполняется чтением из входного потока записи до его конца. В противном случае этот метод вернет null.

Возвращенный массив содержит всех подписантов кода, подписавших эту запись.

Примечание API:: Процесс проверки не включает проверку подлинности подписантов кода или установление доверия к ним. Вызывающий код должен выполнить дополнительные проверки, например использовать CertPathValidator для проверки цепочки сертификатов каждого подписанта и определить, следует ли доверять записи, подписанной этими подписантами.
Требования к реализации:: Если результат не равен null, эта реализация возвращает новый массив при каждом вызове метода.
Возвращает:: объекты CodeSigner для этой записи или null, если их нет.
С версии:: 1.5

getRealName

public String getRealName()

Возвращает фактическое имя этого JarEntry. Если этот JarEntry является записью многоверсионного JAR-файла и JarFile настроен на его обработку, этот метод возвращает имя пути версионной записи, которую представляет JarEntry, а не имя пути базовой записи, возвращаемое методом ZipEntry.getName(). Если JarEntry не представляет версионную запись многоверсионного JarFile или JarFile не настроен на обработку многоверсионного JAR-файла, этот метод возвращает то же имя, что и метод ZipEntry.getName().

Возвращает:: фактическое имя JarEntry
С версии:: 10

© 1993, 2025, 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.