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
57 lines
2.5 KiB
Bash
Executable File
57 lines
2.5 KiB
Bash
Executable File
#!/usr/bin/env bash
|
|
# spring.config.import ordering, multi-document activation, and the activation Boot refuses.
|
|
set -euo pipefail
|
|
set +m
|
|
cd "$(dirname "$0")/.."
|
|
source scripts/env.sh
|
|
|
|
{
|
|
echo "== spring.config.import: which document wins? =="
|
|
echo
|
|
echo "application-import.yaml imports imported.yaml. Both set demo.greeting."
|
|
echo "\$ java -jar $JAR --spring.profiles.active=import"
|
|
echo
|
|
start_app --spring.profiles.active=import > /dev/null
|
|
report demo.greeting
|
|
echo
|
|
echo " demo.imported-only = $(curl -s "http://127.0.0.1:${APP_PORT}/precedence?name=demo.imported-only" | python3 -c 'import json,sys; print(json.load(sys.stdin)["effectiveValue"])')"
|
|
echo
|
|
echo "The imported file WON. spring.config.import does not behave like #include, and it"
|
|
echo "does not behave like a default either: the imported document is processed AFTER the"
|
|
echo "document that declared the import, so it outranks the file that pulled it in."
|
|
echo "If you import a shared baseline expecting your own file to override it, every key"
|
|
echo "the baseline sets will quietly beat yours."
|
|
echo
|
|
|
|
echo "== one file, several documents, activated by condition =="
|
|
for profile in "" staging prod; do
|
|
label="${profile:-<none>}"
|
|
echo "--- spring.profiles.active=$label (with the multidoc profile) ---"
|
|
if [ -z "$profile" ]; then
|
|
start_app --spring.profiles.active=multidoc > /dev/null
|
|
else
|
|
start_app --spring.profiles.active="multidoc,$profile" > /dev/null
|
|
fi
|
|
report demo.greeting
|
|
echo
|
|
done
|
|
echo "Later documents in the same file win over earlier ones, so the unconditional first"
|
|
echo "document acts as the default and each conditional document overrides it."
|
|
echo
|
|
|
|
echo "== the activation Spring Boot refuses =="
|
|
echo "application-badactivation.yaml tries to set spring.profiles.active from a document"
|
|
echo "that is itself conditional on a profile."
|
|
echo "\$ java -jar $JAR --spring.profiles.active=badactivation,staging"
|
|
echo
|
|
stop_app
|
|
java -jar "$JAR" --spring.profiles.active=badactivation,staging 2>&1 | clean \
|
|
| grep -E 'InvalidConfigDataPropertyException' | head -2 | fold -s -w 96
|
|
echo
|
|
echo
|
|
echo "InvalidConfigDataPropertyException, naming the file and the line. Boot refuses"
|
|
echo "rather than half-applying it: a profile that activates itself would change which"
|
|
echo "files are loaded after those files had already been chosen."
|
|
} > docs/output/04-import-and-multidoc.txt 2>&1
|
|
cat docs/output/04-import-and-multidoc.txt
|