Linux Swagger与Spring Boot如何集成-LINUX-PHP中文网

Linux Swagger与Spring Boot如何集成

星降

发布： 2025-04-10 09:48:10

原创

592人浏览过

Spring Boot项目轻松集成Swagger：详细步骤指南

本文将指导您如何在spring boot项目中快速集成swagger，方便api文档的生成和测试。以下步骤将帮助您轻松完成集成，并开始使用swagger ui浏览您的api。

Linux Swagger与Spring Boot如何集成

第一步：添加依赖

在您的pom.xml文件中添加以下Swagger依赖：

<dependency>
    <groupId>io.springfox</groupId>
    <artifactId>springfox-swagger2</artifactId>
    <version>2.9.2</version>
</dependency>
<dependency>
    <groupId>io.springfox</groupId>
    <artifactId>springfox-swagger-ui</artifactId>
    <version>2.9.2</version>
</dependency>

登录后复制

请根据您的实际需求选择合适的Swagger版本。

第二步：Swagger配置

创建一个名为SwaggerConfig.java的配置类，并添加如下代码：

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
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.EnableSwagger2;

@Configuration
@EnableSwagger2
public class SwaggerConfig {
    @Bean
    public Docket api() {
        return new Docket(DocumentationType.SWAGGER_2)
                .select()
                .apis(RequestHandlerSelectors.basePackage("com.example.demo.controller")) // 请替换成您的Controller包名
                .paths(PathSelectors.any())
                .build();
    }
}

登录后复制

请务必将com.example.demo.controller替换为您实际的Controller包名。

第三步：访问Swagger UI

启动您的Spring Boot应用程序后，在浏览器中访问以下URL：