Spec-Zone.ru › OpenJDK 17

Класс 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
Метод сжатия для сжатых (с использованием алгоритма DEFLATE) записей.
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 - Объект записи 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()
  • 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 Application Note 970311.

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

getExtra

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

setComment

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

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

Параметры:
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, 2021, 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/17/docs/api/java.base/java/util/zip/ZipEntry.html

Spec-Zone.ru

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