Spring拓展接口之FactoryBean,我们来看看其源码实现

是什么

FactoryBean的源码比较简单,大家可以细读下其注释,我做了简单的如下翻译

/**

* 实现此接口的bean不能用作普通bean。此bean暴露的对象是通过getObject()创建的对象,而不是它自身

*/

public interface FactoryBean {

    /**

    * 返回此工厂管理的对象的实例(可能是共享的或独立的,取决于isSingleton()的返回值)

    */

    @Nullable

    T getObject() throws Exception;

    /**

    * 返回此FactoryBean创建的对象类型,

    */

    @Nullable

    Class getObjectType();

    /**

    * 该工厂管理的对象是否为单例?

    * 如果是(return true),getObject()总是返回同一个共享的实例,该对象会被BeanFactory缓存起来

    * 如果是(return false),getObject()返回独立的实例

    * 一般情况下返回true

    */

    default boolean isSingleton() {

        return true;

    }

}

说的简单点,FactoryBean是BeanFactory支持的、用来暴露bean实例的接口

有什么用

先带大家回忆下,目前我们配置bean主要有哪几种方式?

1、基于XML的配置方式

在xml文件中配置,例如

    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

    xsi:schemaLocation="http://www.springframework.org/schema/beans

    http://www.springframework.org/schema/beans/spring-beans-4.1.xsd">


   

       

       

spring的发布的第一版就支持,这个大家都知道

2、基于注解的配置方式

spring2.5开始支持,例如:@Compoment、@Repository、@Controller、@Service等,平时我们用的挺多的

3、基于Java类的配置方式

spring3.0开始支持,也是目前spring推荐的方式,@Configuration结合@Bean,springboot中用的非常多

一般情况下,Spring通过反射机制利用的class属性指定实现类实例化Bean,在某些情况下,实例化Bean过程比较复杂,如果按照传统的xml方式,则需要在中提供大量的配置信息。xml配置方式的灵活性是受限的,这时采用编码的方式可能会得到一个简单的方案。那么编码方式又有哪些了?spring3.0之后,编码的方式有基于注解、基于Java类以及基于FactoryBean,那么在spring2.5之前了,如何用xml方式配置实例化过程比较复杂的Bean?可以采用xml结合FactoryBean来实现,xml中配置FactoryBean,FactoryBean创建我们需要的、实例化过程比较复杂的Bean,示例核心代码如下,从spring容器获取name为user的bean实例,获取到的是User类型的Bean

xml配置

    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

    xsi:schemaLocation="http://www.springframework.org/schema/beans

    http://www.springframework.org/schema/beans/spring-beans-4.1.xsd">


   

UserFactoryBean

package com.lee.factorybean.config;

import com.lee.factorybean.entity.User;

import org.springframework.beans.factory.FactoryBean;

public class UserFactoryBean implements FactoryBean {

    @Override

    public User getObject() throws Exception {

        // 假设User的实例化过程比较复杂,在此处进行User的实例化

        return new User();

    }

    @Override

    public Class getObjectType() {

        return User.class;

    }

    @Override

    public boolean isSingleton() {

        return true;

    }

}

spring2.5之前,只能通过xml的配置方式将Bean注册到spring管理,但是xml的配置方式又不够灵活,配置实例化过程比较复杂的Bean比较麻烦,所有结合FactoryBean,既能采用编码的方式构建实例化过程比较复杂的Bean,也能将Bean交由Spring管理;spring2.5之后,特别是spring3.0之后,注册实例化过程比较复杂的Bean到spring容器的方式就比较多了(可采用的编码方式比较多),FactoryBean的方式也一直被spring支持。

说的再简单点,通过FactoryBean可以创建实例化过程比较复杂的Bean,至于我们以何种方式将FactoryBean的实例注册到Spring容器,在不同的spring版本,可以采用不同的方式

怎么用

我们通过一个简单的示例来看看FactoryBean到底是怎么用的

应用示例

UserFactoryBean

package com.lee.factorybean.config;

import com.lee.factorybean.entity.User;

