Convenient API Version Configuration in MockMvc

Question

Convenient API Version Configuration in MockMvc

Closed this issue 21 hours ago · 3 comments

Java 21
Spring Boot 4 RC1
Example Project: https://github.com/hantsy/spring7-sandbox/tree/master/boot-api-versioning-webmvc

When I wrote the example codes, I found there is no convenient methods for configuring API versioning.

BTW, it seems MockRestServiceServer is also not updated for apiversion mock/assertion.

Answer 1 · 2025-11-07T13:20:51.000Z

There is such support, so it's unclear what you mean or what you've tried. The referenced project has a test with an autowired MockMvc. That's configurable through a MockMvcBuilderCustomizer. On ConfigurableMockMvc builder you can set the version inserter for the request side. For the handling side, the standalone builder accepts an ApiVersioningStrategy, or if using an ApplicationContext based setup, then it's picked up from your application config.

Answer 2 · 2025-11-08T01:06:40.000Z

The MockMvcBuilderCustomizer lack a defaultApiVersion existed in other Customizers.

Answer 3 · 2025-11-08T08:29:19.000Z

Good point, but there is defaultRequest that at least allows it:

standaloneSetup(new MusicController())
		.defaultRequest(get("/").apiVersion("1.2")
		.build()