Spring Bean 命名各种方式，看这一篇就够了

公众号「架构成长指南」，专注于生产实践、云原生、分布式系统、大数据技术分享。

在 Spring 框架中，每个 bean 必须至少有一个唯一的名称。Spring 遵循简单且默认的命名策略来确定 bean 的名称，无论我们使用 XML 配置还是基于Java代码配置。本文将详细讨论这些策略。

1.使用@Component的默认Bean命名

默认情况下，Spring会使用声明Bean类型的简单名称，将第一个字母改为小写，并使用生成的值来命名Bean。此种方式适用于所有定型注解（@Service、@Repository 等）。

下面我我们声明一个非常简单的bean，如下所示：

java 复制代码

@Configuration
@ComponentScan
public class AppConfig {
	//...
}

@Component
public class DemoBean { 

	//...
}

DemoBean使用@Component注解，当我们从应用程序上下文中检索 bean 并打印其名称时，它会打印" demoBean "。

java 复制代码

var applicationContext = new AnnotationConfigApplicationContext(AppConfig.class);
Arrays.stream(applicationContext.getBeanDefinitionNames()).forEach(System.out::println);

程序输出：

java 复制代码

org.springframework.context.annotation.internalConfigurationAnnotationProcessor
org.springframework.context.annotation.internalAutowiredAnnotationProcessor
org.springframework.context.annotation.internalCommonAnnotationProcessor
org.springframework.context.annotation.internalPersistenceAnnotationProcessor
org.springframework.context.event.internalEventListenerProcessor
org.springframework.context.event.internalEventListenerFactory
appConfig
demoBean

在以上结果输出中，我们可以看到 Spring 创建的基础设施 bean，还有我们创建的beanappConfig和demoBean.

2. 使用@Bean的默认Bean命名

当我们使用@Bean注解来创建一个新的bean时，该bean将以创建它的方法命名。

让我们通过一个示例来理解，我们创建两个具有不同方法名称的DemoBean类型的 bean 。

java 复制代码

@Configuration
public class AppConfig {

  @Bean
  DemoBean demoBean(){
    return new DemoBean();
  }

  @Bean
  DemoBean anotherDemoBean(){
    return new DemoBean();
  }
}

当我们运行代码并打印bean名称时，会输出以下结果：

java 复制代码

...
appConfig
demoBean
anotherDemoBean

3. 带有值的显式 Bean 命名

对于所有的注解类型，都有一个默认属性名为"value"，可以用一个值进行初始化，作为用于标识bean的名称。

java 复制代码

@Component(value = "newBeanName")
public class DemoBean {
	//...
}

注意，@Component(value = "newBeanName") 等同于 @Component("newBeanName")。它们产生一样的结果。

同样@Bean注解有两个属性name 和 value，可以为bean定义一个显式名称。

java 复制代码

@Configuration
public class AppConfig {

  @Bean(name = "newBeanName")
  DemoBean demoBean(){
    return new DemoBean();
  }

  @Bean(value = "anotherNewBeanName")
  DemoBean anotherDemoBean(){
    return new DemoBean();
  }
}

当我们运行代码并打印bean名称时，会输出以下结果：

java 复制代码

...
appConfig
newBeanName
anotherNewBeanName

4. Bean 名称别名：多个 Bean 名称

@Bean 注解的 name 或 value 属性可以指定一个值数组，用于引用 bean 的名称。当这样做时，数组中的第一个值将成为主要名称，而其他值将成为别名。

java 复制代码

@Bean(value = {"newBeanName", "newBeanName-1", "newBeanName-2"})
DemoBean demoBean(){
  return new DemoBean();
}

现在，当打印 bean 的名称时，它仍然是 "newBeanName"。但是当我们打印 bean 的名称别名时，我们会得到额外的名称，即 "newBeanName-1" 和 "newBeanName-2"。

java 复制代码

var applicationContext = new AnnotationConfigApplicationContext(AppConfig.class);
Arrays.stream(applicationContext.getBeanDefinitionNames()).forEach(System.out::println);

var demoBean = applicationContext.getBeansOfType(DemoBean.class);

demoBean.forEach((k, v) -> {
  var aliases = applicationContext.getAliases(k);
  if (aliases.length > 0) {
    Arrays.stream(aliases).forEach(System.out::println);
  }
});

输出

java 复制代码

...
appConfig
newBeanName
newBeanName-2
newBeanName-1

5.生成自定义Bean名称

与Spring中的所有功能类似，bean的命名也可以进行自定义。为了进行自定义名称生成，我们可以定义一个类，继承 AnnotationBeanNameGenerator 并在 @ComponentScan 注解中指定该类的名称。

java 复制代码

@Configuration
@ComponentScan(nameGenerator = CustomBeanNameGenerator.class)
public class AppConfig {
	//...
}

接下来，我们通过在 CustomBeanNameGenerator 类中重写 buildDefaultBeanName() 方法来定义自定义的名称生成逻辑。

以下示例会返回由小写的简单类名与唯一标识符连接而成的 bean 名称。

java 复制代码

public class CustomBeanNameGenerator extends AnnotationBeanNameGenerator {

  @Override
  protected String buildDefaultBeanName(BeanDefinition definition, BeanDefinitionRegistry registry) {
    var beanName = definition.getBeanClassName()
      .substring(definition.getBeanClassName().lastIndexOf(".") + 1)
      .toLowerCase(Locale.ROOT);
    var uid = UUID.randomUUID().toString().replace("-","").substring(0,8);
    return beanName + "-" + uid;
  }
}

输出

java 复制代码

appConfig
demobean-889ed00b

总结

在本Spring教程中，我们学习了5种bean命名策略希望对你有所帮助。