org.springframework.core.PriorityOrdered Maven / Gradle / Ivy
/*
* 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.
* You may obtain a copy of the License at
*
* https://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package org.springframework.core;
/**
* Extension of the {@link Ordered} interface, expressing a priority
* ordering: {@code PriorityOrdered} objects are always applied before
* plain {@link Ordered} objects regardless of their order values.
*
* 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
* a special phase, ahead of other post-processor beans. This subtly
* affects their autowiring behavior: they will only be autowired against
* 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 {
}