How to version my API with Spring MVC?

Question

For now, URLs of my API are for example:

/api/users

With Spring MVC:

@RequestMapping("/api/users")

I would like to version this api:

/api-v1.0/users

The best would be to be able to use an SpEL in the @RequestMapping annotation, but it is unfortunately not possible:

@RequestMapping("/api-#{appProps['version']}/users")

What are the other options then?

1. Code it hard. 2. pre-process your code (e.g. ant-replace/maven-filter...) 3. Extend DefaultAnnotationHandlerMapping (but don't break it:) — xerx593
– xerx593, Commented Apr 22, 2015 at 18:01

Jose Luis Martin · Accepted Answer · 2015-04-23 00:09:38Z

3

Try with @RequestMapping("/api-${version}/users").

answered Apr 23, 2015 at 0:09

Jose Luis Martin

10.7k1 gold badge40 silver badges38 bronze badges

Sign up to request clarification or add additional context in comments.

Comments

minion · Accepted Answer · 2015-04-23 01:41:27Z

2

@RequestMapping resolves from property place holder values. So define a PropertySourcesPlaceHolderConfigurer like below.

<context:property-placeholder location="classpath*:*.properties"/>

Then use the syntax like below.

@RequestMapping("/api-${version}/users")

answered Apr 23, 2015 at 1:41

minion

4,3532 gold badges22 silver badges35 bronze badges