RESTful Java Web Services - Third Edition

Annotation inheritance

JAX-RS annotations defined in a class or interface method are inherited by the corresponding subclass or implementation class method, provided that the method and its parameters do not define their own annotations. Let's familiarize ourselves with this with a simple example; the IEmployeeService interface defines REST API functions with the annotations required for EmployeeService to implement:

public interface IEmployeeService {  @GET @Path("{id}") @Produces(MediaType.APPLICATION_JSON) public Employee findEmployee(@PathParam("id") Short id);  @GET @Path("{age}") @Produces(MediaType.APPLICATION_JSON) public List<Employee> findEmployeesByAge(@PathParam("age") Short age); }public class EmployeeService implements IEmployeeService{ ...