我正在尝试使用swagger spring-mvc(https://github.com/martypitt/swagger-springmvc)为我的java spring MVC API自动生成文档 .

为什么我的@Api注释没有使用描述?我正在使用(com.wordnik.swagger.annotations.Api) . 这是我的控制器中的@Api声明:

@Api(value = "hierarchies", description = "Hierarchies Resource")

这是来自/ api-docs /的结果JSON:

{"path":"/v1/hierarchies","description":"hierarchies"}

即使是昂首阔步的在线演示也显示了描述的有效性:

http://petstore.swagger.wordnik.com/

在JSON中,它显示:{“path”:“/ pet”,“description”:“关于宠物的操作”}

似乎文档引擎忽略了描述字段,无论我输入什么,只是使用描述的值 . 我在swagger-springmvc做错了什么?我需要使用不同的注释吗?这只是swagger-spring-mvc中的一个错误吗?