FXML是JavaFX提供的一种基于XML的声明式界面描述语言，它的核心作用是把应用的界面结构与后端业务逻辑代码分开，避免将大量界面布局代码写在Java类里，让代码结构更清晰，也方便后续的界面修改和维护。使用FXML设计界面时，我们可以通过标签直观定义窗口、按钮、文本框等各类UI组件，还能设置组件的属性、布局关系和事件绑定规则。
FXML的核心特性
FXML的设计遵循了MVC模式的思想，界面层由FXML文件负责，控制层由对应的控制器类实现，数据层可以结合JavaFX的属性绑定机制完成。它的主要特性包括：
- 声明式语法：用XML标签描述UI组件，比纯Java代码编写界面更直观，降低界面调整的难度
- 与Java代码解耦：界面修改只需要调整FXML文件，不需要改动后端逻辑代码，减少代码改动范围
- 支持可视化编辑：可以配合Scene Builder工具拖拽组件生成FXML代码，提升界面设计效率
- 事件绑定灵活：可以直接在FXML中指定组件事件对应的控制器方法，不需要手动编写事件注册代码
FXML的基本语法规则
FXML文件的整体结构是一个XML文档，根标签通常是JavaFX的布局容器类，比如BorderPane、VBox等。每个UI组件对应一个XML标签，标签名就是组件的类名，组件属性可以通过标签的属性或者子标签来设置。
基础FXML文件示例
下面是一个简单的FXML文件，定义了一个包含文本标签和按钮的窗口界面：
<?xml version="1.0" encoding="UTF-8"?>
<?import javafx.scene.control.Button?>
<?import javafx.scene.control.Label?>
<?import javafx.scene.layout.VBox?>
<VBox alignment="CENTER" spacing="20" xmlns="http://javafx.com/javafx/8.0.171" xmlns:fx="http://javafx.com/fxml/1" fx:controller="com.example.DemoController">
<children>
<Label text="欢迎使用FXML设计的界面" />
<Button text="点击按钮" onAction="#handleButtonClick" />
</children>
</VBox>
这个文件中，<?import?>语句用来导入需要用到的JavaFX类，fx:controller属性指定了对应的控制器类全路径，onAction="#handleButtonClick"表示按钮的点击事件会绑定到控制器的handleButtonClick方法。
用FXML设计JavaFX应用的完整流程
第一步：创建FXML文件
可以在项目的资源目录下新建FXML文件，手动编写上面的XML代码，或者打开Scene Builder工具，拖拽需要的组件到画布上，调整组件的属性和布局，完成后导出FXML文件到项目对应目录。
第二步：编写控制器类
控制器类是用来处理界面交互逻辑的类，需要和FXML中fx:controller指定的路径一致，类中的方法需要和FXML里绑定的事件方法名对应。上面的示例对应的控制器代码如下：
package com.example;
import javafx.event.ActionEvent;
import javafx.fxml.FXML;
import javafx.scene.control.Alert;
public class DemoController {
@FXML
private void handleButtonClick(ActionEvent event) {
Alert alert = new Alert(Alert.AlertType.INFORMATION);
alert.setTitle("提示");
alert.setHeaderText(null);
alert.setContentText("按钮被点击了");
alert.showAndWait();
}
}
这里的@FXML注解用来标记方法是FXML可访问的事件处理方法，方法名和FXML中onAction指定的名称完全一致。
第三步：加载FXML文件启动应用
需要在JavaFX的主应用类中加载FXML文件，生成界面场景并显示。主类代码如下：
package com.example;
import javafx.application.Application;
import javafx.fxml.FXMLLoader;
import javafx.scene.Parent;
import javafx.scene.Scene;
import javafx.stage.Stage;
public class MainApp extends Application {
@Override
public void start(Stage primaryStage) throws Exception {
// 加载FXML文件，路径是资源目录下的fxml文件路径
Parent root = FXMLLoader.load(getClass().getResource("/demo.fxml"));
primaryStage.setTitle("FXML示例应用");
primaryStage.setScene(new Scene(root, 400, 300));
primaryStage.show();
}
public static void main(String[] args) {
launch(args);
}
}
运行这个主类，就会弹出包含标签和按钮的窗口，点击按钮会弹出提示框，说明FXML和控制器已经正确关联。
FXML使用注意事项
- FXML文件中的组件id如果需要和控制器中的成员变量绑定，需要给组件添加
fx:id属性，同时控制器中用@FXML注解标记对应的成员变量，类型和组件类型一致 - FXML文件的编码建议统一使用UTF-8，避免出现中文乱码问题
- 如果FXML文件放在非默认资源目录，加载时需要写对完整的类路径，否则会抛出文件找不到的异常
- 不要在控制器中编写过多的界面布局代码，控制器只负责处理交互逻辑，界面调整尽量在FXML文件中完成
FXML是JavaFX界面开发的重要工具，熟练掌握它的使用方法可以大幅提升界面开发的效率和代码的可维护性，建议开发者在实际项目中优先采用FXML分离界面和业务逻辑。