我可以在Swagger的@ApiOperation中做出什么回应

时间:2015-07-21 21:56:58

标签: java rest swagger swagger-2.0

在此代码中,当此方法返回Response.noContent.build()时,我可以使用Status.class @ApiOperation吗?

    @DELETE
    @Path("/property/{id}")
    @ApiOperation(value = "Delete", notes = "Delete a persisted property from data source.", response = Status.class??)
    public Response delete(String id){
    ...
    ...
    return Response.noContent().build();
    }

1 个答案:

答案 0 :(得分:3)

您可以省略event.point部分,默认情况下会使用response。来自docs

  

Void.class

     

操作的响应类型。   在JAX-RS应用程序中,将自动使用该方法的返回类型,除非它是public abstract Class<?> response。在这种情况下,操作返回类型将默认为javax.ws.rs.core.Response,因为无法知道实际响应类型。(强调我的)

     

设置此属性将覆盖任何自动派生的数据类型。

     

如果使用的值是表示基元(voidInteger,...)的类,则将使用相应的基元类型。

     

默认

     

Long