SWAGGER2_INTEGRATION_WITH_SPRING_REST

CustomerServiceController.java

@Controller
@Api(value = "customers")
public class CustomerServiceController {
    ...
    @ApiOperation(value = "Gets a customer based on customer id", 
        notes = "Retrieves a single customer", response = Customer.class)
    @RequestMapping(method = RequestMethod.GET, 
        produces = { MediaType.APPLICATION_XML_VALUE,
                     MediaType.APPLICATION_JSON_VALUE }, 
        value = "customers/{id}")
   @ResponseBody
   public Customer getCustomer(@PathVariable Integer id) {
       Customer customer = service.getCustomer(id);
       return customer;
  }
 ...
}