Three new article modules: configuration binding, profiles and config data, Spring AOP
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
This commit is contained in:
83
profiles-and-config/docs/output/01-precedence.txt
Normal file
83
profiles-and-config/docs/output/01-precedence.txt
Normal file
@@ -0,0 +1,83 @@
|
||||
== every source sets demo.greeting at once ==
|
||||
|
||||
$ DEMO_GREETING=from-environment-variable \
|
||||
java -Ddemo.greeting=from-system-property \
|
||||
-jar target/profiles-and-config-1.0.0.jar --spring.profiles.active=prod \
|
||||
--demo.greeting=from-command-line-argument
|
||||
|
||||
{
|
||||
"property": "demo.greeting",
|
||||
"effectiveValue": "from-command-line-argument",
|
||||
"activeProfiles": [
|
||||
"prod",
|
||||
"prod-db",
|
||||
"prod-metrics"
|
||||
],
|
||||
"holders": [
|
||||
{
|
||||
"rank": 1,
|
||||
"source": "SimpleCommandLinePropertySource {name='commandLineArgs'}",
|
||||
"value": "from-command-line-argument",
|
||||
"origin": "\"demo.greeting\" from property source \"commandLineArgs\""
|
||||
},
|
||||
{
|
||||
"rank": 2,
|
||||
"source": "PropertiesPropertySource {name='systemProperties'}",
|
||||
"value": "from-system-property",
|
||||
"origin": "\"demo.greeting\" from property source \"systemProperties\""
|
||||
},
|
||||
{
|
||||
"rank": 3,
|
||||
"source": "OriginAwareSystemEnvironmentPropertySource {name='systemEnvironment'}",
|
||||
"value": "from-environment-variable",
|
||||
"origin": "System Environment Property \"DEMO_GREETING\""
|
||||
},
|
||||
{
|
||||
"rank": 4,
|
||||
"source": "OriginTrackedMapPropertySource {name='Config resource 'class path resource [application-prod.yaml]' via location 'optional:classpath:/''}",
|
||||
"value": "from-application-prod-yaml",
|
||||
"origin": "class path resource [application-prod.yaml] from profiles-and-config-1.0.0.jar - 4:13"
|
||||
},
|
||||
{
|
||||
"rank": 5,
|
||||
"source": "OriginTrackedMapPropertySource {name='Config resource 'class path resource [application.yaml]' via location 'optional:classpath:/''}",
|
||||
"value": "from-application-yaml",
|
||||
"origin": "class path resource [application.yaml] from profiles-and-config-1.0.0.jar - 21:13"
|
||||
}
|
||||
],
|
||||
"shadowedCount": 4
|
||||
}
|
||||
|
||||
== and with the environment variable removed, nothing else changed ==
|
||||
./scripts/demo-precedence.sh: line 41: 5735 Killed DEMO_GREETING=from-environment-variable setsid nohup java -Ddemo.greeting=from-system-property -jar "$JAR" --spring.profiles.active=prod --demo.greeting=from-command-line-argument > /tmp/profiles-precedence.log 2>&1 < /dev/null
|
||||
{
|
||||
"property": "demo.greeting",
|
||||
"effectiveValue": "from-system-property",
|
||||
"activeProfiles": [
|
||||
"prod",
|
||||
"prod-db",
|
||||
"prod-metrics"
|
||||
],
|
||||
"holders": [
|
||||
{
|
||||
"rank": 1,
|
||||
"source": "PropertiesPropertySource {name='systemProperties'}",
|
||||
"value": "from-system-property",
|
||||
"origin": "\"demo.greeting\" from property source \"systemProperties\""
|
||||
},
|
||||
{
|
||||
"rank": 2,
|
||||
"source": "OriginTrackedMapPropertySource {name='Config resource 'class path resource [application-prod.yaml]' via location 'optional:classpath:/''}",
|
||||
"value": "from-application-prod-yaml",
|
||||
"origin": "class path resource [application-prod.yaml] from profiles-and-config-1.0.0.jar - 4:13"
|
||||
},
|
||||
{
|
||||
"rank": 3,
|
||||
"source": "OriginTrackedMapPropertySource {name='Config resource 'class path resource [application.yaml]' via location 'optional:classpath:/''}",
|
||||
"value": "from-application-yaml",
|
||||
"origin": "class path resource [application.yaml] from profiles-and-config-1.0.0.jar - 21:13"
|
||||
}
|
||||
],
|
||||
"shadowedCount": 2
|
||||
}
|
||||
./scripts/demo-precedence.sh: line 41: 5796 Killed setsid nohup java -Ddemo.greeting=from-system-property -jar "$JAR" --spring.profiles.active=prod > /tmp/profiles-precedence2.log 2>&1 < /dev/null
|
||||
Reference in New Issue
Block a user