溫馨提示×

centos swagger案例分享

小樊
45
2025-08-08 17:32:19
欄目: 智能運維

以下是一些CentOS上使用Swagger的案例分享:

搭建Swagger UI展示API文檔

  1. 安裝Node.js和npm:通過命令安裝,如curl -sL https://rpm.nodesource.com/setup_14.x | sudo -E bash -,再sudo yum install -y nodejs。
  2. 安裝Swagger UI:從GitHub克隆項目,如git clone https://github.com/swagger-api/swagger-ui.git,然后cd到項目目錄安裝依賴npm install。
  3. 配置并啟動:創建index.js文件配置Swagger UI,如指定靜態文件目錄等,然后node index.js啟動,通過瀏覽器訪問http://localhost:3000查看。
  4. 添加API文檔:可手動創建或用Swagger Editor生成符合OpenAPI Specification的JSON或YAML文件,將其放到指定目錄并通過修改相關配置文件來顯示在Swagger UI中。

結合Spring Boot生成API文檔

  1. 安裝Java和Maven:使用sudo yum install -y java-1.8.0-openjdk-develsudo yum install -y maven安裝。
  2. 添加Swagger依賴:在Spring Boot項目的pom.xml中添加springfox-swagger2springfox-swagger-ui依賴。
  3. 配置Swagger:在主類中添加Swagger配置類,使用@EnableSwagger2注解等配置相關信息。
  4. 編寫API注釋:在代碼的路由或控制器文件中添加Swagger注釋來描述API。
  5. 查看文檔:啟動應用后,通過http://localhost:8080/swagger-ui.html訪問Swagger UI查看和測試API文檔。

0
亚洲午夜精品一区二区_中文无码日韩欧免_久久香蕉精品视频_欧美主播一区二区三区美女