Ubuntu Swagger如何快速上手

在Ubuntu上快速上手Swagger，通常涉及以下幾個步驟：

1. 安裝Swagger UI

首先，你需要安裝Swagger UI?？梢酝ㄟ^以下命令在Ubuntu上安裝Swagger UI：

sudo apt update
sudo apt install -y openjdk-11-jre-headless
wget https://repo1.maven.org/maven2/io/springfox/springfox-swagger-ui/2.9.2/springfox-swagger-ui-2.9.2.html
unzip springfox-swagger-ui-2.9.2.html
sudo mv springfox-swagger-ui-2.9.2 /var/www/html/swagger-ui

2. 配置Swagger UI

編輯 /var/www/html/swagger-ui/index.html 文件，找到以下行并進行修改：

<script>
  window.onload = function() {
    // Begin Swagger UI call region
    const ui = SwaggerUIBundle({
      url: "http://petstore.swagger.io/v2/api-docs",
      dom_id: '#swagger-ui',
      deepLinking: true,
      presets: [
        SwaggerUIBundle.presets.apis,
        SwaggerUIStandalonePreset
      ],
      plugins: [
        SwaggerUIBundle.plugins.DownloadUrl
      ],
      layout: "StandaloneLayout"
    });
    // End Swagger UI call region
    window.ui = ui;
  };
</script>

3. 啟動Web服務器

你可以使用Apache或Nginx作為Web服務器。以下是使用Apache的示例：

sudo a2ensite default.conf
sudo systemctl restart apache2

或者使用Nginx：

sudo cp /etc/nginx/sites-available/default /etc/nginx/sites-available/default.backup
sudo nano /etc/nginx/sites-available/default

修改 server 塊中的 root 和 index 指令：

server {
  listen 80 default_server;
  listen [::]: 80 default_server;
  root /var/www/html;
  index index.html index.htm;
  server_name _;
  location / {
    try_files $uri $uri/ =404;
  }
}

保存并退出編輯器，然后重啟Nginx：

sudo systemctl restart nginx

4. 訪問Swagger UI

現在，你應該能夠通過瀏覽器訪問 http://your_server_ip/swagger-ui 來查看和使用Swagger UI。

5. 在Spring Boot項目中集成Swagger（可選）

如果你使用的是Spring Boot項目，可以通過以下步驟集成Swagger：

添加依賴

在項目的 pom.xml 文件中添加以下依賴：

<dependency>
  <groupId>io.springfox</groupId>
  <artifactId>springfox-swagger2</artifactId>
  <version>2.9.2</version>
</dependency>
<dependency>
  <groupId>io.springfox</groupId>
  <artifactId>springfox-swagger-ui</artifactId>
  <version>2.9.2</version>
</dependency>

配置Swagger

創建一個配置類來啟用Swagger并定義一些基本信息：

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import springfox.documentation.builders.PathSelectors;
import springfox.documentation.builders.RequestHandlerSelectors;
import springfox.documentation.spi.DocumentationType;
import springfox.documentation.spring.web.plugins.Docket;
import springfox.documentation.swagger2.annotations.EnableSwagger2;

@Configuration
@EnableSwagger2
public class SwaggerConfig {
    @Bean
    public Docket api() {
        return new Docket(DocumentationType.SWAGGER_2)
                .select()
                .apis(RequestHandlerSelectors.any())
                .paths(PathSelectors.any())
                .build();
    }
}

添加文檔內容

在完成了上述配置后，啟動Spring Boot項目后，訪問 http://localhost:8080/swagger-ui.html（假設服務端口為8080），可以看到Swagger UI界面，其中展示了項目中定義的所有API接口及其詳細信息。

通過以上步驟，你應該能夠在Ubuntu上快速上手Swagger。