Springfox-swagger继承支持

Question

有没有办法在springfox swagger（2.7.0）中暴露遗传/多态性？我知道昂首阔步规范支持所有的。springfox支持这个吗？下面是示例域模型。

@ApiModel
public abstract class Animal{
    private String name;
}

@ApiModel(parent=Animal.class)
public class Dog extends Animal{
    ...
}

@ApiModel(parent=Animal.class)
public class Cat extends Animal{
    ...
}

若控制者归还动物，那个么《大摇大摆》合同不会暴露猫或狗。它只返回带有属性的动物。

Answer 1

@ApiModel(subTypes = {
Dog.class,
Cat.class},
discriminator = "type")
public abstract class Animal{
    private String name;
    public abstract AnimalType getType();
}

@ApiModel(parent=Animal.class)
public class Dog extends Animal{
    ...
}

@ApiModel(parent=Animal.class)
public class Cat extends Animal{
    ...
}

public enum AnimalType{
CAT,
DOG;
}

像上面这样的解决方案对我有用，但只记录了具有所有选项（类型）的父类。

Answer 2

对多态性的支持仍然不可用（使用2.9.2）。我们在项目中所做的就是简单地手动添加模型。

在你的昂首阔步配置：

@Bean
public Docket apiDocumentation() {
    TypeResolver typeResolver = new TypeResolver();
    return new Docket(DocumentationType.SWAGGER_2)
                .additionalModels(
                    typeResolver.resolve(type1.class),
                    typeResolver.resolve(type2.class),
                    typeResolver.resolve(typeX.class));
}

这将使模型在swagger ui中可用

Answer 3

在您发布它时，SpringFox还没有添加对多态性的支持。然而，2.9.0版本似乎添加了它。看看这个