在Spring中如何获取一个Bean

引言

在这篇文章中，我们将介绍在Spring框架（包括SpringBoot、SpringCloud）中获取Bean的方法，在Spring容器中，Bean的存在方式是多种多样的，针对不同种类的Bean我们有哪些方法可以获取到它们，如何安全的获取这些Bean而不会产生错误，获取到它们之后我们有能够怎样处理呢？今天我们来聊一聊关于在Spring容器中获取Bean的话题🎃。

摘要

本文主要介绍Spring框架中Bean的获取相关知识，主要涉及 BeanFactory 和 ListableBeanFactory两个接口中的方法，这两个接口也是Spring容器中的核心接口，其中定义了获取单个Bean和获取Bean集合的一些强大功能。

正文

在之前的文章中，我们介绍了Spring/SpringBoot中的Bean，而在使用Spring/SpringBoot框架开发应用程序的过程中，主要通过对Bean的操作来实现各种各样的功能，那么在Spring/SpringBoot中如何来获取一个或多个Bean，也是有讲究的，针对不同的Bean对象我们可以采取不同的获取方式，今天我们就来介绍一些常用的获取Bean的方式。

为了方便测试，在我们先定义几个bean以备使用

public class BeanDemo {
    private String name;
    private Long id;
    //省略getter,setter,toString方法
}

public class PersonEntity {
    private String name;
    private int age;
    private Gender gender;
    //省略getter,setter,toString方法
}

public enum Gender {
    MALE,FEMALE;
}

注册bean

public class ConfigDemo{	
	@Bean
    public PersonEntity zhangFei(){
        return PersonEntity.bornMale("zhang fei");
    }

    @Bean
    public PersonEntity guanyu(){
        return PersonEntity.bornMale("guan yu");
    }

    @Bean
    public PersonEntity liubei(){
        return PersonEntity.bornMale("liu bei");
    }

    @Bean
    public PersonEntity sunshangxiang(){
        return PersonEntity.bornFemale("sun shangxiang");
    }

    @Bean
    public BeanDemo tongquetai(){
        BeanDemo res = new BeanDemo();
        res.setId(1L);
        res.setName("tong que tai");
        return res;
    }
}

常用的Bean获取方式

自动注入

spring中最常见的Bean查找（获取）方式就是通过 @Autowired注解或 @Resource注解注入一个Bean，这两者的区别在于 @Autowired是Spring提供的注解，而 @Resource是JavaEE标准中提供的注解，两者的使用方式类似，详细对比如下

表：Autowired和Resource注解对比

对比	@Autowired	@Resource
提供方	Spring2.5	JavaEE标准库
是否可指定Bean名称	否（结合@Qualifier注解可实现相同功能）	是
是否可指定Bean类型	否	是
官方建议	不建议使用	建议使用

以下代码说明了 @Autowired注解的基本功能

public class BeanLookupComponent implements ApplicationRunner {
    @Autowired
    private BeanDemo beanDemo;
    
    @Override
    public void run(ApplicationArguments args) throws Exception {
        System.out.println(beanDemo);
    }
}

注意这里 @Autowired只支持容器中只存在一个 BeanDemo类型的Bean的情况。如果存在多种同类型的Bean，需要结合 @Qualifier注解（注意：本文后续所有测试代码都在 BeanLookupComponent这个类中完成，因此部分代码就省略了）

@Qualifier("liubei")
@Autowired
private PersonEntity beanDemo;

相对的 @Resource注解的用法就要灵活的多

可以按类型注入，不指定Bean名称

private BeanDemo resourceBean;

当存在多个同类型的Bean时，可以通过指定名称明确使用哪一个Bean（也可以指定类型）

@Resource(name = "guanyu",type = PersonEntity.class)
private PersonEntity resourceBean;

主动获取

除此之外还可以通过 BeanFactory 接口的 getBean方法获取一个Bean，而 BeanFactory接口可以通过实现 BeanFactoryAware接口获取到。

