Spring/spring-framework
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Introduce fallback flag and annotation (as companion to primary)

Browse Source 
Closes gh-26241
This commit is contained in:
Juergen Hoeller
2024-02-20 13:37:41 +01:00
parent c077805761
commit 480051a21c
7 changed files with 197 additions and 3 deletions
Download Patch File Download Diff File Expand all files Collapse all files

5
spring-context/src/main/java/org/springframework/context/annotation/AnnotationConfigUtils.java
View File

@@ -1,5 +1,5 @@
/*
* Copyright 2002-2023 the original author or authors.
* Copyright 2002-2024 the original author or authors.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
@@ -246,6 +246,9 @@ public abstract class AnnotationConfigUtils {
if (metadata.isAnnotated(Primary.class.getName())) {
abd.setPrimary(true);
}
if (metadata.isAnnotated(Fallback.class.getName())) {
abd.setFallback(true);
}
AnnotationAttributes dependsOn = attributesFor(metadata, DependsOn.class);
if (dependsOn != null) {
abd.setDependsOn(dependsOn.getStringArray("value"));

44
spring-context/src/main/java/org/springframework/context/annotation/Fallback.java Normal file
View File

@@ -0,0 +1,44 @@
/*
* Copyright 2002-2024 the original author or authors.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* https://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package org.springframework.context.annotation;
import java.lang.annotation.Documented;
import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;
/**
* Indicates that a bean qualifies as a fallback autowire candidate.
* This is a companion and alternative to the {@link Primary} annotation.
*
* <p>If all beans but one among multiple matching candidates are marked
* as a fallback, the remaining bean will be selected.
*
* @author Juergen Hoeller
* @since 6.2
* @see Primary
* @see Lazy
* @see Bean
* @see org.springframework.beans.factory.config.BeanDefinition#setFallback
*/
@Target({ElementType.TYPE, ElementType.METHOD})
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface Fallback {
}

4
spring-context/src/main/java/org/springframework/context/annotation/Primary.java
View File

@@ -1,5 +1,5 @@
/*
* Copyright 2002-2016 the original author or authors.
* Copyright 2002-2024 the original author or authors.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
@@ -77,10 +77,12 @@ import java.lang.annotation.Target;
* @author Chris Beams
* @author Juergen Hoeller
* @since 3.0
* @see Fallback
* @see Lazy
* @see Bean
* @see ComponentScan
* @see org.springframework.stereotype.Component
* @see org.springframework.beans.factory.config.BeanDefinition#setPrimary
*/
@Target({ElementType.TYPE, ElementType.METHOD})
@Retention(RetentionPolicy.RUNTIME)