ubuntu

swagger怎样在ubuntu集成

小樊
44
2025-08-07 04:54:38
栏目: 智能运维

在Ubuntu上集成Swagger主要有以下两种常见方式:

基于Node.js和Express框架集成

  1. 安装Node.js和npm:sudo apt updatesudo apt install nodejs npm
  2. 安装Swagger工具:sudo npm install -g swagger-jsdoc swagger-ui-express
  3. 创建Swagger配置文件:如swagger.jsonswagger.yaml,可手动编写或用Swagger Editor生成。
  4. 集成到Express应用:在应用中添加代码const express = require('express'); const swaggerUi = require('swagger-ui-express'); const swaggerDocument = require('./swagger.json'); const app = express(); app.use('/api-docs', swaggerUi.serve, swaggerUi.setup(swaggerDocument));
  5. 运行应用:node app.js,然后访问http://localhost:3000/api-docs查看Swagger UI。

基于Java和Spring Boot集成

  1. 安装Java:sudo apt updatesudo apt install openjdk-11-jdk
  2. 添加Swagger依赖到pom.xml:如springfox-swagger2springfox-swagger-ui
  3. 配置Swagger:创建配置类,使用@EnableSwagger2注解,通过Docket bean配置扫描包等。
  4. 使用注解描述API:在Controller和Model类上添加@Api@ApiOperation等注解。
  5. 访问Swagger UI:启动Spring Boot项目后,访问http://localhost:8080/swagger-ui.html

0
看了该问题的人还看了