
在Debian系统上配置Swagger需要遵循一系列步骤,包括软件包的安装、API文档生成工具的配置以及Swagger UI的设置。以下是完整的操作指南:
首先,确保Debian系统的软件包列表是最新的:
<code>sudo apt-get update sudo apt-get upgrade</code>
然后,安装Swagger相关的软件包,特别是Spring Boot开发工具及其依赖项:
<code>sudo apt-get install spring-boot-devtools</code>
在你的Spring Boot项目里,加入Swagger所需的依赖项。如果使用Maven,需在 pom.xml 文件中添加如下依赖:
<code><dependency><groupid>io.springfox</groupid><artifactid>springfox-boot-starter</artifactid><version>3.0.0</version></dependency></code>
对于Gradle用户,则应在 build.gradle 文件中插入以下依赖:
<code>implementation 'io.springfox:springfox-boot-starter:3.0.0'</code>
于项目内建立一个配置类来生成Swagger文档。示例如下:
<code>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();
}
}</code>记得将 com.example.demo 替换为实际的控制器所在包名。
启动Spring Boot应用后,可通过以下链接访问Swagger UI界面:
<code>https://www.php.cn/link/3f2624ba9ffc5ebd40c98284e1379e99</code>
若打算在Docker容器中运行Spring Boot应用,可参考以下步骤:
在项目根目录创建 Dockerfile 文件:
<code>FROM openjdk:11-jre-slim COPY target/demo-0.0.1-SNAPSHOT.jar app.jar ENTRYPOINT ["java", "-jar", "app.jar"]</code>
在项目根目录执行以下命令以构建Docker镜像:
<code>docker build -t demo .</code>
构建成功后,利用以下命令运行Docker容器:
<code>docker run -p 8080:8080 demo</code>
此时,即可通过 https://www.php.cn/link/3f2624ba9ffc5ebd40c98284e1379e99 在浏览器中查看Swagger UI。
以上就是Swagger在Debian上如何配置使用的详细内容,更多请关注php中文网其它相关文章!
每个人都需要一台速度更快、更稳定的 PC。随着时间的推移,垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是,许多工具可以让 Windows 保持平稳运行。
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号