[docs] Explain URI template encoding [SPR-16422]

[spring-projects-issues]

Rossen Stoyanchev opened SPR-16422 and commented

Encoding with URI templates is a very common source of issues and questions. There are a number of options that have appeared over time as a result. Some can be discovered in the JavaDoc, e.g. RestTemplate#setUriTemplateHandler or the UriBuilderFactor in WebClient.Builder, but it's also easy to miss if debugging a problem or using the underlying UriComponentsBuilder directly.

This topic needs to be addressed properly and thoroughly in the reference where it would be easier to find. It would also make it easier to answer questions by pointing to the reference content.

---

Affects: 4.3.14, 5.0.3

Issue Links:

• UriComponentsBuilder does not encode "+" properly [SPR-16718] #21259 UriComponentsBuilder does not encode "+" properly
• Encoding of URI Variables on RestTemplate [SPR-16202] #20750 Encoding of URI Variables on RestTemplate

Referenced from: commits aa4bced, 4db0d99, 3d20db1