spring boot集成接口文档框架

Spring Boot可以集成多个接口文档框架，其中两个比较常用的是Swagger和Knife4j。下面分别介绍它们的集成方法：

1. Swagger集成：
Swagger是一个开源的接口文档框架，可以帮助我们生成、展示和测试API文档。在Spring Boot中，我们可以通过添加相应的依赖和配置来集成Swagger。

首先，在pom.xml文件中添加Swagger的依赖：

<dependency>
    <groupId>io.springfox</groupId>
    <artifactId>springfox-boot-starter</artifactId>
    <version>3.0.0</version>
</dependency>

然后，在Spring Boot的启动类上添加`@EnableSwagger2`注解：

import springfox.documentation.swagger2.annotations.EnableSwagger2;

@EnableSwagger2
@SpringBootApplication
public class Application {
    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }
}

接下来，我们可以在Controller类的方法上使用Swagger的注解来描述接口信息，例如：

import io.swagger.annotations.Api;
import io.swagger.annotations.ApiOperation;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
@Api(tags = "示例接口")
public class SampleController {
    @GetMapping("/hello")
    @ApiOperation("示例接口")
    public String hello() {
        return "Hello, Swagger!";
    }
}

最后，启动Spring Boot应用程序，访问`http://localhost:8080/swagger-ui.html`即可查看生成的接口文档。

2. Knife4j集成：
Knife4j是Swagger的增强版，提供了更多的功能和样式定制。在Spring Boot中，我们可以通过添加相应的依赖和配置来集成Knife4j。

首先，在pom.xml文件中添加Knife4j的依赖：

<dependency>
    <groupId>com.github.xiaoymin</groupId>
    <artifactId>knife4j-spring-boot-starter</artifactId>
    <version>3.0.2</version>
</dependency>

然后，在Spring Boot的启动类上添加`@EnableKnife4j`注解：

import com.github.xiaoymin.knife4j.spring.annotations.EnableKnife4j;

@EnableKnife4j
@SpringBootApplication
public class Application {
    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }
}

接下来，我们可以在Controller类的方法上使用Knife4j的注解来描述接口信息，例如：

import io.swagger.annotations.Api;
import io.swagger.annotations.ApiOperation;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
@Api(tags = "示例接口")
public class SampleController {
    @GetMapping("/hello")
    @ApiOperation("示例接口")
    public String hello() {
        return "Hello, Knife4j!";
    }
}

最后，启动Spring Boot应用程序，访问`http://localhost:8080/doc.html`即可查看生成的接口文档。