NOTE: {@code @Order} values may influence priorities at injection points + *
NOTE: {@code @Order} values may influence priorities at injection points, * but please be aware that they do not influence singleton startup order which is an * orthogonal concern determined by dependency relationships and {@code @DependsOn} * declarations as mentioned above. Also, {@link javax.annotation.Priority} is not * available at this level since it cannot be declared on methods; its semantics can - * be modelled through {@code @Order} values in combination with {@code @Primary} on + * be modeled through {@code @Order} values in combination with {@code @Primary} on * a single bean per type. * *
Since Spring 4.1, the standard {@link javax.annotation.Priority} annotation * can be used as a drop-in replacement for this annotation in ordering scenarios. - * Note that {@code Priority} may have additional semantics when a single element + * Note that {@code @Priority} may have additional semantics when a single element * has to be picked (see {@link AnnotationAwareOrderComparator#getPriority}). * *
Alternatively, order values may also be determined on a per-instance basis diff --git a/src/docs/asciidoc/core/core-beans.adoc b/src/docs/asciidoc/core/core-beans.adoc index ac42c2c0053..0a1a7beb804 100644 --- a/src/docs/asciidoc/core/core-beans.adoc +++ b/src/docs/asciidoc/core/core-beans.adoc @@ -4438,17 +4438,17 @@ The same applies for typed collections: ==== Your target beans can implement the `org.springframework.core.Ordered` interface or use the `@Order` or standard `@Priority` annotation if you want items in the array or list -to be sorted into a specific order. Otherwise their order will follow the registration +to be sorted in a specific order. Otherwise their order will follow the registration order of the corresponding target bean definitions in the container. The `@Order` annotation may be declared at target class level but also on `@Bean` methods, potentially being very individual per bean definition (in case of multiple definitions -with the same bean class). `@Order` values may influence priorities at injection points +with the same bean class). `@Order` values may influence priorities at injection points, but please be aware that they do not influence singleton startup order which is an orthogonal concern determined by dependency relationships and `@DependsOn` declarations. Note that the standard `javax.annotation.Priority` annotation is not available at the -`@Bean` level since it cannot be declared on methods. Its semantics can be modelled +`@Bean` level since it cannot be declared on methods. Its semantics can be modeled through `@Order` values in combination with `@Primary` on a single bean per type. ====