diff --git a/spring-core/src/main/java/org/springframework/core/PriorityOrdered.java b/spring-core/src/main/java/org/springframework/core/PriorityOrdered.java index c50c6ee9f07..2090cd35f9c 100644 --- a/spring-core/src/main/java/org/springframework/core/PriorityOrdered.java +++ b/spring-core/src/main/java/org/springframework/core/PriorityOrdered.java @@ -1,5 +1,5 @@ /* - * Copyright 2002-2015 the original author or authors. + * Copyright 2002-2019 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,14 +18,19 @@ package org.springframework.core; /** * Extension of the {@link Ordered} interface, expressing a priority - * ordering: order values expressed by {@code PriorityOrdered} objects - * always apply before same order values expressed by plain - * {@link Ordered} objects. + * ordering: {@code PriorityOrdered} objects are always applied before + * plain {@link Ordered} objects regardless of their order values. * - *

This is primarily a special-purpose interface, used for objects where - * it is particularly important to recognize prioritized objects - * first, without even obtaining the remaining objects. A typical example: - * prioritized post-processors in a Spring + *

When sorting a set of {@code Ordered} objects, {@code PriorityOrdered} + * objects and plain {@code Ordered} objects are effectively treated as + * two separate subsets, with the set of {@code PriorityOrdered} objects preceding + * the set of plain {@code Ordered} objects and with relative + * ordering applied within those subsets. + * + *

This is primarily a special-purpose interface, used within the framework + * itself for objects where it is particularly important to recognize + * prioritized objects first, potentially without even obtaining the + * remaining objects. A typical example: prioritized post-processors in a Spring * {@link org.springframework.context.ApplicationContext}. * *

Note: {@code PriorityOrdered} post-processor beans are initialized in @@ -34,10 +39,10 @@ package org.springframework.core; * beans which do not require eager initialization for type matching. * * @author Juergen Hoeller + * @author Sam Brannen * @since 2.5 * @see org.springframework.beans.factory.config.PropertyOverrideConfigurer * @see org.springframework.beans.factory.config.PropertyPlaceholderConfigurer */ public interface PriorityOrdered extends Ordered { - }