@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");
|
||||
* 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.ElementType;
|
||||
import java.lang.annotation.Inherited;
|
||||
import java.lang.annotation.Retention;
|
||||
import java.lang.annotation.RetentionPolicy;
|
||||
import java.lang.annotation.Target;
|
||||
|
||||
/**
|
||||
* Indicates that a bean should be given preference when multiple candidates
|
||||
* are qualified to autowire a single-valued dependency. If exactly one 'primary'
|
||||
* bean exists among the candidates, it will be the autowired value. This annotation
|
||||
* is semantically equivalent to the {@code <bean>} element's {@code primary} attribute
|
||||
* in Spring XML.
|
||||
* are qualified to autowire a single-valued dependency. If exactly one
|
||||
* 'primary' bean exists among the candidates, it will be the autowired value.
|
||||
*
|
||||
* <p>May be used on any class directly or indirectly annotated with @{@link
|
||||
* org.springframework.stereotype.Component Component} or on methods annotated
|
||||
* with @{@link Bean}.
|
||||
* <p>This annotation 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
|
||||
* {@code @Component} or on methods annotated with @{@link Bean}.
|
||||
*
|
||||
* <h2>Example</h2>
|
||||
* <pre class="code">
|
||||
* @Component
|
||||
* public class FooService {
|
||||
*
|
||||
* private FooRepository fooRepository;
|
||||
*
|
||||
* @Autowired
|
||||
|
@ -48,6 +48,7 @@ import java.lang.annotation.Target;
|
|||
*
|
||||
* @Component
|
||||
* public class JdbcFooRepository {
|
||||
*
|
||||
* public JdbcFooService(DataSource dataSource) {
|
||||
* // ...
|
||||
* }
|
||||
|
@ -56,23 +57,25 @@ import java.lang.annotation.Target;
|
|||
* @Primary
|
||||
* @Component
|
||||
* public class HibernateFooRepository {
|
||||
*
|
||||
* public HibernateFooService(SessionFactory sessionFactory) {
|
||||
* // ...
|
||||
* }
|
||||
* }
|
||||
* </pre>
|
||||
*
|
||||
* <p>Because {@code HibernateFooRepository} is marked with {@code @Primary}, it will
|
||||
* be injected preferentially over the jdbc-based variant assuming both are present as
|
||||
* beans within the same Spring application context, which is often the case when
|
||||
* component-scanning is applied liberally.
|
||||
* <p>Because {@code HibernateFooRepository} is marked with {@code @Primary},
|
||||
* it will be injected preferentially over the jdbc-based variant assuming both
|
||||
* are present as beans within the same Spring application context, which is
|
||||
* often the case when component-scanning is applied liberally.
|
||||
*
|
||||
* <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
|
||||
* XML, {@code @Primary} annotation metadata is ignored, and
|
||||
* component-scanning is being used. If a {@code @Primary}-annotated class is
|
||||
* declared via XML, {@code @Primary} annotation metadata is ignored, and
|
||||
* {@code <bean primary="true|false"/>} is respected instead.
|
||||
*
|
||||
* @author Chris Beams
|
||||
* @author Juergen Hoeller
|
||||
* @since 3.0
|
||||
* @see Lazy
|
||||
* @see Bean
|
||||
|
@ -81,7 +84,6 @@ import java.lang.annotation.Target;
|
|||
*/
|
||||
@Target({ElementType.TYPE, ElementType.METHOD})
|
||||
@Retention(RetentionPolicy.RUNTIME)
|
||||
@Inherited
|
||||
@Documented
|
||||
public @interface Primary {
|
||||
|
||||
|
|
Loading…
Reference in New Issue