public class BeanLookupComponent implements BeanFactoryAware {
    private BeanFactory beanFactory;
    
    @Override
    public void setBeanFactory(BeanFactory beanFactory) throws BeansException {
        this.beanFactory=beanFactory;
    }
}

getBean方法是一系列的重载方法，可以实现按Bean的名称、类型获取到对应的bean，简单示例如下

@Override
public void run(ApplicationArguments args) throws Exception {
    //按名称获取
    Object liubei = beanFactory.getBean("liubei");
    //处理bean
    System.out.println(liubei);
    
    //按类型获取
    BeanDemo demo = beanFactory.getBean(BeanDemo.class);
    System.out.println(demo);
    
    //指定名称和类型（可自动转换类型）
    PersonEntity guanyu = beanFactory.getBean("guanyu", PersonEntity.class);
    System.out.println(guanyu);
}

以上这三种都是常用的获取Bean的API，但这几个API存在同样的问题，就是不能保证一定能获取到对应的Bean，为什么这么说呢？考虑以下几种情况

1. 当没有配置名称为 liubei的bean，通过 getBean("liubei")方法能得到什么
2. 按类型获取时，如果这个类型同时存在多个Bean，会得到什么结果

实际上，上边这两种做法都会报错

1. 第一种情况，程序直接终止，提示 A component required a bean named '***' that could not be found.
2. 第二种情况，抛出异常 NoUniqueBeanDefinitionException

安全的获取Bean

安全的获取单个Bean

除了上述几个获取Bean的API，Spring提供了 ObjectProvider<T>这一API能够相对安全的获取Bean，这里的安全意思是，当要获取的Bean不存在或存在多个时不会直接抛出异常。

对于只想获取一个Bean的情况可以采用如下方式

ObjectProvider<BeanDemo> beanProvider = beanFactory.getBeanProvider(BeanDemo.class);
BeanDemo uniqueBean = beanProvider.getIfUnique();
System.out.println(uniqueBean);

得到如下打印结果

DemoEntity{name='tong que tai', id=1}

当要获取的类型存在多个Bean时，下例中PersonEntity类型的Bean有多个

ObjectProvider<PersonEntity> personProvider = beanFactory.getBeanProvider(PersonEntity.class);
PersonEntity uniquePerson = personProvider.getIfUnique();
System.out.println(uniquePerson);

这是会返回一个空值，打印结果如下

null

当然，ObjectProvider也支持函数式编程的写法，上例的lambda等价写法如下

ObjectProvider<BeanDemo> beanProvider = beanFactory.getBeanProvider(BeanDemo.class);
beanProvider.ifUnique(demo-> System.out.println(demo));

安全的获取Bean列表

如果想获取到这一类型的全部Bean对象， ObjectProvider也是支持的，通过lambda表达式即可实现

ObjectProvider<PersonEntity> personProvider = beanFactory.getBeanProvider(PersonEntity.class);
personProvider.forEach(o-> System.out.println(o));

或者通过streamAPI进行其他操作，如

personProvider.stream().filter(o->o.getGender()== Gender.FEMALE).forEach(o-> System.out.println(o));

获取Bean集合

Spring提供了一些列根据类的名称获取对应类型的Bean名称的工具方法，这些方法都在 ListableBeanFactory接口中定义，同时在 DefaultListableBeanFactory类中提供了默认的实现，而一般情况下，我们通过实现 BeanFactoryAware接口而获得的 BeanFactory实际上就是 DefaultListableBeanFactory，因此这些方法可以直接使用。

通过类型获取Bean集合

根据类型获取所有Bean的名称可以这样做

if(beanFactory instanceof DefaultListableBeanFactory){
    DefaultListableBeanFactory listableBeanFactory = (DefaultListableBeanFactory) beanFactory;
    String[] beanNames = listableBeanFactory.getBeanNamesForType(PersonEntity.class);
    System.out.println(Arrays.toString(beanNames));
}

