Close

Spring - Controlling Beans Loading Order by using @DependsOn

[Last Updated: Dec 22, 2023]

The order in which Spring container loads beans cannot be predicted. There's no specific ordering logic specification given by Spring framework. But Spring guarantees if a bean A has dependency of B (e.g. bean A has an instance variable @Autowired B b;) then B will be initialized first. But what if bean A doesn't have direct dependency of B and we still want B to initialize first?



When we want to control beans initializing order

There might be scenarios where A is depending on B indirectly. For example assume A is some kind of events publisher and B is listening to those events. This is a typical scenario of observer pattern. We don't want B to miss any events and would like to have B being initialize before A.

@DependsOn annotation

Spring provides @DependsOn indicating which bean should be initialized before this bean:



Example

Following example shows a very basic observer pattern.

EventManager, a facility to register listeners and publishing events

package com.logicbig.example.bean;

import jakarta.annotation.PostConstruct;
import java.util.ArrayList;
import java.util.List;
import java.util.function.Consumer;

public class EventManager {
  private final List<Consumer<String>> listeners = new ArrayList<>();

  @PostConstruct
  public void initialize() {
      System.out.println("initializing: "+this.getClass().getSimpleName());
  }

  public void publish(final String message) {
      listeners.forEach(l -> l.accept(message));
  }

  public void addListener(Consumer<String> eventConsumer) {
      listeners.add(eventConsumer);
  }
}

EventPublisher

package com.logicbig.example.bean;

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

public class EventPublisher {
  @Autowired
  private EventManager eventManager;

  @PostConstruct
  public void initialize() {
      System.out.println("initializing: "+this.getClass().getSimpleName());
      eventManager.publish("event published from EventPublisherBean");
  }
}

EventListener

package com.logicbig.example.bean;

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

public class EventListener {
  @Autowired
  private EventManager eventManager;

  @PostConstruct
  private void initialize() {
      System.out.println("initializing: "+this.getClass().getSimpleName());
      eventManager.addListener(s ->
              System.out.println("event received in EventListenerBean : " + s));

  }
}

Defining beans and running main class

package com.logicbig.example;

import com.logicbig.example.bean.EventListener;
import com.logicbig.example.bean.EventManager;
import com.logicbig.example.bean.EventPublisher;
import org.springframework.context.annotation.*;

@Configuration
@ComponentScan("com.logicbig.example")
public class AppConfig {

  @Bean
  @DependsOn("eventListenerBean")
  public EventPublisher eventPublisherBean() {
      return new EventPublisher();
  }

  @Bean
  public EventListener eventListenerBean() {
      return new EventListener();
  }

  @Bean
  public EventManager eventManagerBean() {
      return new EventManager();
  }

  public static void main(String... strings) {
      AnnotationConfigApplicationContext context = new AnnotationConfigApplicationContext(AppConfig.class);
      context.close();

  }
}

Output

initializing: EventManager
initializing: EventListener
initializing: EventPublisher
event received in EventListenerBean : event published from EventPublisherBean

If we don't use @DependsOn, there's no guarantee that EventListener will initialize first:

@Configuration
@ComponentScan("com.logicbig.example")
public class AppConfig {

    @Bean
   // @DependsOn("eventListenerBean")
    public EventPublisher eventPublisherBean() {
        return new EventPublisher();
    }

    @Bean
    public EventListener eventListenerBean() {
        return new EventListener();
    }

    @Bean
    public EventManager eventManagerBean() {
        return new EventManager();
    }

    public static void main(String... strings) {
        AnnotationConfigApplicationContext context = new AnnotationConfigApplicationContext(AppConfig.class);
        context.close();

    }
}

Output

initializing: EventManager
initializing: EventPublisher
initializing: EventListener

Example Project

