RESTful Java Web Services - Third Edition

Request matching

JAX-RS uses the @Path annotation for dispatching requests to corresponding resource or sub-resource methods using the following steps:

1. Identify a set of candidate root resource classes matching the request.
2. Obtain a set of candidate resource methods for the request.

3. Identify the method that will handle the request.
4. If no matching resource method or sub-resource method can be found, then an appropriate error response is returned.

Now let us illustrate, for the following services, Service1 and Service2, how request dispatching happens when a client requests the target resources:

@Path("/s1")public class Service1 {    /**     * Creates a new instance of Service1         */    public Service1() {    }    @GET    @Path("{name : .+}") @Produces(MediaType.APPLICATION_JSON) ...