root
/
spring-framework
mirror of https://github.com/spring-projects/spring-framework.git
1
0
Fork 0
Code Issues Actions 7 Packages Projects Releases Wiki Activity

Merge branch '5.1.x'

This commit is contained in:
Sam Brannen 2019-06-25 10:42:14 +03:00
parent 1afc2be5aa dda4dfb44b
commit b2dc4debde
1 changed files with 14 additions and 9 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

23
spring-core/src/main/java/org/springframework/core/PriorityOrdered.java
View File

@ -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 <em>priority</em>
* ordering: order values expressed by {@code PriorityOrdered} objects
* always apply before same order values expressed by <em>plain</em>
* {@link Ordered} objects.
* ordering: {@code PriorityOrdered} objects are always applied before
* <em>plain</em> {@link Ordered} objects regardless of their order values.
*
* <p>This is primarily a special-purpose interface, used for objects where
* it is particularly important to recognize <em>prioritized</em> objects
* first, without even obtaining the remaining objects. A typical example:
* prioritized post-processors in a Spring
* <p>When sorting a set of {@code Ordered} objects, {@code PriorityOrdered}
* objects and <em>plain</em> {@code Ordered} objects are effectively treated as
* two separate subsets, with the set of {@code PriorityOrdered} objects preceding
* the set of <em>plain</em> {@code Ordered} objects and with relative
* ordering applied within those subsets.
*
* <p>This is primarily a special-purpose interface, used within the framework
* itself for objects where it is particularly important to recognize
* <em>prioritized</em> objects first, potentially without even obtaining the
* remaining objects. A typical example: prioritized post-processors in a Spring
* {@link org.springframework.context.ApplicationContext}.
*
* <p>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 {
}