import org.springframework.beans.factory.FactoryBean;

import org.springframework.stereotype.Component;

@Component("user")          // beanName = user

public class UserFactoryBean implements FactoryBean {

    @Override

    public User getObject() throws Exception {

        // 假设User的实例化过程比较复杂,在此处进行User的实例化

        return new User();

    }

    @Override

    public Class getObjectType() {

        return User.class;

    }

    @Override

    public boolean isSingleton() {

        return true;

    }

}

User

package com.lee.factorybean.entity;

public class User {

    private Integer id;

    private String name;

    private Integer age;

    public Integer getId() {

        return id;

    }

    public void setId(Integer id) {

        this.id = id;

    }

    public String getName() {

        return name;

    }

    public void setName(String name) {

        this.name = name;

    }

    public Integer getAge() {

        return age;

    }

    public void setAge(Integer age) {

        this.age = age;

    }

}

FactoryBeanTest

package com.lee.factorybean.test;

import com.lee.factorybean.FactoryBeanApplication;

import org.junit.Test;

import org.junit.runner.RunWith;

import org.springframework.beans.factory.BeanFactory;

import org.springframework.beans.factory.annotation.Autowired;

import org.springframework.boot.test.context.SpringBootTest;

import org.springframework.test.context.junit4.SpringRunner;

@RunWith(SpringRunner.class)

@SpringBootTest

public class FactoryBeanTest {

    @Autowired

    private BeanFactory beanFactory;

    @Test

    public void test() {

        Object user = beanFactory.getBean("user");

        System.out.println(user.getClass().getName());

    }

}

我们运行测试用例,发现输出的结果是:com.lee.factorybean.entity.User,而不是:com.lee.factorybean.config.UserFactoryBean

spring中的FactoryBean实现

Spring自身就提供了很多FactoryBean的实现(spring版本不一样,实现数量不一样),springboot2.0.3(对应spring5.0.7)中FactoryBean实现有如下

除了我们自定义的UserFactoryBean,有60个是springboot中的实现,其中有50多个是spring中的实现;有兴趣的可以细看下,注意springboot版本,如果直接用的spring,则注意spring的版本

实际工作中,我们自己实现FactoryBean的场景非常少,反正我工作中是用的非常少,印象中有,但感觉是很久之前的事了;Spring中有很多FactoryBean的实现,也有很多第三方的实现,比如MyBatis的MapperFactoryBean、druid的JdbcStatManagerFactoryBean、shiro的ShiroFilterFactoryBean等等。用不用FactoryBean,全看我们个人,但我们一定得知道FactoryBean,当我们碰到FactoryBean的实现时(读源码很容易碰到),我们一眼就能明白其意图,当我们需要构建实例化过程比较复杂的Bean时,FactoryBean也是一种可选的方案

为什么

具体问题应该是这样的:上述示例中,为什么从spring容器获取的name为user的实例,其类型是User,而不是UserFactoryBean;抽象的问题:根据FactoryBean实例的name获取的为什么不是FactoryBean实例,而是FactoryBean实例的getObject()返回的对象? 

源码探究

我们就以beanFactory.getBean("user");为断点入口

@Test

public void test() {

        // 断点入口

    Object user = beanFactory.getBean("user");

    System.out.println(user.getClass().getName());

}

一开始从spring容器获取名为user的bean,类型确实是:UserFactoryBean,但是后面又经过getObjectForBeanInstance来真正获取我们需要的对象

bean = getObjectForBeanInstance(sharedInstance, name, beanName, null);

/**

* 获取实例对象

* 可能是beanInstance自身,也可能是beanInstance创建的对象(如果beanInstance是FactoryBean类型)

*/

