Класс Deflater

public static final int DEFLATED

Метод сжатия для алгоритма deflate (единственный поддерживаемый в настоящее время).

public static final int NO_COMPRESSION

Уровень сжатия для отсутствия сжатия.

public static final int BEST_SPEED

Уровень сжатия для самого быстрого сжатия.

public static final int BEST_COMPRESSION

Уровень сжатия для наилучшего сжатия.

public static final int DEFAULT_COMPRESSION

Уровень сжатия по умолчанию.

public static final int FILTERED

Стратегия сжатия, наилучшим образом используемая для данных, состоящих в основном из небольших значений с несколько случайным распределением. Принудительно используется больше кодирования Хаффмана и меньше сопоставления строк.

public static final int HUFFMAN_ONLY

Стратегия сжатия только с кодированием Хаффмана.

public static final int DEFAULT_STRATEGY

Стратегия сжатия по умолчанию.

public static final int NO_FLUSH

Режим сброса сжатия, используемый для достижения наилучшего результата сжатия.

public static final int SYNC_FLUSH

Режим сброса сжатия, используемый для вывода всех ожидаемых результатов; может ухудшить сжатие для некоторых алгоритмов сжатия.

public static final int FULL_FLUSH

Режим сброса сжатия, используемый для вывода всех ожидаемых результатов и сброса сжатия. Чрезмерное использование этого режима может серьезно ухудшить сжатие.

public Deflater(int level, boolean nowrap)

Создает новый компрессор, используя указанный уровень сжатия. Если 'nowrap' имеет значение true, то заголовки и поля контрольной суммы ZLIB не будут использоваться, чтобы поддерживать формат сжатия, используемый как в GZIP, так и в PKZIP.

public Deflater(int level)

Создает новый компрессор, используя указанный уровень сжатия. Сжатые данные будут генерироваться в формате ZLIB.

public Deflater()

Создает новый компрессор с уровнем сжатия по умолчанию. Сжатые данные будут генерироваться в формате ZLIB.

public void setInput(byte[] input, int off, int len)

Устанавливает входные данные для сжатия.

Один из методов setInput() должен быть вызван всякий раз, когда needsInput() возвращает true, указывая, что требуются дополнительные входные данные.

public void setInput(byte[] input)

Устанавливает входные данные для сжатия.

Один из методов setInput() должен быть вызван всякий раз, когда needsInput() возвращает true, указывая, что требуются дополнительные входные данные.

public void setInput(ByteBuffer input)

Устанавливает входные данные для сжатия.

Один из методов setInput() должен быть вызван всякий раз, когда needsInput() возвращает true, указывая, что требуются дополнительные входные данные.

Позиция заданного буфера будет перемещаться по мере выполнения операций сжатия deflate, до границы буфера. Входной буфер может быть изменён (пополнен) между операциями сжатия; это эквивалентно созданию нового буфера и установке его с помощью этого метода.

Изменение содержимого, позиции или границы входного буфера во время выполнения операции deflate приведёт к неопределённому поведению, которое может включать неправильные результаты работы или сбои в работе.

public void setDictionary(byte[] dictionary, int off, int len)

Устанавливает предварительно заданный словарь для сжатия. Предварительно заданный словарь используется, когда буфер истории может быть предопределён. Когда данные позже распаковываются с помощью Inflater.inflate(), Inflater.getAdler() можно вызвать для получения значения Adler-32 словаря, необходимого для распаковки.

public void setDictionary(byte[] dictionary)

Устанавливает предварительно заданный словарь для сжатия. Предварительно заданный словарь используется, когда буфер истории может быть предопределён. Когда данные позже распаковываются с помощью Inflater.inflate(), Inflater.getAdler() можно вызвать для получения значения Adler-32 словаря, необходимого для распаковки.

public void setDictionary(ByteBuffer dictionary)

Устанавливает предварительно заданный словарь для сжатия. Предварительно заданный словарь используется, когда буфер истории может быть предопределён. Когда данные позже распаковываются с помощью Inflater.inflate(), Inflater.getAdler() можно вызвать для получения значения Adler-32 словаря, необходимого для распаковки.

Байты в данном буфере байтов будут полностью использованы этим методом. По завершении, его позиция будет равна его пределу.

public void setStrategy(int strategy)

Устанавливает стратегию сжатия до указанного значения.

Если стратегия сжатия изменяется, следующий вызов deflate будет сжимать доступные входные данные до сих пор со старой стратегией (и может быть сброшен); новая стратегия вступит в силу только после этого вызова.

public void setLevel(int level)

Устанавливает уровень сжатия до указанного значения.

Если уровень сжатия изменён, следующее вызов deflate будет сжимать доступный на данный момент ввод с использованием старого уровня (и, возможно, будет выполнен сброс); новый уровень будет действовать только после этого вызова.

public boolean needsInput()

Возвращает true, если в буфере ввода нет данных. Это можно использовать, чтобы определить, нужно ли вызвать один из setInput() методов, чтобы предоставить дополнительный ввод.

public void finish()

При вызове указывает, что сжатие должно завершиться текущим содержимым буфера ввода.

public boolean finished()

Возвращает true, если достигнут конец выходного потока сжатых данных.

public int deflate(byte[] output, int off, int len)

Сжимает данные ввода и заполняет указанный буфер сжатыми данными. Возвращает фактическое количество байтов сжатых данных. Значение 0 указывает, что следует вызвать needsInput, чтобы определить, требуется ли дополнительный ввод данных.

Этот метод использует NO_FLUSH в качестве режима сброса сжатия. Вызов этого метода в форме deflater.deflate(b, off, len) даёт тот же результат, что и вызов deflater.deflate(b, off, len, Deflater.NO_FLUSH).

public int deflate(byte[] output)

