前言

Spring 很复杂,很多东西都很难完全深入了解,这里写下Bean 的初始化的分析,主要是为了解SpringBoot 与Shiro 整合时,引起的事务失败问题,网上很多说是初始化顺序引起没有生成事务代理类而导致失败。为了知其然知其所以然的原则,决定了解了解。

以下分析基于Spring 5.1.9.RELEASE、shiro1.4.0

一、Bean 初始化过程

1. Bean初始化入口:ApplicationContext

Application 继承结构图
ApplicationContext-Level.png

2. Bean 的生命周期图示

bean_lifecycle.png

生命周期相关步骤解析:

注意: Spring 只帮我们管理单例模式 Bean 的完整生命周期,对于 prototype 的 bean ,Spring 在创建好交给使用者之后则不会再管理后续的生命周期。

  1. 通过反射,实例化Bean
  2. 依赖注入推荐使用setter 方法(主要注入方法:setter注入constructor构造器注入)
  3. 当依赖注入完成,以下接口方法将会回调:BeanNameAware.setBeanName(String name);该方法是在Bean Factory 创建bean 时,设置Bean的名称
  4. 然后调用: BeanClassLoaderAware.setBeanClassLoader(), 设置类加载器加载Bean 实例
  5. 然后调用: BeanFactoryAware.setBeanFactory(BeanFactory beanFactory) ,为当前的Bean 设置Bean Factory
  6. 容器调用: BeanPostProcessor.postProcessBeforeInitialization, 回调该方法,可将原始bean包装成任意成对像返回
  7. 然后如果方法上有注解@PostConstruct 则会被调用(注意:这里需要开启组件扫描,以便对注解进行处理)
  8. 在注解@PostConstruct 方法调用后,回调接口方法InitializingBean.afterPropertiesSet()
  9. 调用在xml 配置中bean 标签属性init-method 定义的方法
  10. 然后调用 BeanPostProcessor.postProcessAfterInitialization(), 调用该方法,用于包装原始bean
  11. 到目前为止,bean已经初始化,可以使用了
  12. 当ApplicationContext 销毁钩子registerShutdownHook() 调用(调用后不是会立即销毁), 有注解@PreDestroy 等销毁方法会被调用
  13. 然后接着调用Bean 实现接口 DisposableBean.destroy() 方法
  14. 然后调用在xml 配置中bean 标签属性 destroy-method 的方法
  15. 垃圾回收器会自动调用Object 类的finalize() 方法销毁对象

    初始化回调的方法

  16. 接口InitializingBean 的afterPropertiesSet() 方法,Spring 不推荐使用

  17. 注解@PostConstruct的方法
  18. xml配置中bean标签属性 init-method 指定的方法 或 JavaConfig 注解@Bean 中属性initMethod 指定的方法
  19. 如果以上上三种方法都使用了,则按以下顺序执行

    1. 先调用注解@PostConstruct的方法
    2. 再调用 接口InitializingBean 的afterPropertiesSet() 方法
    3. 然后才调用 xml 配置的 init-method 指定方法 或 Java配置中的initMethod 指定的方法

      销毁回调的方法

  20. 接口DisposableBean的 destroy(), Spring 不推荐使用

  21. 推荐使用 注解@PreDestroy标识的方法 或 在xml 配置 bean 标签属性destroy-method 定义的方法(Java 配置中,注解@Bean 属性destroyMethod 定义的方法)
  22. 如果以上方法都配置,则按以下顺序执行
    1. 注解@PreDestroy 标识的方法先执行
    2. 然后执行在xml 配置 bean 标签属性destroy-method 定义的方法(Java 配置中,注解@Bean 属性destroyMethod 定义的方法)
    3. 最后执行接口DisposableBean的 destroy()

      二、例子

      1. 创建Maven 项目

      添加Spring 依赖
      1. <dependency>
      2. <groupId>org.springframework</groupId>
      3. <artifactId>spring-context</artifactId>
      4. <version>5.1.9.RELEASE</version>
      5. </dependency>

      2. 创建Student 类,并实现相关接口

  1. public class Student implements InitializingBean, DisposableBean,
  2. BeanFactoryAware, BeanNameAware {
  3. private String name;
  4. private Integer age;
  5. public Student() {
  6. System.out.println("初始化构造函数");
  7. }
  8. public String getName() {
  9. return name;
  10. }
  11. public void setName(String name) {
  12. this.name = name;
  13. }
  14. public Integer getAge() {
  15. return age;
  16. }
  17. public void setAge(Integer age) {
  18. this.age = age;
  19. }
  20. @PostConstruct
  21. public void springPostConstruct() {
  22. System.out.println("---@PostConstruct--- 执行");
  23. }
  24. @Override
  25. public void afterPropertiesSet() throws Exception {
  26. System.out.println("---InitializingBean.afterPropertiesSet---");
  27. }
  28. public void myInitMethod() {
  29. System.out.println("---init-method---");
  30. }
  31. @Override
  32. public String toString() {
  33. return "Student{" +
  34. "name='" + name + '\'' +
  35. ", age=" + age +
  36. '}';
  37. }
  38. @Override
  39. public void setBeanName(String name) {
  40. System.out.println("---BeanNameAware.setBeanName---");
  41. }
  42. @Override
  43. public void setBeanFactory(BeanFactory beanFactory) throws BeansException {
  44. System.out.println("---BeanFactoryAware.setBeanFactory---");
  45. }
  46. @PreDestroy
  47. public void springPreDestroy(){
  48. System.out.println("-----@PreDestroy-----");
  49. }
  50. @Override
  51. public void destroy() throws Exception {
  52. System.out.println("-----DisposableBean.destroy()------");
  53. }
  54. public void myDestroyMethod(){
  55. System.out.println("---destroy-method---");
  56. }
  57. }

