Springfox——如果POJO未在控制器中使用，是否可以通过注释记录POJO

Question

正如标题所说，如果在控制器方法中没有使用POJO，那么它是否可以包含在一个招摇过市的文档中？

我尝试在POJO类上使用@ApiModel注释，即：

@ApiModel("POJO")
public class Pojo {
  ...
}

然而，除非控制器返回POJO，否则我无法让它出现在生成的swagger文档中。有没有办法做到这一点？

顺便说一下，我使用的是springfox 2.9.2版。

Answer 1

有了Springfox，这是可能的。你只需要修改你的摘要。将additionalModels方法添加到您的Docket实现中：

@Autowired
private TypeResolver resolver;

@Bean
public Docket api() {
    return new Docket(DocumentationType.SWAGGER_2)
            .select()
            .apis(RequestHandlerSelectors.any())
            .paths(PathSelectors.any())
            .build()

            ...

            .additionalModels(resolver.resolve(Pojo.class));
}