Ankur Mhatre
86246dc860
configuration-properties/ @ConfigurationProperties vs @Value on Spring Boot 4.1.1. The relaxed-binding matrix is generated by binding each spelling rather than transcribed, and re-checked against real processes -- the in-process probe was wrong twice before it was right. Records the three findings that came out of it: @Value does get relaxed resolution inside Spring Boot (Boot attaches ConfigurationPropertySources), the configuration processor silently stops generating metadata on JDK 23+ when declared as a plain dependency, and @Valid is not what makes nested constraints run. profiles-and-config/ Precedence, profiles, spring.config.import and config trees. /precedence reports every source holding a property in rank order with file and line, which turns "my profile file had no effect" into a two-line answer. Also pins the counterintuitive one: an imported file outranks the file that imported it. spring-aop/ Designators, proxy types, and aspects that do not fire. One advice per supported designator so the reference table is generated from real matches; all fourteen unsupported designators fed to the parser. Two corrections to the reference documentation: unsupported designators throw UnsupportedPointcutPrimitiveException (extends RuntimeException, not IllegalArgumentException), and spring-boot-starter-aop was renamed to spring-boot-starter-aspectj in Boot 4. 19 contract tests across the three modules, 15 captured transcripts, all regenerated by scripts/run-all.sh. Verified on Spring Boot 4.1.1, Spring Framework 7.0.9, JDK 25.0.4.1. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01Gip4srpzMwjgoba6uEfbr5
23 lines
1.2 KiB
Plaintext
23 lines
1.2 KiB
Plaintext
== relaxed binding matrix ==
|
|
canonical property: demo.relaxed.api-key
|
|
|
|
SPELLING SOURCE BINDER ${} plain ${} boot
|
|
--------------------------------------------------------------
|
|
demo.relaxed.api-key map bound bound bound
|
|
demo.relaxed.apiKey map bound MISS bound
|
|
demo.relaxed.api_key map bound MISS bound
|
|
demo.relaxed.APIKEY map bound MISS bound
|
|
DEMO.RELAXED.API-KEY map bound MISS bound
|
|
demo.relaxed.apikey map bound MISS bound
|
|
demo.relaxed.api.key map MISS MISS MISS
|
|
DEMO_RELAXED_API_KEY env bound bound bound
|
|
DEMO_RELAXED_APIKEY env bound MISS bound
|
|
demo_relaxed_api_key env bound bound bound
|
|
DEMO.RELAXED.API-KEY env bound bound bound
|
|
|
|
BINDER = what @ConfigurationProperties sees (Binder)
|
|
${} plain = placeholder resolution against a bare StandardEnvironment
|
|
${} boot = the same, after ConfigurationPropertySources.attach(env),
|
|
which Spring Boot performs on every environment it prepares
|
|
bound = the value arrived; MISS = the property was not found
|