Enabling Non-Spring Libraries to Access Spring Boot Components

Internal

• Spring Boot

Overview

This article describes a possible approach to give non-Spring libraries access to Spring Boot runtime components.

Playground Example

https://github.com/ovidiuf/playground/tree/master/spring/spring-boot/spring-boot-with-dependency

Approach

The Spring Boot runtime should implement a Spring component whose job is to configure a dedicated class in the dependency package. This solution assumes that the dependency package "cooperates" and we can write code in it. The dedicated class in the dependency package is conventionally named SpringApplicationContextAccess:

package playground.springboot.dependency;

import org.springframework.context.ApplicationContext;

public class SpringApplicationContextAccess {

  private static ApplicationContext APPLICATION_CONTEXT;
    
  public static void installApplicationContext(ApplicationContext ac) {
        
    APPLICATION_CONTEXT = ac;
  }

  /**
   * Use this method to explicitly pull the bean from the context.
   *
   * @return may return null if no such bean exists in the application context.
   *
   * @throws IllegalStateException if we encounter bad state because the initialization was not performed.
   */
  public static <T> T getBean(Class<T> type) throws IllegalStateException {
      
    if (APPLICATION_CONTEXT == null) {
        
      throw new IllegalStateException("access to Spring ApplicationContext has not been configured");
    }
    
    return SpringApplicationContextAccess.APPLICATION_CONTEXT.getBean(type);
  }
}

Note that the dependency project should be configured with "compile only" access to Spring Framework API packages "org.springframework:spring-beans" and "org.springframework:spring-context". A way to do this that does not involve Spring Boot dependency management is described here: Spring dependency-management Plugin for Gradle.

The Spring Boot runtime is supposed to configured SpringApplicationContextAccess for the dependency, via a SpringApplicationContextConfiguratorForDependencies component., early in its life cycle. The simplest way to do this is when the component is initialized so it has access to the application context:

@Component
public class SpringApplicationContextConfiguratorForDependencies {

  @Autowired
  public SpringApplicationContextConfiguratorForDependencies(ApplicationContext applicationContext) {

     SpringApplicationContextAccess.installApplicationContext(applicationContext);
  }
}

The SpringApplicationContextConfiguratorForDependencies component should be autowired into the Spring Boot application to trigger configuration.

@SpringBootApplication
public class MainApplication  {

    @Autowired
    private SpringApplicationContextConfiguratorForDependencies springBootstrap;

   ...
}

Finally, the non-spring dependency should explicitly pull the component it needs from the application context, with getBean(). That will trigger bean initialization and will kick off necessary dependency injection.

package playground.springboot.dependency;

public class Dependency {

  private DependencySpringComponentA springComponent;

  public Dependency() {

    springComponent = SpringApplicationContextAccess.getBean(DependencySpringComponentA.class); 
  }

  public void run() {

    System.out.println(this + " is running with Spring component " + springComponent);

    springComponent.run();
  }
}

Obviously, DependencySpringComponentA must exist and be a valid Spring component.