如何开始使用swagger-ui

Question

什么是swagger-ui，它的用途是什么？

我已经访问了http://swagger.io/，但我需要更多信息。

请给我引路。

Answer 1

Swagger UI是一个工具，可以获取Swagger规范文件，以可视方式呈现这些文件，并允许您执行操作。

Swagger本身就是一个用于记录和描述REST API的规范。规范可以在这里找到- https://github.com/swagger-api/swagger-spec/。存储库包含规范本身、json模式、示例等。该存储库的主要自述文件还为您提供了其他工具，包括库和框架，以生成您的规范。

在创建Swagger规范时，您可以使用其中一个框架，并将其与现有代码集成以自动生成此类文档。

如果您没有现有的应用程序，或者更愿意手动记录它，您可以使用Swagger-Editor工具或您选择的文本编辑器。

Answer 2

maven依赖：

    <dependency>
         <groupId>io.springfox</groupId>
         <artifactId>springfox-swagger2</artifactId>
         <version>2.4.0</version>
    </dependency>  
    <dependency>
        <groupId>io.springfox</groupId>
        <artifactId>springfox-swagger-ui</artifactId>
        <version>2.4.0</version>
    </dependency>

============================================================================

@Configuration
@EnableSwagger2   
    public class SwaggerConfig {

        private static final String SEARCH = "spring-rest-swagger";

        @Bean
        public Docket myApp() {
            return new Docket(DocumentationType.SWAGGER_2).groupName(SEARCH)
                    .apiInfo(apiInfo()).tags(new Tag(SEARCH, "spring-rest-swagger API"));
        }

        private ApiInfo apiInfo() {
            return new ApiInfoBuilder().title(SEARCH).build();
        }
    }

==============================================================================

下面的链接提供了参考使用的：(分步说明)

https://www.youtube.com/watch?v=xeYpiHLpme0&t=1s