CwaFX

CwaFX 让 JavaFX 开发 更简单。 更现代。

组件扫描与依赖注入、FXML 视图、窗口导航、后台任务、国际化与设置持久化—— 把一个 JavaFX 应用真正需要的基础设施一次性配齐，让你专注在界面与业务本身。

Github 文档

CwaFX 能做什么

依赖注入

基于 @Bean 与 @Autowired 的组件管理与依赖注入，自动扫描启动类所在包及其子包。

@Bean · @Autowired

FXML 视图

标注 @FxmlView 即自动加载 FXML，并把控制器注册为可注入的 Node Bean。

@FxmlView

窗口与导航

窗口级页面导航，支持页面参数、替换、返回栈与返回结果；模态框、通知和默认样式开箱即用。

WindowCreator · Window

后台任务

Tasks 统一管理 JavaFX Task，并提供可直接使用的任务列表视图。

Tasks

设置持久化

@Settings 从 JSON 文件加载配置，并在应用退出时自动写回，无需手写序列化。

@Settings

国际化

基于 ResourceBundle 的国际化支持，默认语言可在 app.json 中配置。

ResourceBundle

生命周期与事件

@Initialize、@PreDestroy、@OnEvent 提供完整的生命周期与事件回调。

@Initialize · @OnEvent

快捷键事件

@OnKeyPressed 把按键事件直接绑定到方法上，快捷键不再散落在各处监听器里。

@OnKeyPressed 
@Bean
@FxmlView("hello-view.fxml")
public class HelloView {
    @Autowired
    private GreetingService service;

    @OnKeyPressed("hello")
    private void onHello() {
        service.greet("Hello World!");
    }
}

少写样板，多写业务

在 CwaFX 里，一个视图就是一个 Bean。标注 @FxmlView 之后， 框架会自动加载 FXML、把它注册成 Node Bean，并按需完成依赖注入与生命周期回调。

需要跳转到新页面？交给 WindowCreator——页面参数、返回栈和返回结果都不用自己操心。 需要跑耗时逻辑？交给 Tasks，UI 线程安全由框架保证。

查看最小示例

文档

快速开始

从依赖、资源到第一个窗口的完整接入路径。

docs/quick-start

组件与生命周期

Bean、注入、生命周期和事件注解的详细说明。

docs/components-and-lifecycle

动态表单

动态表单、校验、提交事件和 FXML 声明方式。

docs/forms

界面与任务

窗口、FXML、模态框、通知和后台任务。

docs/interface-and-tasks

配置与国际化

app.json、设置文件、语言资源和快捷键。

docs/configuration-and-i18n