我想调整Swagger-UI for Java REST API . 要求:

  • 添加REST路径的描述

  • 为多个产品添加下拉列表(我能够这样做,但无法再次复制)

  • 添加要在"Model schema"中选择的示例

提前致谢 .

@Component
@Path("/test")
@Api(value = "/test",
    description = "Demo of how to pass JSON/XML document to the REST services", 
    consumes = MediaType.APPLICATION_JSON + "," + MediaType.APPLICATION_XML,
    produces = MediaType.APPLICATION_JSON + "," + MediaType.APPLICATION_XML)
@Consumes({ MediaType.APPLICATION_JSON, MediaType.APPLICATION_XML })
@Produces({ MediaType.APPLICATION_JSON, MediaType.APPLICATION_XML })
public class TerminologyRest2 {

    @POST
    @Consumes({ MediaType.APPLICATION_JSON, MediaType.APPLICATION_XML })
    @Produces({ MediaType.APPLICATION_JSON, MediaType.APPLICATION_XML })
    @ApiOperation(value = "Creates a product", 
                  notes = "Creates a product and puts it in the catalog.", 
                  consumes = MediaType.APPLICATION_JSON + "," + MediaType.APPLICATION_XML, 
                  produces = MediaType.APPLICATION_JSON + "," + MediaType.APPLICATION_XML, 
                  protocols = "POST", 
                  response = Product.class)
    @ApiResponses(value = { 
            @ApiResponse(code = 400, message = "Malformed definition of new product", response = StatusInfo.class),
            @ApiResponse(code = 500, message = "Internal server error", response = StatusInfo.class),
            @ApiResponse(code = 200, message = "Successful catalogization of new product", response = Product.class)
            })
    public Response createProduct(@ApiParam(name = "product", required = true, value = "Define product content") Product product) {
        try {

            return Response.status(200).entity(product).build();
        } catch (IllegalArgumentException e) {
            return Response.status(Status.NOT_ACCEPTABLE).entity(e.getMessage()).build();
        }
    }
}

目前:

通缉: