Класс 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`	Метод сжатия для сжатых (сжатых) записей.
`static final int`	`ENDCOM`	Смещение поля длины комментария файла архива в заголовке конца центрального каталога (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.

Методы, объявленные в классе java.lang.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 (CEN Header size) превышает 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 использует точность в наносекундах, тогда как этот класс использует точность в миллисекундах. Преобразование будет обрезать любые избыточные сведения о точности так, как если бы значение в наносекундах подвергалось целочисленному делению на один миллион.

Parameters:

time - Время последнего изменения записи в локальном часовом поясе

Throws:

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

Since:

See Also:

getTimeLocal

public LocalDateTime getTimeLocal()

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

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

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

Returns:

Время последнего изменения записи в локальном часовом поясе

Since:

See Also:

setLastModifiedTime

public ZipEntry setLastModifiedTime(FileTime time)

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

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

Parameters:

time - Время последнего изменения записи

Returns:

Эта запись ZIP

Throws:

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

Since:

1.8

See Also:

getLastModifiedTime

public FileTime getLastModifiedTime()

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

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

Returns:

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

Since:

1.8

See Also:

setLastAccessTime

public ZipEntry setLastAccessTime(FileTime time)

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

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

Parameters:

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

Returns:

Эта запись ZIP

Throws:

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

Since:

1.8

See Also:

getLastAccessTime

public FileTime getLastAccessTime()

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

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

Returns:

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

Since:

1.8

See Also:

setCreationTime

public ZipEntry setCreationTime(FileTime time)

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

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

Parameters:

time - Время создания записи

Returns:

Эта запись ZIP

Throws:

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

Since:

1.8

See Also:

getCreationTime

public FileTime getCreationTime()

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

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

Returns:

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

Since:

1.8

See Also:

setSize

public void setSize(long size)

Устанавливает размер данных записи без сжатия.

Parameters:

size - размер без сжатия в байтах

Throws:

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

See Also:

getSize

public long getSize()

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

Returns:

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

See Also:

getCompressedSize

public long getCompressedSize()

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

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

Returns:

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

See Also:

setCompressedSize

public void setCompressedSize(long csize)

Устанавливает размер сжатых данных записи.

Parameters:

csize - размер сжатых данных

See Also:

setCrc

public void setCrc(long crc)

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

Parameters:

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

Throws:

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

See Also:

getCrc

public long getCrc()

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

Returns:

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

See Also:

setMethod

public void setMethod(int method)

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

Parameters:

method - метод сжатия, либо STORED, либо DEFLATED

Throws:

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

See Also:

getMethod

public int getMethod()

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

Returns:

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

See Also:

setExtra

public void setExtra(byte[] extra)

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

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

Parameters:

extra - Байты дополнительных данных поля

Throws:

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

See Also:

getExtra

public byte[] getExtra()

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

Returns:

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

See Also:

setComment

public void setComment(String comment)

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

Parameters:

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

Throws:

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

See Also:

getComment

public String getComment()

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

Returns:

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

See Also:

isDirectory

public boolean isDirectory()

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

Returns:: true, если это запись каталога

toString

public String toString()

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

Overrides:: toString в классе Object
Returns:: строковое представление объекта

hashCode

public int hashCode()

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

Overrides:

hashCode в классе Object

Returns:

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

See Also:

clone

public Object clone()

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

Overrides:

clone в классе Object

Returns:

клонированный экземпляр.

See Also:

© 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://download.java.net/java/early_access/jdk24/docs/api/java.base/java/util/zip/ZipEntry.html