Spring-Boot 使用 Swagger-UI 时隐藏自动注入的实体类,并显示 HttpHeader 中的 token 参数

通常在构建 API 时会通过 在 HttpHeader 中传递 Token 参数来自动注入用户实体类,但是在 Swagger-UI 生成的文档中测试时,既没有输入 token 的地方,在参数列表中还存在用户实体类参数,造成了 Swagger-UI 与实际调用参数完全不符的情况。实际上使用一些简单的设[……]

Read more

Spring-Boot 与 Swagger-UI 整合搭建

在 RESTful API 的构建中,接口文档的重要性不言而喻,而 Swagger-UI 就提供了一种自动构建接口文档的方式,它可以轻易的整合在 Spring-Boot 中,并且在写在代码中可以省去代码注释与接口文档中的重复工作,更是易于维护与更新。

  1. 添加依赖
    <dependency[......]

    Read more