How to define swagger annotation for json payload(如何为 json 有效负载定义 swagger 注释)
问题描述
如何为这个示例 post API 定义 swagger 注释.TenantConfiguration 正在获取为 json 有效负载.
how to define swagger annotation for this example post API.TenantConfiguration is getting as a json payload.
@Consumes({ "application/json", "application/xml" })
@POST
public Message configureSettings(TenantConfiguration configuration)
throws AndroidAgentException {
.....................
}
推荐答案
我找到了一个使用 Jax-rs APIs 注释 json 的解决方案.它工作正常.
I found a solution to annotate json consuming Jax-rs Apis.It's working properly.
@POST
@ApiOperation(
consumes = MediaType.APPLICATION_JSON,
httpMethod = "POST",
value = "Configuring Android Platform Settings",
notes = "Configure the Android platform settings using this REST API"
)
@ApiResponses(value = {
@ApiResponse(code = 201, message = "Android platform configuration saved successfully"),
@ApiResponse(code = 500, message = "Internal Server Error")
})
Message configureSettings(@ApiParam(name = "configuration", value = "AndroidPlatformConfiguration")
TenantConfiguration configuration) throws AndroidAgentException;
JSON 对象的映射类.
Mapping class for the JSON object.
@XmlRootElement(
name = "tenantConfiguration"
)
@XmlAccessorType(XmlAccessType.NONE)
@ApiModel(
value = "TenantConfiguration",description = "This class carries all
information related to a Tenant configuration"
)
public class TenantConfiguration implements Serializable {
@XmlElement(
name = "type"
)
@ApiModelProperty(
name = "type",
value = "type of device",
required = true
)
private String type;
@ApiModelProperty(
name = "configuration",
value = "List of Configuration Entries",
required = true
)
@XmlElement(
name = "configuration"
)
private List<ConfigurationEntry> configuration;
public TenantConfiguration() {
}
public String getType() {
return this.type;
}
public void setType(String type) {
this.type = type;
}
public List<ConfigurationEntry> getConfiguration() {
return this.configuration;
}
public void setConfiguration(List<ConfigurationEntry> configuration) {
this.configuration = configuration;
}
}
这篇关于如何为 json 有效负载定义 swagger 注释的文章就介绍到这了,希望我们推荐的答案对大家有所帮助,也希望大家多多支持编程学习网!
本文标题为:如何为 json 有效负载定义 swagger 注释
基础教程推荐
- 在springboot中如何给mybatis加拦截器 2023-04-29
- Maven:无效的目标版本:10 2022-01-01
- 将 Windows 证书导入 Java 2022-01-01
- 控制台应用程序中的 Java 键盘输入解析 2022-01-01
- JPA惰性列表上的流 2022-01-01
- doFilter()是在servlet的工作完成之前还是之后执行的? 2022-01-01
- 如何在相机中应用自定义滤镜 [Surfaceview 预览]. 2022-01-01
- 在java中使用xpath和selenium解析HTML表格数据 2022-01-01
- Java ECDSAwithSHA256 签名长度不一致 2022-01-01
- 将 double 转换为 Int,向下舍入 2022-01-01
