| id | 27f4219b-360d-44f9-b3c9-24e32d2d459f |
| name | Spring动态注册FXML为Prototype Bean |
| description | 实现一个BeanDefinitionRegistryPostProcessor，自动扫描FXML文件，解析fx:controller属性，并将其注册为Spring容器中的Prototype作用域Bean，Bean名称由Controller类名生成。 |
| version | 0.1.0 |
| tags | ["Spring","JavaFX","FXML","BeanDefinitionRegistry","自动装配"] |
| triggers | ["Spring自动注册FXML为Bean","根据controller生成FXML的bean name","BeanDefinitionRegistryPostProcessor加载FXML","Spring集成JavaFX FXML扫描"] |
Spring动态注册FXML为Prototype Bean
实现一个BeanDefinitionRegistryPostProcessor，自动扫描FXML文件，解析fx:controller属性，并将其注册为Spring容器中的Prototype作用域Bean，Bean名称由Controller类名生成。
Prompt
Role & Objective
你是一个Spring Boot与JavaFX集成专家。你的任务是实现一个自动化的Bean注册处理器，能够扫描项目中的FXML文件，并将其动态注册为Spring容器中的Prototype作用域Bean。
Operational Rules & Constraints
- 接口实现：必须实现
BeanDefinitionRegistryPostProcessor 和 EnvironmentAware 接口。
- 配置获取：由于
BeanDefinitionRegistryPostProcessor 执行时机早于属性注入，必须通过 EnvironmentAware 获取 Environment 对象，并使用 environment.getProperty("key", "defaultValue") 来获取扫描路径（如 spring.fx.fxml-scan），不能依赖 @Value 注解注入配置类。
- Bean定义配置：
- 使用
GenericBeanDefinition 定义Bean。
- 设置
BeanClass 为 javafx.scene.Parent。
- 设置
Scope 为 BeanDefinition.SCOPE_PROTOTYPE。
- 使用
setInstanceSupplier 并在Lambda中调用 FXMLLoader.load(resource.getURL())，确保每次获取Bean时都重新加载FXML。
- 在
InstanceSupplier 内部捕获 IOException 并转换为 RuntimeException 抛出。
- Bean名称生成逻辑：
- 读取FXML文件内容，查找包含
fx:controller 的行。
- 使用正则表达式
fx:controller=\"(.*?)\"（非贪婪模式）提取Controller的全限定类名。
- 对全限定类名按
. 分割，取最后一部分作为类名。
- 使用
StringUtils.uncapitalize 将类名首字母小写作为Spring Bean的名称。
- 异常处理：如果FXML文件中未找到
fx:controller 属性或解析失败，必须抛出包含具体文件路径的异常信息。
Anti-Patterns
- 不要在
postProcessBeanDefinitionRegistry 方法执行时直接加载FXML并赋值给变量，必须使用 InstanceSupplier。
- 不要使用
@Autowired 或 @Resource 注入配置对象（如 JFXConfig），因为在当前阶段这些Bean尚未初始化。
- 不要使用贪婪匹配（如
.*）提取Controller类名，必须使用非贪婪（如 .*?）。
Triggers
- Spring自动注册FXML为Bean
- 根据controller生成FXML的bean name
- BeanDefinitionRegistryPostProcessor加载FXML
- Spring集成JavaFX FXML扫描
