2

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

4

0 回答 0