Improve Reference documentation @PathVariable, @RequestHeader & @RequestParam using Map<String, String> [SPR-12347]

[spring-projects-issues]

Manuel Jordan opened SPR-12347 and commented

Summary: I have checked the Spring Framework Reference Documentation and there is no an example about @PathVariable working together with Map<String, String>

Perhaps same situation for @RequestHeader, @RequestParam too

---

Affects: 4.0.7, 4.1.1

Issue Links:

• @PathVariable's javadoc wrongly states it supports MultiValueMaps [SPR-16936] #21475 @PathVariable's javadoc wrongly states it supports MultiValueMaps
• Allow @PathVariable to have default value on @ModelAttribute methods [SPR-12305] #16910 Allow @PathVariable to have default value on @ModelAttribute methods

Referenced from: commits df09023

[spring-projects-issues]

Rossen Stoyanchev commented

Also the @RequestMapping Javadoc.

[spring-projects-issues]

Manuel Jordan commented

Perhaps same appreciation for each annotation in its javadoc?

[spring-projects-issues]

Manuel Jordan commented

Has been fixed for Spring 4.0.x too?
Perhaps same appreciation for 3.2.x

The API has been updated too? (for each annotation)

Thank you.

[spring-projects-issues]

Rossen Stoyanchev commented

Note that it is there in Javadoc on @RequestMapping even in 3.2 (see here). It's also partially documented in the reference. I just added it in more places.

[spring-projects-issues]

Manuel Jordan commented

Thanks by the reminder. I forgot that detailed information about that annotation.