@@ -48,20 +48,23 @@ option java_package = "io.spine.validate";
48
48
// After substitution, the final output would be:
49
49
// "My dog's name is Fido."
50
50
//
51
- // Each placeholder `key` should have a corresponding entry in `placeholder_value`.
51
+ // Each placeholder `key` referenced in the template string must have a corresponding entry
52
+ // in the `placeholder_value` map. However, the `placeholder_value` map is not restricted to
53
+ // containing only the placeholders used in the template. Additional entries in the map
54
+ // that do not correspond to placeholders in the template string are permitted.
52
55
//
53
56
message TemplateString {
54
57
55
58
// The template string that may contain one or more placeholders.
56
59
string with_placeholders = 1 ;
57
60
58
- // A map that provides values for each placeholder referenced in `with_placeholders`.
61
+ // A map that provides values for placeholders referenced in `with_placeholders`.
59
62
//
60
- // The keys in this map should match the placeholder keys inside `with_placeholders` without
61
- // the `${}` placeholder marker .
63
+ // The keys in this map should match the placeholder keys inside `with_placeholders`
64
+ // excluding the `${}` placeholder markers .
62
65
//
63
- // All placeholders present in `with_placeholders` must have corresponding entries in this map,
64
- // otherwise the template is considered invalid.
66
+ // All placeholders present in `with_placeholders` must have corresponding entries
67
+ // in this map. Otherwise, the template is considered invalid.
65
68
//
66
69
map <string , string > placeholder_value = 2 ;
67
70
}
0 commit comments