Класс ZipOutputStream

java.util.zip.ZipOutputStream

Все реализованные интерфейсы:: Closeable, Flushable, AutoCloseable

Прямые известные подклассы:: JarOutputStream

public class ZipOutputStream extends DeflaterOutputStream

Этот класс реализует фильтр выходного потока для записи файлов в формате 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`	Метод сжатия для нескомпрессированных (STORED) записей.

Поля, объявленные в классе java.util.zip.DeflaterOutputStream

buf, def

Поля, объявленные в классе java.io.FilterOutputStream

out

Краткое описание конструкторов

Конструктор	Описание
`ZipOutputStream(OutputStream out)`	Создает новый поток вывода ZIP.
`ZipOutputStream(OutputStream out, Charset charset)`	Создает новый поток вывода ZIP.

Краткое описание методов

Модификатор и тип	Метод	Описание
`void`	`close()`	Закрывает поток вывода ZIP, а также фильтруемый поток.
`void`	`closeEntry()`	Закрывает текущую запись ZIP и позиционирует поток для записи следующей записи.
`void`	`finish()`	Завершает запись содержимого потока вывода ZIP без закрытия базового потока.
`void`	`putNextEntry(ZipEntry e)`	Начинает запись новой записи файла ZIP и позиционирует поток в начало данных записи.
`void`	`setComment(String comment)`	Устанавливает комментарий к файлу ZIP.
`void`	`setLevel(int level)`	Устанавливает уровень сжатия для последующих записей, сжатых методом DEFLATED.
`void`	`setMethod(int method)`	Устанавливает метод сжатия по умолчанию для последующих записей.
`void`	`write(byte[] b, int off, int len)`	Записывает массив байтов в текущие данные записи ZIP.

Методы, объявленные в классе java.util.zip.DeflaterOutputStream

deflate, flush, write

Методы, объявленные в классе java.io.FilterOutputStream

write

Методы, объявленные в классе java.io.OutputStream

nullOutputStream

Методы, объявленные в классе java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

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

STORED

public static final int STORED

Метод сжатия для несжатых (STORED) записей.

См. также:

Значения постоянных полей

DEFLATED

public static final int DEFLATED

Метод сжатия для сжатых (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).

См. также:

Значения постоянных полей

Смещение поля сжатого размера заголовка центрального каталога (CEN)

static final int CENSIZ

Смещение поля сжатого размера заголовка центрального каталога (CEN).

См. также:

Значения постоянных полей

Смещение поля размера незаархивированного заголовка центрального каталога (CEN)

static final int CENLEN

Смещение поля размера незаархивированного заголовка центрального каталога (CEN).

См. также:

Значения постоянных полей

Смещение поля длины имени файла в заголовке центрального каталога (CEN)

static final int CENNAM

Смещение поля длины имени файла в заголовке центрального каталога (CEN).

См. также:

Значения постоянных полей

Смещение поля длины дополнительного поля заголовка центрального каталога (CEN)

static final int CENEXT

Смещение поля длины дополнительного поля заголовка центрального каталога (CEN).

См. также:

Значения постоянных полей

Смещение поля длины комментария в заголовке центрального каталога (CEN)

static final int CENCOM

Смещение поля длины комментария в заголовке центрального каталога (CEN).

См. также:

Значения постоянных полей

Смещение поля начального номера диска в заголовке центрального каталога (CEN)

static final int CENDSK

Смещение поля начального номера диска в заголовке центрального каталога (CEN).

См. также:

Значения постоянных полей

Смещение поля атрибутов внутреннего файла в заголовке центрального каталога (CEN)

static final int CENATT

Смещение поля атрибутов внутреннего файла в заголовке центрального каталога (CEN).

См. также:

Значения постоянных полей

Смещение поля атрибутов внешнего файла в заголовке центрального каталога (CEN)

static final int CENATX

Смещение поля атрибутов внешнего файла в заголовке центрального каталога (CEN).

См. также:

Значения постоянных полей

Смещение поля смещения заголовка LOC в заголовке центрального каталога (CEN)

static final int CENOFF

Смещение поля смещения заголовка LOC в заголовке центрального каталога (CEN).

См. также:

Значения постоянных полей

Смещение поля количества записей на данном диске в заголовке конца центрального каталога (END)

static final int ENDSUB

Смещение поля количества записей на данном диске в заголовке конца центрального каталога (END).

См. также:

Значения постоянных полей

Смещение поля общего количества записей в заголовке конца центрального каталога (END)

static final int ENDTOT

Смещение поля общего количества записей в заголовке конца центрального каталога (END).

См. также:

Значения постоянных полей

Смещение поля размера центрального каталога в байтах в заголовке конца центрального каталога (END)

static final int ENDSIZ

Смещение поля размера центрального каталога в байтах в заголовке конца центрального каталога (END).

См. также:

Значения постоянных полей

Смещение поля смещения первого заголовка CEN в заголовке конца центрального каталога (END)

static final int ENDOFF

Смещение поля смещения первого заголовка CEN в заголовке конца центрального каталога (END).

См. также:

Значения постоянных полей

Смещение поля длины комментария к zip-архиву в заголовке конца центрального каталога (END)

static final int ENDCOM

Смещение поля длины комментария к zip-архиву в заголовке конца центрального каталога (END).

См. также:

Значения постоянных полей

Подробное описание конструкторов

ZipOutputStream

public ZipOutputStream(OutputStream out)

Создаёт новый поток вывода ZIP.

Используется кодировка UTF-8 для кодирования имён записей и комментариев.

Параметры:: out - фактический поток вывода

ZipOutputStream

public ZipOutputStream(OutputStream out, Charset charset)

Создаёт новый поток вывода ZIP.

Параметры:: out - фактический поток вывода; charset - используемая кодировка для кодирования имён записей и комментариев
Since:: 1.7

Подробное описание методов

setComment

public void setComment(String comment)

Устанавливает комментарий к ZIP-архиву.

Параметры:: comment - строка комментария
Исключения:: IllegalArgumentException - если длина указанного комментария ZIP-архива превышает 0xFFFF байт

setMethod

public void setMethod(int method)

Устанавливает метод сжатия по умолчанию для последующих записей. По умолчанию используется DEFLATED.

Параметры:: method - метод сжатия по умолчанию
Исключения:: IllegalArgumentException - если указанный метод сжатия некорректен

setLevel

public void setLevel(int level)

Устанавливает уровень сжатия для последующих записей, сжатых с помощью DEFLATED. Значение по умолчанию - DEFAULT_COMPRESSION.

Параметры:: level - уровень сжатия (0-9)
Исключения:: IllegalArgumentException - если уровень сжатия некорректен

putNextEntry

public void putNextEntry(ZipEntry e) throws IOException

Начинает запись новой записи ZIP-архива и переводит поток к началу данных записи. Закрывает текущую запись, если она активна.

Используется метод сжатия по умолчанию, если метод сжатия не указан для записи. При записи сжатой (DEFLATED) записи, и сжатый размер не был явно задан методом ZipEntry.setCompressedSize(long), то сжатый размер будет установлен в фактический сжатый размер после разархивации.

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

Параметры:: e - запись ZIP, подлежащая записи
Исключения:: ZipException - если произошла ошибка формата ZIP; IOException - если произошла ошибка ввода-вывода

closeEntry

public void closeEntry() throws IOException

Закрывает текущую запись ZIP-архива и переводит поток в состояние готовности к записи следующей записи.

Исключения:: ZipException - если произошла ошибка формата ZIP; IOException - если произошла ошибка ввода-вывода

write

public void write(byte[] b, int off, int len) throws IOException

Записывает массив байтов в текущие данные записи ZIP-архива. Этот метод будет блокироваться, пока все байты не будут записаны.

Переопределяет:

write в классе DeflaterOutputStream

Параметры:

b - данные, подлежащие записи

off - начальный смещение в данных

len - количество записываемых байтов

Исключения:

ZipException - если произошла ошибка в формате ZIP-архива

IOException - если произошла ошибка ввода-вывода

См. также:

FilterOutputStream.write(int)

finish

public void finish() throws IOException

Завершает запись содержимого потока вывода ZIP, не закрывая при этом базовый поток. Используйте этот метод при применении нескольких фильтров последовательно к одному потоку вывода.

Переопределяет:: finish в классе DeflaterOutputStream
Исключения:: ZipException - если произошла ошибка в формате ZIP-архива; IOException - если произошла ошибка ввода-вывода

Закрыть

public void close() throws IOException

Закрывает поток вывода ZIP, а также фильтруемый поток.

Определено в:

close в интерфейсе AutoCloseable

Определено в:

close в интерфейсе Closeable

Переопределяет:

close в классе DeflaterOutputStream

Исключения:

ZipException - если произошла ошибка в файле ZIP

IOException - если произошла ошибка ввода/вывода

См. также:

© 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/ZipOutputStream.html