Класс ZipEntry

Все реализованные интерфейсы:
Cloneable
Непосредственные известные подклассы:
JarEntry
public class ZipEntry
extends Object
implements Cloneable

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

С:
1.1

Поля

Модификатор и тип Поле Описание
static int CENATT
static int CENATX
static int CENCOM
static int CENCRC
static int CENDSK
static int CENEXT
static int CENFLG
static int CENHDR
static int CENHOW
static int CENLEN
static int CENNAM
static int CENOFF
static long CENSIG
static int CENSIZ
static int CENTIM
static int CENVEM
static int CENVER
static int DEFLATED

Метод сжатия для сжатых (сжатых с помощью алгоритма deflating) записей.
static int ENDCOM
static int ENDHDR
static int ENDOFF
static long ENDSIG
static int ENDSIZ
static int ENDSUB
static int ENDTOT
static int EXTCRC
static int EXTHDR
static int EXTLEN
static long EXTSIG
static int EXTSIZ
static int LOCCRC
static int LOCEXT
static int LOCFLG
static int LOCHDR
static int LOCHOW
static int LOCLEN
static int LOCNAM
static long LOCSIG
static int LOCSIZ
static int LOCTIM
static int LOCVER
static 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

public static final long LOCSIG
См. также:
Значения константных полей

EXTSIG

public static final long EXTSIG
См. также:
Значения константных полей

CENSIG

public static final long CENSIG
См. также:
Значения константных полей

ENDSIG

public static final long ENDSIG
См. также:
Значения константных полей

LOCHDR

public static final int LOCHDR
См. также:
Значения константных полей

EXTHDR

public static final int EXTHDR
См. также:
Значения константных полей

CENHDR

public static final int CENHDR
См. также:
Значения константных полей

ENDHDR

public static final int ENDHDR
См. также:
Значения константных полей

LOCVER

public static final int LOCVER
См. также:
Значения константных полей

LOCFLG

public static final int LOCFLG
См. также:
Значения константных полей

LOCHOW

public static final int LOCHOW
См. также:
Значения константных полей

LOCTIM

public static final int LOCTIM
См. также:
Значения константных полей

LOCCRC

public static final int LOCCRC
См. также:
Значения константных полей

LOCSIZ

public static final int LOCSIZ
См. также:
Значения константных полей

LOCLEN

public static final int LOCLEN
См. также:
Значения константных полей

LOCNAM

public static final int LOCNAM
См. также:
Значения константных полей

LOCEXT

public static final int LOCEXT
См. также:
Значения константных полей

EXTCRC

public static final int EXTCRC
См. также:
Значения константных полей

EXTSIZ

public static final int EXTSIZ
См. также:
Значения константных полей

EXTLEN

public static final int EXTLEN
См. также:
Значения константных полей

CENVEM

public static final int CENVEM
См. также:
Значения константных полей

CENVER

public static final int CENVER
См. также:
Значения константных полей

CENFLG

public static final int CENFLG
См. также:
Значения константных полей

CENHOW

public static final int CENHOW
См. также:
Значения константных полей

CENTIM

public static final int CENTIM
См. также:
Значения константных полей

CENCRC

public static final int CENCRC
См. также:
Значения константных полей

CENSIZ

public static final int CENSIZ
См. также:
Значения константных полей

CENLEN

public static final int CENLEN
См. также:
Значения константных полей

CENNAM

public static final int CENNAM
См. также:
Значения константных полей

CENEXT

public static final int CENEXT
См. также:
Значения константных полей

CENCOM

public static final int CENCOM
См. также:
Значения константных полей

CENDSK

public static final int CENDSK
См. также:
Значения константных полей

CENATT

public static final int CENATT
См. также:
Значения константных полей

CENATX

public static final int CENATX
См. также:
Значения константных полей

CENOFF

public static final int CENOFF
См. также:
Значения константных полей

ENDSUB

public static final int ENDSUB
См. также:
Значения константных полей

ENDTOT

public static final int ENDTOT
См. также:
Значения константных полей

ENDSIZ

public static final int ENDSIZ
См. также:
Значения константных полей

ENDOFF

public static final int ENDOFF
См. также:
Значения константных полей

ENDCOM

public static final int ENDCOM
См. также:
Значения константных полей

Конструкторы

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

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

setLastAccessTime

public ZipEntry setLastAccessTime(FileTime time)

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

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

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

getLastAccessTime

public FileTime getLastAccessTime()

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

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

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

setCreationTime

public ZipEntry setCreationTime(FileTime time)

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

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

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

getCreationTime

public FileTime getCreationTime()

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

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

Возвращает:
время создания записи, null, если не указано
С момента:
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.

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

hashCode

public int hashCode()

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

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

clone

public Object clone()

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

Переопределяет:
clone в классе Object
Возвращает:
клонированный экземпляр.
См. также:
Cloneable

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

Spec-Zone .ru
спецификации, руководства, описания, API