Сжимает данные ввода и заполняет указанный буфер сжатыми данными. Возвращает фактическое количество байтов сжатых данных. Значение 0 указывает, что следует вызвать needsInput, чтобы определить, требуется ли дополнительный ввод данных.

Этот метод использует NO_FLUSH в качестве режима сброса сжатия. Вызов этого метода в форме deflater.deflate(b) даёт тот же результат, что и вызов deflater.deflate(b, 0, b.length, Deflater.NO_FLUSH).

public int deflate(ByteBuffer output)

Сжимает данные ввода и заполняет указанный буфер сжатыми данными. Возвращает фактическое количество байтов сжатых данных. Значение 0 указывает, что следует вызвать needsInput, чтобы определить, требуется ли дополнительный ввод данных.

Этот метод использует NO_FLUSH в качестве режима сброса сжатия. Вызов этого метода в форме deflater.deflate(output) даёт тот же результат, что и вызов deflater.deflate(output, Deflater.NO_FLUSH).

public int deflate(byte[] output, int off, int len, int flush)

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

Режим сброса сжатия — один из следующих трёх режимов:

• NO_FLUSH: позволяет дефлатору решить, сколько данных накопить перед выводом, чтобы достичь наилучшего сжатия (должен использоваться в стандартных сценариях). Значение 0 в этом режиме сброса указывает, что следует вызвать needsInput(), чтобы определить, требуется ли дополнительный ввод данных.
• SYNC_FLUSH: все ожидающие данные вывода в дефлаторе сбрасываются в указанный буфер вывода, чтобы декомпрессор, работающий со сжатыми данными, мог получить все доступные на данный момент данные ввода (в частности, needsInput() возвращает true после этого вызова, если предоставлено достаточно места в буфере). Сброс с SYNC_FLUSH может ухудшить сжатие для некоторых алгоритмов сжатия, поэтому его следует использовать только при необходимости.
• FULL_FLUSH: все ожидающие данные сбрасываются, как и при SYNC_FLUSH. Состояние сжатия сбрасывается, чтобы декомпрессор, обрабатывающий сжатые выходные данные, мог перезапуститься с этой точки, если предыдущие сжатые данные были повреждены или требуется произвольный доступ. Использование FULL_FLUSH слишком часто может серьёзно ухудшить сжатие.

В случае FULL_FLUSH или SYNC_FLUSH, если возвращаемое значение равно len, доступного места в буфере вывода b, этот метод следует вызвать снова с тем же параметром flush и большим объёмом места в буфере. Убедитесь, что len больше 6, чтобы избежать многократного вывода маркера сброса (5 байт) в буфер вывода каждый раз при вызове этого метода.

Если метод setInput(ByteBuffer) был вызван для предоставления буфера для ввода, позиция буфера ввода будет продвинута на количество байтов, потреблённых этим операцией.

public int deflate(ByteBuffer output, int flush)

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

Режим сброса сжатия — один из следующих трёх режимов:

• NO_FLUSH: позволяет дефлатору решить, сколько данных накопить перед выводом, чтобы достичь наилучшего сжатия (должен использоваться в стандартных сценариях). Значение 0 в этом режиме сброса указывает, что следует вызвать needsInput(), чтобы определить, требуется ли дополнительный ввод данных.
• SYNC_FLUSH: все ожидающие данные вывода в дефлаторе сбрасываются в указанный буфер вывода, чтобы декомпрессор, работающий со сжатыми данными, мог получить все доступные на данный момент данные ввода (в частности, needsInput() возвращает true после этого вызова, если предоставлено достаточно места в буфере). Сброс с SYNC_FLUSH может ухудшить сжатие для некоторых алгоритмов сжатия, поэтому его следует использовать только при необходимости.
• FULL_FLUSH: все ожидающие данные сбрасываются, как и при SYNC_FLUSH. Состояние сжатия сбрасывается, чтобы декомпрессор, обрабатывающий сжатые выходные данные, мог перезапуститься с этой точки, если предыдущие сжатые данные были повреждены или требуется произвольный доступ. Использование FULL_FLUSH слишком часто может серьёзно ухудшить сжатие.

В случае FULL_FLUSH или SYNC_FLUSH, если возвращаемое значение равно оставшемуся месту буфера, этот метод следует вызвать снова с тем же параметром flush и большим объёмом места в буфере. Убедитесь, что буфер имеет по крайней мере 6 байт свободного места, чтобы избежать многократного вывода маркера сброса (5 байт) в буфер вывода каждый раз при вызове этого метода.

При успехе позиция данного output байтового буфера будет продвинута на количество байт, произведённых операцией, что равно возвращаемому значению этого метода.

Если метод setInput(ByteBuffer) был вызван для предоставления буфера для ввода, позиция буфера ввода будет продвинута на количество байтов, потреблённых этой операцией.

public int getAdler()

Возвращает значение ADLER-32 нескомпрессированных данных.

public int getTotalIn()

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

Так как количество байтов может быть больше Integer.MAX_VALUE, метод getBytesRead() теперь предпочтительнее для получения этой информации.

public long getBytesRead()

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

public int getTotalOut()

Возвращает общее количество сжатых байтов, выведенных до настоящего момента.

Поскольку количество байтов может быть больше, чем Integer.MAX_VALUE, метод getBytesWritten() теперь является предпочтительным способом получения этой информации.

public long getBytesWritten()

Возвращает общее количество сжатых байтов, выведенных до настоящего момента.

public void reset()

Сбрасывает deflater, чтобы можно было обработать новый набор входных данных. Сохраняет текущие настройки уровня сжатия и стратегии.

public void end()

Закрывает компрессор и отбрасывает любые необработанные входные данные. Этот метод должен вызываться, когда компрессор больше не используется. После вызова этого метода поведение объекта Deflater не определено.