Создание архива

Jar-архивы создаются с помощью классов пакета java.util.jar или с помощью утилиты командной строки jar.

Правила применения утилиты jar очень похожи на правила применения утилиты tar. Набрав в командной строке слово jar и нажав клавишу <Enter>, вы получите краткое пояснение, показанное на рис. П.1.

В строке

jar {ctxu}[vfmOM] [jar-file] [manifest-file] [-C dir] files...

зашифрованы правила применения утилиты. Фигурные скобки показывают, что после слова jar и пробела надо написать одну из букв с, t, x или и. Эти буквы означают следующие операции:

• с (create) — создать новый архив;
• t (table of contents) — вывести в стандартный вывод список содержимого архива;
• х (extract) — извлечь из архива один или несколько файлов;
• u (update) — обновить архив, заменив или добавив один или несколько файлов.

Рис. П.1. Правила употребления утилиты jar

После буквы, без пробела, можно написать одну или несколько букв, перечисленных в квадратных скобках. Они означают следующее:

• v (verbose) — выводить сообщения о процессе работы с архивом в стандартный вывод;
• f (file) — записанный далее параметр jar-file показывает имя архивного файла;
• m (manifest) — записанный далее параметр manifest-file показывает имя файла описания;
• о (нуль) — не сжимать файлы, записывая их в архив; 
• м (manifest) — не создавать файл описания;

Параметр -i (index) предписывает создать в архиве файл INDEX.LIST. Он используется уже после формирования архивного файла.

После буквенных параметров-файлов через пробел записывается имя архивного файла jar-file, потом, через пробел, имя файла описания manifest-file, затем перечисляются имена файлов, которые надо занести в архив или извлечь из архива. Если это имена каталогов, то операция выполняется рекурсивно со всеми файлами каталога.

Перед первым именем каталога может стоять параметр -с. Конструкция -с dir означает, что на время выполнения утилиты jar текущим каталогом станет каталог dir. ,

Необязательные параметры занесены в квадратные скобки.

Итак, в конце командной строки должно быть записано хотя бы одно имя файла или каталога. Если среди параметров есть буква f, то первый из этих файлов понимается как архивный jar-файл. Если среди параметров находится буква т, то первый файл понимается как файл описания (manifest-file). Если среди параметров присутствуют обе буквы, то имя архивного файла и имя файла описания должны идти в том же порядке, что и буквы f и т.

Если параметр f и имя архивного файла отсутствуют, то архивным файлом будет служить стандартный вывод.

Рис. П.2. Работа  с утилитой jar

Если параметр m и имя файла описания отсутствуют, то по умолчанию файл MANIFEST.MF, лежащий в каталоге META-INF архивного файла, будет содержать только номер версии.

На рис. П.2 показан процесс создания архива Base.jar в каталоге ch3. Сначала показано содержимое каталога ch3. Затем создается архив, в который включается файл Base.class и все содержимое подкаталога classes. Снова выводится содержимое каталога ch3. В нем появляется файл Base.jar. Потом выводится содержимое архива.

Как видите, в архиве создан каталог META-INF, а в нем файл MANIFEST.MF.