• swagger 的 pathmapping 配置的理解 断舍离


    1. 首选看源码注释:
    /* Extensibility mechanism to add a servlet path mapping, if there is one, to the apis base path. 扩展性机制,用于将servlet路径映射(如果有)添加到API基本路径。
    **/

    public Docket pathMapping(String path) { this.pathMapping = ofNullable(path);
    return this;
    }

    2.我的理解:
      2.1 它是一个附加虚拟路径,并没有映射产生对应到上@RequestMapping里面的路径。 所以你后端跑,配置上pathMapping用的话会报404.
      2.2 它会作用到生成swagger-doc里的api路径拼接 http://host:port/pathmapping/apiurl。
      2.3 在前后端分离架构上, swagger使用iframe方式嵌套,生成的地址都是前端暴露的地址端口,后端请求转发都需要拼接关键字 “dev-api”
        来标记区别是请求nginx静态资源,然后由proxy判断 关键字转发到后端接口, proxy会rewrite到后端地址+端口时,通常会去掉关键字“dev-api”.所以swagger生成的docs
        如果在此环境下需要配置上pathMapping 让它生成的文档地址里带上 关键字。这样swagger的api也是通过前端端口转发访问到后端了。
      2.4 假如要后端直接访问,那么要去掉 pathMapping. 这个就是经常遇到的问题key.
      
      

      
    博客地址: https://www.cnblogs.com/java2sap/
    世界丰富多彩,知识天花乱坠。
    ---如果有帮到你,点个赞吧~
  • 相关阅读:
    源码安装jdk
    yum操作的一些笔记
    Tomcat笔记
    源码编译安装zabbix server端和agent端
    用nginx做反向代理时 通过设置让后台真实服务器日志记录客户端的IP
    LVS负载均衡的两种调度模式:NAT和DR
    nginx配置文件详解
    FPGA高级设计——时序分析和收敛(转)
    12个有趣的C语言面试题
    LDO稳压器工作原理
  • 原文地址:https://www.cnblogs.com/java2sap/p/15538394.html
Copyright © 2020-2023  润新知