zoukankan      html  css  js  c++  java
  • springboot 2.0.4 利用swagger2构建api文档

    springboot 2.0.4
    swagger 2.8.0
            <dependency>
                <groupId>io.springfox</groupId>
                <artifactId>springfox-swagger2</artifactId>
                <version>2.8.0</version>
            </dependency>
            <dependency>
                <groupId>io.springfox</groupId>
                <artifactId>springfox-swagger-ui</artifactId>
                <version>2.8.0</version>
            </dependency>

    sp升级到2.0 以后,swagger 包也要升级,否则页面打不开

    一、pom

    二、 配置类

    package cn.com.connext.authority.config;
    
    import org.springframework.context.annotation.Bean;
    import org.springframework.context.annotation.Configuration;
    import org.springframework.web.context.request.async.DeferredResult;
    import springfox.documentation.builders.ApiInfoBuilder;
    import springfox.documentation.service.ApiInfo;
    import springfox.documentation.service.Contact;
    import springfox.documentation.spi.DocumentationType;
    import springfox.documentation.spring.web.plugins.Docket;
    import springfox.documentation.swagger2.annotations.EnableSwagger2;
    
    import static com.google.common.base.Predicates.or;
    import static springfox.documentation.builders.PathSelectors.regex;
    
    @Configuration
    @EnableSwagger2
    public class SwaggerConfig {
    
        /**
         * 可以定义多个组,比如本类中定义把test和demo区分开了
         * (访问页面就可以看到效果了)
         */
        @Bean
        public Docket testApi() {
            return new Docket(DocumentationType.SWAGGER_2)
                    .groupName("auth")
                    .genericModelSubstitutes(DeferredResult.class)
                    .useDefaultResponseMessages(false)
                    .forCodeGeneration(true)
                    .pathMapping("/")// base,最终调用接口后会和paths拼接在一起
                    .select()
                    .paths(or(regex("/api/.*")))//过滤的接口
                    .build()
                    .apiInfo(testApiInfo());
        }
    
    
        private ApiInfo testApiInfo() {
            return new ApiInfoBuilder()
                    .title("product API")//大标题
                    .version("1.0")//版本
                    .build();
        }
    
    }

    访问:

    http://localhost:9091/swagger-ui.html

    swagger2.9 好像又不一样了

    参考:https://blog.csdn.net/allen_lu_hh/article/details/83218028

    404 参考 https://www.jianshu.com/p/04dd5ff82dad

  • 相关阅读:
    Pupet自动化管理环境部署记录
    Puppet常识梳理
    手动编写的几个简单的puppet管理配置
    Centos下部署DRBD+NFS+Keepalived高可用环境记录
    DRBD详细解说及配置过程记录
    kvm虚拟化管理平台WebVirtMgr部署-完整记录(2)
    kvm虚拟化管理平台WebVirtMgr部署-完整记录(1)
    kvm虚拟化管理平台WebVirtMgr部署-完整记录(0)
    zabbix监控-基本原理介绍
    OpenStack构架知识梳理
  • 原文地址:https://www.cnblogs.com/lyon91/p/10410716.html
Copyright © 2011-2022 走看看