​
简介

从Spring Framework 7开始，Spring提供了一流的编程式Bean注册支持，通过BeanRegistrar接口可以以灵活高效的方式编程式注册Bean。这一新特性为开发者提供了更强大的工具来动态管理应用上下文中的Bean定义。

​
BeanRegistrar接口

​
基本用法

Bean注册器实现通常通过在@Configuration类上使用@Import注解来导入：

@Configuration
@Import(MyBeanRegistrar.class)
class MyConfiguration {
}

可以利用类型级条件注解（@Conditional及其他变体）来有条件地导入相关的Bean注册器。

​
实现示例

Bean注册器实现使用BeanRegistry和Environment API以简洁灵活的方式编程式注册Bean。例如，它允许通过if表达式、for循环等进行自定义注册：

class MyBeanRegistrar implements BeanRegistrar {

    @Override
    public void register(BeanRegistry registry, Environment env) {
        // 基本Bean注册
        registry.registerBean("foo", Foo.class);

        // 高级Bean注册，带配置选项
        registry.registerBean("bar", Bar.class, spec -> spec
                .prototype()
                .lazyInit()
                .description("自定义描述")
                .supplier(context -> new Bar(context.bean(Foo.class))));

        // 条件Bean注册
        if (env.matchesProfiles("baz")) {
            registry.registerBean(Baz.class, spec -> spec
                    .supplier(context -> new Baz("你好，世界！")));
        }
    }
}

Bean注册器支持AOT优化，无论是在JVM上还是使用GraalVM原生镜像，包括使用实例供应商的情况。

​
与传统方法的比较

​
@Conditional注解的局限性

虽然@Conditional系列注解在条件化Bean注册中发挥了重要作用，但在复杂场景下仍存在一些限制：

  1. 表达能力有限 - 无法直接使用编程结构（循环/分支/异常处理）
  2. 调试困难 - 条件匹配过程对开发者不够透明，排查问题成本高

这些限制在需要动态决策、复杂条件组合或需要与运行时环境深度交互的场景中尤为明显。

​
Spring 7之前的编程式注册

深入研究Spring框架源码的开发者会发现，基于BeanDefinitionRegistry的编程式注册机制在Spring生态系统中被广泛应用。这种模式在Spring Boot的自动配置、各类starter的条件化Bean注册以及众多Spring项目的核心实现中尤为常见。它为框架开发者提供了极高的灵活性，使得复杂的组件注册逻辑得以实现，但同时也带来了较高的使用门槛和复杂性。

​
主要方法

  1. 使用BeanDefinitionRegistry
    • 通过BeanDefinitionRegistryPostProcessor实现（Spring 3.0+）
    • 需要手动创建和配置BeanDefinition对象
    • 更冗长和复杂
@Override
public void postProcessBeanDefinitionRegistry(BeanDefinitionRegistry bdr) {
    BeanDefinition definition = new RootBeanDefinition(MyClass.class);
    bdr.registerBeanDefinition("myId", definition);
}
  1. 使用SingletonBeanRegistry
    • 通过ConfigurableListableBeanFactory
    • 更简单但仅限于注册已创建的单例实例
    • 对Bean定义属性的控制有限
ConfigurableListableBeanFactory beanFactory =
    ((ConfigurableApplicationContext) applicationContext).getBeanFactory();
beanFactory.registerSingleton(bean.getClass().getCanonicalName(), bean);

​
优势与展望

Spring Framework 7的新编程式Bean注册相比之前的方法是一个显著改进，新方法简化了常见的注册模式，遵循Spring提供更现代、对开发者友好的API的趋势，同时保持与现有方法的向后兼容性。