以上示例代码的打印结果为：

[zhangFei, guanyu, liubei, sunshangxiang]

getBeanNamesForType()方法还提供一个需要 ResolvableType类型的重载方法，用法类似

String[] beanNames2 = listableBeanFactory.getBeanNamesForType(ResolvableType.forType(PersonEntity.class));
System.out.println(Arrays.toString(beanNames2));

如果想直接获取到所有的Bean可以通过下面这个方法

Map<String, PersonEntity> beansOfType = listableBeanFactory.getBeansOfType(PersonEntity.class);
beansOfType.entrySet().forEach(entry-> System.out.println(entry.getKey() +" => "+entry.getValue().getName()));

这个方法获取到所有的 PersonEntity类型的Bean，并打印它们的姓名

zhangFei => zhang fei
guanyu => guan yu
liubei => liu bei
sunshangxiang => sun shangxiang

同时，getBeansOfType还存在一个重载方法，允许传入两个boolean的值，getBeansOfType(Class<T> type, boolean includeNonSingletons, boolean allowEagerInit)，后两个boolean值的说明

1. includeNonSingletons=>是否包括非单例的Bean，
2. allowEagerInit=>是否提前初始化延迟加载的Bean。但是由于这里是获取Bean的操作，即便不允许提前初始化在这里也会被初始化

通过注解获取Bean集合

除此之外，ListableBeanFactory还提供根据注解获取对应的Bean名称或Bean对象的方法，下列方法用户获取所有通过 @Component注解注册的Bean

//根据注解获取Bean的名称
String[] beanAnnoNames = listableBeanFactory.getBeanNamesForAnnotation(Component.class);
System.out.println(Arrays.toString(beanAnnoNames));

//根据注解获取Bean对象Map<Bean名称, Bean对象>
Map<String, Object> configBeans = listableBeanFactory.getBeansWithAnnotation(Component.class);
configBeans.entrySet().forEach((entry)->{
    System.out.println(entry.getKey()+" => "+entry.getValue().getClass());
});

以上代码的打印输出内容根据各自的配置不同，输出的内容也不同。注意，如果是Spring Boot项目输出的内容可能会比较多，因为SpringBoot为了方便开发内置注册了很多Bean。

我的输出内容是

