kotlin - 为 Kotlin Swagger

Question

有人用过 Kotlin 的 swagger 工具吗？

在我们的组织中，我们使用 Java 和 SpringMVC(@RestController 类)创建了大部分 REST 服务。我们已经使用 springfox 生成了 Swagger API 文档。 swagger JSON 表示还用于自动提供可搜索的服务目录，因此服务元数据的 swagger 格式对我们很重要。

一些开发团队现在开始使用 Kotlin。我们正在寻找与在 Kotlin 中使用 springfox 或其他 swagger 库相关的建议或评论。

Answer 1

这是带有 swagger 的示例 spring boot 应用程序:

@RestController
class MyController {
    @ApiOperation(value = "doc header...", notes = "detailed doc...")
    @RequestMapping(value = "/double", method = arrayOf(RequestMethod.GET))
    fun doubleValue(number: Int) = 2 * number
}


@Configuration
@EnableSwagger2
class SwaggerConfig {
    @Bean
    fun api(): Docket {
        return Docket(DocumentationType.SWAGGER_2)
                .select()
                .apis(RequestHandlerSelectors.any())
                .paths(PathSelectors.any())
                .build()
    }
}

依赖是

compile("io.springfox:springfox-swagger2:2.7.0")
compile("io.springfox:springfox-swagger-ui:2.7.0")

如果您浏览 http://localhost:8080/swagger-ui.html一切都在那里......