Рекомендации по перегрузке http-методов в REST

Question

Я использовал регулярное выражение в @Path для достижения перегрузки, и сначала я думал, что это действительно опрятно, но методы перегрузки обычно не являются хорошей практикой. То же самое относится к веб-службам RESTful? Есть ли лучший способ добиться этого с помощью JAX-RS?

Так теперь я могу назвать мою службу getProject привала/проект/ProjectNumber1000 или/проектом/12345

@Path("/project") 
public class ProjectPropertiesResource 
{ 
    @GET 
    @Produces(MediaType.APPLICATION_JSON) 
    @Path("/{name : [a-zA-Z]+}") 
    public Response getProjectPropertiesByName(@PathParam("name") String name) 
    { 
     ... 
    } 

    @GET 
    @Produces(MediaType.APPLICATION_JSON) 
    @Path("/{id : \\d+}") 
    public Response getProjectPropertiesById(@PathParam("id") long id) 
    { 
     ... 
    } 
} 

Answer 1

Вы можете сделать это, однако, только один из перегруженных должен фактически вернуть тело ответа с 200 . Другие перегрузки должны возвращать перенаправление 303 в URI, который возвращает тело.

Это гарантирует, что в кешах будет только одна копия ресурса, и если вы используете PUT или POST на основном URI, вы аннулируете одну копию. В противном случае вы можете начать получать непоследовательные результаты из-за разных версий, существующих в кеше.