Spec-Zone.ru › OpenJDK 21

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

Методы, объявленные в классе 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 - если имя записи длиннее 0xFFFF байт

ZipEntry

public ZipEntry(ZipEntry e)
Создает новую запись ZIP с полями, взятыми из указанной записи ZIP.
Параметры:
e - Объект ZipEntry
Исключения:
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()
  • getLastModifiedTime()

getTime

public long getTime()
Возвращает время последнего изменения записи.

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

Возвращает:
Время последнего изменения записи в миллисекундах с начала эпохи или -1, если не указано
См. также:
  • setTime(long)
  • setLastModifiedTime(FileTime)

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 - Время последнего изменения записи в локальном времени
С:
9
См. также:
  • getTimeLocal()

getTimeLocal

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

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

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

Возвращает:
Время последнего изменения записи в локальном времени
С:
9
См. также:
  • setTimeLocal(LocalDateTime)

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

getLastModifiedTime

public FileTime getLastModifiedTime()
Возвращает время последней модификации записи.

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

Возвращает:
Время последней модификации записи, null, если не указано
Since:
1.8
См. также:
  • setLastModifiedTime(FileTime)

setLastAccessTime

public ZipEntry setLastAccessTime(FileTime time)
Устанавливает время последнего доступа к записи.

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

Параметры:
time - Время последнего доступа к записи
Возвращает:
Эта запись ZIP
Исключения:
NullPointerException - если time равно null
Since:
1.8
См. также:
  • getLastAccessTime()

getLastAccessTime

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

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

Возвращает:
Время последнего доступа к записи, null, если не указано
Since:
1.8
См. также:
  • setLastAccessTime(FileTime)

setCreationTime

public ZipEntry setCreationTime(FileTime time)
Устанавливает время создания записи.

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

Параметры:
time - Время создания записи
Возвращает:
Эта запись ZIP
Исключения:
NullPointerException - если time равно null
Since:
1.8
См. также:
  • getCreationTime()

getCreationTime

public FileTime getCreationTime()
Возвращает время создания записи.

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

Возвращает:
время создания записи, null, если не указано
Since:
1.8
См. также:
  • setCreationTime(FileTime)

setSize

public void setSize(long size)
Устанавливает размер данных записи без сжатия.
Параметры:
size - размер без сжатия в байтах
Исключения:
IllegalArgumentException - если указанный размер меньше 0, больше 0xFFFFFFFF, когда формат ZIP64 не поддерживается, или меньше 0, когда ZIP64 поддерживается
См. также:
  • getSize()

getSize

public long getSize()
Возвращает размер данных записи без сжатия.
Возвращает:
размер записи без сжатия, или -1, если неизвестен
См. также:
  • setSize(long)

getCompressedSize

public long getCompressedSize()
Возвращает размер сжатых данных записи.

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

Возвращает:
размер сжатых данных записи, или -1, если неизвестен
См. также:
  • setCompressedSize(long)

setCompressedSize

public void setCompressedSize(long csize)
Устанавливает размер сжатых данных записи.
Параметры:
csize - сжатый размер для установки
См. также:
  • getCompressedSize()

setCrc

public void setCrc(long crc)
Устанавливает контрольную сумму CRC-32 несжатых данных записи.
Параметры:
crc - значение CRC-32
Исключения:
IllegalArgumentException - если указанное значение CRC-32 меньше 0 или больше 0xFFFFFFFF
См. также:
  • getCrc()

getCrc

public long getCrc()
Возвращает контрольную сумму CRC-32 несжатых данных записи.
Возвращает:
контрольная сумма CRC-32 несжатых данных записи, или -1, если неизвестна
См. также:
  • setCrc(long)

setMethod

public void setMethod(int method)
Устанавливает метод сжатия для записи.
Параметры:
method - метод сжатия, либо STORED, либо DEFLATED
Исключения:
IllegalArgumentException - если указанный метод сжатия некорректен
См. также:
  • getMethod()

getMethod

public int getMethod()
Возвращает метод сжатия записи.
Возвращает:
метод сжатия записи, или -1, если не указан
См. также:
  • setMethod(int)

setExtra

public void setExtra(byte[] extra)
Устанавливает дополнительные данные поля для записи.

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

Параметры:
extra - данные байтов дополнительного поля
Исключения:
IllegalArgumentException - если длина указанных данных дополнительного поля превышает 0xFFFF байт
См. также:
  • getExtra()

getExtra

public byte[] getExtra()
Возвращает дополнительные данные поля записи.
Возвращает:
дополнительные данные поля записи, или null, если нет
См. также:
  • setExtra(byte[])

setComment

public void setComment(String comment)
Устанавливает необязательную строку комментария для записи.

Комментарии записей ZIP имеют максимальную длину 0xffff. Если длина указанной строки комментария больше 0xFFFF байт после кодирования, выводятся только первые 0xFFFF байт в запись файла ZIP.

Параметры:
comment - строка комментария
См. также:
  • getComment()

getComment

public String getComment()
Возвращает строку комментария для записи.
Возвращает:
строку комментария для записи, или null, если нет
См. также:
  • setComment(String)

isDirectory

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

toString

public String toString()
Возвращает строковое представление записи ZIP.
Overrides:
toString в классе Object
Возвращает:
строковое представление объекта.

hashCode

public int hashCode()
Возвращает значение хэш-кода для этой записи.
Overrides:
hashCode в классе Object
Возвращает:
значение хэш-кода для этого объекта.
См. также:
  • Object.equals(java.lang.Object)
  • System.identityHashCode(java.lang.Object)

clone

public Object clone()
Возвращает копию этой записи.
Overrides:
clone в классе Object
Возвращает:
клонированный экземпляр.
См. также:
  • Cloneable

© 1993, 2023, 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/21/docs/api/java.base/java/util/zip/ZipEntry.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API