Commit 660d284f authored by Madhura Bhave's avatar Madhura Bhave

Document when and how to use brackets when binding to maps

Closes gh-13506
parent 56235187
...@@ -1102,6 +1102,24 @@ property name ...@@ -1102,6 +1102,24 @@ property name
TIP: We recommend that, when possible, properties are stored in lower-case kebab format, TIP: We recommend that, when possible, properties are stored in lower-case kebab format,
such as `my.property-name=acme`. such as `my.property-name=acme`.
When binding to `Map` properties, if the `key` contains anything other than lowercase
alpha-numeric characters or `-`, you need to use the bracket notation so that the original
value is preserved. If the key is not surrounded by `[]`, any characters that are not alpha-numeric
or `-` are removed. For example, consider binding the following properties to a `Map`:
[source,yaml,indent=0]
----
acme:
map:
"[/key1]": value1
"[/key2]": value2
/key3: value3
----
The properties above will bind to a `Map` with `/key1`, `/key2` and `key3` as the keys in the map.
[[boot-features-external-config-complex-type-merge]] [[boot-features-external-config-complex-type-merge]]
==== Merging Complex Types ==== Merging Complex Types
When lists are configured in more than one place, overriding works by replacing the entire When lists are configured in more than one place, overriding works by replacing the entire
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment