[chuuminggg]

PathPattern supports capturing the rest of a path into a variable with {*name}, for example:

@GetMapping("/files/{*path}")
String file(@PathVariable("path") String path) { … }

When such a request is documented with pathParameters, PathParametersSnippet takes the variable's name to be *path rather than path:

this.mockMvc.perform(RestDocumentationRequestBuilders.get("/files/{*path}", "a/b.txt"))
	.andDo(document("capture", pathParameters(parameterWithName("path").description("File path"))));

org.springframework.restdocs.snippet.SnippetException: Path parameters with the following names were not documented: [*path]. Path parameters with the following names were not found in the request: [path]

The only way to document the parameter is currently parameterWithName("*path"), which then appears as *path in the snippet.

getParameterName already removes a :regex suffix from the variable. This PR also removes a leading *, so the parameter is named path, matching the name that's used with @PathVariable. I've checked this end to end with MockMvc and a @GetMapping("/files/{*path}") controller as well as with the new unit test in PathParametersSnippetTests.

This is a change in behavior for anyone who's worked around the problem by documenting *path. They'd need to document path instead.