我们使用Spring + Jackson(Java)。在我们的API中,我们可以发送不同的对象到同一个端点。 例如如何描述Swagger中的多态端点?
@JsonTypeInfo(
use = JsonTypeInfo.Id.NAME,
include = As.PROPERTY,
property = "type")
@JsonSubTypes({
@JsonSubTypes.Type(value = Dog.class, name = "dog"),
@JsonSubTypes.Type(value = Cat.class, name = "cat")
})
public static class Animal {
}
@JsonTypeName("dog")
public static class Dog extends Animal {
public double barkVolume;
}
@JsonTypeName("cat")
public static class Cat extends Animal {
boolean likesCream;
public int lives;
}
@Controller
public class MyController {
//REST service
@RequestMapping(value = "test")
public @ResponseBody String save(@RequestBody Animal animal){
System.out.println(animal.getClass());
return success;
}
}
发送到/测试
{
"type": "dog",
"barkVolume": 23.3
}
将显示Dog.class
发送到/测试
{
"type": "cat",
"likesCream": true,
"lives": 42
}
将显示Cat.class
如何描述Swagger中的多态端点?