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<resourceitem></resourceitem>绑定到TableView，让JavaFX自动刷新
关键点：Controller类不能有无参构造函数以外的构造方式；若需传参（如主窗口引用），必须用FXMLLoader.setControllerFactory()配合DI容器（如SimpleInjector），否则FXMLLoader会反射失败。
文件资源扫描卡界面？必须用Task而不是Thread
扫描本地目录（尤其是含大量子文件夹的“下载”或“文档”目录）时，如果在JavaFX主线程执行Files.walk()，整个UI会冻结，进度条不动、按钮点无效，用户只能强杀进程。
立即学习“Java免费学习笔记（深入）”；
正确做法是用JavaFX内置并发工具：
- 继承
Task<void></void>，重写call()方法放耗时扫描逻辑 - 在
call()中用updateProgress(current, total)和updateMessage("扫描中: xxx")推送进度 - 将
Task交给new Thread(task).start()，再用task.setOnSucceeded()在主线程更新UI（如填充ObservableList） - 绝对不要在
call()里直接调用Platform.runLater()更新控件——这会引发线程竞争，且违背JavaFX并发设计契约
示例片段：
Task<List<ResourceItem>> scanTask = new Task<>() {
@Override
protected List<ResourceItem> call() throws Exception {
List<ResourceItem> 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_USERSoftwareClasses.pdfOpenWithProgids下新建字符串值ResourceMgr.PDF，再在HKEY_CURRENT_USERSoftwareClassesResourceMgr.PDFshellopencommand设默认值为"C:Program FilesResourceMgrResourceMgr.exe" "%1" - 图标替换不是改exe资源，而是给
jpackage指定--icon src/main/resources/app.ico（必须是.ICO格式，含16x16/32x32/256x256多尺寸）
最易忽略的是：打包后的exe启动时工作目录是安装路径，而非用户文档目录。若代码里用new File("config.json")，实际路径变成C:Program FilesResourceMgrconfig.json（权限被拒绝）。必须用System.getProperty("user.home") + "/.resourcemgr/config.json"定位配置文件。
