我正在使用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时遇到过类似的问题?你是怎么过来的?