• 阶段一-01.万丈高楼,地基首要-第3章 用户登录注册模块开发-3-6 整合Swagger2文档api


    已经开发完了两个接口,一个是注册,一个是判断用户名是否存在。

    引入swagger2



    引入这一段相应的依赖

    父工程内添加引用。核心内容都是在springfox-swagger2
    前两个是官方提供的,从groupId就可以看出来。


    这一个是自行添加的。由其他的开发人员所发布的UI

    编写配置

    在Api的微服务里面,创建config的包。

    创建swagger2

    让Springboot容器扫描到。加上@Configuration的注解。加上注解后就会被扫描到。

    第二步,要开启swagger2的配置。

    配置swagger2的核心配置,被称为docket




    进入到documentionType里面,发现对应的三种版本,我们使用的是2.0的 对应的是swagger_2




    响应式的编程风格,在后面直接,点 apiInfo

    点进来查看ApiInfo

    进入ApiInfo

    ApiInfo里面包含了很多的属性。


    我们重新的去创建一个新的方法。返回ApiInfo类型的


    apiInfo在主方法内调用。

    配置扫描包的地址

    配置扫描包所在的地址,也就是我们现有的所有的controller所在的地址。
    ,目前我们所有的controller都在com.imooc.controller包下。那么所需要去生成的文档,要根据哪些controller来。他们的源头又是在哪个包呢。

    使用select选择器,里面有个apis里面的参数是RequestHandler,RequestHandler就是一个选择器。


    基础的包名

    Path指定扫描包,扫描哪些,这里any是所有的。最后调用build方法。

    这样我们的配置就都配置好了。

    最后再加上@Bean的注解。让它编程一个Spring的Bean


    swagger2的访问路径、

    执行 maven install

    运行测试

    启动api服务。输入地址测试。



    就是代码的这一部分信息






    测试用户名的调用

    换肤

    使用的就是我们之前引入的这个依赖。

    访问路径比较简单

    doc.html。分成了左右,左边是导航,右边是信息。



    测试用户名是否存在的接口。

    结束


     

  • 相关阅读:
    Kafka简介
    Storm之详解spout、blot
    【刷题】面筋-页面很卡的原因分析及解决方案
    【JAVA】栈和堆,JVM内存概述
    【刷题】面筋-游戏测试-农药测试向分析
    【刷题】面筋-游戏测试-什么样的游戏可以称为一个好的游戏
    【刷题】面筋-两颗鸡蛋测临界楼层的问题
    【刷题】面筋-游戏测试的目的和流程
    【刷题】面筋-测开-游戏测试用例要点与测试俄罗斯方块
    【刷题】面筋-游戏平衡性
  • 原文地址:https://www.cnblogs.com/wangjunwei/p/12080833.html
Copyright © 2020-2023  润新知