Swagger jaxrs Doclet自定义注释不生成输出

时间:2015-04-28 17:27:29

标签: swagger doclet

我正在使用teamcarma中非常有用的swagger-jaxrs-doclet工具来生成必要的json文件,这些文件可以输入swagger-ui前端来记录我的RESTful服务。

我遇到的一个问题是doclet文档中描述的自定义注释(例如@bodyType)在文档生成时似乎没有被doclet选中。

以doclet文档本身为例,我可能会记录一个服务端点:

/**
 * @inputType fixtures.inputtype.Data2
 */
@POST
@Path("/postData2b")
public Response postData2b(@HeaderParam("X-forwarded-for") String xFwd, @QueryParam("p1") int p1, Data1 data) {
    return Response.ok().build();
}

我希望@inputType注释用于提供身体模型。

不幸的是,注释完全被忽略了。

有没有人在使用swagger-jaxrs-doclet时遇到过类似的问题?你是怎么过来的?

0 个答案:

没有答案