在Debian系統(tǒng)上配置Swagger需要遵循一系列步驟，包括軟件包的安裝、API文檔生成工具的配置以及Swagger ui的設(shè)置。以下是完整的操作指南：
1. 更新系統(tǒng)并安裝所需軟件包
首先，確保Debian系統(tǒng)的軟件包列表是最新的：
sudo apt-get update sudo apt-get upgrade
然后，安裝Swagger相關(guān)的軟件包，特別是spring Boot開發(fā)工具及其依賴項(xiàng)：
sudo apt-get install spring-boot-devtools
2. 設(shè)置spring boot項(xiàng)目環(huán)境
在你的Spring Boot項(xiàng)目里，加入Swagger所需的依賴項(xiàng)。如果使用maven，需在 pom.xml 文件中添加如下依賴：
<dependency><groupid>io.springfox</groupid><artifactid>springfox-boot-starter</artifactid><version>3.0.0</version></dependency>
對(duì)于gradle用戶，則應(yīng)在 build.gradle 文件中插入以下依賴：
implementation 'io.springfox:springfox-boot-starter:3.0.0'
3. 創(chuàng)建Swagger配置類
于項(xiàng)目內(nèi)建立一個(gè)配置類來生成Swagger文檔。示例如下：
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(); } }
記得將 com.example.demo 替換為實(shí)際的控制器所在包名。
4. 瀏覽Swagger UI
啟動(dòng)Spring Boot應(yīng)用后，可通過以下鏈接訪問Swagger UI界面：
https://www.php.cn/link/3f2624ba9ffc5ebd40c98284e1379e99
5. docker配置（可選）
若打算在Docker容器中運(yùn)行Spring Boot應(yīng)用，可參考以下步驟：
編寫Dockerfile
在項(xiàng)目根目錄創(chuàng)建 Dockerfile 文件：
FROM openjdk:11-jre-slim COPY target/demo-0.0.1-SNAPSHOT.jar app.jar ENTRYPOINT ["java", "-jar", "app.jar"]
打包并構(gòu)建鏡像
在項(xiàng)目根目錄執(zhí)行以下命令以構(gòu)建Docker鏡像：
docker build -t demo .
啟動(dòng)Docker容器
構(gòu)建成功后，利用以下命令運(yùn)行Docker容器：
docker run -p 8080:8080 demo
此時(shí)，即可通過 https://www.php.cn/link/3f2624ba9ffc5ebd40c98284e1379e99 在瀏覽器中查看Swagger UI。
.png)
推廣.jpg)