Dependencies and Technologies Used:

  • spring-context 6.1.2 (Spring Context)
     Version Compatibility: 3.2.9.RELEASE - 6.1.2Version List
    ×

    Version compatibilities of spring-context with this example:

    • 3.2.9.RELEASE
    • 3.2.10.RELEASE
    • 3.2.11.RELEASE
    • 3.2.12.RELEASE
    • 3.2.13.RELEASE
    • 3.2.14.RELEASE
    • 3.2.15.RELEASE
    • 3.2.16.RELEASE
    • 3.2.17.RELEASE
    • 3.2.18.RELEASE
    • 4.0.0.RELEASE
    • 4.0.1.RELEASE
    • 4.0.2.RELEASE
    • 4.0.3.RELEASE
    • 4.0.4.RELEASE
    • 4.0.5.RELEASE
    • 4.0.6.RELEASE
    • 4.0.7.RELEASE
    • 4.0.8.RELEASE
    • 4.0.9.RELEASE
    • 4.1.0.RELEASE
    • 4.1.1.RELEASE
    • 4.1.2.RELEASE
    • 4.1.3.RELEASE
    • 4.1.4.RELEASE
    • 4.1.5.RELEASE
    • 4.1.6.RELEASE
    • 4.1.7.RELEASE
    • 4.1.8.RELEASE
    • 4.1.9.RELEASE
    • 4.2.0.RELEASE
    • 4.2.1.RELEASE
    • 4.2.2.RELEASE
    • 4.2.3.RELEASE
    • 4.2.4.RELEASE
    • 4.2.5.RELEASE
    • 4.2.6.RELEASE
    • 4.2.7.RELEASE
    • 4.2.8.RELEASE
    • 4.2.9.RELEASE
    • 4.3.0.RELEASE
    • 4.3.1.RELEASE
    • 4.3.2.RELEASE
    • 4.3.3.RELEASE
    • 4.3.4.RELEASE
    • 4.3.5.RELEASE
    • 4.3.6.RELEASE
    • 4.3.7.RELEASE
    • 4.3.8.RELEASE
    • 4.3.9.RELEASE
    • 4.3.10.RELEASE
    • 4.3.11.RELEASE
    • 4.3.12.RELEASE
    • 4.3.13.RELEASE
    • 4.3.14.RELEASE
    • 4.3.15.RELEASE
    • 4.3.16.RELEASE
    • 4.3.17.RELEASE
    • 4.3.18.RELEASE
    • 4.3.19.RELEASE
    • 4.3.20.RELEASE
    • 4.3.21.RELEASE
    • 4.3.22.RELEASE
    • 4.3.23.RELEASE
    • 4.3.24.RELEASE
    • 4.3.25.RELEASE
    • 4.3.26.RELEASE
    • 4.3.27.RELEASE
    • 4.3.28.RELEASE
    • 4.3.29.RELEASE
    • 4.3.30.RELEASE
    • 5.0.0.RELEASE
    • 5.0.1.RELEASE
    • 5.0.2.RELEASE
    • 5.0.3.RELEASE
    • 5.0.4.RELEASE
    • 5.0.5.RELEASE
    • 5.0.6.RELEASE
    • 5.0.7.RELEASE
    • 5.0.8.RELEASE
    • 5.0.9.RELEASE
    • 5.0.10.RELEASE
    • 5.0.11.RELEASE
    • 5.0.12.RELEASE
    • 5.0.13.RELEASE
    • 5.0.14.RELEASE
    • 5.0.15.RELEASE
    • 5.0.16.RELEASE
    • 5.0.17.RELEASE
    • 5.0.18.RELEASE
    • 5.0.19.RELEASE
    • 5.0.20.RELEASE
    • 5.1.0.RELEASE
    • 5.1.1.RELEASE
    • 5.1.2.RELEASE
    • 5.1.3.RELEASE
    • 5.1.4.RELEASE
    • 5.1.5.RELEASE
    • 5.1.6.RELEASE
    • 5.1.7.RELEASE
    • 5.1.8.RELEASE
    • 5.1.9.RELEASE
    • 5.1.10.RELEASE
    • 5.1.11.RELEASE
    • 5.1.12.RELEASE
    • 5.1.13.RELEASE
    • 5.1.14.RELEASE
    • 5.1.15.RELEASE
    • 5.1.16.RELEASE
    • 5.1.17.RELEASE
    • 5.1.18.RELEASE
    • 5.1.19.RELEASE
    • 5.1.20.RELEASE
    • 5.2.0.RELEASE
    • 5.2.1.RELEASE
    • 5.2.2.RELEASE
    • 5.2.3.RELEASE
    • 5.2.4.RELEASE
    • 5.2.5.RELEASE
    • 5.2.6.RELEASE
    • 5.2.7.RELEASE
    • 5.2.8.RELEASE
    • 5.2.9.RELEASE
    • 5.2.10.RELEASE
    • 5.2.11.RELEASE
    • 5.2.12.RELEASE
    • 5.2.13.RELEASE
    • 5.2.14.RELEASE
    • 5.2.15.RELEASE
    • 5.2.15.RELEASE
    • 5.2.16.RELEASE
    • 5.2.17.RELEASE
    • 5.2.18.RELEASE
    • 5.2.19.RELEASE
    • 5.2.20.RELEASE
    • 5.2.21.RELEASE
    • 5.2.22.RELEASE
    • 5.2.23.RELEASE
    • 5.2.24.RELEASE
    • 5.2.25.RELEASE
    • 5.3.0
    • 5.3.1
    • 5.3.2
    • 5.3.3
    • 5.3.4
    • 5.3.5
    • 5.3.6
    • 5.3.7
    • 5.3.8
    • 5.3.9
    • 5.3.10
    • 5.3.11
    • 5.3.12
    • 5.3.13
    • 5.3.14
    • 5.3.15
    • 5.3.16
    • 5.3.17
    • 5.3.18
    • 5.3.19
    • 5.3.20
    • 5.3.21
    • 5.3.22
    • 5.3.23
    • 5.3.24
    • 5.3.25
    • 5.3.26
    • 5.3.27
    • 5.3.28
    • 5.3.29
    • 5.3.30
    • 5.3.31
    • Compatible Java Version: 17+
    • 6.0.0
    • 6.0.1
    • 6.0.2
    • 6.0.3
    • 6.0.4
    • 6.0.5
    • 6.0.6
    • 6.0.7
    • 6.0.8
    • 6.0.9
    • 6.0.10
    • 6.0.11
    • 6.0.12
    • 6.0.13
    • 6.0.14
    • 6.0.15
    • 6.1.0
    • 6.1.1
    • 6.1.2

    Versions in green have been tested.

  • jakarta.jakartaee-api 10.0.0 (Eclipse Foundation)
  • JDK 17
  • Maven 3.8.1

@DependsOn Example Select All Download
  • spring-depends-on
    • src
      • main
        • java
          • com
            • logicbig
              • example
                • bean
                • AppConfig.java

    See Also