JavaFX项目应分model/view/controller三层:model用POJO含绑定属性,view仅FXML加载与事件绑定,controller通过ObservableList更新UI;耗时操作须用Task并发;SQLite操作必用PreparedStatement;jpackage打包需配注册表、图标及用户目录配置。

JavaFX项目结构怎么组织才不容易后期崩溃
JavaFX应用不是把所有代码塞进MainApp类就完事的。资源管理系统涉及文件读写、数据持久化、UI状态同步,一旦用单例+静态变量硬扛,很快会遇到NullPointerException(尤其在initialize()里访问未加载的FXMLLoader控件)或线程冲突(如后台扫描文件时更新TableView)。
建议按职责切分三层:
-
model/:纯POJO(如ResourceItem),含SimpleStringProperty等JavaFX绑定属性,避免手动firePropertyChange -
view/:仅负责FXML加载、控件引用(用@FXML)、基础事件绑定(如按钮点击调用controller.handleAdd()) -
controller/:处理业务逻辑,但不直接操作UI控件——通过ObservableList绑定到TableView,让JavaFX自动刷新
关键点:Controller类不能有无参构造函数以外的构造方式;若需传参(如主窗口引用),必须用FXMLLoader.setControllerFactory()配合DI容器(如SimpleInjector),否则FXMLLoader会反射失败。
文件资源扫描卡界面?必须用Task而不是Thread
扫描本地目录(尤其是含大量子文件夹的“下载”或“文档”目录)时,如果在JavaFX主线程执行Files.walk(),整个UI会冻结,进度条不动、按钮点无效,用户只能强杀进程。
立即学习“Java免费学习笔记(深入)”;
正确做法是用JavaFX内置并发工具:
- 继承
Task,重写call()方法放耗时扫描逻辑 - 在
call()中用updateProgress(current, total)和updateMessage("扫描中: xxx")推送进度 - 将
Task交给new Thread(task).start(),再用task.setOnSucceeded()在主线程更新UI(如填充ObservableList) - 绝对不要在
call()里直接调用Platform.runLater()更新控件——这会引发线程竞争,且违背JavaFX并发设计契约
示例片段:
Task> scanTask = new Task<>() { @Override protected List
call() throws Exception { List items = new ArrayList<>(); Files.walk(Paths.get("D:\\MyResources")) .filter(Files::isRegularFile) .forEach(path -> { items.add(new ResourceItem(path)); updateProgress(items.size(), 10000); // 假设预估总数 }); return items; } }; scanTask.setOnSucceeded(e -> tableView.getItems().setAll(scanTask.getValue()));
SQLite存资源元数据,为什么PreparedStatement比拼接SQL更关键
资源管理系统要存文件名、路径、大小、类型、标签、修改时间等字段。若用字符串拼接SQL(如"INSERT INTO resources VALUES ('" + name + "', ...)"),遇到文件名含单引号(O'Reilly.pdf)或中文路径(C:\用户\张三\资料)会直接抛SQLException,且存在SQL注入风险(虽然本地应用风险低,但习惯决定质量)。
必须用PreparedStatement:
- 占位符
?自动处理转义,路径中的反斜杠、单引号、emoji都不用额外处理 - 预编译提升批量插入性能(资源导入常一次几百条)
- 配合
try-with-resources确保Connection/PreparedStatement及时关闭,避免SQLite数据库被锁死(典型错误:database is locked)
注意SQLite不支持DATE类型原生存储,存lastModified()时间戳建议用INTEGER(毫秒值),读取时转Instant.ofEpochMilli(),比存字符串格式(如"2024-05-20 14:30:00")更省空间且便于范围查询。
打包成exe后图标和文件关联失效?别只盯着jpackage
用jpackage --input target --name "ResourceMgr" --main-class com.example.MainApp打包后,Windows上双击exe能运行,但右键菜单没有“用ResourceMgr打开”,任务栏图标也是Java默认咖啡杯——这不是jpackage没配好,而是Windows注册表和文件关联需要额外步骤。
真实生效点:
-
jpackage生成的.msi安装包默认不写注册表,需加--win-per-user-install并配合--win-menu才能创建开始菜单项 - 文件关联必须手动添加注册表项:
HKEY_CURRENT_USER\Software\Classes\.pdf\OpenWithProgids下新建字符串值ResourceMgr.PDF,再在HKEY_CURRENT_USER\Software\Classes\ResourceMgr.PDF\shell\open\command设默认值为"C:\Program Files\ResourceMgr\ResourceMgr.exe" "%1" - 图标替换不是改exe资源,而是给
jpackage指定--icon src/main/resources/app.ico(必须是.ICO格式,含16x16/32x32/256x256多尺寸)
最易忽略的是:打包后的exe启动时工作目录是安装路径,而非用户文档目录。若代码里用new File("config.json"),实际路径变成C:\Program Files\ResourceMgr\config.json(权限被拒绝)。必须用System.getProperty("user.home") + "/.resourcemgr/config.json"定位配置文件。










