Spring Boot Starter Data Rest change URL of repository from the root URI

Question

Following the spring.io example here: http://spring.io/guides/gs/accessing-data-rest/ for exposing a repository as a rest web service works just fine, but I cannot see how to change the URL of the exposed service. The API documentation is a little vague as to what the annotation parameters mean, perhaps some prior knowledge is assumed.

What I want - A HATEOAS service accessed at http://localhost:8080/api/people for a People repository. I want to achieve this URL using annotations only, not messing with the context root or similar. I tried the following repository annotations:

• @RepositoryRestResource(collectionResourceRel = "api/people", path = "people")
• @RepositoryRestResource(collectionResourceRel = "people", path = "api/people")
• @RepositoryRestResource(collectionResourceRel = "api/people", path = "api/people")

None of these work.

I know I have probably missed the obvious, much appreciate anyone who can point it out.

Answer 1

As of Spring Boot 1.2 you are able to set this property:

spring.data.rest.baseUri=api

Alternatively:

spring.data.rest.base-uri=api

(Spring Boot uses a relaxed binding system)

NOTE: I have found that if you have extended RepositoryRestMvcConfiguration with custom configuration, the property does not take effect. For more information see:

https://github.com/spring-projects/spring-boot/issues/2392

Once the next version of Spring Boot is released (after 1.2.1), the solution will be to extend RepositoryRestMvcBootConfiguration instead.