在Debian上安装Swagger通常有两种常见方式,分别是基于Node.js环境和Java环境,以下是具体步骤:
sudo apt update
和sudo apt upgrade -y
,确保系统软件包是最新的。curl -sL https://deb.nodesource.com/setup_14.x | sudo -E bash -
安装Node.js 14.x版本,然后执行sudo apt-get install -y nodejs
。sudo npm install -g swagger-ui-express
命令进行安装。swagger-ui-demo
,进入该目录后创建app.js
文件,在其中添加代码来配置Swagger UI,例如使用swagger-ui-express
中间件来服务Swagger文档。swagger.yaml
文件,定义API的相关信息,如路径、操作、参数等。node app.js
,然后访问http://localhost:3000/api-docs
,即可查看Swagger UI界面。sudo apt install openjdk-11-jdk -y
安装JDK。wget https://repo1.maven.org/maven2/io/swagger/swagger-codegen-cli/2.4.21/swagger-codegen-cli-2.4.21.jar
,并将其重命名为swagger-codegen-cli.jar
。java -jar swagger-codegen-cli.jar generate -i /path/to/your/openapi.yaml -l java -o /output/directory
命令,根据指定的OpenAPI规范文件生成对应的Java代码和文档。