Класс 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

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

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)

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

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

Параметры:

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 к приложению 970311.

Параметры:

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

Вызывает исключение:

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

См. также:

getExtra

public byte[] getExtra()

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

Возвращает:

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

См. также:

setComment

public void setComment(String comment)

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

Параметры:

comment — строка комментария

Вызывает исключение:

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.
https://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/util/zip/ZipEntry.html