swagger生成api接口文档安装

Swagger是一个用于设计、构建、记录以及使用RESTful Web服务的框架。Swagger允许你描述结构化的API，以便机器可以读取这些描述。这样你就可以自动地生成文档、客户端库等。在很多编程语言中都有Swagger的实现，比如Swagger的Java实现叫做Swagger Java。

对于在Java项目中使用Swagger生成API接口文档，通常需要添加Swagger相关的依赖库。以Spring Boot项目为例，你可以通过添加Swagger的依赖和配置Swagger相关的Bean来完成安装和配置。下面是简单的步骤：

1. 添加Swagger依赖到你的`pom.xml`文件中（如果你使用的是Maven）：

<!-- 添加Swagger2的依赖 -->
<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>

2. 创建一个配置类来启用Swagger，并配置API的基本信息：

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
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()
                // 指定扫描的包路径来定义哪些接口暴露给Swagger
                .apis(RequestHandlerSelectors.basePackage("com.example.demo.controller"))
                .build();
    }
}

3. 访问Swagger UI来查看和测试你的API文档：
默认情况下，你可以通过访问`http://localhost:8080/swagger-ui.html`（假设你的应用运行在本地的8080端口）来查看Swagger UI，并与你的API进行交互。