protected Object getObjectForBeanInstance(

        Object beanInstance, String name, String beanName, @Nullable RootBeanDefinition mbd) {

    // name以工厂引用(&)开头,可以跟下isFactoryDereference方法

    if (BeanFactoryUtils.isFactoryDereference(name)) {

        if (beanInstance instanceof NullBean) {

            return beanInstance;

        }

        // 如果name以&开头,而beanInstance不是FactoryBean类型,则抛异常(我们没按spring规则来使用)

        if (!(beanInstance instanceof FactoryBean)) {

            throw new BeanIsNotAFactoryException(transformedBeanName(name), beanInstance.getClass());

        }

    }

    // 如果beanInstance不是FactoryBean类型,则直接返回beanInstance

    // 或者name以&开头,也直接返回beanInstance,说明我们就想获取FactoryBean实例

    if (!(beanInstance instanceof FactoryBean) || BeanFactoryUtils.isFactoryDereference(name)) {

        return beanInstance;

    }

    Object object = null;

    if (mbd == null) {

        object = getCachedObjectForFactoryBean(beanName);

    }

    if (object == null) {

        // 此时beanInstance是FactoryBean类型,而name又不是以&开头; 这是我们示例工程的情况,也是最普通、用的最多的情况

        // 将beanInstance强转成FactoryBean类型

        FactoryBean factory = (FactoryBean) beanInstance;

        // 从缓存中获取我们需要的实例对象

        if (mbd == null && containsBeanDefinition(beanName)) {

            mbd = getMergedLocalBeanDefinition(beanName);

        }

        boolean synthetic = (mbd != null && mbd.isSynthetic());

        // 调用FactoryBean的getObject方法创建我们需要的实例对象;大家自行跟下getObjectFromFactoryBean

        object = getObjectFromFactoryBean(factory, beanName, !synthetic);

    }

    return object;

}

根据name从spring容器获取实例,如果该实例不是FactoryBean类型,则直接返回该实例,这也是我们平时用的最多的、最普通的情况;如果该实例是FactoryBean类型,而name又是以&开头,也直接返回该实例,说明我们想要的就是FactoryBean实例;如果name不是以&开头,而该实例又是FactoryBean类型,则会调用该实例的getObject()来创建我们需要的目标实例

如何获取FactoryBean实例

这个答案在上面已经有了,通过在name前加&即可,如下

@Test

public void test() {

    Object user = beanFactory.getBean("&user");

    System.out.println(user.getClass().getName());

}

输出结果如下

com.lee.factorybean.config.UserFactoryBean

总结

1、FactoryBean是BeanFactory支持的、用来暴露bean实例的接口,可以实现此接口来完成实例化过程比较复杂的bean的创建;

2、通过beanName从spring容器获取bean实例时,一开始获取的是beanName直接关联的bean实例,后续spring容器会根据此bean实例返回我们需要的对象实例;如果bean实例不是FactoryBean类型,则直接返回bean实例,如果bean实例是FactoryBean类型,而beanName又是以&开头,直接返回bean实例,如果bean实例是FactoryBean类型,而beanName不是以&开头,则返回bean实例的getObject()方法获取的对象实例(一般getObject中就是我们需要的实例对象的创建过程);

3、对于创建过程比较复杂的对象的创建,目前spring其实有很多实现方式了,而FactoryBean只是其中一种,也许我们不会采用此种方式来实现实例对象的创建,但我们需要能够看懂此种方式,知道有这种实现方式;很多第三方都沿用了此种方式,我们去追源码的时候,很容易就能碰到;

4、相比普通bean的创建,FactoryBean的方式会在spring容器中多存在一个FactoryBean的实例,若想获取FactoryBean实例对象,只需要在FactoryBean的beanName加&即可;

欢迎工作一到五年的Java工程师朋友们加入Java程序员开发: 721575865

群内提供免费的Java架构学习资料(里面有高可用、高并发、高性能及分布式、Jvm性能调优、Spring源码,MyBatis,Netty,Redis,Kafka,Mysql,Zookeeper,Tomcat,Docker,Dubbo,Nginx等多个知识点的架构资料)合理利用自己每一分每一秒的时间来学习提升自己,不要再用"没有时间“来掩饰自己思想上的懒惰!趁年轻,使劲拼,给未来的自己一个交代!

你可能感兴趣的:(Spring拓展接口之FactoryBean,我们来看看其源码实现)