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

Это свойство — числовое значение, задающее целевой размер N (в байтах) каждого сегмента архива. Если отдельный входной файл требует больше N байт, он получит свой собственный сегмент архива.

В качестве особого случая, значение -1 создаст один большой сегмент со всеми входными файлами, а значение 0 — по одному сегменту для каждого класса. Более крупные сегменты архива приводят к меньшей фрагментации и лучшему сжатию, но их обработка требует больше памяти.

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

По умолчанию значение равно -1, что означает, что архиватор всегда создаст один выходной файл-сегмент. В случаях, когда генерируются чрезвычайно большие выходные файлы, пользователям настоятельно рекомендуется использовать сегментирование или разбить входной файл на более мелкие JAR-архивы.

JAR-архив размером 10 МБ, сжатый без этого ограничения, обычно сжимается примерно на 10% меньше, но архиватору может потребоваться большая куча Java (примерно в десять раз больше предела сегмента).

Если это свойство установлено в TRUE, архиватор передаст все элементы в исходном порядке внутри исходного архива.

Если оно установлено в FALSE, архиватор может переупорядочить элементы и также удалить записи каталога JAR, которые не содержат полезной информации для приложений Java. (Как правило, это позволяет добиться лучшего сжатия.)

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

Если это свойство установлено в одно десятичное число, архиватор использует указанное количество усилий для сжатия архива. Уровень 1 может давать немного больший размер и более высокую скорость сжатия, а уровень 9 займёт намного больше времени, но может обеспечить лучшее сжатие.

Специальное значение 0 указывает архиватору скопировать исходный JAR-файл напрямую без сжатия. Стандарт JSR 200 требует, чтобы любой распаковщик понимал этот специальный случай как пропуск всего архива.

По умолчанию значение 5, что инвестирует умеренное время для получения разумного сжатия.

Если это свойство установлено в TRUE или FALSE, архиватор соответствующим образом установит подсказку сжатия в выходном архиве и не будет передавать отдельные подсказки сжатия элементов архива.

Если это свойство установлено в специальную строку KEEP, архиватор попытается определить независимую подсказку сжатия для каждого доступного элемента входного архива и передать эту подсказку отдельно.

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

Реализация распаковщика должна предпринять действия по использованию подсказки для соответствующего сжатия элементов результирующего распакованного jar-файла.

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

Если это свойство установлено в специальную строку LATEST, архиватор попытается определить последнее время изменения среди всех доступных записей в исходном архиве или последнее время изменения всех доступных записей в каждом сегменте. Это единственное значение будет передано как часть сегмента и применено ко всем записям в каждом сегменте, SEGMENT_LIMIT.

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

Если это свойство установлено в специальную строку KEEP, архиватор передает отдельное время изменения для каждого входного элемента.

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

Реализация распаковщика должна предпринять действия по соответствующей установке времени изменения каждого элемента выходного файла.

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

Преобразования путей не происходит, за исключением того, что разделитель системных файлов заменяется разделителем JAR-файлов '/'.

Имена результирующих файлов должны точно совпадать в виде строк со своими вхождениями в JAR-файл.

Если значение свойства — имя каталога, все файлы в этом каталоге также будут переданы.

Примеры:

Map p = packer.properties();
     p.put(PASS_FILE_PFX+0, "mutants/Rogue.class");
     p.put(PASS_FILE_PFX+1, "mutants/Wolverine.class");
     p.put(PASS_FILE_PFX+2, "mutants/Storm.class");
     # Pass all files in an entire directory hierarchy:
     p.put(PASS_FILE_PFX+3, "police/");

Указывает действие, которое необходимо выполнить при обнаружении класса файла, содержащего неизвестное атрибут. Возможные значения — строки ERROR, STRIP и PASS.

Строка ERROR означает, что операция упаковки в целом завершится неудачей с исключением типа IOException. Строка STRIP означает, что атрибут будет удалён. Строка PASS означает, что весь класс-файл будет передан (как если бы это был файл-ресурс) без сжатия со соответствующим предупреждением. Это значение по умолчанию для этого свойства.

Примеры:

Map p = pack200.getProperties();
     p.put(UNKNOWN_ATTRIBUTE, ERROR);
     p.put(UNKNOWN_ATTRIBUTE, STRIP);
     p.put(UNKNOWN_ATTRIBUTE, PASS);

При конкатенации с именем атрибута класса указывает формат этого атрибута, используя язык макета, указанный в спецификации JSR 200.

Например, эффект этого параметра встроен: pack.class.attribute.SourceFile=RUH.

Также разрешены специальные строки ERROR, STRIP и PASS с тем же значением, что и UNKNOWN_ATTRIBUTE. Это даёт возможность пользователям запрашивать отказ от определённых атрибутов, их удаление или передачу побитово (без сжатия класса).

Код, похожий на этот, может быть использован для поддержки атрибутов для JCOV:

Map p = packer.properties();
     p.put(CODE_ATTRIBUTE_PFX+"CoverageTable",       "NH[PHHII]");
     p.put(CODE_ATTRIBUTE_PFX+"CharacterRangeTable", "NH[PHPOHIIH]");
     p.put(CLASS_ATTRIBUTE_PFX+"SourceID",           "RUH");
     p.put(CLASS_ATTRIBUTE_PFX+"CompilationID",      "RUH");

Код, похожий на этот, может быть использован для удаления атрибутов отладки:

Map p = packer.properties();
     p.put(CODE_ATTRIBUTE_PFX+"LineNumberTable",    STRIP);
     p.put(CODE_ATTRIBUTE_PFX+"LocalVariableTable", STRIP);
     p.put(CLASS_ATTRIBUTE_PFX+"SourceFile",        STRIP);

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

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

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

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

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

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

Возвращаемая карта реализует все необязательные операции SortedMap

Преобразует JarFile в архив Pack200.

Закрывает входной поток, но не выходной. (Архивы Pack200 могут быть добавлены).

Преобразует JarInputStream в архив Pack200.

Закрывает входной поток, но не выходной. (Архивы Pack200 могут быть добавлены).

Атрибуты времени изменения и подсказки сжатия не доступны для файла манифеста JAR и содержащей его директории.

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

Стандартная реализация этого метода ничего не делает и не имеет побочных эффектов.

ВНИМАНИЕ: Этот метод отсутствует в объявлении интерфейса во всех подмножествах профилей Java SE, не включающих пакет java.beans.

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

Стандартная реализация этого метода ничего не делает и не имеет побочных эффектов.

ВНИМАНИЕ: Этот метод отсутствует в объявлении интерфейса во всех подмножествах профилей Java SE, не включающих пакет java.beans.