117笔记问答在Debian系统中配置Swagger文档生成，通常需要以下几个步骤：
-
安装必要的软件包： 首先，确保你的Debian系统已经安装了Java和Maven。如果没有安装，可以使用以下命令进行安装：
sudo apt update sudo apt install openjdk-11-jdk maven
-
添加Swagger依赖： 在你的Maven项目的
pom.xml文件中添加Swagger依赖。以下是一个示例配置：io.swagger.core.v3 swagger-annotations 2.1.12 io.swagger.core.v3 swagger-models 2.1.12 io.swagger.core.v3 swagger-parser 2.0.28 io.swagger.core.v3 swagger-models 2.1.12 io.swagger.core.v3 swagger-annotations 2.1.12 -
配置Swagger： 在你的Spring Boot应用程序中，创建一个Swagger配置类。以下是一个示例配置：
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")) .paths(PathSelectors.any()) .build(); } } -
运行应用程序： 启动你的Spring Boot应用程序。Swagger UI将会自动集成到你的应用程序中，默认情况下可以通过访问
http://localhost:8080/swagger-ui.html来查看Swagger文档。 -
自定义Swagger配置（可选）： 你可以根据需要进一步自定义Swagger配置，例如添加API信息、安全配置等。以下是一个更详细的配置示例：
import org.springframework.context.annotation.Bean; import org.springframework.context.annotation.Configuration; import springfox.documentation.builders.ApiInfoBuilder; import springfox.documentation.builders.PathSelectors; import springfox.documentation.builders.RequestHandlerSelectors; import springfox.documentation.service.ApiInfo; 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) .apiInfo(apiInfo()) .select() .apis(RequestHandlerSelectors.basePackage("com.example.demo")) .paths(PathSelectors.any()) .build(); } private ApiInfo apiInfo() { return new ApiInfoBuilder() .title("My API") .description("Description of my API") .version("1.0.0") .build(); } }
通过以上步骤，你应该能够在Debian系统中成功配置Swagger文档生成。