centos swagger文档生成

在CentOS上生成Swagger文档通常涉及以下几个步骤：

1. 安装Java环境：Swagger依赖于Java环境，因此首先需要在CentOS上安装Java。可以使用以下命令安装OpenJDK 8：

sudo yum install java-1.8.0-openjdk-devel

2. 安装Maven：Swagger的构建过程需要Maven，因此需要安装Maven。可以使用以下命令安装Maven：

sudo yum install maven

3. 导入Swagger库：根据你使用的编程语言和框架，导入相应的Swagger库。例如，如果你使用的是Spring Boot，可以导入以下依赖：

<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>

4. 配置Swagger：创建Swagger配置类，使用注解来配置Swagger生成文档的基本信息、扫描的包路径等。例如，对于Spring Boot项目，可以创建如下配置类：

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;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
@EnableSwagger2
public class SwaggerConfig {
    @Bean
    public Docket api() {
        return new Docket(DocumentationType.SWAGGER_2)
                .select()
                .apis(RequestHandlerSelectors.basePackage("cn.weijishu.server.api.rest"))
                .paths(PathSelectors.any())
                .build();
    }
}

5. 生成Swagger文档：使用Swagger提供的注解在代码中标记API，然后运行项目。Swagger会自动生成文档。

6. 访问Swagger UI：启动项目后，可以通过浏览器访问Swagger UI页面，查看和测试生成的API文档。通常可以通过访问http://localhost:8080/swagger-ui.html来查看Swagger UI。