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

相关推荐
厦门德仔3 分钟前
【WPF】WPF(样式)
android·java·wpf
大春儿的试验田3 分钟前
高并发收藏功能设计:Redis异步同步与定时补偿机制详解
java·数据库·redis·学习·缓存
Gappsong8746 分钟前
【Linux学习】Linux安装并配置Redis
java·linux·运维·网络安全
hqxstudying10 分钟前
Redis为什么是单线程
java·redis
RainbowSea21 分钟前
NVM 切换 Node 版本工具的超详细安装说明
java·前端
逆风局?23 分钟前
Maven高级——分模块设计与开发
java·maven
周某某~25 分钟前
maven详解
java·maven
读书点滴27 分钟前
笨方法学python -练习14
java·前端·python
lingRJ77728 分钟前
微服务架构下的抉择:Consul vs. Eureka,服务发现该如何选型?
java·eureka·springcloud·consul·backend·microservices·servicediscovery
RainbowSea28 分钟前
问题:后端由于字符内容过长,前端展示精度丢失修复
java·spring boot·后端