webprogr.ru Новости

Разделение по MVC: Организуйте код по слоям – например, пакеты model, view, controller. FXML-файлы и связанные ресурсы хранятся отдельно от Java-кода (обычно в src/main/resources).
Пример структуры (Maven-проект):
src/main/java  
├── controllers/       (классы контроллеров UI)  
├── model/            (бизнес-логика, данные)  
├── MainApp.java      (класс Application)  
src/main/resources  
├── view/             (FXML файлы интерфейса)  
├── css/              (CSS стили)  
├── images/           (графические ресурсы)  
Такой подход упрощает поддержку: четко видно, где логика, а где описание интерфей.
Подключение JavaFX: В pom.xml/Gradle добавьте зависимости org.openjfx (модули javafx-controls, javafx-fxml и др.) – это необходимо, поскольку JavaFX не входит в JDK 11+. Если используете модули Java, добавьте requires javafx.controls; requires javafx.fxml; и opens [пакет контроллеров] to javafx.fxml; в module-info.java.
Сборка и запуск: Рекомендуется использовать Maven (плагин JavaFX) или Gradle JavaFX Toolchain для упрощения запуска. Это автоматически настроит module-path при запуске приложения. Альтернативно, можно пользоваться JDK, включающим JavaFX (например, Liberica Full JDK).


Пояснение:
Правильная структура проекта делает разработку и поддержку приложения гораздо удобнее. В случае JavaFX с FXML имеет смысл придерживаться принципа MVC (Model-View-Controller), хотя фреймворк и не навязывает его строго.
Один из практических вариантов организации (как подсказано в сообществеstackoverflow.com
): создать пакет, например, controllers для всех классов контроллеров, отдельные пакеты для моделей (бизнес-объектов, логики) и, возможно, для сервисов/DAO, если приложение большое и требует слоя для работы с данными. FXML-файлы чаще всего группируют в папке ресурсов, подкаталоге view (можно дублировать подструктуру пакетов контроллеров, либо складывать все вместе, если их немного). CSS-стили – в папке css, изображения и прочие ресурсы – в соответствующих подпапках. Такой расклад отражает роль каждого файла: .java файлы – код, .fxml – разметка интерфейсов, .css – стили, и все лежит обособленно.
Например, в Maven-проекте структура может быть такой:
src/main/java
com.example.myapp/
MainApp.java        (запуск приложения, класс Application)
controllers/
LoginController.java
MainWindowController.java
model/
User.java
Order.java
service/
UserService.java
src/main/resources
com.example.myapp/
view/
LoginView.fxml
MainWindow.fxml
css/
styles.css
images/
logo.png
При таком устройстве FXML ссылается на контроллер через полный путь класса fx:controller="com.example.myapp.controllers.LoginController". Загрузка FXML – через ресурс: FXMLLoader.load(getClass().getResource("/com/example/myapp/view/LoginView.fxml")). В контроллере, если нужны сервисы или модель, их можно получать через синглтон, контекст или DI-фреймворк (например, Spring – но это отдельная большая тема). Главное – контроллер не должен содержать бизнес-логику, он лишь связывает модель и отображение.
Подключение JavaFX библиотек: если вы используете Maven, нужно добавить зависимости на необходимые модули OpenJFX. Обычно достаточно javafx-controls и javafx-fxml (они подтянут базовые графические модули). Если ваше приложение использует медиа, веб-контент или 3D, могут понадобиться javafx-media, javafx-web, javafx-graphics и др. Версию ставьте актуальную (например, 21.0.0. Важно: версия JavaFX должна совпадать или быть совместимой с версией Java. Обычно OpenJFX публикуется отдельно, но, к примеру, JavaFX 21 требует JDK не ниже 17).
Gradle-проекты аналогично – применяют плагин org.openjfx.javafxplugin или настраивают зависимости и VM args вручную. С Gradle JVM 17+ нужно учесть модульность, указав модульный путь.
Module vs Classpath: JavaFX можно запускать как на Module Path (с module-info), так и на старом Classpath. К 2025 году модульная система Java довольно устоялась, поэтому рекомендуется делать JavaFX-приложение модульным – это обеспечит явное указание зависимостей. В module-info.java вам почти всегда нужно как минимум:
module MyApp {
requires javafx.controls;
requires javafx.fxml;
// если используете другие модули JavaFX, тоже добавить (graphics, media, etc.)
opens com.example.myapp.controllers to javafx.fxml;
exports com.example.myapp; // экспорт пакета с MainApp, если надо
}
Строка opens ... to javafx.fxml – как упоминалось – нужна для доступа FXML Loader к контроллерам. Без нее вы получите исключение о невозможности instantiating controller.
Сборка артефакта: после успешной компиляции и запуска в IDE, можно собирать исполняемый JAR. Для JavaFX-приложений простого fat JAR бывает недостаточно из-за модуляции. Часто используют JavaFX Maven Plugin (от OpenJFX) – он умеет запускать приложение (mvn javafx:run) и создавать исполняемый jar/образ. Также есть утилита jlink, позволяющая собрать минимальный runtime с включением JavaFX модулей – на выходе получается папка, которую можно упаковать в zip/installer. Это особенно полезно для доставки desktop-приложений без зависимости от установленной Java у пользователя.
Современные тенденции: Некоторые проекты используют Gluon FX для упаковки JavaFX-приложений в нативные образы (через GraalVM AOT компиляцию) – чтобы сделать .exe, .app или .apk. Это продвинутая тема, но стоит знать, что JavaFX ныне применяют не только на настольных ПК, но и на мобильных устройствах (есть порт на Android/iOS через Gluon Substrate).
Для наших целей учебного курса важно, чтобы студент умел правильно разложить проект и запустить его. Поэтому всегда проверяйте файл pom.xml на наличие зависимостей JavaFX, а в настройках запуска указывайте VM Options с --module-path и --add-modules, если не используете плагин. Например:
--module-path ${PATH_TO_FX} --add-modules javafx.controls,javafx.fxml
(${PATH_TO_FX} – путь к папке с модулями JavaFX). IDE современные (IntelliJ) при создании JavaFX проекта часто сами это пропишут.
Наконец, помните про файл module-info.java (если проект модульный). Множество ошибок FXML и запуска связаны именно с отсутствующими opens/export или requires. В режиме разработки можно отладочно открыть вообще все (opens com.example.myapp.controllers to javafx.fxml;), но в боевом коде явно ограничивайте экспорт только нужными пакетами.