springfox - swagger 2 - 如何设置全局参数的类型

Question

我正在使用带 spring 引导的 swagger 2.5.0 来生成 api 文档。我配置了一个全局 header 参数，如下所示：

myDocket.globalOperationParameters(return Arrays.asList(
        new ParameterBuilder()
            .name("version")
            .description("Version of the api. Starting with 1.")
            .modelRef(new ModelRef("integer"))
            .parameterType("path")
            .defaultValue("1")
            .required(true)
            .build()))

问题是，它生成了这个 apidoc.json:

...."parameters":[{"name":"version","in":"path","description":"Version of the api. Starting with 1.","required":true,"type":"ref","default":"1"}],.....

问题是 "type":"ref" 。 Swagger 编辑器说这是无效的。

我怎样才能大摇大摆地生成 "type":"string" ???

Answer 1

将 .modelRef(new ModelRef("integer")) 更新为 .modelRef(new ModelRef("string"))。

springfox - swagger 2 - 如何设置全局参数的类型

springfox - swagger 2 - How to set type of global parameter

swagger

spring-boot

swagger-2.0