JavaWeb合集16-接口管理Swager

十六、接口管理

1、Swager

使用Swagger你只需要按照它的规范去定义接口及接口相关的信息,就可以做到生成接口文档,以及在线接口调试页面。

官网: https://swagger.io/

Knife4j是为Java MVC框架集成Swagger生成Api文档的增强解决方案。

xml 复制代码
            <dependency>
                <groupId>com.github.xiaoymin</groupId>
                <artifactId>knife4j-openapi3-jakarta-spring-boot-starter</artifactId>
                <version>4.4.0</version>
            </dependency>
  1. 导入knife4j的maven坐标

  2. 在配置类中加入knife4j相关配置

java 复制代码
@Configuration
public class WebMvcConfiguration extends WebMvcConfigurationSupport{

/*
*
* 在配置类中加入knife4j相关配置*/
@Bean
public OpenAPI springShopOpenAPI() {
  log.info("knife4j配置成功");
  return new OpenAPI()
          // 接口文档标题
          .info(new Info().title("永恒之月")
                  // 接口文档简介
                  .description("接口管理")
                  // 接口文档版本
                  .version("v1.0")
                  // 开发者联系方式
                  .contact(new Contact().name("yhzy").email("yhzyai@163.com")))
          .externalDocs(new ExternalDocumentation()
                  .description("SpringBoot基础框架")
                  .url("http://127.0.0.1:9091"));
}

//   下面是分组
  @Bean
  public GroupedOpenApi groupedOpenApi01(){
      return GroupedOpenApi.builder()
              .group("管理端接口")
              // 该分组所在的包
              .packagesToScan("fun.yhzy.controller.admin")
              .build();
  }

  @Bean
  public GroupedOpenApi groupedOpenApi02(){
      return GroupedOpenApi.builder()
              .group("用户端接口")
              // 该分组所在的包
              .packagesToScan("fun.yhzy.controller.user")
              .build();
  }

  /**
   * 设置静态资源映射
   * @param registry
   */
  protected void addResourceHandlers(ResourceHandlerRegistry registry) {
      registry.addResourceHandler("/doc.html").addResourceLocations("classpath:/META-INF/resources/");
      registry.addResourceHandler("/webjars/**").addResourceLocations("classpath:/META-INF/resources/webjars/");
  }


}
  1. yml配置
yml 复制代码
#knife4j 相关配置
springdoc:
  swagger-ui:
    path: /swagger-ui.html
    tags-sorter: alpha
    operations-sorter: alpha
  api-docs:
    path: /v3/api-docs


# knife4j的增强配置,不需要增强可以不配
knife4j:
  enable: true
  setting:
    language: zh_cn
    #是否开启密码保护
  basic:
    enable: true
    username: root
    password: 123
1.2 Swager 常用注解

通过注解可以控制生成的接口文档,使接口文档拥有更好的可读性,常用注解如下:

注解 说明
@Tag 作用于控制类上,name属性用于描述控制类
@Operation 作用于控制类的方法上面,summary属性用于描述方法
@Parameter(hidden = true) 、@Operation(hidden = true)、@Hidden 这是用于排除或隐藏api
@Schema DTO实体属性,name属性用于描述属性

创建好后直接访问:后端地址:端口号/doc.html,如:http://localhost:9091/doc.html

相关推荐
RainbowSea1 天前
12. LangChain4j + 向量数据库操作详细说明
java·langchain·ai编程
RainbowSea1 天前
11. LangChain4j + Tools(Function Calling)的使用详细说明
java·langchain·ai编程
考虑考虑1 天前
Jpa使用union all
java·spring boot·后端
用户3721574261351 天前
Java 实现 Excel 与 TXT 文本高效互转
java
浮游本尊1 天前
Java学习第22天 - 云原生与容器化
java
渣哥1 天前
原来 Java 里线程安全集合有这么多种
java
间彧1 天前
Spring Boot集成Spring Security完整指南
java
间彧1 天前
Spring Secutiy基本原理及工作流程
java
Java水解1 天前
JAVA经典面试题附答案(持续更新版)
java·后端·面试
洛小豆1 天前
在Java中,Integer.parseInt和Integer.valueOf有什么区别
java·后端·面试