如何在Wicket中获取Spring Boot的@ConfigurationProperties？

1. 正确定义配置属性类 #

确保配置属性类被Spring正确管理并绑定YAML属性：

• 用@ConfigurationProperties指定属性前缀，结合@Component让Spring扫描到Bean；或者用@EnableConfigurationProperties显式注册。

// 方式一：Component + ConfigurationProperties
@Component
@ConfigurationProperties(prefix = "app.wicket")
public class WicketAppProperties {
    private String pageTitle;
    private int maxItemsPerPage;

    // 必须添加Getter/Setter，Spring通过setter绑定属性
    public String getPageTitle() { return pageTitle; }
    public void setPageTitle(String pageTitle) { this.pageTitle = pageTitle; }
    public int getMaxItemsPerPage() { return maxItemsPerPage; }
    public void setMaxItemsPerPage(int maxItemsPerPage) { this.maxItemsPerPage = maxItemsPerPage; }
}

// 方式二：仅ConfigurationProperties，配合主类的EnableConfigurationProperties
// @ConfigurationProperties(prefix = "app.wicket")
// public class WicketAppProperties { ... }

如果用方式二，需要在Spring Boot主类添加：

@SpringBootApplication
@EnableConfigurationProperties(WicketAppProperties.class)
public class MyWicketApplication extends WebApplication { ... }

2. 确保Wicket与Spring的集成配置正确 #

在Wicket的Application类中，通过构造注入Spring的ApplicationContext，并初始化SpringComponentInjector，让Wicket从Spring上下文获取Bean：

@SpringBootApplication
public class MyWicketApplication extends WebApplication {

    private final ApplicationContext springContext;

    // 构造注入Spring上下文，避免静态获取
    public MyWicketApplication(ApplicationContext springContext) {
        this.springContext = springContext;
    }

    @Override
    public void init() {
        super.init();
        // 添加Spring组件注入器，传入Spring上下文，确保Wicket使用Spring管理的Bean实例
        getComponentInstantiationListeners().add(new SpringComponentInjector(this, springContext));
        // 其他Wicket配置（比如页面映射、资源设置等）
    }

    @Override
    public Class<? extends Page> getHomePage() {
        return HomePage.class;
    }
}

3. 在Wicket组件中正确使用@SpringBean注入 #

• 使用@SpringBean注解注入配置属性类；
• 避免在组件构造方法中直接使用注入的Bean（Wicket先实例化组件再完成注入），改用onInitialize()方法（注入完成后触发）：

public class HomePage extends WebPage {

    @SpringBean
    private WicketAppProperties wicketProps;

    public HomePage(PageParameters parameters) {
        super(parameters);
    }

    @Override
    protected void onInitialize() {
        super.onInitialize();
        // 此时wicketProps已完成注入和属性绑定
        add(new Label("siteTitle", wicketProps.getPageTitle()));
        add(new Label("maxItems", String.valueOf(wicketProps.getMaxItemsPerPage())));
    }
}

关键注意事项 #

• 配置属性类必须提供Getter和Setter：Spring通过Setter方法完成YAML属性的绑定，没有Setter会导致属性无法填充；
• 确保SpringComponentInjector使用的是Spring的ApplicationContext：如果只传入Wicket的Application实例，注入器可能会创建新的Bean实例而非复用Spring管理的实例；
• 避免静态获取ApplicationContext：构造注入或Spring提供的依赖注入方式是更优雅的实现，符合依赖倒置原则。

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