Как встроить фронтенд в JAR-файл: практическое руководство

Упаковка фронтенда в JAR-файл бэкенда позволяет создать самодостаточное приложение, упрощая развертывание и обновление. Это решение особенно удобно для небольших приложений, изолированных сред или когда требуется быстрое развертывание без использования Docker или сложных CI/CD процессов. Такой подход может быть полезен в случаях, когда требуется обеспечить легкую установку приложения для пользователей с минимальными техническими навыками, а также для проектов в ограниченных средах, например, где доступ к ресурсам и интернету ограничен.

Идея заключается в использовании встроенного веб-сервера Spring Boot для обслуживания статических файлов фронтенда, размещенных в каталоге /static в ресурсах проекта бэкенда. Таким образом, при запуске JAR-файла Spring Boot автоматически обрабатывает запросы, перенаправляя их на соответствующие ресурсы. Данный метод подходит как для простых HTML/JS страниц, так и для сложных Angular-приложений. Для автоматического определения адреса, на котором развернут бэкенд и доступен фронтенд, используется window.location в JavaScript, таким образом, фронтенд может динамически обращаться к API бэкенда.

Пример реализации включает в себя проект бэкенда на Spring Boot, проект фронтенда на чистом JS и проект фронтенда на Angular. Бэкенд предоставляет API для получения случайного числа и обслуживает статические файлы фронтенда. Фронтенд (как на JS, так и на Angular) периодически запрашивает данные у бэкенда и отображает полученные значения на странице. Angular-проект компилируется в статические файлы, которые затем копируются в папку /static бэкенда. Это позволяет развернуть приложение как единый JAR-файл.

Хотя данный подход подходит для небольших и средних приложений, он может быть не лучшим выбором для высоконагруженных систем, где более эффективно разделять фронтенд и бэкенд на разные сервисы с отдельными процессами масштабирования и развертывания. Однако в ситуациях, где требуется быстрое и простое развертывание единого пакета, внедрение фронтенда в JAR-файл может быть весьма полезным и удобным решением.


Новое на сайте