[springNotesApplication, beanLookupComponent, appProperties, classPathProp, sourceProperties, org.springframework.boot.autoconfigure.context.PropertyPlaceholderAutoConfiguration, propertySourcesPlaceholderConfigurer, org.springframework.boot.autoconfigure.jmx.JmxAutoConfiguration, org.springframework.boot.autoconfigure.admin.SpringApplicationAdminJmxAutoConfiguration, org.springframework.boot.autoconfigure.aop.AopAutoConfiguration$ClassProxyingConfiguration, org.springframework.boot.autoconfigure.aop.AopAutoConfiguration, org.springframework.boot.autoconfigure.availability.ApplicationAvailabilityAutoConfiguration, org.springframework.boot.autoconfigure.context.ConfigurationPropertiesAutoConfiguration, org.springframework.boot.autoconfigure.context.LifecycleAutoConfiguration, org.springframework.boot.autoconfigure.info.ProjectInfoAutoConfiguration, org.springframework.boot.autoconfigure.task.TaskExecutionAutoConfiguration, org.springframework.boot.autoconfigure.task.TaskSchedulingAutoConfiguration]
springNotesApplication => class top.sunyog.spring.notes.SpringNotesApplication$$EnhancerBySpringCGLIB$$53408404
beanLookupComponent => class top.sunyog.spring.notes.auto.BeanLookupComponent
appProperties => class top.sunyog.spring.notes.prop.AppProperties
classPathProp => class top.sunyog.spring.notes.prop.ClassPathProp$$EnhancerBySpringCGLIB$$67bc2c5d
sourceProperties => class top.sunyog.spring.notes.prop.SourceProperties
org.springframework.boot.autoconfigure.context.PropertyPlaceholderAutoConfiguration => class org.springframework.boot.autoconfigure.context.PropertyPlaceholderAutoConfiguration
propertySourcesPlaceholderConfigurer => class org.springframework.context.support.PropertySourcesPlaceholderConfigurer
org.springframework.boot.autoconfigure.jmx.JmxAutoConfiguration => class org.springframework.boot.autoconfigure.jmx.JmxAutoConfiguration
org.springframework.boot.autoconfigure.admin.SpringApplicationAdminJmxAutoConfiguration => class org.springframework.boot.autoconfigure.admin.SpringApplicationAdminJmxAutoConfiguration
org.springframework.boot.autoconfigure.aop.AopAutoConfiguration$ClassProxyingConfiguration => class org.springframework.boot.autoconfigure.aop.AopAutoConfiguration$ClassProxyingConfiguration
org.springframework.boot.autoconfigure.aop.AopAutoConfiguration => class org.springframework.boot.autoconfigure.aop.AopAutoConfiguration
org.springframework.boot.autoconfigure.availability.ApplicationAvailabilityAutoConfiguration => class org.springframework.boot.autoconfigure.availability.ApplicationAvailabilityAutoConfiguration
org.springframework.boot.autoconfigure.context.ConfigurationPropertiesAutoConfiguration => class org.springframework.boot.autoconfigure.context.ConfigurationPropertiesAutoConfiguration
org.springframework.boot.autoconfigure.context.LifecycleAutoConfiguration => class org.springframework.boot.autoconfigure.context.LifecycleAutoConfiguration
org.springframework.boot.autoconfigure.info.ProjectInfoAutoConfiguration => class org.springframework.boot.autoconfigure.info.ProjectInfoAutoConfiguration
org.springframework.boot.autoconfigure.task.TaskExecutionAutoConfiguration => class org.springframework.boot.autoconfigure.task.TaskExecutionAutoConfiguration
org.springframework.boot.autoconfigure.task.TaskSchedulingAutoConfiguration => class org.springframework.boot.autoconfigure.task.TaskSchedulingAutoConfiguration

获取Bean上的注解

ListableBeanFactory还提供了一个可以获取到Bean上标注的注解的方法 findAnnotationOnBean(String beanName, Class annoType)，这个方法需要传入一个Bean名称beanName和一个注解的类型annoType，获取到这个Bean上标注的annoType注解，这个方法对于需要在运行时获取到Bean的描述业务逻辑非常重要。使用方法如下：

Qualifier zhangFeiQualifier = listableBeanFactory.findAnnotationOnBean("zhangFei", Qualifier.class);
System.out.println(zhangFeiQualifier.value());

这里需要把名称为 zhangFei的Bean配置做一下修改

@Bean
@Qualifier(value = "zhang")
public PersonEntity zhangFei(){
    return PersonEntity.bornMale("zhang fei");
}

此时输出结果为

zhang

总结

今天主要介绍了在Spring中如何获取Bean，Spring框架的最主要的作用就是管理Bean，Spring容器中存在着大量的、各种类型的Bean对象，因此了解Spring中有哪些方式可以获取到这些Bean对象就显得十分重要。本文主要介绍了 BeanFactory和 ListableBeanFactory两个容器中的获取Bean的方法，这两个接口也是Spring中的核心接口很多类都是基于这两个接口而扩展出来的，包括 AbstractApplicationContext、DefaultListableBeanFactory等

---

📩 联系方式
邮箱： qijilaoli@foxmail.com
掘金： 奇迹老李
微信公众号：奇迹老李

❗版权声明
本文为原创文章，版权归作者所有。未经许可，禁止转载。更多内容请访问奇迹老李的博客首页