3. 创建BeanPostProcessor 自定义实现类

  1. public class MyBeanPostProcessor implements BeanPostProcessor {
  2. @Override
  3. public Object postProcessAfterInitialization(Object bean, String beanName)
  4. throws BeansException {
  5. System.out.println("BeanPostProcessor.postProcessAfterInitialization");
  6. return bean;
  7. }
  8. @Override
  9. public Object postProcessBeforeInitialization(Object bean, String beanName)
  10. throws BeansException {
  11. System.out.println("BeanPostProcessor.postProcessBeforeInitialization");
  12. return bean;
  13. }
  14. }

4. 使用xml配置Bean

  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <beans xmlns="http://www.springframework.org/schema/beans"
  3. xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  4. xmlns:context="http://www.springframework.org/schema/context"
  5. xsi:schemaLocation="http://www.springframework.org/schema/beans
  6. http://www.springframework.org/schema/beans/spring-beans.xsd
  7. http://www.springframework.org/schema/util
  8. https://www.springframework.org/schema/util/spring-util.xsd
  9. http://www.springframework.org/schema/context
  10. https://www.springframework.org/schema/context/spring-context.xsd">
  11. <!--组件扫描-->
  12. <context:component-scan base-package="cn.hdj"/>
  13. <!--配置bean, 加载的顺序由上到下,先定义的Bean先初始化-->
  14. <bean id="student" class="cn.hdj.entity.Student" init-method="myInitMethod" destroy-method="myDestroyMethod"/>
  15. <bean id="myBeanPostProcessor" class="cn.hdj.MyBeanPostProcessor"/>
  16. </beans>

5. 实例化上下文

  1. public static void main(String[] args) {
  2. AbstractApplicationContext context = new ClassPathXmlApplicationContext("classpath:application-Context.xml");
  3. Student bean = context.getBean(Student.class);
  4. System.out.println(bean);
  5. context.registerShutdownHook();
  6. }

6. 启动项目,输出结果

  1. 初始化构造函数
  2. ---BeanNameAware.setBeanName---
  3. ---BeanFactoryAware.setBeanFactory---
  4. BeanPostProcessor.postProcessBeforeInitialization
  5. ---@PostConstruct--- 执行
  6. ---InitializingBean.afterPropertiesSet---
  7. ---init-method---
  8. BeanPostProcessor.postProcessAfterInitialization
  9. Student{name='null', age=null}
  10. -----@PreDestroy-----
  11. -----DisposableBean.destroy()------
  12. ---destroy-method---

以上就是Bean 初始化的过程,如果说我们想要对Bean 初始化过程中,对Bean 做一些处理,那么接下来我们需要了解一下,Spring 为我们提供的扩展点接口。

三、Aware 接口

*Aware 接口可以用于在初始化 bean 时获得 Spring 中的一些对象,如获取 Spring 上下文等。 以下为Spring 提供的*Aware接口

