FXMLLoader的setController与setControllerFactory区别及适用场景

核心区别 #

1. 作用方式不同 #

• setController()：直接传入已创建完成的控制器实例，FXMLLoader会直接复用这个实例，完全跳过自动创建控制器的逻辑。如果FXML文件中通过fx:controller指定了控制器类，调用此方法后该配置会被忽略。
• setControllerFactory()：传入一个控制器创建逻辑的工厂函数（类型为Function<Class<?>, Object>）。当FXMLLoader需要创建控制器时（比如FXML中指定了fx:controller，或需要动态生成控制器），会调用这个工厂函数来生成实例，替代默认的无参构造创建方式。

2. 灵活性差异 #

• setController()：属于静态绑定实例，只能使用你提前初始化好的那个对象，逻辑简单直接，但缺乏动态调整的空间。
• setControllerFactory()：属于动态创建策略，可以完全自定义控制器的创建流程，支持复杂的逻辑判断、依赖注入等，灵活性远高于前者。

适用场景 #

优先用setController()的场景 #

• 复用控制器实例：比如多个FXML视图需要共享同一个控制器的状态（比如表单输入内容、筛选条件），直接传入已有的实例就能避免状态丢失。
• 控制器提前完成复杂初始化：如果控制器需要在加载FXML前就完成数据绑定、事件注册等操作，提前创建好实例再传给FXMLLoader更高效。
• 简单界面场景：小型项目或简单弹窗，控制器逻辑单一，提前创建实例的方式更直观，不需要额外的工厂逻辑。

示例代码：

// 提前初始化控制器并设置数据
UserFormController controller = new UserFormController();
controller.setUserModel(currentUser);

// 绑定到FXMLLoader
FXMLLoader loader = new FXMLLoader(getClass().getResource("user-form.fxml"));
loader.setController(controller);
Parent formRoot = loader.load();

优先用setControllerFactory()的场景 #

• 依赖注入需求：如果控制器需要通过带参构造注入服务类、数据仓库等依赖（默认无参构造无法满足），工厂函数可以在创建控制器时传入这些依赖。
• 统一处理控制器初始化：比如给所有控制器统一注入日志对象、全局配置，或者在创建时做权限校验，工厂函数可以集中处理这些重复逻辑。
• 动态切换控制器实现：根据业务场景（如用户角色、环境配置）返回不同的控制器子类实例，工厂函数可以根据控制器类做判断并返回对应实现。
• 保留FXML的fx:controller配置：既想在FXML中直观指定控制器类，又不想用默认无参构造创建，工厂函数可以接管创建逻辑，兼顾FXML的可读性和自定义创建需求。

示例代码（带依赖注入的工厂）：

FXMLLoader loader = new FXMLLoader(getClass().getResource("order-view.fxml"));
// 自定义工厂，为指定控制器注入依赖服务
loader.setControllerFactory(controllerClass -> {
    if (controllerClass == OrderController.class) {
        return new OrderController(orderService, notificationService);
    }
    // 其他控制器 fallback 到默认无参构造
    try {
        return controllerClass.getDeclaredConstructor().newInstance();
    } catch (Exception e) {
        throw new RuntimeException("Failed to create controller", e);
    }
});
Parent orderRoot = loader.load();

内容的提问来源于stack exchange，提问作者SquidXTV