Swagger示例

对于项目完成后不用写文档,好处还是蛮大的

不需要关注项目其他 只关注接口与实体类即可

SpringBoot项目

依赖

复制代码
<!--Swagger依赖-->
<dependency>
    <groupId>io.springfox</groupId>
    <artifactId>springfox-swagger2</artifactId>
    <version>2.9.2</version>
</dependency>

<!--Swagger UI-->
<dependency>
    <groupId>io.springfox</groupId>
    <artifactId>springfox-swagger2</artifactId>
    <version>2.9.2</version>
</dependency>

启动类或者配置类添加开启Swagger注解

对于SpringBoot版本2.6以上的 需要配置文件里加个配置 不然启动报错(设置个路径)

复制代码
SpringBoot版本2.6以上,需要在配置文件里假如  解决SpringBoot2.6.2使用Swagger的问题

浏览器访问: http://ip:port/上下文/swagger-ui.html

可以写个Swagger配置类

复制代码
@Configuration
public class SwaggerConfig {

    //配置Swagger docket的bean实例
    @Bean
    public Docket docket(){

        //1.创建Docket对象
        Docket docket=new Docket(DocumentationType.SWAGGER_2);

        //2.创建API信息,接口文档总体描述
        /**
         * 使用指定的信息构造 ApiInfo 的实例。
         *
         * @param title               API 的标题。
         * @param description         API 的描述。
         * @param version             API 的版本。
         * @param termsOfServiceUrl   API 的服务条款 URL。
         * @param contact             API 的联系信息。
         * @param license             API 的许可证信息。
         * @param licenseUrl          API 许可证的 URL。
         * @param vendorExtensions    要包含在 API 文档中的额外供应商扩展。
         */
        ApiInfo apiInfo=new ApiInfoBuilder()
                .title("图书馆管理系统 API")
                .version("1.0.0")
                .description("前后端分离项目,前端vue,后端SpringBoot+Dubbo分布式项目")
                .contact(new Contact("hrui", "www.hrui.com", "[email protected]"))
                .license("Apache 2.0")
                .licenseUrl("http://www.opensource.org/licenses/mit-license.php")
                .build();
        //3.使用ApiInfo
        docket = docket.apiInfo(apiInfo);
        //4.设置参与文档生成的包
        docket=docket.select().apis(RequestHandlerSelectors.basePackage("com.example.controller")).build();
        return docket;

    }


}

下面介绍一款国人开发整合的 叫knife4j

git地址

swagger-bootstrap-ui-demo: knife4j 以及swagger-bootstrap-ui 集成框架示例项目

用法 不注释掉也可以 两个可以一起使用

看下新的页面效果

访问http://ip:端口/上下文/doc.html

两个可以一起使用 我这里没有配置上下文路径 访问路径分别为

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

http://localhost:8080/doc.html

Swagger注解

  1. @Api:用于描述整个Controller API的信息,包括API的标题、描述等。

  2. @ApiOperation:用于描述单个接口,包括接口的HTTP方法、URL路径、接口的描述等。

  3. @ApiParam和@ApiImplicitParam和@ApiImplicitParams:用于描述接口中的参数信息。

  1. @ApiResponse:用于描述接口的响应信息,可以包括多个响应。

  2. @ApiResponses :用于包装多个@ApiResponse注解,可以用于一个接口有多个响应情况的情形。

  3. @ApiModel:用于描述一个DTO(数据传输对象)类。

  4. @ApiModelProperty:用于描述DTO类中的属性信息。

  5. @ApiIgnore :用于忽略某个类、方法或字段,不在Swagger文档中显示。@ApiIgnore

查看效果

后续都用这个国人改造的 感觉好看点

paramType 是这些注解中一个重要的属性,表示参数的位置,常见取值有:

  • query: 参数在 URL 中,例如:http://example.com/resource?param1=value1&param2=value2
  • path: 参数是 URL 的一部分,例如:/resource/{param}
  • header: 参数在请求头中。
  • body: 复杂对象参数通常放在请求体中,适用于 POST 或 PUT 请求。
  • form: 参数以表单的形式提交,通常用于 POST 请求。
相关推荐
矮油0_o10 分钟前
5.好事多磨 -- TCP网络连接Ⅱ
服务器·网络·tcp/ip·网络编程·socket
独隅30 分钟前
针对Ansible执行脚本时报错“可执行文件格式错误”,以下是详细的解决步骤和示例
运维·开发语言·ansible·lua·lua5.4
m0_677904841 小时前
Nginx介绍及使用
服务器·nginx
菜鸟xy..1 小时前
麒麟系统桌面版本v10安装教程
linux·运维·服务器·虚拟机·安装教程·麒麟
什么半岛铁盒1 小时前
存储基石:深度解读Linux磁盘管理机制与文件系统实战
linux·运维·服务器
我命由我123451 小时前
C++ - 头文件基础(常用标准库头文件、自定义头文件、头文件引入方式、防止头文件重复包含机制)
服务器·c语言·开发语言·c++·后端·visualstudio·visual studio code
w23617346011 小时前
Linux常用基础命令应用
linux·服务器·php
别致的影分身1 小时前
Protobuf 的快速使用(四)
服务器·网络·c++
White の algo1 小时前
【Linux系统】linux下的软件管理
linux·运维·服务器
松树戈1 小时前
Ubuntu挂载HDD迁移存储PostgreSQL数据
linux·ubuntu·postgresql