我有一个名为Station的实体。 这个实体有一个名为attributes的属性，它是StationAttributes值对象。我尝试将属性设置为StationAttributes /*** @ORM\Column(name="attributes", type="station_attributes", nullable=true)
浏览 9提问于2019-05-23得票数 0
回答已采纳
我们在Spring REST控制器中使用各种swagger注释import io.swagger.annotations.ApiOperation但是，我们希望配置数据对象中的字段在Swagger文档中的显示方式。例如，我们可能希望字段名使用驼峰式大小写。暂时把Swagger放在一边，我知道我们可以使用Jack
浏览 0提问于2018-05-30得票数 1
1回答
我目前有几个共享公共对象的API。在某些情况下，我希望在生成swagger文档时隐藏这些常见对象的某些属性。age;
}
对于某些API，我希望年龄字段出现在swagger文档中，但在其他API中<em
浏览 11提问于2017-03-08得票数 3
Spring REST Docs最近发布了，文档中说：
这种方法可以使您摆脱像Swagger这样的工具所施加的限制。因此，我想问一下，与Swagger相比，Spring REST文档什么时候更适合使用，以及它能释放哪些限制。
浏览 3提问于2015-12-24得票数 42
回答已采纳
我使用Java11.0.2、SpringBoot2.2.6和Spring 1.1.49来使用注释创建一个OpenApi文档。在请求在Controller中创建一个商人时，我需要一个自定义header属性，但它必须是可选的。基于参数对象的Swagger文档，字段"required“(确定此参数是否为强制参数)。如果参数位置为"path"，则需要此属性，且
浏览 11提问于2020-05-14得票数 0
我已经验证了通过通过Postman调用API来正确序列化字段，但是Swashbuckle生成的Swagger定义没有正确地反映这一点。(定义只显示一个空类型)我已经创建了一个来复制这个。它在/api/Test提供了HTTP方法，它返回带有字段和属性的Test类型的对象。两者都是字符串。通过Postman调用此API将返回两个API的正确值</em
浏览 1提问于2020-11-27得票数 14
回答已采纳
我有一个特定的DTO，我用它作为Swagger文档的示例返回。如果我有一个成功的201代码，我该如何更改示例？ swagger中的示例响应： ? 我使用注释"@ApiModelProperty“来描述我的对象，但是没有办法为不同的响应代码更改示例。在我的代码中，我不想显示错误列表，因为它是一个可
浏览 94提问于2021-09-24得票数 3
回答已采纳
2回答
我使用Swashbuckle和Swagger自动生成API文档。public int?ID { get; set; }我的端点方法以PersonViewmodel作为主体，并使用IActionResult返回一个PersonViewmodel但是，我不希望用户定义一个ID，因为它是由业务逻辑生成的。在代码中，如果设置
浏览 6提问于2021-10-21得票数 0
2回答
我在我的apache cxf项目中使用了swagger，使用了@Api和@ApiOperations以及@ApiParam注释，并为rest服务生成了一个api文档。但我想从模型属性或完整的模块或属性属性中排除一些字段，如EntityTag、StatusType和MediaType等。
如何做到这一点？我从db获取数据，并将其设置为</e
浏览 1提问于2015-01-05得票数 17
1回答
ProductController：@RequestMapping("/api/v1")
如何描述/记录Swagger中CustomRepsonse的各个属性？也就是说，是否有一个Swagger注释来描述Custom
浏览 2提问于2017-07-31得票数 2
回答已采纳
我正在实施基于泽西的REST API，并使用swagger来生成基于HTML的文档。我正在使用swagger的注释来读取和扫描资源以生成文档。我已经使用@ApiResponse注释为每个资源指定了响应，如下所示：@Api(value = "Hello World"
浏览 0提问于2016-03-16得票数 5
我在我的Spring Boot应用程序中使用Springfox Swagger2版本2.4.0、Springfox Swagger UI版本2.4.0和Swagger Annotation版本1.5.0这里的问题是，我能够为我的控制器的API生成swagger UI，并且能够对其进行测试。但我无法为我的请求标头指定请求标头描述。我使用@Reque
浏览 4提问于2017-02-20得票数 9
1回答
我的控制器类中有几个方法，它们需要相同的Model/Payload类。我已经用@ApiModelProperty注释了那个类的属性。我已经为它们中的每一个提供了一个示例值。现在，当Swagger文档生成时，它使用这些值来创建一个完整的示例。到现在为止还好。
当我在请求中只需要一些字段时，问题就开始了。例如，当请求在/endpoint/1上打补丁时，<e
浏览 0提问于2019-07-24得票数 0
在最近与我的团队一起启动了一个基于Spring的新项目之后，我们决定放弃我们众所周知但过时的Swagger2.0文档实践，转而使用Swagger3.0标准来遵循OpenApi指令。为了避免过于激烈的跳跃，我们试图坚持基于配置和注释的自动生成文档风格。然而，这并不是没有困难的。
我们只想为一些高度可重用的类型定义一次模式，供整个项目使用。也就是说，我们使用org.bson.types.ObjectId字段，同时使用-to-string和string-to-序列化器
浏览 2提问于2020-02-11得票数 0
除此之外，我们还有swagger，使用注释为资源提供文档。问题
我们希望看到这些限制在swagger生成的文档中可见。有没有办法做到这一点？
浏览 0提问于2015-11-17得票数 17
回答已采纳
我试图在在线Swagger编辑器中的用户类上定义POST方法。我要做什么/改变什么才能做到这一点？我尝试过各种“必需”关键字的变体(请参见下面的图片中的一个关键词)，但是没有能够完成这项工作，它没有显示在生成的文档中(请参阅右边的图片，我的<
浏览 4提问于2020-09-17得票数 2
回答已采纳
4回答
我在Jersey2.17和杰克逊有一些RESTful API。它们都采用JSON风格，工作非常好。首先我试了，
它使用Json示例直接生成HTML文档。然后我尝试了，它知道一些杰克逊注释，比如@JsonProperty，但仍然不能处理@JsonIgnore。它也是数据模式的描述，而不是示例。如果API<
浏览 3提问于2016-12-06得票数 0
回答已采纳
1回答
我正在使用swagger文档为我的应用程序生成API。Doc是用yml编写的，在某些地方它将定义一些属性，这些属性是enum (我们使用mysql)。. // And so on and on{ "title": "string",正如您所看到
浏览 1提问于2015-06-26得票数 0
1回答
我使用Swagger API来记录我的REST服务。早些时候我的控制器方法没有信息性的注释，所以Swagger API没有显示描述，但现在即使在更新了注释之后，我也没有在突出显示的区域中获得方法描述。name="retailerId"></param>
/// <param name="returnId"&
浏览 0提问于2017-03-16得票数 11
回答已采纳
云服务器
ICP备案
云直播
实时音视频
即时通信 IM
腾讯云开发者
