Spring/spring-boot
Spring/spring-boot
1
0
Fork 0
mirror of https://github.com/spring-projects/spring-boot.git synced 2024-08-29 03:06:45 +08:00
Code Issues Packages Projects Releases Wiki Activity

Polish "Add a note on early init with @ConditionalOnExpression"

Browse Source 
See gh-29276
This commit is contained in:
Stephane Nicoll 2022-02-01 16:32:27 +01:00
parent fce3cd1684
commit 5fe6176966
2 changed files with 9 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

11
spring-boot-project/spring-boot-autoconfigure/src/main/java/org/springframework/boot/autoconfigure/condition/ConditionalOnExpression.java
View File

@ -1,5 +1,5 @@
/*
* Copyright 2012-2019 the original author or authors.
* Copyright 2012-2022 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.
@ -27,6 +27,11 @@ import org.springframework.context.annotation.Conditional;
/**
* Configuration annotation for a conditional element that depends on the value of a SpEL
* expression.
* <p>
* Referencing a bean in the expression will cause that bean to be initialized very early
* in context refresh processing. As a result, the bean won't be eligible for
* post-processing (such as configuration properties binding) and its state may be
* incomplete.
*
* @author Dave Syer
* @since 1.0.0
@ -40,10 +45,6 @@ public @interface ConditionalOnExpression {
/**
* The SpEL expression to evaluate. Expression should return {@code true} if the
* condition passes or {@code false} if it fails.
* <p>
* NOTE: Referencing a bean in the expression will cause that bean to be initialized
* very early in context refresh processing. As a result, the bean will load with
* default property values.
* @return the SpEL expression
*/
String value() default "true";

4
spring-boot-project/spring-boot-docs/src/docs/asciidoc/features/developing-auto-configuration.adoc
View File

@ -143,7 +143,9 @@ This condition will not match for applications that are run with an embedded ser
==== SpEL Expression Conditions
The `@ConditionalOnExpression` annotation lets configuration be included based on the result of a {spring-framework-docs}/core.html#expressions[SpEL expression].
NOTE: Referencing a bean in the expression will cause that bean to be initialized very early in context refresh processing. As a result, the bean will load with default property values.
NOTE: Referencing a bean in the expression will cause that bean to be initialized very early in context refresh processing.
As a result, the bean won't be eligible for post-processing (such as configuration properties binding) and its state may be incomplete.
[[features.developing-auto-configuration.testing]]