Springboot扩展点之SmartInitializingSingleton
前言
这篇文章会重点分析一下SmartInitializingSingleton扩展点的功能 特性、实现方式 、工作原理。SmartInitializingSingleton扩展点内只有一个扩展方法，且执行时机在Spring Bean的生命周期里比较靠后，很重要，但是也很简单。
功能特性
1、SmartInitializingSingleton主要用于在Spring容器启动完成时进行扩展操作，即afterSingletonsInstantiated()；
2、实现SmartInitializingSingleton接口的bean的作用域必须是单例，afterSingletonsInstantiated()才会触发；
3、afterSingletonsInstantiated()触发执行时，非懒加载的单例bean已经完成实现化、属性注入以及相关的初始化操作；
3、afterSingletonsInstantiated()的执行时机是在DefaultListableBeanFactory#preInstantiateSingletons()；
关于Spring bean有七种作用域：默认singleton(单例)、prototype、request、session、globalSession、application、websocket；
1、singleton(单例)：Spring容器只会创建一个bean对象；
2、prototype：每次获取bean都会重新创建一个bean对象；
3、request：对于每一个http请求，在同一个请求内Spring容器只会创建一个bean对象，若请求结束，bean也随之销毁；
4、session：在同一个http会话里，Spring容器只会创建一个bean对象，若传话结束，也随之销毁；
5、globalSession：globalSession作用域的效果与session作用域类似，但是只适用于基于portlet的web应用程序中
6、application：在servlet程序中，该作用域的bean将会作为ServletContext对象的属性，被全局访问，与singleton的区别就是，singleton作用域的bean在Spring容器中只一；application作用域的bean在ServletContex中唯一；
7、websocket：为每个websocket对象创建一个实例。仅在Web相关的ApplicationContext中生效。
实现方式
这里用一个示例验证SmartInitializingSingleton的功能特性，并且通过debug分析其工作过程：
1、定义Dog类，以setter注入方式进行属性注入，同时Dog类实现SmartInitializingSingleton接口，重写afterSingletonsInstantiated()，并在方法内部打印日志，如果在实际业务开发过程中用到了这个扩展点，相关的扩展操作逻辑就是在这个方法内实现；
@Slf4j
public class Dog implements InitializingBean, DisposableBean, SmartInitializingSingleton {private String name = "wang cai";private Food food;public Dog() {log.info("----Dog的无参构造方法被执行");}@Autowiredpublic void setFood(Food food) {this.food = food;log.info("----dog的food属性被注入");}@Overridepublic void afterPropertiesSet() throws Exception {log.info("----com.fanfu.entity.Dog.afterPropertiesSet触发执行");}public void myInitMethod() {log.info("----com.fanfu.entity.Dog.myInitMethod触发执行");}@Overridepublic void destroy() throws Exception {log.info("----com.fanfu.entity.Dog.destroy触发执行");}@Overridepublic void afterSingletonsInstantiated() {log.info("----com.fanfu.entity.Dog.afterSingletonsInstantiated触发执行");}
}2、定义Food类，作为Dog类的一个属性；
@Slf4j
public class Food {private String name = "大骨头";public Food() {log.info("----Food的无参数构造方法被执行");}
}3、使用Configuration配置类的方式注册Dog、Food到Spring容器里；默认是单例对象；
@Configuration
public class SpringConfig {@Bean(initMethod = "myInitMethod")public Dog dog(){Dog dog = new Dog();return dog;}@Beanpublic Food food(){Food food = new Food();return food;}
}4、单元测试，用于验证结果；
@Testpublic void test5(){log.info("----单元测试执行开始");AnnotationConfigApplicationContext context = new AnnotationConfigApplicationContext("com.fanfu");log.info("----单元测试执行完毕");}
工作原理
如果我分享的关于Springboot扩展点系统的文章，从头都一点一点自己debug看过的话，一定对AbstractApplicationContext#refresh()不陌生，与Spring容器启动相关的核心逻辑都在这个方法中。
1、在AbstractApplicationContext#refresh()中，会发现调用了finishBeanFactoryInitialization()，从上面的注释可以看出，这个方法昌要实例化所有非懒加载的单例bean；
2、进入到finishBeanFactoryInitialization()方法内，做了一些beanFactory的准备工作后，调用preInstantiateSingletons()开始非懒加载的单例bean实例化；
3、继续往下实际上是调用 了DefaultListableBeanFactory#preInstantiateSingletons()，单独看这个方法，逻辑相对简单，分为两部分：第一部分，bean的实例化、属性注入、相关初始化操作；第二部分，找出所有实现了SmartInitializingSingleton接口的实现类，遍历并执行afterSingletonsInstantiated()；
public void preInstantiateSingletons() throws BeansException {//----------start------------------实例化bean----------------------------------------if (logger.isTraceEnabled()) {logger.trace("Pre-instantiating singletons in " + this);}List<String> beanNames = new ArrayList<>(this.beanDefinitionNames);// Trigger initialization of all non-lazy singleton beans...for (String beanName : beanNames) {RootBeanDefinition bd = getMergedLocalBeanDefinition(beanName);if (!bd.isAbstract() && bd.isSingleton() && !bd.isLazyInit()) {if (isFactoryBean(beanName)) {Object bean = getBean(FACTORY_BEAN_PREFIX + beanName);if (bean instanceof FactoryBean) {FactoryBean<?> factory = (FactoryBean<?>) bean;boolean isEagerInit;if (System.getSecurityManager() != null && factory instanceof SmartFactoryBean) {isEagerInit = AccessController.doPrivileged((PrivilegedAction<Boolean>) ((SmartFactoryBean<?>) factory)::isEagerInit,getAccessControlContext());}else {isEagerInit = (factory instanceof SmartFactoryBean &&((SmartFactoryBean<?>) factory).isEagerInit());}if (isEagerInit) {getBean(beanName);}}}else {getBean(beanName);}}}//----------end------------------实例化bean----------------------------------------//----------start------------------SmartInitializingSingleton#afterSingletonsInstantiated----------------------------------------for (String beanName : beanNames) {Object singletonInstance = getSingleton(beanName);//判断单例bean是否实现了SmartInitializingSingleton接口if (singletonInstance instanceof SmartInitializingSingleton) {SmartInitializingSingleton smartSingleton = (SmartInitializingSingleton) singletonInstance;if (System.getSecurityManager() != null) {AccessController.doPrivileged((PrivilegedAction<Object>) () -> {smartSingleton.afterSingletonsInstantiated();return null;}, getAccessControlContext());}else {//执行afterSingletonsInstantiated()smartSingleton.afterSingletonsInstantiated();}}}//----------start------------------SmartInitializingSingleton#afterSingletonsInstantiated----------------------------------------
}总结
如果要在业务开发中使用SmartInitializingSingleton扩展点，需要特别注意实现这个接口的bean应该是非懒加载的单例bean，执行时机是在bean完成实例化、属性注入、相关初始化操作后，否则无法触发执行。