Aware 接口 实现的方法 作用(在Bean 构造函数初始后回调,但在初始化回调方法前调用)
ApplicationContextAware void setApplicationContext(ApplicationContext applicationContext) throws BeansException; Interface to be implemented by any object that wishes to be notified of the ApplicationContext that it runs in.
ApplicationEventPublisherAware void setApplicationEventPublisher(ApplicationEventPublisher applicationEventPublisher); Set the ApplicationEventPublisher that this object runs in.
BeanClassLoaderAware void setBeanClassLoader (ClassLoader classLoader); Callback that supplies the bean class loader to a bean instance.
BeanFactoryAware void setBeanFactory (BeanFactory beanFactory) throws BeansException; Callback that supplies the owning factory to a bean instance.
BeanNameAware void setBeanName(String name); Set the name of the bean in the bean factory that created this bean.
BootstrapContextAware void setBootstrapContext (BootstrapContext bootstrapContext); Set the BootstrapContext that this object runs in.
LoadTimeWeaverAware void setLoadTimeWeaver (LoadTimeWeaver loadTimeWeaver); Set the LoadTimeWeaver of this object’s containing ApplicationContext.
MessageSourceAware void setMessageSource (MessageSource messageSource); Set the MessageSource that this object runs in.
NotificationPublisherAware void setNotificationPublisher(NotificationPublisher notificationPublisher); Set the NotificationPublisher instance for the current managed resource instance.
PortletConfigAware void setPortletConfig (PortletConfig portletConfig); Set the PortletConfig this object runs in.
PortletContextAware void setPortletContext (PortletContext portletContext); Set the PortletContext that this object runs in.
ResourceLoaderAware void setResourceLoader (ResourceLoader resourceLoader); Set the ResourceLoader that this object runs in.
ServletConfigAware void setServletConfig (ServletConfig servletConfig); Set the ServletConfig that this object runs in.
ServletContextAware void setServletContext (ServletContext servletContext); Set the ServletContext that this object runs in.

四、增强处理器

种类

  1. BeanPostProcessor
    2. BeanFactoryPostProcessor (不在Bean 生命周期内)

    增强处理器处理过程

Spring系列之Bean 生命周期分析 - 图3

增强处理器的特点

  • BeanFactoryPostProcessor是加载Bean定义后执行
  • BeanPostProcessor 则是在Bean 初始化和依赖注入后执行
  • 如果你在一个容器内定义了增强处理器,它就只作用于这个容器内的bean,即使其它容器与该容器有相同的层级关系
  • 想要控制多个处理器的处理顺序,可以实现Order 接口来控制,数值越小,优先级越大

BeanFactoryPostProcessor的接口定义

  1. public interface BeanFactoryPostProcessor {
  2. void postProcessBeanFactory(ConfigurableListableBeanFactory beanFactory);
  3. }

BeanPostProcessor 的接口定义

  1. public interface BeanPostProcessor {
  2. //前置处理
  3. @Nullable
  4. default Object postProcessBeforeInitialization(Object bean, String beanName) throws BeansException {
  5. return bean;
  6. }
  7. //后置处理
  8. @Nullable
  9. default Object postProcessAfterInitialization(Object bean, String beanName) throws BeansException {
  10. return bean;
  11. }
  12. }

