Как запустить JAR-файл из командной строки с classpath

Быстрый ответ

Для выполнения JAR-файла с определенным внешним classpath воспользуйтесь следующей командой:

java -cp "libs/*;MyApp.jar" com.myapp.Main

• Вместо libs/* вставьте путь к вашим библиотекам, а в операционной системе Windows пути разделяются точкой с запятой ;.
• Поменяйте MyApp.jar и com.myapp.Main на имя вашего JAR-файла и основной класс.

Понимание взаимосвязи между -jar и -cp

Использование флага -jar приводит к запуску класса, указанного в поле Main-Class манифеста JAR-файла, при этом исключается classpath, указанный с помощью параметра -cp. Чтобы задать свой classpath:

• Включите нужные пути в манифест JAR-файла.
• Используйте -cp, при этом отказывайтесь от использования -jar, и укажите полное имя запускаемого класса.

Взаимодействие с classpath и манифестом

Объявление classpath в манифесте

Оптимальнее указывать все JAR-зависимости непосредственно в манифесте JAR-файла:

• Добавьте атрибут Class-Path в раздел META-INF/MANIFEST.MF.
• Используйте относительные пути к библиотекам.
• Соблюдайте ограничение в 72 символа для строк, чтобы избежать ошибок, связанных с ограничениями манифеста.

Подробнее об этом расскажет наш спикер на видео

Динамическое включение classpath

Вы также можете определить classpath динамически:

java -cp "MyJar.jar:lib/*" com.somepackage.subpackage.Main

Помните, что в Windows используется ;, в то время как в Unix и Linux предпочитают использовать :. Символ * позволяет включить все JAR-файлы из директории.

Обход проблем с пробелами и специальными символами

При использовании путей, содержащих пробелы или спецсимволы, их нужно экранировать, особенно в Windows PowerShell:

java -cp 'C:\Program Files\Java\libs\*;MyApp.jar' com.myapp.Main // "Неудивительно, что работа с путями с пробелами изначально все усложняет, не так ли? 😯"

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

Управление classpath и манифестом удобнее осуществлять при помощи скриптов или сборочных инструментов вроде ANT, Maven или Gradle. Такой подход обеспечивает сохранность кода и надежность работы. Автоматизация — наше всё!

Тестирование в различных средах

Тестирование работы JAR-файла и classpath в разных средах позволит определить несоответствия в путях и скриптах между Unix/Linux и Windows системами. Внимательные тесты – залог успешной работы.

Анализ распространенных сообщений об ошибках

NoClassDefFoundError

Такое сообщение означает, что в classpath не включены все необходимые библиотеки. Проверьте пути и разрешения.

Не найден или не загружен основной класс

Такая ошибка указывает на то, что указан неверный Main-Class. Убедитесь в правильности манифеста и имени класса.

Мимо exec

Избегайте использования Runtime.getRuntime().exec(command) при запуске JAR-файла или управлении classpath. Это часто вызывает проблемы.

Визуализация

Представляйте процесс словно дирижирование оркестром, где вы стоите за дирижерским пультом, а оркестр состоит из JAR-файлов и зависимостей:

Запуск JAR-файла: java -jar MyProgram.jar // 🎶 Согласие!
Добавление classpath: -cp или -classpath "/path/to/library" // 🎼 Еще нотки!

И в конечном итоге у нас сложится симфония:

java -cp "/path/to/library*" -jar MyProgram.jar // 🎵 Великий звук!

Полезные материалы

1. Настройка Class Path — Описание настройки classpath от Oracle.
2. Документация команды java — инструкции по команде java.
3. Как запустить .jar файл двойным щелчком в Windows 7 64 — Советы по запуску JAR-файла в Windows от Stack Overflow.
4. Документация JDK 21 — Самая свежая документация по Java.
5. Java – Добавление JAR-файлов в classpath — Как добавить JAR-файл в classpath в Windows.
6. Как установить classpath для Java в Windows и Linux? Шаги и пример — Объяснение работы classpath в Java.