@Primary not marked as inherited anymore
Issue: SPR-14780
This commit is contained in:
parent
74b6a5b6d7
commit
a32b52555a
|
@ -1,5 +1,5 @@
|
||||||
/*
|
/*
|
||||||
* Copyright 2002-2011 the original author or authors.
|
* Copyright 2002-2016 the original author or authors.
|
||||||
*
|
*
|
||||||
* Licensed under the Apache License, Version 2.0 (the "License");
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
||||||
* you may not use this file except in compliance with the License.
|
* you may not use this file except in compliance with the License.
|
||||||
|
@ -18,26 +18,26 @@ package org.springframework.context.annotation;
|
||||||
|
|
||||||
import java.lang.annotation.Documented;
|
import java.lang.annotation.Documented;
|
||||||
import java.lang.annotation.ElementType;
|
import java.lang.annotation.ElementType;
|
||||||
import java.lang.annotation.Inherited;
|
|
||||||
import java.lang.annotation.Retention;
|
import java.lang.annotation.Retention;
|
||||||
import java.lang.annotation.RetentionPolicy;
|
import java.lang.annotation.RetentionPolicy;
|
||||||
import java.lang.annotation.Target;
|
import java.lang.annotation.Target;
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Indicates that a bean should be given preference when multiple candidates
|
* Indicates that a bean should be given preference when multiple candidates
|
||||||
* are qualified to autowire a single-valued dependency. If exactly one 'primary'
|
* are qualified to autowire a single-valued dependency. If exactly one
|
||||||
* bean exists among the candidates, it will be the autowired value. This annotation
|
* 'primary' bean exists among the candidates, it will be the autowired value.
|
||||||
* is semantically equivalent to the {@code <bean>} element's {@code primary} attribute
|
|
||||||
* in Spring XML.
|
|
||||||
*
|
*
|
||||||
* <p>May be used on any class directly or indirectly annotated with @{@link
|
* <p>This annotation is semantically equivalent to the {@code <bean>} element's
|
||||||
* org.springframework.stereotype.Component Component} or on methods annotated
|
* {@code primary} attribute in Spring XML.
|
||||||
* with @{@link Bean}.
|
*
|
||||||
|
* <p>May be used on any class directly or indirectly annotated with
|
||||||
|
* {@code @Component} or on methods annotated with @{@link Bean}.
|
||||||
*
|
*
|
||||||
* <h2>Example</h2>
|
* <h2>Example</h2>
|
||||||
* <pre class="code">
|
* <pre class="code">
|
||||||
* @Component
|
* @Component
|
||||||
* public class FooService {
|
* public class FooService {
|
||||||
|
*
|
||||||
* private FooRepository fooRepository;
|
* private FooRepository fooRepository;
|
||||||
*
|
*
|
||||||
* @Autowired
|
* @Autowired
|
||||||
|
@ -48,6 +48,7 @@ import java.lang.annotation.Target;
|
||||||
*
|
*
|
||||||
* @Component
|
* @Component
|
||||||
* public class JdbcFooRepository {
|
* public class JdbcFooRepository {
|
||||||
|
*
|
||||||
* public JdbcFooService(DataSource dataSource) {
|
* public JdbcFooService(DataSource dataSource) {
|
||||||
* // ...
|
* // ...
|
||||||
* }
|
* }
|
||||||
|
@ -56,23 +57,25 @@ import java.lang.annotation.Target;
|
||||||
* @Primary
|
* @Primary
|
||||||
* @Component
|
* @Component
|
||||||
* public class HibernateFooRepository {
|
* public class HibernateFooRepository {
|
||||||
|
*
|
||||||
* public HibernateFooService(SessionFactory sessionFactory) {
|
* public HibernateFooService(SessionFactory sessionFactory) {
|
||||||
* // ...
|
* // ...
|
||||||
* }
|
* }
|
||||||
* }
|
* }
|
||||||
* </pre>
|
* </pre>
|
||||||
*
|
*
|
||||||
* <p>Because {@code HibernateFooRepository} is marked with {@code @Primary}, it will
|
* <p>Because {@code HibernateFooRepository} is marked with {@code @Primary},
|
||||||
* be injected preferentially over the jdbc-based variant assuming both are present as
|
* it will be injected preferentially over the jdbc-based variant assuming both
|
||||||
* beans within the same Spring application context, which is often the case when
|
* are present as beans within the same Spring application context, which is
|
||||||
* component-scanning is applied liberally.
|
* often the case when component-scanning is applied liberally.
|
||||||
*
|
*
|
||||||
* <p>Note that using {@code @Primary} at the class level has no effect unless
|
* <p>Note that using {@code @Primary} at the class level has no effect unless
|
||||||
* component-scanning is being used. If a {@code @Primary}-annotated class is declared via
|
* component-scanning is being used. If a {@code @Primary}-annotated class is
|
||||||
* XML, {@code @Primary} annotation metadata is ignored, and
|
* declared via XML, {@code @Primary} annotation metadata is ignored, and
|
||||||
* {@code <bean primary="true|false"/>} is respected instead.
|
* {@code <bean primary="true|false"/>} is respected instead.
|
||||||
*
|
*
|
||||||
* @author Chris Beams
|
* @author Chris Beams
|
||||||
|
* @author Juergen Hoeller
|
||||||
* @since 3.0
|
* @since 3.0
|
||||||
* @see Lazy
|
* @see Lazy
|
||||||
* @see Bean
|
* @see Bean
|
||||||
|
@ -81,7 +84,6 @@ import java.lang.annotation.Target;
|
||||||
*/
|
*/
|
||||||
@Target({ElementType.TYPE, ElementType.METHOD})
|
@Target({ElementType.TYPE, ElementType.METHOD})
|
||||||
@Retention(RetentionPolicy.RUNTIME)
|
@Retention(RetentionPolicy.RUNTIME)
|
||||||
@Inherited
|
|
||||||
@Documented
|
@Documented
|
||||||
public @interface Primary {
|
public @interface Primary {
|
||||||
|
|
||||||
|
|
Loading…
Reference in New Issue