springboot2.7.9 整合swagger2 使用com.github.xiaoymin 的knife4j
时间: 2023-12-05 13:04:03 浏览: 273
好的,你想要了解如何在Spring Boot 2.7.9中整合Swagger2并使用com.github.xiaoymin的knife4j扩展库,是吗?我可以为你提供一些步骤。
首先,你需要在你的pom.xml文件中添加以下依赖:
```xml
<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>
<dependency>
<groupId>com.github.xiaoymin</groupId>
<artifactId>knife4j-spring-boot-starter</artifactId>
<version>2.0.8</version>
</dependency>
```
然后,你需要在你的Spring Boot配置类中添加以下内容:
```java
@Configuration
@EnableSwagger2
public class Swagger2Config {
@Bean
public Docket createRestApi() {
return new Docket(DocumentationType.SWAGGER_2)
.apiInfo(apiInfo())
.select()
.apis(RequestHandlerSelectors.basePackage("com.example.demo.controller"))
.paths(PathSelectors.any())
.build();
}
private ApiInfo apiInfo() {
return new ApiInfoBuilder()
.title("Swagger2接口文档")
.description("Swagger2接口文档")
.termsOfServiceUrl("http://localhost:8080/")
.version("1.0")
.build();
}
}
```
这个配置类将创建一个名为"Swagger2接口文档"的文档,并扫描com.example.demo.controller包中的所有控制器。
最后,你可以在你的浏览器中访问http://localhost:8080/doc.html来查看生成的文档。
如果你想自定义Swagger UI的主题,你可以在application.properties中添加以下配置:
```properties
# Swagger UI主题
knife4j.swaggerui.path=/doc.html
knife4j.swaggerui.title=Swagger2接口文档
knife4j.swaggerui.description=Swagger2接口文档
knife4j.swaggerui.version=1.0
knife4j.swaggerui.contact.name=联系人姓名
knife4j.swaggerui.contact.email=联系人邮箱
knife4j.swaggerui.contact.url=联系人网址
knife4j.swaggerui.license.name=许可证名称
knife4j.swaggerui.license.url=许可证网址
knife4j.swaggerui.enable=true
# 配置主题
knife4j.swaggerui.theme=flattop
```
这将启用knife4j并使用flattop主题。
希望这些步骤对你有所帮助。
阅读全文