java springboot 正合Knife4j框架

要将 Knife4j(之前称为 SwaggerBootstrapUi)集成到 Spring Boot 项目中。

可以按照以下步骤操作:

1、添加依赖

在 pom.xml 文件中添加 Knife4j 的相关依赖。确保 Spring Boot 版本与 Knife4j 支持的版本相匹配。

这里以 Maven 为例:

XML 复制代码
<dependencies>
    <!-- Springfox Swagger 依赖 -->
    <dependency>
        <groupId>io.springfox</groupId>
        <artifactId>springfox-boot-starter</artifactId>
        <version>3.0.0</version> <!-- 根据实际需要选择版本 -->
    </dependency>
    
    <!-- Knife4j UI 依赖 -->
    <dependency>
        <groupId>com.github.xiaoymin</groupId>
        <artifactId>knife4j-spring-boot-starter</artifactId>
        <version>3.0.3</version> <!-- 请根据最新版本进行调整 -->
    </dependency>
</dependencies>

2、配置 Swagger 和 Knife4j

在 src\main\resources 目录下创建或修改 application.yml 或 application.properties 文件,配置 Swagger 和 Knife4j。

application.yml 示例配置:

XML 复制代码
springfox:
  documentation:
    swagger-ui:
      enabled: true
    knife4j:
      enable: true # 开启 Knife4j 增强功能

server:
  port: 8080

# 如果使用的是Spring Security,可能需要配置Swagger的访问权限
# security:
#   ignored: /swagger-ui.html**, /webjars/**

3、创建 Swagger 配置类

可选地,可以创建一个 Swagger 配置类来定制 API 文档信息。

以下是一个简单的示例:

java 复制代码
import springfox.documentation.builders.PathSelectors;
import springfox.documentation.builders.RequestHandlerSelectors;
import springfox.documentation.spi.DocumentationType;
import springfox.documentation.spring.web.plugins.Docket;
import springfox.documentation.swagger2.annotations.EnableSwagger2WebMvc;

@Configuration
@EnableSwagger2WebMvc // 使用Swagger2
public class Knife4jConfig {

    @Bean(value = "defaultApi2")
    public Docket defaultApi2() {
        return new Docket(DocumentationType.SWAGGER_2)
                .apiInfo(new ApiInfoBuilder()
                        .title("应用名称")
                        .description("API 描述")
                        .termsOfServiceUrl("http://yourwebsite.com")
                        .contact("联系人")
                        .version("1.0")
                        .build())
                // 分组名称
                .groupName("默认")
                .select()
                // 这里指定Controller扫描包路径
                .apis(RequestHandlerSelectors.basePackage("包路径"))
                .paths(PathSelectors.any())
                .build();
    }
}

4、访问 Swagger UI

完成上述配置后,启动 Spring Boot 应用,然后访问 http://localhost:8080/项目名/doc.html(或根据你的端口配置调整),能看到 Knife4j 增强版的 Swagger UI 界面。

相关推荐
小马爱打代码20 分钟前
Spring Boot 3.4 :@Fallback 注解 - 让微服务容错更简单
spring boot·后端·微服务
小庞在加油25 分钟前
Apollo源码架构解析---附C++代码设计示例
开发语言·c++·架构·自动驾驶·apollo
旷世奇才李先生41 分钟前
奇哥面试记:SpringBoot整合RabbitMQ与高级特性,一不小心吊打面试官
spring boot·面试·java-rabbitmq
yngsqq1 小时前
netdxf—— CAD c#二次开发之(netDxf 处理 DXF 文件)
java·前端·c#
A了LONE1 小时前
h5的底部导航栏模板
java·前端·javascript
专注VB编程开发20年1 小时前
各版本操作系统对.NET支持情况(250707更新)
开发语言·前端·ide·vscode·.net
我喜欢就喜欢1 小时前
RapidFuzz-CPP:高效字符串相似度计算的C++利器
开发语言·c++
莫彩1 小时前
【Modern C++ Part7】_创建对象时使用()和{}的区别
开发语言·c++
经典19921 小时前
spring boot 详解以及原理
java·spring boot·后端
星光54221 小时前
飞算JavaAI:给Java开发装上“智能引擎”的超级助手
java·开发语言