Search code examples
springannotationsspring-bootautowired

Spring fallback bean implementation

I'm currently trying to configure Spring Boot (using Java Annotations and ComponentScan) for the following scenario:

Scenario

  • There's an interface MyService.
  • I want to provide a default implementation for MyService, let's call it MyDefaultService.
  • If the component scan detects no other implementation for MyService, Spring should instantiate MyDefaultService as a "fallback".
  • If there is a different implementation of MyService present, let's say MyCustomService, then that bean should always take precedence over MyDefaultService when autowiring a dependency to MyService. In that regard, MyDefaultService should be recessive (as opposed to @Primary).
  • Ideally, there should not need to be an additional annotation on MyCustomService to have it "override" MyDefaultService.
  • Ideally, no explicitly implemented factories or factory methods should be required.

Question

The question is: how do I need to annotate the MyDefaultService class in order to achieve this?

What I tried so far to solve the problem

  • Annotating MyDefaultService with @ConditionalOnMissingBean(MyService.class). Didn't work because MyDefaultService is never used, even if there is no other implementation of MyService.
  • There is an annotation called @Primarythat solves the problem. However, it needs to reside on MyCustomService, a class that I try to keep free of additional annotations. Essentially, I need the inverse annotation of @Primary on MyDefaultService. However, I couldn't find such an annotation.

Concrete use case

I am developing a service layer in one project, and a different project will implement a web UI layer on top of it. The UI project has a dependency to the service layer project. However, for certain functionalities implemented at the service layer, I need to know which user is currently logged in at the web context. So I have to define a service interface for that in the service layer project, such that it can be implemented by the UI project. However, for testing purposes in the service-layer project, I need a default implementation of that interface. Also, in case that the UI project team forgets to implement this interface, the app should not crash, but instead instantiate the fallback bean and issue a warning.

Thanks & kind regards,

Alan

Solution

  • Traditionally in Spring you could use @Primary annotation to mark a bean, so that it would take precedence over regular beans not annotated with @Primary in case of multiple autowiring candidates are found.

    However, in Spring 6.2 a new annotation was introduced - @Fallback.

    It is essentially the opposite of @Primary. Such bean would be used only in case there are no beans with @Primary annotation AND no regular beans.