Linux上Swagger如何与Swagger Codegen配合使用

在Linux上，Swagger（现在称为OpenAPI）和Swagger Codegen可以配合使用来生成客户端库、API文档和API服务器代码。以下是使用Swagger Codegen的基本步骤：

1. 安装Swagger Codegen： Swagger Codegen可以通过多种方式安装，包括使用Docker、Homebrew（对于Mac用户）或者直接下载jar文件。在Linux上，你可以使用以下命令下载预编译的jar文件：

   wget https://repo1.maven.org/maven2/io/swagger/swagger-codegen-cli/2.4.23/swagger-codegen-cli-2.4.23.jar
   

   请注意，你可能需要根据最新的版本号来更新下载链接。

2. 准备Swagger规范： 你需要有一个Swagger（OpenAPI）规范文件，通常是一个.yaml或.json文件。这个文件描述了你的API接口和数据模型。

3. 生成代码： 使用Swagger Codegen CLI工具，你可以根据Swagger规范文件生成客户端库、API服务器代码等。例如，要生成一个Java客户端库，你可以运行以下命令：

   java -jar swagger-codegen-cli-2.4.23.jar generate \
   -i /path/to/api-spec.yaml \
   -l java \
   -o /output/directory
   

   这里-i参数指定输入的Swagger规范文件，-l参数指定目标语言，-o参数指定输出目录。

4. 自定义模板（可选）： 如果你需要对生成的代码进行定制，可以使用Swagger Codegen提供的模板，或者编写自己的模板。模板通常位于Swagger Codegen的modules/swagger-codegen/src/main/resources目录下。

5. 集成到构建过程中： 你可以将Swagger Codegen集成到你的构建过程中，例如使用Maven或Gradle插件，这样可以自动化代码生成的过程。

6. 查看生成的文档： Swagger Codegen还可以生成API文档。你可以使用以下命令生成并查看HTML格式的API文档：

   java -jar swagger-codegen-cli-2.4.23.jar generate \
   -i /path/to/api-spec.yaml \
   -l swagger \
   -o /output/directory
   

   生成的文档通常位于指定的输出目录中的swagger-ui/index.html文件。

请根据你的具体需求和Swagger Codegen的版本调整上述步骤。如果有新的版本发布，建议查看官方文档以获取最新的安装和使用指南。