BeanPostProcessor 的注册过程?

  1. //用于实例化和注册BeanPostProcessor
  2. protected void registerBeanPostProcessors(ConfigurableListableBeanFactory beanFactory) {
  3. PostProcessorRegistrationDelegate.registerBeanPostProcessors(beanFactory, this);
  4. }
  5. public static void registerBeanPostProcessors(
  6. ConfigurableListableBeanFactory beanFactory, AbstractApplicationContext applicationContext) {
  7. String[] postProcessorNames = beanFactory.getBeanNamesForType(BeanPostProcessor.class, true, false);
  8. // Register BeanPostProcessorChecker that logs an info message when
  9. // a bean is created during BeanPostProcessor instantiation, i.e. when
  10. // a bean is not eligible for getting processed by all BeanPostProcessors.
  11. int beanProcessorTargetCount = beanFactory.getBeanPostProcessorCount() + 1 + postProcessorNames.length;
  12. beanFactory.addBeanPostProcessor(new BeanPostProcessorChecker(beanFactory, beanProcessorTargetCount));
  13. // 区分不同优先级的BeanPostProcessor
  14. //优先级分别有:PriorityOrdered,Ordered和其他的
  15. List<BeanPostProcessor> priorityOrderedPostProcessors = new ArrayList<>();
  16. List<BeanPostProcessor> internalPostProcessors = new ArrayList<>();
  17. List<String> orderedPostProcessorNames = new ArrayList<>();
  18. List<String> nonOrderedPostProcessorNames = new ArrayList<>();
  19. for (String ppName : postProcessorNames) {
  20. if (beanFactory.isTypeMatch(ppName, PriorityOrdered.class)) {
  21. //实现了接口PriorityOrdered的BeanPostProcessor
  22. //会优先实例化
  23. BeanPostProcessor pp = beanFactory.getBean(ppName, BeanPostProcessor.class);
  24. priorityOrderedPostProcessors.add(pp);
  25. if (pp instanceof MergedBeanDefinitionPostProcessor) {
  26. internalPostProcessors.add(pp);
  27. }
  28. }
  29. else if (beanFactory.isTypeMatch(ppName, Ordered.class)) {
  30. orderedPostProcessorNames.add(ppName);
  31. }
  32. else {
  33. nonOrderedPostProcessorNames.add(ppName);
  34. }
  35. }
  36. // 首先对实现了接口 PriorityOrdered.的BeanPostProcessor进行排序
  37. //然后注册
  38. sortPostProcessors(priorityOrderedPostProcessors, beanFactory);
  39. registerBeanPostProcessors(beanFactory, priorityOrderedPostProcessors);
  40. // 接着对实现了接口 Ordered.的BeanPostProcessor进行排序
  41. //然后注册
  42. List<BeanPostProcessor> orderedPostProcessors = new ArrayList<>();
  43. for (String ppName : orderedPostProcessorNames) {
  44. BeanPostProcessor pp = beanFactory.getBean(ppName, BeanPostProcessor.class);
  45. orderedPostProcessors.add(pp);
  46. if (pp instanceof MergedBeanDefinitionPostProcessor) {
  47. internalPostProcessors.add(pp);
  48. }
  49. }
  50. sortPostProcessors(orderedPostProcessors, beanFactory);
  51. registerBeanPostProcessors(beanFactory, orderedPostProcessors);
  52. // 再接着对普通的BeanPostProcessor进行排序
  53. //然后注册
  54. List<BeanPostProcessor> nonOrderedPostProcessors = new ArrayList<>();
  55. for (String ppName : nonOrderedPostProcessorNames) {
  56. BeanPostProcessor pp = beanFactory.getBean(ppName, BeanPostProcessor.class);
  57. nonOrderedPostProcessors.add(pp);
  58. if (pp instanceof MergedBeanDefinitionPostProcessor) {
  59. internalPostProcessors.add(pp);
  60. }
  61. }
  62. registerBeanPostProcessors(beanFactory, nonOrderedPostProcessors);
  63. //最后对内部定义的BeanPostProcessor进行排序,然后注册
  64. sortPostProcessors(internalPostProcessors, beanFactory);
  65. registerBeanPostProcessors(beanFactory, internalPostProcessors);
  66. //重新注册用于将内部bean检测为ApplicationListener的后处理器,
  67. //将其移到处理器链的末尾(for picking up proxies etc)。
  68. beanFactory.addBeanPostProcessor(new ApplicationListenerDetector(applicationContext));
  69. }

BeanPostProcessor按优先级分为PriorityOrdered,Ordered和其他的,对他们分别进行以下操作。

  • 先beanFactory.getBean进行实例化,
  • 再使用sortPostProcessors() 进行排序
  • 最后registerBeanPostProcessors()进行注册。

所以,优先级高Bpp的先被实例化,而优先级低的Bpp在实例化时可以应用优先级高的(不过同级或优先级低的不行,因为还没初始化)

那问题来了,BeanPostProcessor依赖的Bean, 导致其提前初始化,有什么后果?
根据BeanPostProcessor 的注册过程,我们可以知道如果Bean 被优先级高的Bpp依赖而导致提前初始化,那么这个Bean 就不会在被其他优先级低的Bpp处理(Bpp还没初始化); 例如典型的例子就是 auto-proxy,因为
AutowiredAnnotationBeanPostProcessor(用于处理依赖注入的Bpp)的优先级是PriorityOrdered, 而AnnotationAwareAspectJAutoProxyCreator(用于 auto-proxy)的优先级是Ordered, 如果Bean 在AnnotationAwareAspectJAutoProxyCreator注册前实例化,那么这个Bean依赖注入时,就不会以代理类(JDK代理或CGlib代理)的形式注入

解决的方法:  1. 对依赖的Bean 添加@Lazy(懒加载注解),2. 使用注解@DependsOn

五、Spring 整合Shiro 引起事务失败问题解答

1.问题原因

  • 在DbShiroRealm 中注入UserService时,未加懒加载注解@Lazy ,打印的Bean 实例化顺序

