Improve migration documentation at "28.1.8 Path Matching and Content Negotiation"

[huberchrigu]

The Spring Boot migration guide links https://docs.spring.io/spring-boot/docs/current/reference/html/boot-features-developing-web-applications.html#boot-features-spring-mvc-pathmatch for migrating MVC endpoints with suffix matching. There the documentation says

Spring Boot chooses to disable suffix pattern matching by default, which means that requests like "GET /projects/spring-boot.json" won’t be matched to @GetMapping("/projects/spring-boot") mappings. ... If you understand the caveats and would still like your application to use suffix pattern matching, the following configuration is required:

spring.mvc.contentnegotiation.favor-path-extension=true
...

That is not accurate, the given example will still not work. I suggest you also mention to add the following property

spring.mvc.pathmatch.use-suffix-pattern=true

Only then it works as with Spring 4.

[nishantraut]

Hi Phil, Can you help us to understand which file to be updated, as i understand that paragraph need to be updated to include property spring.mvc.pathmatch.use-suffix-pattern=true

Can you please guide? Thanks.

[philwebb]

Hi @nishantraut, The file in question is in spring-boot-project/spring-boot-docs/src/main/asciidoc/spring-boot-features.adoc. It's an asciidoctor file. You can find details about the syntax here.

Thanks!

[nishantraut]

Hi @philwebb Thanks for the update. I will try to update as soon as i can, bit busy with weekdays office work, mostly on Saturday will try to raise PR.

[nishantraut]

Or early if i get a chance.

[nishantraut]

Hi @philwebb Have committed changes under PR #14977 Please review and merge if looks ok. Thanks.