SpringFox Swagger -删除200个响应

SpringFox Swagger 是一个用于生成、描述、调用和可视化 RESTful 风格 Web 服务的框架。它结合了 Swagger 和 Spring MVC，使得 RESTful API 的文档生成变得简单。当你使用 SpringFox Swagger 并且想要删除特定的响应代码（例如200）时，通常是因为你希望控制 API 文档中显示的信息，或者是因为某些响应代码在你的应用中不再适用。

基础概念

Swagger 是一套基于 OpenAPI 规范构建的开源工具集，用于设计、构建、记录和使用 RESTful Web 服务。SpringFox 是一个库，它可以自动从 Spring 应用程序中读取 API 元数据，并生成 Swagger 文档。

类型

SpringFox 提供了多种注解来定制 API 文档，例如 @Api, @ApiOperation, @ApiResponses, 和 @ApiResponse 等。

应用场景

API 文档：为开发者提供详细的 API 使用指南。
API 测试：允许开发者在浏览器中直接测试 API 端点。
客户端代码生成：根据 API 文档自动生成客户端代码。

遇到的问题及解决方法

如果你想要删除特定的响应代码（如200），可以通过自定义 @ApiResponses 或 @ApiResponse 注解来实现。以下是一个示例：

import io.swagger.annotations.Api;
import io.swagger.annotations.ApiOperation;
import io.swagger.annotations.ApiResponse;
import io.swagger.annotations.ApiResponses;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
@Api(tags = "Sample API")
public class SampleController {

    @GetMapping("/sample")
    @ApiOperation(value = "Get sample data")
    @ApiResponses(value = {
        @ApiResponse(code = 400, message = "Bad Request"),
        @ApiResponse(code = 500, message = "Internal Server Error")
        // 注意这里没有包含200响应
    })
    public String getSampleData() {
        return "Sample Data";
    }
}

在这个例子中，我们故意没有包含200响应代码。这样，Swagger UI 将不会显示200作为这个 API 端点的有效响应代码。