Класс ZipEntry

java.lang.Object

java.util.zip.ZipEntry

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

Прямые известные подклассы:: JarEntry

public class ZipEntry extends Object implements Cloneable

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

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

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

Модификатор и тип	Поле	Описание
`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`	`DEFLATED`	Метод сжатия для сжатых (deflated) записей.
`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).
`static final int`	`STORED`	Метод сжатия для несжатых записей.

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

Конструктор	Описание
`ZipEntry(String name)`	Создает новую запись ZIP с указанным именем.
`ZipEntry(ZipEntry e)`	Создает новую запись ZIP со значениями полей, взятыми из указанной записи ZIP.

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

Модификатор и тип	Метод	Описание
`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)`	Заставляет текущий поток ожидать пробуждения, обычно вследствие уведомления или прерывания, либо до истечения заданного промежутка реального времени.

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

STORED

public static final int STORED

Метод сжатия для несжатых записей.

См. также:

DEFLATED

public static final int DEFLATED

Метод сжатия для сжатых (дефлированных) записей.

См. также:

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).

См. также:

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

ZipEntry

public ZipEntry(String name)

Создает новую запись ZIP с указанным именем.

Параметры:: name — имя записи
Исключения:: NullPointerException — если имя записи равно null; IllegalArgumentException — если общая длина имени записи и размера заголовка CEN превышает 65 535 байт.

ZipEntry

public ZipEntry(ZipEntry e)

Создает новую запись ZIP, используя поля указанной записи ZIP.

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

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

getName

public String getName()

Возвращает имя записи.

Возвращает:: имя записи

setTime

public void setTime(long time)

Задает время последнего изменения записи.

Параметры:

time — время последнего изменения записи в миллисекундах с начала эпохи

См. также:

getTime

public long getTime()

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

Если запись считывается из ZIP-файла или входного потока в формате ZIP-файла, это время последнего изменения из date and time fields записи ZIP-файла. Для преобразования даты и времени в стандартном формате MS-DOS во время эпохи используется default TimeZone.

Возвращает:

время последнего изменения записи в миллисекундах с начала эпохи или -1, если оно не задано

См. также:

setTimeLocal

public void setTimeLocal(LocalDateTime time)

Задает время последнего изменения записи как локальные дату и время.

Если запись выводится в ZIP-файл или поток вывода в формате ZIP-файла, время последнего изменения, заданное этим методом, будет сохранено в date and time fields записи ZIP-файла и закодировано в стандартном формате MS-DOS date and time format. Если заданные дата и время выходят за пределы диапазона стандартного MS-DOS date and time format, время также будет сохранено в расширенных полях временных меток записи ZIP-файла в optional extra data по времени UTC. Для преобразования локальных даты и времени во время UTC используется system default TimeZone.

LocalDateTime использует точность до наносекунд, тогда как этот класс использует точность до миллисекунд. При преобразовании избыточная точность будет отброшена, как если бы значение в наносекундах делилось на миллион целочисленно.

Параметры:

time — время последнего изменения записи в виде локальных даты и времени

Исключения:

NullPointerException — если time равно null

Начиная с:

См. также:

getTimeLocal

public LocalDateTime getTimeLocal()

Возвращает время последнего изменения записи в виде локальных даты и времени.

Если запись считывается из ZIP-файла или входного потока в формате ZIP-файла, это время последнего изменения из optional extra data записи ZIP-файла, если присутствуют расширенные поля временных меток. В противном случае время последнего изменения считывается из даты и времени записи в стандартном формате MS-DOS date and time fields.

Для преобразования времени UTC в локальные дату и время используется system default TimeZone.

Возвращает:

время последнего изменения записи в виде локальных даты и времени

Начиная с:

См. также:

setLastModifiedTime

public ZipEntry setLastModifiedTime(FileTime time)

Задает время последнего изменения записи.

При выводе в ZIP-файл или поток вывода в формате ZIP-файла время последнего изменения, заданное этим методом, будет сохранено в date and time fields записи ZIP-файла в standard MS-DOS date and time format), а расширенные поля временных меток — в optional extra data по времени UTC.

Параметры:

time — время последнего изменения записи

Возвращает:

эта запись ZIP

Исключения:

NullPointerException — если time равно null

Начиная с:

1.8

См. также:

getLastModifiedTime

public FileTime getLastModifiedTime()

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

Если запись считывается из ZIP-файла или входного потока в формате ZIP-файла, это время последнего изменения из optional extra data записи ZIP-файла, если присутствуют расширенные поля временных меток. В противном случае время последнего изменения считывается из date and time fields записи; для преобразования даты и времени в стандартном формате MS-DOS во время эпохи используется default TimeZone.

Возвращает:

время последнего изменения записи или null, если оно не задано

Начиная с:

1.8

См. также:

setLastAccessTime

public ZipEntry setLastAccessTime(FileTime time)

Задает время последнего доступа к записи.

Если оно задано, время последнего доступа будет сохранено в расширенных полях временных меток optional extra data записи при выводе в ZIP-файл или поток в формате ZIP-файла.

Параметры:

time — время последнего доступа к записи

Возвращает:

эта запись ZIP

Исключения:

NullPointerException — если time равно null

Начиная с:

1.8

См. также:

getLastAccessTime

public FileTime getLastAccessTime()

Возвращает время последнего доступа к записи.

При чтении из ZIP-файла или потока в формате ZIP-файла время последнего доступа берется из расширенных полей временных меток optional extra data записи.

Возвращает:

время последнего доступа к записи или null, если оно не задано

Начиная с:

1.8

См. также:

setCreationTime

public ZipEntry setCreationTime(FileTime time)

Задает время создания записи.

Если оно задано, время создания будет сохранено в расширенных полях временных меток optional extra data записи при выводе в ZIP-файл или поток в формате ZIP-файла.

Параметры:

time — время создания записи

Возвращает:

эта запись ZIP

Исключения:

NullPointerException — если time равно null

Начиная с:

1.8

См. также:

getCreationTime

public FileTime getCreationTime()

Возвращает время создания записи.

При чтении из ZIP-файла или потока в формате ZIP-файла время создания берется из расширенных полей временных меток optional extra data записи.

Возвращает:

время создания записи или null, если оно не задано

Начиная с:

1.8

См. также:

setSize

public void setSize(long size)

Задает несжатый размер данных записи.

Параметры:

size — несжатый размер в байтах

Исключения:

IllegalArgumentException — если указанный размер меньше 0, больше 0xFFFFFFFF при неподдерживаемом формате ZIP64 или меньше 0 при поддерживаемом ZIP64

См. также:

getSize

public long getSize()

Возвращает несжатый размер данных записи.

Возвращает:

несжатый размер данных записи или -1, если он неизвестен

См. также:

getCompressedSize

public long getCompressedSize()

Возвращает размер сжатых данных записи.

Для сохраненной записи размер сжатых данных будет равен несжатому размеру записи.

Возвращает:

размер сжатых данных записи или -1, если он неизвестен

См. также:

setCompressedSize

public void setCompressedSize(long csize)

Задает размер сжатых данных записи.

Параметры:

csize — задаваемый размер сжатых данных

См. также:

setCrc

public void setCrc(long crc)

Устанавливает контрольную сумму CRC-32 несжатых данных записи.

Параметры:

crc — значение CRC-32

Исключения:

IllegalArgumentException — если указанное значение CRC-32 меньше 0 или больше 0xFFFFFFFF

См. также:

getCrc

public long getCrc()

Возвращает контрольную сумму CRC-32 несжатых данных записи.

Возвращает:

контрольную сумму CRC-32 несжатых данных записи или -1, если она неизвестна

См. также:

setMethod

public void setMethod(int method)

Устанавливает метод сжатия для записи.

Параметры:

method — метод сжатия: STORED или DEFLATED

Исключения:

IllegalArgumentException — если указанный метод сжатия недопустим

См. также:

getMethod

public int getMethod()

Возвращает метод сжатия записи.

Возвращает:

метод сжатия записи или -1, если он не указан

См. также:

setExtra

public void setExtra(byte[] extra)

Устанавливает дополнительные данные необязательного поля записи.

Вызов этого метода может изменить время последнего изменения, время последнего доступа и время создания записи, если данные поля extra содержат расширяемые поля временных меток, такие как NTFS tag 0x0001 или Info-ZIP Extended Timestamp, согласно спецификации примечания Info-ZIP Application Note 970311.

Параметры:

extra — байты дополнительных данных поля

Исключения:

IllegalArgumentException — если суммарная длина указанных дополнительных данных поля, имени записи, комментария записи и размера заголовка CEN превышает 65 535 байт.

См. также:

getExtra

public byte[] getExtra()

Возвращает дополнительные данные поля записи.

Возвращает:

дополнительные данные поля записи или null, если их нет

См. также:

setComment

public void setComment(String comment)

Устанавливает необязательную строку комментария для записи. Если comment является пустой строкой или null, комментария у записи не будет.

Параметры:

comment — строка комментария; пустая строка или null, если комментарий не нужен

Исключения:

IllegalArgumentException — если суммарная длина указанного комментария записи, имени записи, дополнительных данных поля и размера заголовка CEN превышает 65 535 байт.

См. также:

getComment

public String getComment()

Возвращает строку комментария записи.

Возвращает:

строку комментария записи или null, если комментария нет

См. также:

isDirectory

public boolean isDirectory()

Возвращает true, если эта запись является каталогом. Запись считается каталогом, если её имя заканчивается символом «/».

Возвращает:: true, если эта запись является каталогом

toString

public String toString()

Возвращает строковое представление записи ZIP.

Переопределяет:: toString в классе Object
Возвращает:: строковое представление объекта

hashCode

public int hashCode()

Возвращает значение хеш-кода этой записи.

Переопределяет:

hashCode в классе Object

Возвращает:

значение хеш-кода этого объекта

См. также:

clone

public Object clone()

Возвращает копию этой записи.

Переопределяет:

clone в классе Object

Возвращает:

копию этого экземпляра.

См. также:

© 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.