如何使用swagger进行多人协同开发

 时间:2026-02-12 14:18:28

1、引入swagger依赖,如下图所示。

如何使用swagger进行多人协同开发

2、在启动类的同级目录下创建Swagger2类,作为配置类,如下图所示。

★通过@Configuration标记此类为配置类,会在SpringBoot项目启动的时候加载,@EnableSwagger2用来启动Swagger。


★Swagger会自动扫描我们配置的cn.com.wenyi.controller包下的接口自动生成接口文档。

如何使用swagger进行多人协同开发

3、在Controller类上使用@Api注解,如下图所示。

如何使用swagger进行多人协同开发

4、在方法上使用@ApiOperation注解来给API增加方法说明,如下图所示。

如何使用swagger进行多人协同开发

5、在方法上使用@ApiImplicitParams或者@ApiImplicitParam注解,用来给方法入参增加说明,如下图所示。

如何使用swagger进行多人协同开发

如何使用swagger进行多人协同开发

6、在实体类上使用@ApiModel注解,描述一个Model的信息,如下图所示。

如何使用swagger进行多人协同开发

7、在实体类的属于变量上使用@ApiModelProperty,描述一个model的属性,如下图所示。

如何使用swagger进行多人协同开发

8、启动Spring Boot程序,访问:http://localhost:8080/swagger-ui.html,看看显示效果,如下图所示。

如何使用swagger进行多人协同开发

9、总结:

1、引入swagger依赖

2、创建Swagger2类,使用@Configuration与@EnableSwagger2

3、使用@Api

4、使用@ApiOperation

5、使用@ApiImplicitParams或者@ApiImplicitParam

6、使用@ApiModel

7、使用@ApiModelProperty

8、访问:http://localhost:8080/swagger-ui.html

  • Linux下安装tomcat步骤说明
  • Linux/centos网络管理命令和关机重启命令
  • Linux平台的SVN服务器的配置及搭建
  • 在windows下添加计划任务
  • 解决“0516-787 extendlv”报错
  • 热门搜索
    孕妇贫血怎么补 邮箱地址怎么填 电视投屏怎么设置 升级怎么玩 青鱼怎么做好吃 函怎么写 黑豆怎么吃最补肾 户口本丢了怎么办 电脑怎么升级系统 五行怎么看