Интерфейс Pack200.Unpacker

Вложенный класс:: Pack200

public static interface Pack200.Unpacker

Движок распаковки преобразует упакованный поток в файл JAR. Экземпляр движка можно получить, используя Pack200.newUnpacker().

Каждый файл JAR, созданный этим движком, будет включать строку "PACK200" в качестве комментария файла zip. Это позволяет развертывателю определить, был ли архив JAR упакован и распакован.

Примечание: если не указано иное, передача null аргумента конструктору или методу в этом классе приведет к выбрасыванию NullPointerException.

Эта версия распаковщика совместима со всеми предыдущими версиями.

С:: 1.5

Поля

Модификатор и тип	Поле и описание
`static String`	`DEFLATE_HINT` Свойство, указывающее, что распаковщик должен игнорировать все передаваемые значения для DEFLATE_HINT, заменяя их заданным значением, `TRUE` или `FALSE`.
`static String`	`FALSE` Строка "false", возможное значение для определенных свойств.
`static String`	`KEEP` Строка "keep", возможное значение для определенных свойств.
`static String`	`PROGRESS` Прогресс распаковщика в процентах, периодически обновляемый распаковщиком.
`static String`	`TRUE` Строка "true", возможное значение для определенных свойств.

Методы

Модификатор и тип	Метод и описание
`default void`	`addPropertyChangeListener(PropertyChangeListener listener)` Устарело. Зависимость от `PropertyChangeListener` создает значительное препятствие для будущей модулизации платформы Java. Этот метод будет удален в будущей версии. Приложения, которым необходимо отслеживать прогресс распаковщика, могут вместо этого опросить значение свойства `PROGRESS`.
`SortedMap<String,String>`	`properties()` Получить набор свойств этого движка.
`default void`	`removePropertyChangeListener(PropertyChangeListener listener)` Устарело. Зависимость от `PropertyChangeListener` создает значительное препятствие для будущей модулизации платформы Java. Этот метод будет удален в будущей версии.
`void`	`unpack(File in, JarOutputStream out)` Прочитать архив Pack200 и записать закодированный JAR в JarOutputStream.
`void`	`unpack(InputStream in, JarOutputStream out)` Прочитать архив Pack200 и записать закодированный JAR в JarOutputStream.

Поля

KEEP

static final String KEEP

Строка "keep", возможное значение для определенных свойств.

См. также:: DEFLATE_HINT, Значения константных полей

TRUE

static final String TRUE

Строка "true", возможное значение для определенных свойств.

См. также:: DEFLATE_HINT, Значения константных полей

FALSE

static final String FALSE

Строка "false", возможное значение для определенных свойств.

См. также:: DEFLATE_HINT, Значения константных полей

DEFLATE_HINT

static final String DEFLATE_HINT

Свойство, указывающее, что распаковщик должен игнорировать все передаваемые значения для DEFLATE_HINT, заменяя их заданным значением, TRUE или FALSE. Значение по умолчанию — специальная строка KEEP, которая просит распаковщик сохранить все передаваемые подсказки сжатия.

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

PROGRESS

static final String PROGRESS

Прогресс распаковщика в процентах, периодически обновляемый распаковщиком. Значения от 0 до 100 являются нормальными, а -1 указывает на задержку. Прогресс можно отслеживать, опрашивая значение этого свойства.

Как минимум, распаковщик должен установить прогресс в 0 в начале операции упаковки и в 100 в конце.

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

Методы

properties

SortedMap<String,String> properties()

Получить набор свойств этого движка. Этот набор является «живым представлением», поэтому изменение его содержимого немедленно влияет на движок Packer, а изменения от движка (например, индикации прогресса) немедленно отображаются в карте.

Карта свойств может содержать предварительно определенные специфичные для реализации и значения по умолчанию. Пользователям рекомендуется ознакомиться с информацией и полностью понять последствия, прежде чем изменять существующие свойства.

Свойства, специфичные для реализации, имеют префикс с именем пакета, связанного с реализатором, начиная с com. или аналогичного префикса. Все имена свойств, начинающиеся с pack. и unpack., зарезервированы для использования в этом API.

Неизвестные свойства могут быть проигнорированы или отклонены с неопределенной ошибкой, а недействительные записи могут вызвать неопределенную ошибку.

Возвращает:: Отсортированное соответствие строк ключей параметров значениям параметров.

unpack

void unpack(InputStream in,
            JarOutputStream out)
     throws IOException

Прочитать архив Pack200 и записать закодированный JAR в JarOutputStream. Все содержимое входного потока будет считано. Может быть эффективнее прочитать архив Pack200 в файл и передать объект File, используя альтернативный метод, описанный ниже.

Закрывает свой вход, но не выход. (Выход может накапливать больше элементов.)

Параметры:: in - InputStream.; out - JarOutputStream.
Исключения:: IOException - если возникла ошибка.

unpack

void unpack(File in,
            JarOutputStream out)
     throws IOException

Прочитать архив Pack200 и записать закодированный JAR в JarOutputStream.

Не закрывает свой выход. (Выход может накапливать больше элементов.)

Параметры:: in - Файл.; out - JarOutputStream.
Исключения:: IOException - если возникла ошибка.

addPropertyChangeListener

@Deprecated
default void addPropertyChangeListener(PropertyChangeListener listener)

Устарело. Зависимость от PropertyChangeListener создает значительное препятствие для будущей модулизации платформы Java. Этот метод будет удален в будущей версии. Приложения, которым необходимо отслеживать прогресс распаковщика, могут вместо этого опросить значение свойства PROGRESS вместо этого.

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

По умолчанию этот метод ничего не делает и не имеет побочных эффектов.

ПРЕДУПРЕЖДЕНИЕ: Этот метод исключен из объявления интерфейса во всех подмножествах профилей Java SE, которые не включают пакет java.beans.

Параметры:: listener - Объект, который вызывается при изменении свойства.
См. также:: properties(), PROGRESS

removePropertyChangeListener

@Deprecated
default void removePropertyChangeListener(PropertyChangeListener listener)

Удалить слушателя событий PropertyChange, добавленного методом addPropertyChangeListener(java.beans.PropertyChangeListener).

По умолчанию этот метод ничего не делает и не имеет побочных эффектов.

Параметры:: listener - Слушатель PropertyChange, который нужно удалить.
См. также:: addPropertyChangeListener(java.beans.PropertyChangeListener)

© 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.