36得票6回答
Swagger中的枚举

我想知道如何在swagger中记录枚举类型。 根据 JavaDoc dataType是数据类型。请参阅所支持数据类型的文档。如果数据类型是自定义对象,请设置其名称,或者什么也不设置。在枚举类型的情况下,请使用'string'和allowableValues来表示枚举常量。 但是我没有...

26得票3回答
使用Javadocs生成Swagger文档。

我想为一组现有的RESTful API构建Swagger文档,并有以下要求: 离线生成Swagger文档(我使用了http://kongchen.github.io/swagger-maven-plugin/插件)。该插件帮助我在编译时生成Swagger文档。 阅读现有的Javadoc,以...

20得票2回答
Swagger日期字段 vs 日期时间字段

我正在使用Swagger测试我的REST API,我的实体类属性之一是一个日期字段,我需要以yyyy-mm-dd格式获取日期,但Swagger模型架构将此字段显示为日期时间而不是日期字段,因此它会提供带有时间和区域的日期。如何将这个日期时间转换为日期字段? 我有一个Java实体类TimeEn...

7得票1回答
swagger-maven-plugin未为单独的请求映射生成"paths"元素。

我有一个简单的端点,我希望使用swagger-maven-plugin进行处理。生成的swagger.conf文件没有正确反映每个@ApiOperations的“paths:”。API的根路径是“/api”,我想添加GET和PUT的端点到“/api/cluster”。然而,“paths:”子句...

7得票1回答
swagger-maven-plugin触发Javadoc警告:Java注释中的元素值必须是常量表达式(但实际上它就是!)。

Javadoc(通过Maven)在我的Java JAX-RS接口方法签名中给了我以下错误: error: element value must be a constant expression 这是我的JAX-RS接口: public interface FooResource { ...