image.png

  • Shiro 的配置
  1. @Configuration
  2. public class ShiroConfig {
  3. /**
  4. * 验证过滤器
  5. *
  6. * @return
  7. */
  8. @Bean
  9. public JwtAuthFilter jwtAuthFilter() {
  10. JwtAuthFilter authFilter = new JwtAuthFilter();
  11. return authFilter;
  12. }
  13. /**
  14. * 不加入Servlet Filter中
  15. *
  16. * @return
  17. */
  18. @Bean
  19. public FilterRegistrationBean filterRegistrationBean() {
  20. FilterRegistrationBean filterRegistrationBean = new FilterRegistrationBean();
  21. filterRegistrationBean.setFilter(jwtAuthFilter());
  22. filterRegistrationBean.setEnabled(false);
  23. return filterRegistrationBean;
  24. }
  25. @Bean
  26. public Realm dbShiroRealm() {
  27. DbShiroRealm myShiroRealm = new DbShiroRealm();
  28. myShiroRealm.setCredentialsMatcher(new HashedCredentialsMatcher(Sha256Hash.ALGORITHM_NAME));
  29. return myShiroRealm;
  30. }
  31. @Bean
  32. public Realm jwtShiroRealm() {
  33. JwtShiroRealm myShiroRealm = new JwtShiroRealm();
  34. myShiroRealm.setCredentialsMatcher(new JwtCredentialsMatcher());
  35. return myShiroRealm;
  36. }
  37. /**
  38. * 关闭session
  39. *
  40. * @return
  41. */
  42. @Bean
  43. public SessionStorageEvaluator sessionStorageEvaluator() {
  44. DefaultWebSessionStorageEvaluator sessionStorageEvaluator = new DefaultWebSessionStorageEvaluator();
  45. sessionStorageEvaluator.setSessionStorageEnabled(false);
  46. return sessionStorageEvaluator;
  47. }
  48. /**
  49. * 验证器
  50. *
  51. * @return
  52. */
  53. @Bean
  54. public Authenticator authenticator() {
  55. MyModularRealmAuthenticator authenticator = new MyModularRealmAuthenticator();
  56. return authenticator;
  57. }
  58. /**
  59. * 设置过滤器链
  60. */
  61. @Bean("shiroFilter")
  62. public ShiroFilterFactoryBean shiroFilterFactoryBean(SecurityManager securityManager) {
  63. ShiroFilterFactoryBean factoryBean = new ShiroFilterFactoryBean();
  64. //设置登陆的url
  65. factoryBean.setLoginUrl("/api/admin/user/signIn");
  66. factoryBean.setSecurityManager(securityManager);
  67. //设置过滤器
  68. Map<String, Filter> filters = factoryBean.getFilters();
  69. filters.put("authToken", jwtAuthFilter());
  70. factoryBean.setFilters(filters);
  71. // 自定义url规则使用LinkedHashMap有序Map
  72. Map<String, String> filterMap = new LinkedHashMap<>();
  73. // 两个url规则都可以匹配同一个url,只执行第一个
  74. filterMap.put("/api/admin/user/signIn", "anon");
  75. filterMap.put("/api/admin/**", "authToken");
  76. factoryBean.setFilterChainDefinitionMap(filterMap);
  77. return factoryBean;
  78. }
  79. }
  • 说明
  1. ShiroFilterFactoryBean 是FactoryBean,且实现了BeanPostProcessor接口
  2. 在实例化时,依赖securityManager
  3. 而SecurityManager 在Shiro自动化配置中,又依赖于Realm 类的
  4. 所以实例化的顺序为:ShiroFilterFactoryBean > securityManager > dbShiroRealm > userServiceImpl
  5. 此时代理事务配置 ProxyTransactionManagementConfiguration还没实例化

2.解决方法

  1. 采用懒加载的方式
  1. @Lazy
  2. @Autowired
  3. private UserService userService;
  1. 使用注解@DependsOn

说明:
既然我们再创建dbShiroRealm时,需要依赖注入userServiceImpl而且希望注入的是事务代理增强类,但是事务代理增强的配置在 ProxyTransactionManagementConfiguration类中,那么我们在实例化dbShiroRealm时,先让配置类实例化,这样就可以享受到事务代理了。

  1. //@DependsOn中的Bean 名称可以在ProxyTransactionManagementConfiguration中找
  2. @Bean
  3. @DependsOn("org.springframework.transaction.config.internalTransactionAdvisor")
  4. public Realm dbShiroRealm() {
  5. DbShiroRealm myShiroRealm = new DbShiroRealm();
  6. myShiroRealm.setCredentialsMatcher(new HashedCredentialsMatcher(Sha256Hash.ALGORITHM_NAME));
  7. return myShiroRealm;
  8. }

六 、参考