在CentOS系統上生成Swagger代碼,通常需要使用Swagger Codegen工具。以下是詳細的步驟指南:
Swagger Codegen需要Java環境,首先確保你的CentOS系統上已經安裝了Java。如果沒有安裝,可以使用以下命令安裝OpenJDK:
sudo yum install java-1.8.0-openjdk-devel
驗證安裝:
java -version
你可以從Swagger Codegen的GitHub倉庫下載最新版本的代碼生成器。使用以下命令下載:
wget https://repo1.maven.org/maven2/io/swagger/swagger-codegen-cli/3.0.30/swagger-codegen-cli-3.0.30.jar
創建一個配置文件(例如config.json),用于指定生成代碼的參數。以下是一個簡單的配置文件示例:
{
"inputSpec": "path/to/your/swagger.json",
"language": "java",
"output": "path/to/output/directory",
"configOptions": {
"sourceFolder": "src/main/java"
}
}
使用Swagger Codegen CLI工具生成代碼。運行以下命令:
java -jar swagger-codegen-cli-3.0.30.jar generate \
-i path/to/your/swagger.json \
-l java \
-o path/to/output/directory \
--configOptions sourceFolder=path/to/output/directory/src/main/java
進入生成的代碼目錄,檢查生成的代碼是否符合預期。
cd path/to/output/directory
ls -l
假設你有一個Swagger定義文件api.yaml,并且你想生成Java代碼到/home/user/swagger-generated目錄,可以使用以下命令:
java -jar swagger-codegen-cli-3.0.30.jar generate \
-i /home/user/api.yaml \
-l java \
-o /home/user/swagger-generated \
--configOptions sourceFolder=/home/user/swagger-generated/src/main/java
swagger.json或api.yaml)是有效的。-l參數的值即可。通過以上步驟,你應該能夠在CentOS系統上成功生成Swagger代碼。