标签：springfox 8.6 每日 swagger2 一记 文档 接口 注解 swagger

swagger2和spring boot的整合

　　在项目中接口文档是前后端对接的重要工具，而作为编写文档的后端人员每次在写完接口还需要整理这些文档，无疑是降低了工作的效率。这时如果有一款可以在编写代码的同时就顺便把文档写了的插件或者工具就会方便许多。swagger2就是这样一款API开发框架。

　　swagger2是基于注解的方式，侵入接口中，动态的生成接口文档，方便前后端人员的查看。

swagger2的配置

1、swagger2是一个api框架，所以，在项目中使用他需要导入他的jar包

在pom文件中添加依赖

<dependency>
    <groupId>io.springfox</groupId>
    <artifactId>springfox-swagger2</artifactId>
    <version>2.6.1</version>
</dependency>

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

2、创建Swagger2配置类

@Configuration
public class SwaggerConfig {
    
    @Bean
    public Docket createRestApi() {
        return new Docket(DocumentationType.SWAGGER_2).apiInfo(apiInfo()).select()
                .apis(RequestHandlerSelectors.basePackage("com.example.demo.controller")).paths(PathSelectors.any())
                .build();
    }
    /**
     * 在接口文档中，添加的一些标题和描述
     */
    private ApiInfo apiInfo() {
        return new ApiInfoBuilder().title("springboot和swagger整合").description("接口文档")
                .termsOfServiceUrl("测试url").contact("taizhu").version("1.0").build();
    }
}

3、在启动类上添加注解@EnableSwagger2

到此，我们的swagger就配置完毕了。启动项目，在地址栏输入：http://localhost:8080/swagger-ui.html#/就可以看到swagger动态生成的api文档。

swagger2的注解

swagger2是基于注解开发的，所以每一个注解有什么含义，我们必须掌握。

在CSDN上看到的比较全的注解以及解释。https://blog.csdn.net/weixin_41846320/article/details/82970204

标签：springfox,8.6,每日,swagger2,一记,文档,接口,注解,swagger
来源： https://www.cnblogs.com/sunshine-2018/p/11306812.html

本站声明： 1. iCode9 技术分享网（下文简称本站）提供的所有内容，仅供技术学习、探讨和分享；
2. 关于本站的所有留言、评论、转载及引用，纯属内容发起人的个人观点，与本站观点和立场无关；
3. 关于本站的所有言论和文字，纯属内容发起人的个人观点，与本站观点和立场无关；
4. 本站文章均是网友提供，不完全保证技术分享内容的完整性、准确性、时效性、风险性和版权归属；如您发现该文章侵犯了您的权益，可联系我们第一时间进行删除；
5. 本站为非盈利性的个人网站，所有内容不会用来进行牟利，也不会利用任何形式的广告来间接获益，纯粹是为了广大技术爱好者提供技术内容和技术思想的分享性交流网站。