后端编写Swagger接口管理文档()

  本篇文章为你整理了后端编写Swagger接口管理文档()的详细内容,包含有 后端编写Swagger接口管理文档,希望能帮助你了解 后端编写Swagger接口管理文档。

   在后端开发当中,编写好多个接口后需要通过注解编写相应的接口文档提供给前端调用接口实现前后端分离。

  
访问接口文档的网页:http://localhost:8080/swagger-ui/index.html

  

 dependency 

 

   groupId io.springfox /groupId

   artifactId springfox-boot-starter /artifactId

   version 3.0.0 /version

   /dependency

  

 

  编写yaml

  SpringBoot 2.6以上版本修改了路径匹配规则,但是Swagger3还不支持,这里换回之前的,不然启动直接报错

  

spring:

 

   mvc:

   pathmatch:

   matching-strategy: ant_path_matcher

  

 

  创建配置类配置swagger信息

  这个是配置swagger网页的大文字

  

@Configuration

 

  public class SwaggerConfiguration {

   @Bean

   public Docket docket() {

   return new Docket(DocumentationType.OAS_30)

   .apiInfo(apiInfoMyself())

   .select() //开启选择扫描接口功能

   .apis(RequestHandlerSelectors.basePackage("com.example.controller")) //设置swagger只扫描该包下的接口(还可以设置只扫描每个类,某个方法)

   .build();

   private ApiInfo apiInfoMyself(){

   return new ApiInfoBuilder()

   .contact(new Contact("你的名字", "https://www.bilibili.com", "javastudy111*@163.com"))

   .title("图书馆里系统——在线api接口文档")

   .description("欢迎各位前端大佬前来访问接口")

   .version("1.1") //自己随便定义这个接口第几版的

   .build();

  

 

  添加具体描述

  

//为xxxcontroller这个类加注解

 

  @Api(tags = "账户验证接口", description = "包括用户登录、注册、验证码请求等操作。")

  @RestController

  @RequestMapping("/api/auth")

  public class AuthApiController {

  //为某个接口添加注解

  @ApiResponses({

   @ApiResponse(code = 200, message = "邮件发送成功"),

   @ApiResponse(code = 500, message = "邮件发送失败") //不同返回状态码描述

  @ApiOperation("请求邮件验证码") //接口描述

  @GetMapping("/verify-code")

  public RestBean Void verifyCode(@ApiParam("邮箱地址") @RequestParam("email") String email,//请求参数的描述

   @ApiParam("邮箱地址") @RequestParam("email") String email){

  //让swagger忽略每个接口

  @ApiIgnore //忽略此请求映射

  @PostMapping("/login-success")

  public RestBean Void loginSuccess(){

   return new RestBean (200, "登陆成功");

  //为实体类添加描述(因为有时候会返回一个实体类,所以需要告诉前端人员这个实体类描述的是啥)

  @Data

  @ApiModel(description = "响应实体封装类")

  @AllArgsConstructor

  public class RestBean T {

   @ApiModelProperty("状态码")

   int code;

   @ApiModelProperty("状态码描述")

   String reason;

   @ApiModelProperty("数据实体")

   T data;

   public RestBean(int code, String reason) {

   this.code = code;

   this.reason = reason;

  

 

  如果有配置多环境,prod生产环境就没必要开启swagger了

  

springfox:

 

   documentation:

   enabled: false

  

 

  
本文来自,作者:不吃紫菜,遵循CC 4.0 BY-SA版权协议,

  转载请附上原文出处链接:https:///buchizicai/p/16517395.html及本声明;

  本文版权归作者所有,欢迎转载,但未经作者同意必须保留此段声明,且在文章页面明显位置给出原文连接,否则保留追究法律责任的权利。

  以上就是后端编写Swagger接口管理文档()的详细内容,想要了解更多 后端编写Swagger接口管理文档的内容,请持续关注盛行IT软件开发工作室。

郑重声明:本文由网友发布,不代表盛行IT的观点,版权归原作者所有,仅为传播更多信息之目的,如有侵权请联系,我们将第一时间修改或删除,多谢。

留言与评论(共有 条评论)
   
验证码: