Document how POST subresources URI in @RepositoryRestController [DATAREST-1107]

Daniele Renda opened DATAREST-1107 and commented

Would be helpful have more specification about how to use @RepositoryRestController facilities to convert subresources URI in a POST endpoint.

Sometimes to POST a resource you need to send also mandotory subresources (like in my case); so you have to POST everything at the same time.

For example:

@PreAuthorize("isAuthenticated()")
@RequestMapping(method = RequestMethod.POST, path = "/storeBlocks")
public ResponseEntity<?> storeBlocks(@RequestBody(required = true) TicketType ticketType,
@RequestBody(required = true) CheckPoint checkPoint, int firstBlockNumber, int lastBlockNumber, Locale locale)

in this case I'm trying to save several entities called TicketBlock that needs two subresources to be persisted: CheckPoint and TicketType.

According to HATEOAS principles I would expect to send an URIs for CheckPoint and TicketType resources but in custom controllers this doesn't work.

I would expect to have the same facility like in Spring Data REST default repositories or at least to have some documentation explaining how I could reach the same level of automation.

I guess this is not a bug but just an improvement that would be very useful though

Affects: 2.6.4 (Ingalls SR4)