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

spring-aop/scripts/demo-designators.sh

@@ -0,0 +1,48 @@
+#!/usr/bin/env bash
+# Every pointcut designator Spring AOP supports, with what it actually matched.
+set -euo pipefail
+set +m
+cd "$(dirname "$0")/.."
+source scripts/env.sh
+{
+  echo "== which designator matched which join point =="
+  echo
+  echo "Five methods are called once each: OrderService.place, OrderService.cancel,"
+  echo "InventoryService.reserve, InventoryService.finalCheck and"
+  echo "DefaultOrderService.interfaceless."
+  echo
+  start_app > /dev/null
+  curl -s "http://127.0.0.1:${APP_PORT}/aop/designators" | python3 -c '
+import json,sys
+d=json.load(sys.stdin)
+print("  orderService proxy kind :", d["orderServiceProxyKind"])
+print("  proxy is an instance of DefaultOrderService :",
+      d["orderServiceIsDefaultOrderServiceInstance"])
+print()
+for k,v in d["matches"].items():
+    print("  %-32s -> %s" % (k, ", ".join(v)))'
+  echo
+  echo "== what the parser accepts and refuses =="
+  echo
+  curl -s "http://127.0.0.1:${APP_PORT}/aop/parser" | python3 -c '
+import json,sys
+d=json.load(sys.stdin)
+print("  supported (all parsed and evaluated):")
+for r in d["supported"]:
+    print("    %-52s %s" % (r["expression"], "OK" if r["accepted"] else "REJECTED"))
+print()
+print("  unsupported in Spring AOP:")
+for r in d["unsupported"]:
+    print("    %-52s %s" % (r["expression"][:50], "accepted!" if r["accepted"] else "rejected"))
+print()
+first=[r for r in d["unsupported"] if not r["accepted"]][0]
+print("  the exception, in full:")
+print("    " + first["exception"])
+print("    " + first["message"])'
+  echo
+  echo "The reference documentation says these produce an IllegalArgumentException. They do"
+  echo "not: UnsupportedPointcutPrimitiveException extends RuntimeException directly, so a"
+  echo "catch of IllegalArgumentException will not catch it."
+  stop_app
+} > docs/output/01-designators.txt 2>&1
+cat docs/output/01-designators.txt